Difference between revisions of "Raw key events"

From ComputerCraft Wiki
Jump to: navigation, search
m (Reverted edits by 188.143.232.12 (talk) to last revision by Thesbros)
(Added keyboard-image, need to add table version.)
 
(2 intermediate revisions by 2 users not shown)
Line 34: Line 34:
  
 
==Key scan codes ==
 
==Key scan codes ==
 +
[[File:CC-Keyboard-Charcodes.png|center|frame|250x250px|Click for a larger copy of this image - contains keys and their event numbers.]]
 +
 +
<!--
 
The scan codes are typical DirectX numbers.
 
The scan codes are typical DirectX numbers.
 
{|
 
{|
Line 316: Line 319:
 
|-
 
|-
 
| Numpad Enter
 
| Numpad Enter
| 156
+
| 28 <s>156</s> *
 
|-
 
|-
 
| Right Control
 
| Right Control
Line 362: Line 365:
 
| Delete
 
| Delete
 
| 211
 
| 211
 +
|-
 +
| Left Super
 +
| 219
 +
|-
 +
| Right Super
 +
| 220
 +
|-
 +
| Menu
 +
| 221
 
|-
 
|-
 
|}
 
|}
 
|}
 
|}
Source: [http://wiki.tesnexus.com/index.php/DirectX_Scancodes_And_How_To_Use_Them Nexus Wiki]
+
Source: [http://wiki.tesnexus.com/index.php/DirectX_Scancodes_And_How_To_Use_Them Nexus Wiki]<br />
 
+
<i>Note: Items marked with * are not the correct keycode, but return a matching keycode for another button (eg, enter keys).</i>-->
  
 
[[Category:Tutorials]]
 
[[Category:Tutorials]]

Latest revision as of 22:05, 21 December 2012

The built-in os has a function to read incoming keystrokes. But it also implements the functions to move the cursor while typing. This is not always a desired feature; imagine a case in which you want to make a menu with a controllable cursor around the menu entries. The current read() function won't let you.

Detecting keystrokes

In case I made you think the OS sucks, it doesn't (all the time). Because this OS is not Windows, we can access lower-level functions, such as os.pullEvent(). And that's the one that we're going to use:

function rawread()
    bRead = true
    while(bRead) do
        local sEvent, param = os.pullEvent("key")
        if(sEvent == "key") then
            break
        end
    end
end

This function waits for any key, then exits.

Figuring out the key

We can detect any key, but not which key. To find it out, we have to add some further logic to the code:

function rawread()
    while true do
        local sEvent, param = os.pullEvent("key")
        if sEvent == "key" then
            if param == 28 then
                print("Enter detected")
                break
            end
        end
    end
end

This function waits for the Enter key to be pressed. If so, it writes "Enter detected" to the screen and exits.

Key scan codes

Click for a larger copy of this image - contains keys and their event numbers.