[PD-cvs] doc/pddp help-trigger.pd,1.1,1.2

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

Modified Files: help-trigger.pd Log Message: cleaned up patch for MacOSX

Index: help-trigger.pd =================================================================== RCS file: /cvsroot/pure-data/doc/pddp/help-trigger.pd,v retrieving revision 1.1 retrieving revision 1.2 diff -C2 -d -r1.1 -r1.2 *** help-trigger.pd 22 Aug 2003 00:20:54 -0000 1.1 --- help-trigger.pd 19 Apr 2004 21:52:29 -0000 1.2 *************** *** 1,225 **** ! #N canvas 20 8 893 651 10; ! #X obj 26 16 trigger; ! #X text 26 45 The trigger object outputs its input from right to left ! , converting to the types indicated by its creation arguments. There ! is also a "pointer" argument type (see the pointer object.); ! #X text 24 230 As I see it , the [trigger] object serves two great ! purposes which aren't really related - but they might be on some level ! that I don't fully understand yet.; ! #X text 97 15 - sequence messages in right-to-left order and convert ! data types.; ! #X text 22 278 1 Sequence a series of bangs - or triggers for symbols ! and/or other messages. In the example below , you should see that ! it is important that it is important that [metro] gets a tempo setting ! before it is started - but let's assume for a moment that you wanted ! to start the [metro] with only a single click.; ! #X obj 26 481 metro; ! #X msg 51 462 1000; ! #X obj 26 501 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 ! -1; ! #X obj 26 404 tgl 15 0 empty empty On/Off 0 -6 0 7 -262144 -1 -1 0 ! 1; ! #X text 20 364 Click the toggle to set the tempo and start the metro ! simoultaneously.; ! #X text 24 109 The [trigger] object can be abbreviated as "t" and the ! creation arguments can be abbreviated as follows:; ! #X text 25 135 Floats = f; ! #X text 25 147 Bangs = b; ! #X text 24 159 Symbols = s; ! #X text 25 173 Lists = l; ! #X text 25 201 Anythings = a; ! #X text 25 187 Pointers = p; ! #X obj 103 150 trigger float bang symbol list pointer anything; ! #X text 204 169 is the same as; ! #X obj 207 189 t f b s l p a; ! #X text 65 413 Triggers are sent from right to left...so our tempo ! messages gets sent to [metro] immediately before the numbers from the ! [toggle] to start and stop the [metro].; ! #X obj 26 422 t f b; ! #X text 27 526 This example is simple , and may not be very practicle ! in most situations , but it clearly shows how [trigger] can be used ! to create a simple sequence of events. It is important to note however ! that the messages sent from [trigger]'s outlets occur in ZERO time ! with no delay between the events...more at the top right of the page... ! ; ! #X obj 430 94 t b b; ! #X msg 430 75 bang; ! #X obj 430 124 timer; ! #X floatatom 430 144 5 0 0; ! #X obj 399 34 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 ! -1; ! #X obj 399 600 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 ! -1; ! #X text 428 40 Below is a simple structure which will measure the "logical ! time" between bangs from the [trigger] object.; ! #X text 464 75 Click here.; ! #X text 470 141 Watch here.; ! #X text 417 163 Now , to prove that I'm not crazy...click here >; ! #X msg 705 162 bang; ! #X obj 705 203 timer; ! #X floatatom 705 222 5 0 0; ! #X obj 730 182 delay 2000; ! #X text 543 89 any delay between the first bang and the second bang ! ; ! #X text 544 105 from the trigger.; ! #X text 415 179 In this case , I've simply patched a delay; ! #X text 414 193 object to force a 2 second delay between the; ! #X text 414 207 first and second bangs sent to the [timer].; ! #X text 545 75 In this case , the [timer] object does not perceive ! ; ! #X text 417 290 2 Click this subpatch to read about [trigger]'s second ! great purpose...; ! #N canvas 148 20 927 612 trigger_can_convert_data_types 0; ! #X msg 425 103 2.5; ! #X msg 523 103 bang; ! #X msg 465 103 23 64; ! #X msg 569 103 symbol dog; ! #X obj 425 228 trigger float bang symbol list anything; ! #X text 24 24 All sophisticated programming environments provide tools ! to convert data types. For instance , Visual Basic has:; ! #X text 24 55 - VarType: to check the data type.; ! #X text 24 70 - CStr: to convert a variable to a string.; ! #X text 23 84 - CDate: to convert a variable to a date.; ! #X text 24 99 - isNumeric: to test whether the variable is a number. ! ; ! #X text 22 113 - etc.; ! #X text 19 137 [trigger] is one object in PD which can convert an incoming ! atom to a different type of atom.; ! #X text 422 30 In the example below , you can see that this [trigger] ! has creation arguments which specify what data type the object should ! output through each outlet. Messages which are sent to the first outlet ! will be floats ; the second outlet will send bangs ; the third , ! symbols ; etc.; ! #X text 19 172 To prove this , click on each of the messages below ! and watch your terminal window for the output.; ! #X obj 20 239 t b; ! #X msg 20 210 bang; ! #X msg 57 210 1; ! #X floatatom 90 212 5 0 0; ! #X msg 132 211 symbol cat; ! #X msg 204 211 this is anything; ! #X obj 20 259 print all_messages_are_converted_to_bangs; ! #X text 20 292 Another example showing floats and symbols.; ! #X msg 20 308 bang; ! #X floatatom 90 310 5 0 0; ! #X msg 132 309 symbol cat; ! #X msg 206 319 this is anything; ! #X obj 20 337 t f s; ! #X msg 57 308 1 0; ! #X obj 45 387 print converted_to_symbols; ! #X obj 20 407 print converted_to_floats; ! #X text 62 338 Note that "this is anything" causes an error. That is ! because 'anythings' don't conform to floats , symbols , lists , ! pointers. They can only be converted to "bang".; ! #X text 18 430 In the example above , note that the trigger object ! does not split a list among the outlets like [unpack] does. Instead ! it sends all list elements through all outlets and converts them as ! necessary.; ! #X text 20 486 Also note that some messages don't convert as nicely ! as others. Hence , the symbol "cat" converts to a ZERO when [trigger] ! converts that symbol into a float. Likewise , all numbers will convert ! to a symbol called "float" when sent through [trigger]'s right-most ! outlet.; ! #X floatatom 425 248 5 0 0; ! #X obj 482 248 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 ! -1; ! #X symbolatom 539 286 10 0 0; ! #X floatatom 594 162 5 0 0; ! #X obj 594 200 pack f s; ! #X msg 637 161 symbol earth; ! #X msg 652 181 symbol jupiter; ! #X obj 596 267 print a_list; ! #X floatatom 426 403 5 0 0; ! #X symbolatom 470 403 10 0 0; ! #X obj 514 421 print another_list; ! #X text 630 131 Click on all these.; ! #X obj 426 363 r anythings; ! #X text 425 303 Note how each of the messages sent to this trigger ! are converted appropriately for their receiving atoms boxes. Also note ! that "anythings" are sent to the example below.; ! #X text 430 447 I'e used the [route] object to show how "anythings" ! are converted as they pass through the above [trigger]. Note that all ! messages converted to floats are displayed here in the number box , ! all symbols are displayed in the symbol box , and all lists are printed ! to the terminal window.; ! #X obj 654 247 s anythings; ! #X obj 426 383 route float symbol list; ! #X msg 642 103 symbol cat; ! #X connect 0 0 4 0; ! #X connect 1 0 4 0; ! #X connect 2 0 4 0; ! #X connect 3 0 4 0; ! #X connect 4 0 33 0; ! #X connect 4 1 34 0; ! #X connect 4 2 35 0; ! #X connect 4 3 40 0; ! #X connect 4 4 48 0; ! #X connect 14 0 20 0; ! #X connect 15 0 14 0; ! #X connect 16 0 14 0; ! #X connect 17 0 14 0; ! #X connect 18 0 14 0; ! #X connect 19 0 14 0; ! #X connect 22 0 26 0; ! #X connect 23 0 26 0; ! #X connect 24 0 26 0; ! #X connect 25 0 26 0; ! #X connect 26 0 29 0; ! #X connect 26 1 28 0; ! #X connect 27 0 26 0; ! #X connect 36 0 37 0; ! #X connect 37 0 4 0; ! #X connect 38 0 37 1; ! #X connect 39 0 37 1; ! #X connect 45 0 49 0; ! #X connect 49 0 41 0; ! #X connect 49 1 42 0; ! #X connect 49 2 43 0; ! #X connect 50 0 4 0; ! #X restore 421 325 pd trigger_can_convert_data_types; ! #X obj 705 238 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 ! -1; ! #X floatatom 785 164 5 0 0; ! #X text 415 227 You can reset the delay with the number box; ! #X text 415 241 at the top-right to clearly see "logical time"; ! #X text 415 254 as measured by [timer].; ! #X text 459 579 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 418 378 RELATED OBJECTS; ! #X obj 503 404 route; ! #X obj 423 404 unpack; ! #X obj 469 404 pack; ! #X obj 544 404 delay; ! #X obj 586 404 pipe; ! #X obj 621 404 float; ! #X obj 661 404 int; ! #X obj 690 404 symbol; ! #N canvas 0 0 456 306 related_objects_from_other_libraries 0; ! #X obj 31 36 exciter; ! #X text 26 77 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 25 126 The best places to find information about PD's libraries ! is:; ! #X text 22 148 www.pure-data.org and click on "Downloads" then "Software" ! ; ! #X text 24 163 or; ! #X text 24 178 iem.kug.ac.at/pdb/; ! #X restore 423 435 pd related_objects_from_other_libraries; ! #X connect 5 0 7 0; ! #X connect 6 0 5 1; ! #X connect 8 0 21 0; ! #X connect 21 0 5 0; ! #X connect 21 1 6 0; ! #X connect 23 0 25 1; ! #X connect 23 1 25 0; ! #X connect 24 0 23 0; ! #X connect 25 0 26 0; ! #X connect 27 0 28 0; ! #X connect 33 0 34 0; ! #X connect 33 0 36 0; ! #X connect 34 0 35 0; ! #X connect 35 0 45 0; ! #X connect 36 0 34 1; ! #X connect 46 0 36 1; --- 1,232 ---- ! #N canvas 145 60 985 628 10; ! #X obj 26 16 trigger; ! #X text 24 230 As I see it , the [trigger] object serves two great ! purposes which aren't really related - but they might be on some level ! that I don't fully understand yet.; ! #X text 22 278 1 Sequence a series of bangs - or triggers for symbols ! and/or other messages. In the example below , you should see that ! it is important that it is important that [metro] gets a tempo setting ! before it is started - but let's assume for a moment that you wanted ! to start the [metro] with only a single click.; ! #X obj 26 481 metro; ! #X msg 51 462 1000; ! #X obj 26 501 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 ! -1; ! #X obj 26 404 tgl 15 0 empty empty On/Off 0 -6 0 7 -262144 -1 -1 0 ! 1; ! #X text 24 104 The [trigger] object can be abbreviated as "t" and the ! creation arguments can be abbreviated as follows:; ! #X obj 114 150 trigger float bang symbol list pointer anything; ! #X text 215 169 is the same as; ! #X obj 218 189 t f b s l p a; ! #X obj 26 422 t f b; ! #X text 27 526 This example is simple , and may not be very practicle ! in most situations , but it clearly shows how [trigger] can be used ! to create a simple sequence of events. It is important to note however ! that the messages sent from [trigger]'s outlets occur in ZERO time ! with no delay between the events...more at the top right of the page... ! ; ! #X obj 484 94 t b b; ! #X msg 484 75 bang; ! #X obj 484 124 timer; ! #X floatatom 484 144 5 0 0 0 - - -; ! #X obj 456 34 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 ! -1; ! #X obj 456 600 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 ! -1; ! #X text 518 75 Click here.; ! #X text 524 141 Watch here.; ! #X text 476 163 Now , to prove that I'm not crazy...click here >; ! #X obj 822 203 timer; ! #X floatatom 822 222 5 0 0 0 - - -; ! #X obj 847 182 delay 2000; ! #X text 597 89 any delay between the first bang and the second bang ! ; ! #X text 598 105 from the trigger.; ! #X text 476 198 object to force a 2 second delay between the; ! #X text 599 75 In this case , the [timer] object does not perceive ! ; ! #X text 471 290 2 Click this subpatch to read about [trigger]'s second ! great purpose...; ! #N canvas 148 22 927 612 trigger_can_convert_data_types 0; ! #X msg 425 103 2.5; ! #X msg 523 103 bang; ! #X msg 465 103 23 64; ! #X msg 569 103 symbol dog; ! #X obj 425 228 trigger float bang symbol list anything; ! #X text 24 24 All sophisticated programming environments provide tools ! to convert data types. For instance , Visual Basic has:; ! #X text 24 55 - VarType: to check the data type.; ! #X text 24 70 - CStr: to convert a variable to a string.; ! #X text 23 84 - CDate: to convert a variable to a date.; ! #X text 24 99 - isNumeric: to test whether the variable is a number. ! ; ! #X text 22 113 - etc.; ! #X text 19 137 [trigger] is one object in PD which can convert an incoming ! atom to a different type of atom.; ! #X text 422 30 In the example below , you can see that this [trigger] ! has creation arguments which specify what data type the object should ! output through each outlet. Messages which are sent to the first outlet ! will be floats ; the second outlet will send bangs ; the third , ! symbols ; etc.; ! #X text 19 172 To prove this , click on each of the messages below ! and watch your terminal window for the output.; ! #X obj 20 239 t b; ! #X msg 20 210 bang; ! #X msg 57 210 1; ! #X floatatom 90 212 5 0 0 0 - - -; ! #X msg 132 211 symbol cat; ! #X msg 204 211 this is anything; ! #X obj 20 259 print all_messages_are_converted_to_bangs; ! #X text 20 292 Another example showing floats and symbols.; ! #X msg 20 308 bang; ! #X floatatom 90 310 5 0 0 0 - - -; ! #X msg 132 309 symbol cat; ! #X msg 206 319 this is anything; ! #X obj 20 337 t f s; ! #X msg 57 308 1 0; ! #X obj 45 387 print converted_to_symbols; ! #X obj 20 407 print converted_to_floats; ! #X text 62 338 Note that "this is anything" causes an error. That is ! because 'anythings' don't conform to floats , symbols , lists , ! pointers. They can only be converted to "bang".; ! #X text 18 430 In the example above , note that the trigger object ! does not split a list among the outlets like [unpack] does. Instead ! it sends all list elements through all outlets and converts them as ! necessary.; ! #X text 20 486 Also note that some messages don't convert as nicely ! as others. Hence , the symbol "cat" converts to a ZERO when [trigger] ! converts that symbol into a float. Likewise , all numbers will convert ! to a symbol called "float" when sent through [trigger]'s right-most ! outlet.; ! #X floatatom 425 248 5 0 0 0 - - -; ! #X obj 482 248 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 ! -1; ! #X symbolatom 539 286 10 0 0 0 - - -; ! #X floatatom 594 162 5 0 0 0 - - -; ! #X obj 594 200 pack f s; ! #X msg 637 161 symbol earth; ! #X msg 652 181 symbol jupiter; ! #X obj 596 267 print a_list; ! #X floatatom 426 403 5 0 0 0 - - -; ! #X symbolatom 470 403 10 0 0 0 - - -; ! #X obj 514 421 print another_list; ! #X text 630 131 Click on all these.; ! #X obj 426 363 r anythings; ! #X text 425 303 Note how each of the messages sent to this trigger ! are converted appropriately for their receiving atoms boxes. Also note ! that "anythings" are sent to the example below.; ! #X text 430 447 I'e used the [route] object to show how "anythings" ! are converted as they pass through the above [trigger]. Note that all ! messages converted to floats are displayed here in the number box , ! all symbols are displayed in the symbol box , and all lists are printed ! to the terminal window.; ! #X obj 654 247 s anythings; ! #X obj 426 383 route float symbol list; ! #X msg 642 103 symbol cat; ! #X connect 0 0 4 0; ! #X connect 1 0 4 0; ! #X connect 2 0 4 0; ! #X connect 3 0 4 0; ! #X connect 4 0 33 0; ! #X connect 4 1 34 0; ! #X connect 4 2 35 0; ! #X connect 4 3 40 0; ! #X connect 4 4 48 0; ! #X connect 14 0 20 0; ! #X connect 15 0 14 0; ! #X connect 16 0 14 0; ! #X connect 17 0 14 0; ! #X connect 18 0 14 0; ! #X connect 19 0 14 0; ! #X connect 22 0 26 0; ! #X connect 23 0 26 0; ! #X connect 24 0 26 0; ! #X connect 25 0 26 0; ! #X connect 26 0 29 0; ! #X connect 26 1 28 0; ! #X connect 27 0 26 0; ! #X connect 36 0 37 0; ! #X connect 37 0 4 0; ! #X connect 38 0 37 1; ! #X connect 39 0 37 1; ! #X connect 45 0 49 0; ! #X connect 49 0 41 0; ! #X connect 49 1 42 0; ! #X connect 49 2 43 0; ! #X connect 50 0 4 0; ! #X restore 475 325 pd trigger_can_convert_data_types; ! #X obj 822 238 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 ! -1; ! #X floatatom 902 164 5 0 0 0 - - -; ! #X text 477 246 at the top-right to clearly see "logical time"; ! #X text 477 259 as measured by [timer].; ! #X text 509 554 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 472 378 RELATED OBJECTS; ! #X obj 557 404 route; ! #X obj 477 404 unpack; ! #X obj 523 404 pack; ! #X obj 598 404 delay; ! #X obj 640 404 pipe; ! #X obj 675 404 float; ! #X obj 715 404 int; ! #X obj 744 404 symbol; ! #N canvas 0 22 456 306 related_objects_from_other_libraries 0; ! #X obj 31 36 exciter 200 200 8 0.1 1 1; ! #X text 26 77 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 25 126 The best places to find information about PD's libraries ! is:; ! #X text 22 148 www.pure-data.org and click on "Downloads" then "Software" ! ; ! #X text 24 163 or; ! #X text 24 178 iem.kug.ac.at/pdb/; ! #X restore 477 435 pd related_objects_from_other_libraries; ! #X obj 940 5 pddp; ! #X text 472 463 MORE INFO; ! #X obj 479 490 all_about_data_types; ! #X obj 480 516 all_about_lists_vs_anythings; ! #X obj 822 157 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 ! -1; ! #X text 17 138 "float" = f; ! #X text 17 150 "bang" = b; ! #X text 16 162 "symbol" = s; ! #X text 17 176 "list" = l; ! #X text 17 204 "anything" = a; ! #X text 17 190 "pointer" = p; ! #X text 26 45 The [trigger] object outputs its input from right to ! left , converting to the types indicated by its creation arguments. ! There is also a "pointer" argument type (see the [pointer] object.) ! ; ! #X text 20 364 Click the toggle to set the tempo and start the [metro] ! simultaneously.; ! #X text 67 413 Triggers are sent from right to left...so our tempo ! messages gets sent to [metro] immediately before the numbers from the ! toggle to start and stop the [metro].; ! #X text 482 40 Below is a simple structure which will measure the "logical ! time" between "bangs" from the [trigger] object.; ! #X text 477 184 In this case , I've simply patched a [delay]; ! #X text 476 212 first and second "bangs" sent to the [timer].; ! #X text 477 232 You can reset the [delay] with the number box; ! #X text 86 15 - sequence messages in right-to-left order and convert ! data; ! #X text 503 15 types; ! #X connect 3 0 5 0; ! #X connect 4 0 3 1; ! #X connect 6 0 11 0; ! #X connect 11 0 3 0; ! #X connect 11 1 4 0; ! #X connect 13 0 15 1; ! #X connect 13 1 15 0; ! #X connect 14 0 13 0; ! #X connect 15 0 16 0; ! #X connect 17 0 18 0; ! #X connect 22 0 23 0; ! #X connect 23 0 31 0; ! #X connect 24 0 22 1; ! #X connect 32 0 24 1; ! #X connect 50 0 24 0; ! #X connect 50 0 22 0;