diff options
Diffstat (limited to 'doc/pddp/append-help.pd')
-rw-r--r-- | doc/pddp/append-help.pd | 119 |
1 files changed, 119 insertions, 0 deletions
diff --git a/doc/pddp/append-help.pd b/doc/pddp/append-help.pd new file mode 100644 index 00000000..763dfea8 --- /dev/null +++ b/doc/pddp/append-help.pd @@ -0,0 +1,119 @@ +#N canvas 0 0 555 619 10; +#X obj 0 595 cnv 15 552 21 empty \$0-pddp.cnv.footer empty 20 12 0 +14 -228856 -66577 0; +#X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header append 3 12 0 18 +-204280 -1 0; +#X obj 0 226 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 53 247 494 344 META 0; +#X text 12 105 PLATFORM windows macosx gnulinux; +#X text 12 205 LIBRARY internal; +#X text 12 245 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 65 LICENSE SIBSD; +#X text 12 225 AUTHOR Miller Puckette; +#X text 12 305 HELP_PATCH_AUTHORS Updated for Pd version 0.4. Jonathan +Wilkes revised the patch to conform to the PDDP template for Pd version +0.42.; +#X text 12 5 GENRE help; +#X text 12 45 KEYWORDS control data_structure; +#X text 12 85 DESCRIPTION add item to a list; +#X text 12 165 INLET_R pointer; +#X text 12 185 OUTLET_0 pointer; +#X text 12 125 INLET_0 float list; +#X text 12 145 INLET_N float; +#X text 12 25 NAME append; +#X text 12 265 RELEASE_DATE 1997; +#X text 12 285 RELEASE_VERSION; +#X restore 500 597 pd META; +#X obj 0 392 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 436 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 527 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#X obj 78 319 cnv 17 3 35 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 +-162280 0; +#X obj 78 235 cnv 17 3 78 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 319 float; +#N canvas 62 491 428 101 Related_objects 0; +#X obj 14 38 get; +#X obj 46 38 set; +#X obj 136 38 getsize; +#X obj 193 38 setsize; +#X obj 121 63 element; +#X obj 13 64 sublist; +#X obj 79 38 pointer; +#X obj 69 63 struct; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 8 2 [append] Related Objects; +#X restore 101 597 pd Related_objects; +#X obj 484 3 append; +#X obj 455 20 pddp/pddplink http://wiki.puredata.info/en/append -text +pdpedia: append; +#N canvas 114 104 428 109 help-append-template1 0; +#X obj 22 69 filledpolygon z z 0 0 0 20 0 20 30 0 30; +#X obj 22 42 struct help-append-template1 float x float y float z; +#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [append] Template for "help-append-template1"; +#X restore 372 196 pd help-append-template1; +#N canvas 98 282 428 207 help-append-data 0; +#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 7 1 [append] Data Window; +#X restore 372 174 pd help-append-data; +#X obj 261 104 pointer; +#X msg 261 80 traverse pd-help-append-data \, bang; +#X obj 60 152 append help-append-template1 x y z; +#X floatatom 60 95 5 20 400 0 - - -; +#X obj 60 115 t f f; +#X msg 372 138 \; pd-help-append-data clear; +#X text 98 234 float; +#X text 98 264 list; +#X msg 18 95 5 6 7; +#X obj 78 401 cnv 17 3 30 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 401 pointer; +#X obj 78 360 cnv 17 3 27 empty \$0-pddp.cnv.let.r r 5 9 0 16 -228856 +-162280 0; +#X text 98 360 pointer; +#X text 98 531 You may append objects of different templates using +different [append] objects.; +#X text 11 23 add item to a list; +#X text 168 360 - the final inlet takes a pointer to a scalar (or to +the head of a list).; +#X text 168 234 - a float to the left inlet initializes the field(s) +of a scalar and appends the scalar to a glist.; +#X text 168 264 - a list to the first inlet is distributed among the +inlets of [append]. In the example above \, you can use the message +box to assign the values "5" \, "6" \, and "7" to fields "x" \, "y" +\, and "z" \, respectively.; +#X text 168 319 - an additional inlet is created for each field specified +by the creation arguments. A float sent to one of these inlets will +be stored for later use.; +#X text 168 401 - after [append] receives a value at its left inlet +\, it outputs a pointer to the new scalar that has been created.; +#X text 15 74 2) ...then here; +#X text 224 174 3) result is in here ->; +#X text 259 56 1) go to (and output) "head" of the list; +#X text 168 482 - all subsequent arguments are names of fields to initialize. +At least one field must be specified in order to append a new scalar. +; +#X text 80 455 1) symbol atom; +#X text 80 482 n) symbol atom; +#X text 168 455 - a [struct] name that specifies the template of a +new scalar to append.; +#X obj 4 597 pddp/pddplink pddp/help.pd -text help; +#X obj 98 572 pddp/pddplink ../4.data.structures/04.append.pd -text +doc/4.data.structures/04.append.pd; +#X obj 98 557 pddp/pddplink all_about_z_order.pd; +#X obj 325 557 pddp/pddplink scalar-help.pd; +#X connect 15 0 17 3; +#X connect 16 0 15 0; +#X connect 18 0 19 0; +#X connect 19 0 17 0; +#X connect 19 1 17 1; +#X connect 19 1 17 2; +#X connect 23 0 17 0; |