[PD-cvs] doc/pddp help-route.pd,1.2,1.3

Fri May 28 19:57:24 CEST 2004

Update of /cvsroot/pure-data/doc/pddp
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv9782

Modified Files:
	help-route.pd 
Log Message:
added a couple related objects

Index: help-route.pd
===================================================================
RCS file: /cvsroot/pure-data/doc/pddp/help-route.pd,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -d -r1.2 -r1.3
*** help-route.pd	3 Oct 2003 19:55:32 -0000	1.2
--- help-route.pd	28 May 2004 17:57:22 -0000	1.3
***************
*** 1,140 ****
! #N canvas 4 7 1003 641 10;
! #X obj 7 331 print x1;
! #X obj 59 331 print x2;
! #X obj 112 331 print x3;
! #X obj 164 331 print x4;
! #X obj 82 273 route 23 54 1;
! #X msg 290 217 54 43;
! #X msg 332 217 1 foo bar;
! #X obj 44 408 route big apple;
! #X msg 422 377 1 2 3;
! #X msg 332 364 big apple pie;
! #X msg 414 235 walk the dog;
! #X text 25 215 numeric arguments:;
! #X text 18 364 symbolic arguments:;
! #X msg 574 287 bang;
! #X msg 575 380 list;
! #X msg 547 208 5;
! #X msg 553 228 float 5;
! #X msg 575 402 list 5;
! #X msg 579 307 symbol pie;
! #X msg 586 327 pie;
! #X msg 561 248 1 2 3;
! #X obj 9 475 print y1;
! #X obj 69 475 print y2;
! #X obj 129 475 print y3;
! #X obj 26 13 route;
! #X text 67 13 - route messages according to their first element;
! #X text 25 108 If a match is found \, and the message contains only
! ONE element \, then a bang is sent out the corresponding outlet. If
! a match if found \, and the message contains multiple elements (a list)
! \, then all the list elements except the first element is sent out
! 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 138 217 23 345 456;
! #X msg 216 217 420 34 45;
! #X msg 138 364 apple pie;
! #X msg 202 364 impeach ringo starr;
! #X text 147 408 In this case \, the data type 'symbol' is implied by
! the creation arguments and therefore this [route] object will match
! symbols only. Symbolic messages that do not match any of the arguments
! \, and all numbers \, will be output through the right-most outlet.
! ;
! #X obj 526 5 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
! -1;
! #X obj 526 566 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
! -1;
! #X obj 704 468 print NO_Match;
! #X text 541 21 If necessary \, messages of different data types can
! be matched by the [route] object if the data type is explictly defined
! in the creation arguments.;
! #X text 540 71 In the example below \, instead of matching the 'value'
! of a message \, the [route] object will match 'data type': i.e. lists
! will be sent through the first outlet \, floats will be sent through
! the second outlet \, symbols through the third outlet \, bangs through
! the fourth outlet. The fifth outlet will then output anything that
! does not match one of the previously defined data types (i.e. the "pie"
! message below is a text message that hasn't been defined as a 'symbol'
! - hence \, PD cannot determine which data type it is and it will be
! output through the right-most outlet).;
! #X text 577 208 a float;
! #X text 605 228 definately a float!;
! #X text 602 247 a list (of floats);
! #X text 611 287 a bang;
! #X text 653 306 a symbol;
! #X text 620 328 none of the above!;
! #X obj 541 448 route float list bang symbol;
! #X obj 541 546 print floats;
! #X obj 581 527 print lists;
! #X obj 622 508 print bangs;
! #X obj 663 488 print symbols;
! #X msg 575 424 list pie;
! #X msg 568 268 list pie earth;
! #X text 660 267 a list of symbols;
! #X text 595 358 SPECIAL CASES OF LISTS.;
! #X text 629 423 A list with only one symbol is translated into a symbol.
! ;
! #X text 621 400 A list with only one float is translated into a float
! by PD.;
! #X text 612 379 An empty list is tranlated into a bang by PD.;
! #X text 19 508 RELATED OBJECTS;
! #X obj 23 529 select;
! #X obj 68 529 trigger;
! #X obj 120 529 moses;
! #X text 378 588 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 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)
! \, then sends the messages through the appropriate outlets.;
! #N canvas 0 0 454 304 related_objects_from_other_libraries 0;
! #X obj 26 33 segregate;
! #X obj 126 33 multiselect;
! #X text 18 86 These objects are offered in PD only if you have downloaded
! and properly installed the appropriate library. These objects may or
! may not exist in a single library.;
! #X text 17 135 The best places to find information about PD's libraries
! is:;
! #X text 14 157 www.pure-data.org and click on "Downloads" then "Software"
! ;
! #X text 15 173 or;
! #X text 16 187 iem.kug.ac.at/pdb/;
! #X restore 23 552 pd related_objects_from_other_libraries;
! #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 21 0;
! #X connect 7 1 22 0;
! #X connect 7 2 23 0;
! #X connect 8 0 7 0;
! #X connect 9 0 7 0;
! #X connect 10 0 4 0;
! #X connect 13 0 44 0;
! #X connect 14 0 44 0;
! #X connect 15 0 44 0;
! #X connect 16 0 44 0;
! #X connect 17 0 44 0;
! #X connect 18 0 44 0;
! #X connect 19 0 44 0;
! #X connect 20 0 44 0;
! #X connect 28 0 4 0;
! #X connect 29 0 4 0;
! #X connect 30 0 7 0;
! #X connect 31 0 7 0;
! #X connect 33 0 34 0;
! #X connect 44 0 45 0;
! #X connect 44 1 46 0;
! #X connect 44 2 47 0;
! #X connect 44 3 48 0;
! #X connect 44 4 35 0;
! #X connect 49 0 44 0;
! #X connect 50 0 44 0;
--- 1,142 ----
! #N canvas 128 127 1007 645 10;
! #X obj 7 331 print x1;
! #X obj 59 331 print x2;
! #X obj 112 331 print x3;
! #X obj 164 331 print x4;
! #X obj 82 273 route 23 54 1;
! #X msg 290 217 54 43;
! #X msg 332 217 1 foo bar;
! #X obj 44 408 route big apple;
! #X msg 422 377 1 2 3;
! #X msg 332 364 big apple pie;
! #X msg 414 235 walk the dog;
! #X text 25 215 numeric arguments:;
! #X text 18 364 symbolic arguments:;
! #X msg 574 287 bang;
! #X msg 575 380 list;
! #X msg 547 208 5;
! #X msg 553 228 float 5;
! #X msg 575 402 list 5;
! #X msg 579 307 symbol pie;
! #X msg 586 327 pie;
! #X msg 561 248 1 2 3;
! #X obj 9 475 print y1;
! #X obj 69 475 print y2;
! #X obj 129 475 print y3;
! #X obj 26 13 route;
! #X text 67 13 - route messages according to their first element;
! #X text 25 108 If a match is found \, and the message contains only
! ONE element \, then a bang is sent out the corresponding outlet. If
! a match if found \, and the message contains multiple elements (a list)
! \, then all the list elements except the first element is sent out
! 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 138 217 23 345 456;
! #X msg 216 217 420 34 45;
! #X msg 138 364 apple pie;
! #X msg 202 364 impeach ringo starr;
! #X text 147 408 In this case \, the data type 'symbol' is implied by
! the creation arguments and therefore this [route] object will match
! symbols only. Symbolic messages that do not match any of the arguments
! \, and all numbers \, will be output through the right-most outlet.
! ;
! #X obj 526 5 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
! -1;
! #X obj 526 566 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
! -1;
! #X obj 704 468 print NO_Match;
! #X text 541 21 If necessary \, messages of different data types can
! be matched by the [route] object if the data type is explictly defined
! in the creation arguments.;
! #X text 540 71 In the example below \, instead of matching the 'value'
! of a message \, the [route] object will match 'data type': i.e. lists
! will be sent through the first outlet \, floats will be sent through
! the second outlet \, symbols through the third outlet \, bangs through
! the fourth outlet. The fifth outlet will then output anything that
! does not match one of the previously defined data types (i.e. the "pie"
! message below is a text message that hasn't been defined as a 'symbol'
! - hence \, PD cannot determine which data type it is and it will be
! output through the right-most outlet).;
! #X text 577 208 a float;
! #X text 605 228 definately a float!;
! #X text 602 247 a list (of floats);
! #X text 611 287 a bang;
! #X text 653 306 a symbol;
! #X text 620 328 none of the above!;
! #X obj 541 448 route float list bang symbol;
! #X obj 541 546 print floats;
! #X obj 581 527 print lists;
! #X obj 622 508 print bangs;
! #X obj 663 488 print symbols;
! #X msg 575 424 list pie;
! #X msg 568 268 list pie earth;
! #X text 660 267 a list of symbols;
! #X text 595 358 SPECIAL CASES OF LISTS.;
! #X text 629 423 A list with only one symbol is translated into a symbol.
! ;
! #X text 621 400 A list with only one float is translated into a float
! by PD.;
! #X text 612 379 An empty list is tranlated into a bang by PD.;
! #X text 19 508 RELATED OBJECTS;
! #X obj 23 529 select;
! #X obj 68 529 trigger;
! #X obj 120 529 moses;
! #X text 378 588 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 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)
! \, then sends the messages through the appropriate outlets.;
! #N canvas 0 22 458 308 related_objects_from_other_libraries 0;
! #X obj 26 33 segregate;
! #X obj 104 34 multiselect;
! #X text 18 86 These objects are offered in PD only if you have downloaded
! and properly installed the appropriate library. These objects may or
! may not exist in a single library.;
! #X text 17 135 The best places to find information about PD's libraries
! is:;
! #X text 14 157 www.pure-data.org and click on "Downloads" then "Software"
! ;
! #X text 15 173 or;
! #X text 16 187 iem.kug.ac.at/pdb/;
! #X obj 193 34 demux;
! #X obj 245 34 gate;
! #X restore 23 552 pd related_objects_from_other_libraries;
! #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 21 0;
! #X connect 7 1 22 0;
! #X connect 7 2 23 0;
! #X connect 8 0 7 0;
! #X connect 9 0 7 0;
! #X connect 10 0 4 0;
! #X connect 13 0 44 0;
! #X connect 14 0 44 0;
! #X connect 15 0 44 0;
! #X connect 16 0 44 0;
! #X connect 17 0 44 0;
! #X connect 18 0 44 0;
! #X connect 19 0 44 0;
! #X connect 20 0 44 0;
! #X connect 28 0 4 0;
! #X connect 29 0 4 0;
! #X connect 30 0 7 0;
! #X connect 31 0 7 0;
! #X connect 33 0 34 0;
! #X connect 44 0 45 0;
! #X connect 44 1 46 0;
! #X connect 44 2 47 0;
! #X connect 44 3 48 0;
! #X connect 44 4 35 0;
! #X connect 49 0 44 0;
! #X connect 50 0 44 0;