If scene.kb.keys is nonzero,
one or more keyboard events have been stored, waiting to be processed.
Executing key =
scene.kb.getkey() obtains a keyboard input
and removes it from the input queue. If there are no events waiting to be
processed, getkey() waits until a key is pressed.
If len(key) == 1, the input is a single printable character
such as 'b' or 'B' or new line ('\n') or tab ('\t'). Otherwise key is a multicharacter
string such as 'escape' or 'backspace' or 'f3'. For such inputs, the ctrl,
alt, and shift keys are prepended to the key name. For example, if you hold
down the shift key and press F3, key will be the character string 'shift+f3',
which you can test for explicitly. If you hold down all three modifier keys,
you get 'ctrl+alt+shift+f3'; the order is always ctrl, alt, shift.
Here is a test routine that let's you type text into a label:
prose = label() # initially blank text
while 1:
if scene.kb.keys: # is there an event
waiting to be processed?
s
= scene.kb.getkey() # obtain keyboard information
if
len(s) == 1:
prose.text
+= s # append new character
elif
(s == 'backspace' or s == 'delete') and len(prose.text) > 0:
prose.text
= prose.text[:-1] # erase one letter
elif
s == 'shift+delete':
prose.text
= '' # erase all the text
Note that mouse events also provide
information about the ctrl, alt, and shift keys, which may be used to modify
mouse actions.
You can also input a line of text from the keyboard by highlighting
the output window (where print statements are displayed), using the standard
Python function raw_input(). The statement text
= raw_input() accepts a line of typing ending with Enter and sets text
to the input, not including the end-of-line. The statement text
= raw_input('Type something: ') prompts for the input before you type.
