1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
|
class:: KeyState
summary:: Respond to the state of a key
related:: Classes/MouseButton, Classes/MouseX, Classes/MouseY
categories:: UGens>User interaction
Description::
Respond to the state of a key.
note::
Note that this UGen does not prevent normal typing. It therefore may be
helpful to select a GUI window rather than an SC document when using
KeyState, as the latter will be altered by any keystrokes.
::
classmethods::
method::kr
argument::keycode
The keycode value of the key to check. This corresponds to the
keycode values passed into the keyDownActions of SCViews. See the
example below.
argument::minval
The value to output when the key is not pressed.
argument::maxval
The value to output when the key is pressed.
argument::lag
A lag factor.
instancemethods::
private:: signalRange
Examples::
code::
s.boot;
// execute the code below to find out a key's keycode
// the char and keycode of any key you press will be printed in the post window
(
w = Window.new("I catch keystrokes");
w.view.keyDownAction = { arg view, char, modifiers, unicode, keycode; [char, keycode].postln; };
w.front;
)
// then execute this and then press the 'j' key
(
w.front; // something safe to type on
{ SinOsc.ar(800, 0, KeyState.kr(38, 0, 0.1)) }.play;
)
::
|
