aboutsummaryrefslogtreecommitdiff
path: root/doc/pddp/append-help.pd
blob: 763dfea84847b6cef71fabc522da2d9ebeff9b4b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
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;