diff --git a/pd/doc/5.reference/bendin-help.pd b/pd/doc/5.reference/bendin-help.pd index 846a474440a22a9b12eda1d4137aa93284a51478..db15680bedc3e86f19d11195ca5cdc7c1a3620e0 100644 --- a/pd/doc/5.reference/bendin-help.pd +++ b/pd/doc/5.reference/bendin-help.pd @@ -1,10 +1,10 @@ -#N canvas 427 32 555 619 10; +#N canvas 508 58 560 619 10; #X obj 0 595 cnv 15 552 21 empty \$0-pddp.cnv.footer empty 20 12 0 -14 -228856 -66577 0; +14 #dcdcdc #404040 0; #X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header bendin 3 12 0 18 --204280 -1 0; -#X obj 0 395 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; +#c4dcdc #000000 0; +#X obj 0 365 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +#dcdcdc #000000 0; #N canvas 477 282 494 344 META 0; #X text 12 105 LIBRARY internal; #X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; @@ -21,16 +21,16 @@ to conform to the PDDP template for Pd version 0.42.; #X text 12 85 OUTLET_1 float; #X text 12 165 RELEASE_DATE 1997; #X restore 500 597 pd META; -#X obj 0 430 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 495 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; +#X obj 0 400 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 #dcdcdc #000000 0; +#X obj 0 465 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 #dcdcdc #000000 0; #X obj 0 560 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; -#X text 98 439 float; +0 13 #dcdcdc #000000 0; +#X text 98 409 float; #N canvas 213 167 428 456 Related_objects 0; #X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; +14 #c4dcdc #000000 0; #X text 7 1 [bendin] Related Objects; #X obj 75 89 ctlin; #X obj 25 116 pgmin; @@ -67,34 +67,58 @@ by Olaf Matthes); #X obj 186 365 chord; #X restore 101 597 pd Related_objects; #X obj 497 10 bendin; -#X text 98 405 (none); -#X obj 78 439 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 467 cnv 17 3 17 empty \$0-pddp.cnv.let.0 1 5 9 0 16 -228856 --162280 0; -#X text 98 467 float; -#X floatatom 148 171 5 0 0 0 - - -, f 5; -#X floatatom 191 171 5 0 0 0 - - -, f 5; -#X obj 148 144 bendin; -#X text 85 221 The [bendin] object reads incoming pitch bend values -and reports them. If started with no arguments it reports the channel -number through the right outlet.; -#X obj 260 144 bendin 2; -#X floatatom 260 171 5 0 0 0 - - -, f 5; -#X text 311 171 <-- pitch bend values on channel 2; +#X text 98 375 (none); +#X obj 78 409 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 #dcdcdc +#9c9c9c 0; +#X obj 78 437 cnv 17 3 17 empty \$0-pddp.cnv.let.0 1 5 9 0 16 #dcdcdc +#9c9c9c 0; +#X text 98 437 float; +#X floatatom 138 81 5 0 0 0 - - -, f 5; +#X floatatom 195 81 5 0 0 0 - - -, f 5; +#X obj 138 54 bendin; +#X obj 260 54 bendin 2; +#X floatatom 260 81 5 0 0 0 - - -, f 5; +#X text 311 81 <-- pitch bend values on channel 2; #X obj 99 564 pddp/pddplink all_about_midi_flags.pd -text all_about_midi_flags ; #X text 11 23 read incoming pitch bend values; -#X text 167 514 - (optional) a single MIDI channel number from which +#X text 167 484 - (optional) a single MIDI channel number from which to read. If the argument is present \, the [bendin] object does not show the second (right) outlet.; -#X text 168 405 - [bendin] reads directly from the MIDI port.; -#X text 168 439 - pitchbend value (a 14-bit integer).; -#X text 168 467 - MIDI channel number (available unless argument is +#X text 168 375 - [bendin] reads directly from the MIDI port.; +#X text 168 437 - MIDI channel number (available unless argument is given).; -#X text 80 514 1) float; +#X text 80 484 1) float; #X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide ; +#X floatatom 138 141 5 0 0 0 - - -, f 5; +#X floatatom 195 141 5 0 0 0 - - -, f 5; +#X floatatom 260 141 5 0 0 0 - - -, f 5; +#X obj 138 114 bendin 0 1; +#X obj 260 114 bendin 2 1; +#X text 80 531 2) float; +#X text 167 531 - (optional) flag. If nonzero \, [bendin] yields signed +output values (-8192 - 8191).; +#X text 168 409 - pitchbend value (signed range -8192 - 8191 by default). +; +#X text 37 120 unsigned values; +#X text 48 66 signed values; +#X text 7 135 (vanilla-compatible); +#X text 85 171 The [bendin] object reads incoming pitch bend values +and reports them. If invoked with no arguments (or a zero argument +meaning "omni") it reports the channel number through the right outlet. +; +#X text 85 233 CAVEAT: In pd-l2ork \, for consistency with bendout +\, bendin yields *signed* 14 bit values (-8192 - 8191) by default. +However \, for compatibility with vanilla pd \, you can also make bendin +use the *unsigned* 14 bit range (0 - 16384) by adding 1 (or any non-zero +value) as the second argument. This also becomes the default if the +-legacy-bendin option is specified on the command line. You can add +that option to the startup flags in the preferences if you need out-of-the-box +interoperability with vanilla Pd.; #X connect 16 0 14 0; #X connect 16 1 15 0; -#X connect 18 0 19 0; +#X connect 17 0 18 0; +#X connect 30 0 27 0; +#X connect 30 1 28 0; +#X connect 31 0 29 0; diff --git a/pd/doc/5.reference/bendout-help.pd b/pd/doc/5.reference/bendout-help.pd index 4960f50d19b8ff7394a8ca5a146509a70ccf1808..b4e58ea73a2affc130ba159b02b79fbe3502c9ad 100644 --- a/pd/doc/5.reference/bendout-help.pd +++ b/pd/doc/5.reference/bendout-help.pd @@ -1,10 +1,10 @@ -#N canvas 432 35 555 619 10; +#N canvas 432 38 556 623 10; #X obj 0 595 cnv 15 552 21 empty \$0-pddp.cnv.footer empty 20 12 0 -14 -228856 -66577 0; +14 #dcdcdc #404040 0; #X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header bendout 3 12 0 18 --204280 -1 0; +#c4dcdc #000000 0; #X obj 0 377 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; +#dcdcdc #000000 0; #N canvas 489 282 494 344 META 0; #X text 12 105 LIBRARY internal; #X text 12 145 WEBSITE http://crca.ucsd.edu/~msp/; @@ -22,15 +22,15 @@ to conform to the PDDP template for Pd version 0.42.; #X text 12 165 RELEASE_DATE 2009; #X restore 500 597 pd META; #X obj 0 458 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; +13 #dcdcdc #000000 0; #X obj 0 486 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; +0 13 #dcdcdc #000000 0; #X obj 0 561 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; +0 13 #dcdcdc #000000 0; #X text 98 387 float; #N canvas 204 206 441 421 Related_objects 0; #X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 -14 -204280 -1 0; +14 #c4dcdc #000000 0; #X text 8 2 [bendout] Related Objects; #X obj 73 80 ctlin; #X obj 216 80 pgmin; @@ -65,10 +65,10 @@ by Olaf Matthes); #X obj 22 390 pddp/helplink cyclone/midiflush; #X restore 101 598 pd Related_objects; #X text 98 462 (none); -#X obj 78 387 cnv 17 3 35 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 430 cnv 17 3 17 empty \$0-pddp.cnv.let.0 1 5 9 0 16 -228856 --162280 0; +#X obj 78 387 cnv 17 3 35 empty \$0-pddp.cnv.let.0 0 5 9 0 16 #dcdcdc +#9c9c9c 0; +#X obj 78 430 cnv 17 3 17 empty \$0-pddp.cnv.let.0 1 5 9 0 16 #dcdcdc +#9c9c9c 0; #X text 98 430 float; #X obj 99 565 pddp/pddplink all_about_midi_flags.pd -text all_about_midi_flags ; @@ -83,14 +83,14 @@ by Olaf Matthes); #X text 168 505 - (optional) the MIDI channel number to be written to. If no argument is given \, [bendout] defaults to channel 1 . The channel can be changed by sending an integer to the right inlet.; -#X text 168 387 - pitchbend value (0-127).; #X text 168 430 - MIDI channel number (defaults to channel 1).; -#X text 168 462 - [bendin] writes directly to the MIDI port.; #X text 80 505 1) float; #X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide ; #X text 98 407 list; #X text 168 407 - a list is distributed to the inlets.; +#X text 168 387 - pitchbend value (-8192 - 8191).; +#X text 168 462 - [bendout] writes directly to the MIDI port.; #X connect 15 0 17 0; #X connect 16 0 17 1; #X connect 18 0 20 0;