From 819bc4309313e32809dff7cfd99df930c5055082 Mon Sep 17 00:00:00 2001 From: Hans-Christoph Steiner Date: Thu, 28 Jul 2005 19:45:58 +0000 Subject: added in documentation of Pd oddities that I generated in response to the thread on pd-dev about Miller's new [list] object svn path=/trunk/; revision=3383 --- doc/pddp/route-help.pd | 254 ++++++++++++++++++++++++++++++++++++------------- 1 file changed, 188 insertions(+), 66 deletions(-) (limited to 'doc/pddp/route-help.pd') diff --git a/doc/pddp/route-help.pd b/doc/pddp/route-help.pd index bb87e568..b4dcca5f 100644 --- a/doc/pddp/route-help.pd +++ b/doc/pddp/route-help.pd @@ -1,13 +1,9 @@ -#N canvas 103 43 1019 657 10; -#X obj 7 331 print x1; -#X obj 69 331 print x2; -#X obj 131 331 print x3; -#X obj 194 331 print x4; +#N canvas 190 100 1023 661 10; #X obj 82 273 route 23 54 1; #X msg 170 239 54 43; #X msg 212 239 1 foo bar; #X obj 141 418 route big apple; -#X msg 351 386 1 2 3; +#X msg 351 376 1 2 3; #X msg 248 376 big apple pie; #X msg 320 238 walk the dog; #X text 8 217 numeric arguments:; @@ -27,10 +23,6 @@ a match if found \, and the message contains multiple elements (a list) the corresponding outlet. If no match is found \, then the entire message is sent out the right-most outlet - the "rejection" outlet. The number of outlets is the number of arguments plus one.; -#X text 176 265 In this case \, the creation arguments are all numbers -and [route] will therefore assume that it should attempt to match messages -that are data type 'number'. All messages that are not numbers will -be output through the right-most outlet.; #X msg 18 239 23 345 456; #X msg 96 239 420 34 45; #X msg 32 376 apple pie; @@ -59,13 +51,10 @@ output through the right-most outlet).; #X text 630 328 none of the above!; #X text 702 268 a list of symbols; #X text 599 349 SPECIAL CASES OF LISTS.; -#X text 18 563 RELATED OBJECTS; -#X obj 22 584 select; -#X obj 67 584 trigger; -#X obj 119 584 moses; -#X text 588 603 This document was updated for Pd version 0.35 test -26 by Dave Sabine as part of a project called pddp proposed by Krzysztof -Czaja to build comprehensive documentation for Pd.; +#X text 17 583 RELATED OBJECTS; +#X obj 21 604 select; +#X obj 68 604 trigger; +#X obj 122 604 moses; #X text 26 36 Route checks the first element of a message against each of its creation arguments \, which may be numbers or symbols (but not a mixture of the two unless the data types are defined explicitly) @@ -84,7 +73,7 @@ is:; #X text 16 187 iem.kug.ac.at/pdb/; #X obj 193 34 demux; #X obj 245 34 gate; -#X restore 22 607 pd related_objects_from_other_libraries; +#X restore 21 627 pd related_objects_from_other_libraries; #X floatatom 625 498 5 0 0 0 - - -; #X symbolatom 673 497 10 0 0 0 - - -; #X obj 578 518 bng 15 250 50 0 empty empty bang -6 23 1 12 -262144 @@ -114,54 +103,187 @@ is:; -1 -1; #X obj 237 439 bng 15 250 50 0 empty empty everything_else -2 23 1 12 -262144 -1 -1; -#X obj 286 326 bng 15 250 50 0 empty empty bang -6 23 1 12 -262144 --1 -1; -#X obj 333 326 bng 15 250 50 0 empty empty float -4 23 1 12 -262144 --1 -1; -#X obj 381 326 bng 15 250 50 0 empty empty symbol -12 23 1 12 -262144 --1 -1; -#X obj 429 326 bng 15 250 50 0 empty empty everything_else -2 23 1 -12 -262144 -1 -1; #X obj 129 469 print x1; #X obj 189 469 print x2; #X obj 249 469 print x3; -#X text 526 557 [trigger]-style shortcuts don't work:; -#X obj 538 577 route a b f l p s; -#X text 667 576 !=; -#X obj 689 577 route anything bang float list pointer symbol; -#X connect 4 0 0 0; -#X connect 4 1 1 0; -#X connect 4 2 2 0; -#X connect 4 3 3 0; -#X connect 5 0 4 0; -#X connect 6 0 4 0; -#X connect 7 0 60 0; -#X connect 7 0 67 0; -#X connect 7 1 61 0; -#X connect 7 1 68 0; -#X connect 7 2 62 0; -#X connect 7 2 69 0; -#X connect 8 0 7 0; -#X connect 9 0 7 0; -#X connect 10 0 4 0; -#X connect 13 0 50 0; -#X connect 14 0 50 0; -#X connect 15 0 50 0; -#X connect 16 0 50 0; -#X connect 17 0 50 0; -#X connect 18 0 50 0; -#X connect 23 0 4 0; -#X connect 24 0 4 0; -#X connect 25 0 7 0; -#X connect 26 0 7 0; -#X connect 44 0 51 0; -#X connect 45 0 52 0; -#X connect 47 0 50 0; -#X connect 48 0 50 0; -#X connect 49 0 50 0; -#X connect 50 0 46 0; -#X connect 50 1 44 0; -#X connect 50 2 45 0; -#X connect 50 3 53 0; -#X connect 50 4 54 0; -#X connect 55 0 50 0; +#X text 565 555 [trigger]-style shortcuts don't work:; +#X text 678 574 !=; +#X obj 579 575 route b f s l; +#X obj 700 575 route bang float symbol list; +#X obj 7 331 print x23; +#X obj 75 331 print x54; +#X obj 143 331 print x1; +#X obj 204 331 print other; +#X obj 82 293 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 109 293 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 137 293 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 161 293 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X text 176 265 In this case \, the creation arguments are all numbers +and [route] will therefore assume that it should attempt to match messages +that are data type "float". All messages that are not numbers will +be output through the right-most outlet.; +#N canvas 0 22 466 633 routing_data_types 0; +#X obj 334 314 route symbol; +#X obj 336 334 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 413 335 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 331 361 route symbol; +#X obj 333 381 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 410 382 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X msg 318 269 test; +#X msg 357 269 symbol test; +#X obj 58 331 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 135 331 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 55 378 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 132 378 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X msg 89 266 bang; +#X obj 56 311 route bang; +#X obj 53 358 route bang; +#X text 14 5 routing based on reserved words:; +#X obj 188 331 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 265 331 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 185 378 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 262 378 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 186 311 route float; +#X obj 183 358 route float; +#X msg 170 266 1; +#X msg 209 266 float 12; +#X obj 181 542 route list; +#X obj 181 561 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 249 562 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 168 580 route list; +#X obj 168 599 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 236 600 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X msg 184 493 list 1 two 3; +#X msg 167 473 1 two 3; +#X msg 200 513 list one 2 three; +#X msg 365 289 symbol; +#X msg 113 484 list; +#X msg 224 287 float test; +#X text 26 245 These all output the as same atom type that is routed: +; +#X msg 15 266 bang test; +#X obj 71 131 route 1; +#X msg 71 183 2 3 4; +#X obj 71 164 prepend set; +#X msg 71 100 1 2 3 4; +#X msg 218 183 is not a list; +#X obj 218 164 prepend set; +#X obj 218 131 route this; +#X msg 218 100 this is not a list; +#X text 21 50 [route] has three modes \, first is float \, second is +symbol \, and third is data type. In the first two modes \, the first +element of the set is stripped off by [route].; +#X text 26 206 In the third mode \, [route] outputs the same atom type +(bang->bang \, float->float \, symbol->symbol).; +#X text 26 419 Lists do not behave the same with [route list] even +though it is interpreting incoming lists \, not just routing by keyword +\, as in the second symbol mode.; +#X msg 174 164 set; +#X text 157 164 re; +#X text 164 24 "bang" \, "float" \, "symbol" \, and "list"; +#X connect 0 0 1 0; +#X connect 0 0 3 0; +#X connect 0 1 2 0; +#X connect 3 0 4 0; +#X connect 3 1 5 0; +#X connect 6 0 0 0; +#X connect 7 0 0 0; +#X connect 12 0 13 0; +#X connect 13 0 8 0; +#X connect 13 0 14 0; +#X connect 13 1 9 0; +#X connect 14 0 10 0; +#X connect 14 1 11 0; +#X connect 20 0 16 0; +#X connect 20 0 21 0; +#X connect 20 1 17 0; +#X connect 21 0 18 0; +#X connect 21 1 19 0; +#X connect 22 0 20 0; +#X connect 23 0 20 0; +#X connect 24 0 25 0; +#X connect 24 0 27 0; +#X connect 24 1 26 0; +#X connect 27 0 28 0; +#X connect 27 1 29 0; +#X connect 30 0 24 0; +#X connect 31 0 24 0; +#X connect 32 0 24 0; +#X connect 33 0 0 0; +#X connect 34 0 24 0; +#X connect 35 0 20 0; +#X connect 37 0 13 0; +#X connect 38 0 40 0; +#X connect 40 0 39 0; +#X connect 41 0 38 0; +#X connect 43 0 42 0; +#X connect 44 0 43 0; +#X connect 45 0 44 0; +#X connect 49 0 42 0; +#X connect 49 0 39 0; +#X restore 838 496 pd routing_data_types; +#X text 580 601 This document was updated for Pd version 0.38.4 by +Dave Sabine and Hans-Christoph Steiner as part of a project called +pddp proposed by Krzysztof Czaja to build comprehensive documentation +for Pd.; +#X text 832 475 More info:; +#X connect 0 0 64 0; +#X connect 0 0 68 0; +#X connect 0 1 65 0; +#X connect 0 1 69 0; +#X connect 0 2 66 0; +#X connect 0 2 70 0; +#X connect 0 3 67 0; +#X connect 0 3 71 0; +#X connect 1 0 0 0; +#X connect 2 0 0 0; +#X connect 3 0 54 0; +#X connect 3 0 57 0; +#X connect 3 1 55 0; +#X connect 3 1 58 0; +#X connect 3 2 56 0; +#X connect 3 2 59 0; +#X connect 4 0 3 0; +#X connect 5 0 3 0; +#X connect 6 0 0 0; +#X connect 9 0 44 0; +#X connect 10 0 44 0; +#X connect 11 0 44 0; +#X connect 12 0 44 0; +#X connect 13 0 44 0; +#X connect 14 0 44 0; +#X connect 18 0 0 0; +#X connect 19 0 0 0; +#X connect 20 0 3 0; +#X connect 21 0 3 0; +#X connect 38 0 45 0; +#X connect 39 0 46 0; +#X connect 41 0 44 0; +#X connect 42 0 44 0; +#X connect 43 0 44 0; +#X connect 44 0 40 0; +#X connect 44 1 38 0; +#X connect 44 2 39 0; +#X connect 44 3 47 0; +#X connect 44 4 48 0; +#X connect 49 0 44 0; -- cgit v1.2.1