aboutsummaryrefslogtreecommitdiff
path: root/doc/pddp/help-key.pd
diff options
context:
space:
mode:
Diffstat (limited to 'doc/pddp/help-key.pd')
-rw-r--r--doc/pddp/help-key.pd161
1 files changed, 0 insertions, 161 deletions
diff --git a/doc/pddp/help-key.pd b/doc/pddp/help-key.pd
deleted file mode 100644
index ff0ae4fb..00000000
--- a/doc/pddp/help-key.pd
+++ /dev/null
@@ -1,161 +0,0 @@
-#N canvas 274 90 707 580 12;
-#X obj 107 541 pddp;
-#X obj 8 8 cnv 15 90 553 empty empty empty 20 12 0 14 -233017 -66577
-0;
-#X text 104 74 This object does not accept arguments of any type.;
-#N canvas 85 22 597 608 More_Info 0;
-#X text 31 23 OBJECT OUTLETS;
-#N canvas 176 22 575 461 reacting_to_user_input 0;
-#X text 27 18 REACTING TO USER INPUT;
-#X text 41 49 Most \, if not all \, programming environments provide
-us with tools to capture 'user initiated' events from the operating
-system. Keyboard input \, mouse clicks \, and mouse movements are the
-most common events in this 'user event' category.;
-#X text 41 125 PD's [key] \, [keyup] \, and [keyname] are complimented
-by the externals such as [gemmouse] and [nimouse] to provide us with
-a full range of tools to gleen a user's activities at the computer.
-;
-#X text 42 201 It's interesting to note that \, with these tools \,
-PD can mimic some of the functions in other languages - Javascript
-for example has:;
-#X text 55 272 onKeyUp;
-#X text 55 253 onKeyDown;
-#X text 55 291 onKeyPress;
-#X text 42 322 hmmm...wouldn't it be great if PD also gave us onChange
-\, onBlur \, onFocus \, onClick \, onDblClick \, onDragDrop \, onLoad
-\, onMouseDown \, onMouseOver \, onMouseOut \, onMouseMove \, onUnload...?
-;
-#X restore 47 506 pd reacting_to_user_input;
-#X obj 37 61 key;
-#X obj 16 135 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X floatatom 37 118 5 0 0 0 - - -;
-#X obj 31 268 keyup;
-#X obj 18 323 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X floatatom 39 306 5 0 0 0 - - -;
-#X text 88 208 Also note that key combinations \, such as SHIFT+7 produce
-a different result than SHIFT or 7 alone.;
-#X text 88 323 The [key] and [keyup] objects can mimic the functionality
-of the [noteon] and [noteoff] objects. A key combination such as SHIFT+7
-could be considered a 'chord'!;
-#X text 89 54 The number at this outlet represents the numeric "ID"
-of a key on the computer's keyboard. This event occurs when the key
-is pressed down. Only one event is captured at a time.;
-#X text 88 267 The number at this outlets represents the numeric "ID"
-of a key on the computer's keyboard. This even occurs when the key
-is released. Only one event is captured at a time.;
-#X text 89 119 Some keys \, such as SHIFT or the F1-F12 series all
-produce a zero \, but we can see by the [bng] that the event is not
-ignored completely...but the numeric "ID" of the key is not captured
-successfully. (This may produce different results on different systems.)
-;
-#X obj 21 392 keyname;
-#X obj 21 449 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X obj 70 480 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X symbolatom 76 458 10 0 0 0 - - -;
-#X floatatom 18 421 5 0 0 0 - - -;
-#X text 90 388 This object captures both the "keydown" and "keyup"
-events. The left inlet produces a 1 when a key goes down \, and a zero
-when the key goes up. The right outlet produces a symbol which represents
-the name of the key.;
-#N canvas 174 22 571 511 some_keyboard_fun 0;
-#X obj 52 75 loadbang;
-#X msg 23 16 bang;
-#X obj 33 158 qlist;
-#X floatatom 33 185 5 0 0 0 - - -;
-#X obj 388 30 r keyboard_fun;
-#X msg 52 105 read keyboard_fun.txt;
-#X msg 45 51 rewind;
-#X obj 388 112 symbol add2;
-#X obj 388 83 t b s;
-#X obj 388 138 pack s s;
-#X obj 388 164 route list;
-#X msg 47 245 set;
-#X msg 47 278;
-#X obj 388 57 symbol;
-#X text 71 17 Click here to start...;
-#X msg 62 131 tempo 0.8;
-#X obj 47 217 loadbang;
-#X connect 0 0 5 0;
-#X connect 0 0 15 0;
-#X connect 1 0 2 0;
-#X connect 2 0 3 0;
-#X connect 4 0 13 0;
-#X connect 5 0 2 0;
-#X connect 6 0 2 0;
-#X connect 7 0 9 0;
-#X connect 8 0 7 0;
-#X connect 8 1 9 1;
-#X connect 9 0 10 0;
-#X connect 10 0 12 0;
-#X connect 11 0 12 0;
-#X connect 13 0 8 0;
-#X connect 15 0 2 0;
-#X connect 16 0 11 0;
-#X restore 47 532 pd some_keyboard_fun;
-#X connect 2 0 3 0;
-#X connect 2 0 4 0;
-#X connect 5 0 7 0;
-#X connect 5 0 6 0;
-#X connect 13 0 17 0;
-#X connect 13 1 16 0;
-#X connect 16 0 15 0;
-#X connect 17 0 14 0;
-#X restore 107 491 pd More_Info;
-#N canvas 85 22 397 246 Related_Objects 0;
-#X text 25 8 Native PD Objects;
-#X text 25 92 Externals and other object libraries;
-#X obj 61 129 gemkeyboard;
-#X obj 62 159 gemkeyname;
-#X restore 107 465 pd Related_Objects;
-#X text 35 53 INLETS:;
-#X text 6 75 ARGUMENTS:;
-#X text 26 94 OUTLETS:;
-#X text 17 170 EXAMPLES:;
-#X text 18 463 SEE ALSO:;
-#X obj 8 8 cnv 15 180 30 empty empty empty 20 12 0 14 -233017 -66577
-0;
-#X obj 28 14 key;
-#X obj 63 14 keyup;
-#X obj 114 14 keyname;
-#X text 195 15 - GRAB KEYBOARD;
-#X text 104 53 None;
-#X text 104 94 Please see the following sub-patch called "More_Info"
-for detailed information about the objects' outlets. The outlets of
-this 'object group' provide PD with information about keystrokes on
-your computer's keyboard.;
-#X obj 108 174 key;
-#X floatatom 108 201 3 0 0 0 - - -;
-#X floatatom 147 200 3 0 0 0 - - -;
-#X obj 147 174 keyup;
-#X floatatom 201 200 3 0 0 0 - - -;
-#X obj 201 174 keyname;
-#X symbolatom 252 199 10 0 0 0 - - -;
-#X text 109 248 To see this example in action \, simply type something
-on your keyboard.;
-#X obj 108 225 bng 15 50 10 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X obj 147 225 bng 15 50 10 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X obj 201 225 bng 15 50 10 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X text 110 291 [key] and [keyup] report the (system dependent) numbers
-of "printing" keys of the keyboard. [keyname] gives the symbolic name
-of the key \, with a 1 if it's up or 0 if it's down \, and works with
-non-printing keys like shift or "F1".;
-#X text 111 362 Caveat -- this only works if Pd actually gets the key
-events which can depend on the stacking order of windows and/or the
-pointer location. This is dependent on the system.;
-#X text 155 542 - Dave Sabine \, July 11 \, 2003;
-#X obj 281 514 pddp_open all_about_hid;
-#X text 105 515 for more on HIDs:;
-#X connect 17 0 18 0;
-#X connect 18 0 25 0;
-#X connect 19 0 26 0;
-#X connect 20 0 19 0;
-#X connect 21 0 27 0;
-#X connect 22 0 21 0;
-#X connect 22 1 23 0;