diff --git a/pd/doc/5.reference/import-help.pd b/pd/doc/5.reference/import-help.pd index e9b738a3f59ad07749f828d4d7c6c197a6f4f462..9564478826507dae37c0c816a9b63bb6e3375ee6 100644 --- a/pd/doc/5.reference/import-help.pd +++ b/pd/doc/5.reference/import-help.pd @@ -1,13 +1,11 @@ -#N canvas 430 37 555 619 10; +#N canvas 1135 297 555 619 10; #X declare; -#X declare; -#X declare -lib cyclone -lib osc; #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 import 3 12 0 18 --204280 -1 0; -#X obj 0 294 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 --228856 -1 0; +#c4dcdc #000000 0; +#X obj 0 244 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +#dcdcdc #000000 0; #N canvas 487 287 494 344 META 0; #X text 12 125 LIBRARY internal; #X text 12 165 WEBSITE http://crca.ucsd.edu/~msp/; @@ -22,59 +20,61 @@ to conform to the PDDP template for Pd version 0.42.; #X text 12 105 OUTLET_1 bang; #X text 12 185 RELEASE_DATE 2005; #X restore 500 597 pd META; -#X obj 0 369 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 -13 -228856 -1 0; -#X obj 0 455 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj 0 505 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 -0 13 -228856 -1 0; +#X obj 0 327 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 #dcdcdc #000000 0; +#X obj 0 422 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 #dcdcdc #000000 0; +#X obj 0 476 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 #dcdcdc #000000 0; #N canvas 218 522 428 109 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 [import] Related Objects; #X obj 22 42 declare; #X restore 102 597 pd Related_objects; -#X obj 78 303 cnv 17 3 55 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 378 cnv 17 3 30 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 --162280 0; -#X obj 78 411 cnv 17 3 35 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 --162280 0; +#X obj 78 253 cnv 17 3 55 empty \$0-pddp.cnv.let.0 0 5 9 0 16 #dcdcdc +#9c9c9c 0; +#X obj 78 338 cnv 17 3 30 empty \$0-pddp.cnv.let.0 0 5 9 0 16 #dcdcdc +#9c9c9c 0; +#X obj 78 374 cnv 17 3 35 empty \$0-pddp.cnv.let.1 1 5 9 0 16 #dcdcdc +#9c9c9c 0; #X obj 500 10 import; -#X msg 91 114 bang; -#X symbolatom 102 188 0 0 0 0 - - -; -#X obj 91 214 print; -#X text 138 113 get next item in list of loaded libs; -#X text 150 137 start at the top of the list again; -#X msg 103 138 rewind; -#X text 97 509 [import] loads libraries from the patch. On Pd 0.40. +#X msg 91 88 bang; +#X symbolatom 102 162 0 0 0 0 - - -; +#X obj 91 188 print; +#X text 128 88 get next item in list of loaded libs; +#X text 152 112 start at the top of the list again; +#X msg 103 112 rewind; +#X text 97 486 [import] loads libraries from the patch. On Pd 0.40. or greater \, it loads the library into the patch's local namespace. -On older versions \, it loads the libraries into the global namespace. +On older versions \, it loads the libraries into the global namespace. +Note that [declare] is the standard library loading mechanism. [import] +should only be used to iterate through the list of loaded libraries. ; -#X text 98 302 bang; -#X text 98 332 rewind; -#X text 98 377 symbol; -#X text 98 410 bang; -#X obj 262 184 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 --1 -1; +#X text 98 254 bang; +#X text 98 292 rewind; +#X text 98 338 symbol; +#X text 98 374 bang; +#X obj 262 184 bng 15 250 50 0 empty empty empty 17 7 0 10 #fcfcfc +#000000 #000000; #X text 283 183 bang after the end of the list is reached; #X text 11 23 load libraries from a patch; -#X text 168 377 - a "bang" to the inlet of [import] sends a symbol +#X text 168 338 - a "bang" to the inlet of [import] sends a symbol to the left outlet which the name of a loaded library.; -#X text 168 332 - the "rewind" message starts at the top of the list +#X text 168 292 - the "rewind" message starts at the top of the list of libraries.; -#X text 168 302 - sending a "bang" to [import] makes it output the +#X text 168 252 - sending a "bang" to [import] makes it output the loaded libraries one at a time (i.e. \, one per bang).; -#X text 167 410 - once [import] has output the last library in the +#X text 167 374 - once [import] has output the last library in the list \, sending another "bang" to its inlet will cause a "bang" to be sent out its right outlet.; -#X text 80 471 n) symbol atom; -#X text 167 471 - the arguments to [import] specify the libraries to +#X text 80 442 n) symbol atom; +#X text 167 442 - the arguments to [import] specify the libraries to load for patch.; #X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide ; -#X obj 97 568 pddp/pddplink all_about_libraries.pd; -#X obj 91 162 import cyclone osc; +#X obj 97 570 pddp/pddplink all_about_libraries.pd; +#X obj 91 136 import cyclone osc; #X connect 12 0 34 0; #X connect 17 0 34 0; #X connect 34 0 13 0;