Update zl-help.pd

porres · Feb 14, 2024 · d71d454 · d71d454
1 parent 4914101
commit d71d454
Showing 1 changed file with 62 additions and 64 deletions.
diff --git a/documentation/help_files/zl-help.pd b/documentation/help_files/zl-help.pd
@@ -1,4 +1,4 @@
-#N canvas 501 28 558 571 10;
+#N canvas 481 56 558 571 10;
 #X obj 2 251 cnv 3 550 3 empty empty inlets 8 12 0 13 #dcdcdc #000000 0;
 #X obj 2 369 cnv 3 550 3 empty empty outlets 8 12 0 13 #dcdcdc #000000 0;
 #X obj 82 258 cnv 17 3 84 empty empty 0 5 9 0 16 #dcdcdc #9c9c9c 0;
@@ -8,7 +8,6 @@
 #X obj 159 222 nbx 2 14 -1e+37 1e+37 0 0 empty empty empty 0 -8 0 10 #dcdcdc #000000 #000000 0 256;
 #X obj 159 198 cyclone/zl len;
 #X text 119 271 anything;
-#X text 91 285 mode <symbol>;
 #X text 178 271 - one or more element messages to be processed;
 #X text 119 346 anything;
 #X text 119 397 anything;
@@ -24,12 +23,9 @@
 #X msg 202 145 beep 1 2 3 4;
 #X text 143 256 bang;
 #X text 126 313 zlclear;
-#N canvas 452 109 638 490 examples 0;
-#X obj 54 232 bng 18 250 50 0 empty empty empty 0 -6 0 8 #d0d0d0 #404040 #000000;
-#X obj 157 352 nbx 4 14 -1e+37 1e+37 0 0 empty empty empty 0 -8 0 10 #dcdcdc #000000 #000000 0 256;
-#X text 28 40 You can set the size of the list with a first optional float argument. If you don't \, then the first argument is a symbol that specifies the mode type \, and the maximum size is the default: 256 elements., f 54;
-#X text 28 171 The maximum size is also set via the 'zlmaxsize' attribute or message (and it can be up to 32767)., f 54;
-#X text 28 92 The mode argument is obrigatory and this means there is no default mode. If you don't set a mode as an argument \, you have to set it via the mode message., f 54;
+#N canvas 452 109 635 453 examples 0;
+#X obj 54 228 bng 18 250 50 0 empty empty empty 0 -6 0 8 #d0d0d0 #404040 #000000;
+#X obj 157 348 nbx 4 14 -1e+37 1e+37 0 0 empty empty empty 0 -8 0 10 #dcdcdc #000000 #000000 0 256;
 #N canvas 740 59 394 428 ecils 0;
 #X obj 235 277 nbx 3 14 0 100 0 0 empty empty empty 0 -8 0 10 #dcdcdc #000000 #000000 0 256;
 #X text 275 275 split point;
@@ -54,7 +50,7 @@
 #X connect 13 0 14 0;
 #X connect 14 0 4 0;
 #X connect 14 1 5 0;
-#X restore 431 143 pd ecils;
+#X restore 441 123 pd ecils;
 #N canvas 864 197 407 464 group 0;
 #X obj 273 251 bng 25 250 50 0 empty empty empty 17 7 0 10 #dcdcdc #000000 #000000;
 #X obj 266 352 nbx 3 14 1 10 0 0 empty empty empty 0 -8 0 10 #dcdcdc #000000 #000000 0 256;
@@ -84,7 +80,7 @@
 #X connect 15 0 16 0;
 #X connect 16 0 7 0;
 #X connect 17 0 16 0;
-#X restore 431 185 pd group;
+#X restore 441 165 pd group;
 #N canvas 753 249 463 451 iter 0;
 #X msg 174 275 1 2 3 4 5 6;
 #X msg 156 247 mode iter 4;
@@ -109,7 +105,7 @@
 #X connect 10 0 14 0;
 #X connect 13 0 14 0;
 #X connect 14 0 2 0;
-#X restore 431 226 pd iter;
+#X restore 441 206 pd iter;
 #N canvas 788 131 408 292 join 0;
 #X obj 141 240 print zl_join;
 #X obj 77 151 bng 18 250 50 0 empty empty empty 0 -6 0 8 #d0d0d0 #404040 #000000;
@@ -127,7 +123,7 @@
 #X connect 6 0 9 0;
 #X connect 8 0 9 0;
 #X connect 9 0 0 0;
-#X restore 431 247 pd join;
+#X restore 441 227 pd join;
 #N canvas 781 151 405 407 len 0;
 #X msg 162 176 this produces 3;
 #X msg 173 208 and this should be five;
@@ -151,7 +147,7 @@
 #X connect 7 0 12 0;
 #X connect 11 0 12 0;
 #X connect 12 0 3 0;
-#X restore 431 290 pd len;
+#X restore 441 270 pd len;
 #N canvas 573 172 789 398 mth 0;
 #X obj 70 266 bng 18 250 50 0 empty empty empty 0 -6 0 8 #d0d0d0 #404040 #000000;
 #X obj 451 220 bng 18 250 50 0 empty empty empty 0 -6 0 8 #d0d0d0 #404040 #000000;
@@ -193,7 +189,7 @@
 #X connect 23 0 7 0;
 #X connect 23 0 20 0;
 #X connect 23 1 9 0;
-#X restore 431 357 pd mth;
+#X restore 441 337 pd mth;
 #N canvas 426 244 812 412 nth 0;
 #X obj 76 265 bng 18 250 50 0 empty empty empty 0 -6 0 8 #d0d0d0 #404040 #000000;
 #X obj 467 188 bng 18 250 50 0 empty empty empty 0 -6 0 8 #d0d0d0 #404040 #000000;
@@ -236,7 +232,7 @@
 #X connect 24 0 11 0;
 #X connect 24 0 21 0;
 #X connect 24 1 8 0;
-#X restore 431 378 pd nth;
+#X restore 441 358 pd nth;
 #N canvas 786 294 430 326 reg 0;
 #X obj 69 286 print reg;
 #X obj 111 222 bng 18 250 50 0 empty empty empty 0 -6 0 8 #d0d0d0 #404040 #000000;
@@ -258,7 +254,7 @@
 #X connect 7 0 11 0;
 #X connect 10 0 11 0;
 #X connect 11 0 0 0;
-#X restore 514 101 pd reg;
+#X restore 524 81 pd reg;
 #N canvas 865 220 418 288 rev 0;
 #X msg 137 155 way this something means this;
 #X obj 80 159 bng 18 250 50 0 empty empty empty 17 7 0 10 #dcdcdc #000000 #000000;
@@ -275,7 +271,7 @@
 #X connect 5 0 8 0;
 #X connect 7 0 8 0;
 #X connect 8 0 4 0;
-#X restore 514 122 pd rev;
+#X restore 524 102 pd rev;
 #N canvas 842 204 399 436 rot 0;
 #X msg 122 256 sometimes my grammar is all messed up;
 #X obj 195 319 nbx 3 14 -1e+37 1e+37 0 0 empty empty empty 0 -8 0 10 #dcdcdc #000000 #000000 0 256;
@@ -297,7 +293,7 @@
 #X connect 9 0 12 0;
 #X connect 11 0 12 0;
 #X connect 12 0 5 0;
-#X restore 514 143 pd rot;
+#X restore 524 123 pd rot;
 #N canvas 942 241 424 357 sect 0;
 #X obj 53 217 bng 18 250 50 0 empty empty empty 0 -6 0 8 #d0d0d0 #404040 #000000;
 #X obj 230 302 bng 18 250 50 0 empty empty empty 0 -6 0 8 #d0d0d0 #404040 #000000;
@@ -322,7 +318,7 @@
 #X connect 13 0 14 0;
 #X connect 14 0 4 0;
 #X connect 14 1 1 0;
-#X restore 514 185 pd sect;
+#X restore 524 165 pd sect;
 #N canvas 824 23 415 398 slice 0;
 #X obj 236 259 nbx 3 14 0 100 0 0 empty empty empty 0 -8 0 10 #dcdcdc #000000 #000000 0 256;
 #X text 276 257 split point;
@@ -347,7 +343,7 @@
 #X connect 13 0 14 0;
 #X connect 14 0 9 0;
 #X connect 14 1 10 0;
-#X restore 514 205 pd slice;
+#X restore 524 185 pd slice;
 #N canvas 889 66 405 334 sub 0;
 #X obj 69 188 bng 18 250 50 0 empty empty empty 0 -6 0 8 #d0d0d0 #404040 #000000;
 #X msg 210 220 11;
@@ -370,7 +366,7 @@
 #X connect 10 0 11 0;
 #X connect 11 0 5 0;
 #X connect 11 1 4 0;
-#X restore 514 290 pd sub;
+#X restore 524 270 pd sub;
 #N canvas 861 239 405 268 union 0;
 #X obj 65 153 bng 18 250 50 0 empty empty empty 0 -6 0 8 #d0d0d0 #404040 #000000;
 #X obj 108 227 print zl_union;
@@ -387,15 +383,14 @@
 #X connect 6 0 8 0;
 #X connect 7 0 8 0;
 #X connect 8 0 1 0;
-#X restore 515 379 pd union;
-#X text 183 216 set to default;
-#X obj 157 376 print length;
-#X msg 157 260 zlmaxsize \$1;
-#X msg 157 216 256;
-#X msg 171 238 512;
-#X text 28 404 In the above example \, the objects are initialized to a size of 512 but can be resized to the default (256). Note that the group message can't group 512 elements if its size is 256 \, hence it groups two 256 elements message., f 54;
-#X text 197 238 back to 512;
-#X obj 54 259 cyclone/uzi 512;
+#X restore 525 359 pd union;
+#X text 183 212 set to default;
+#X obj 157 372 print length;
+#X msg 157 256 zlmaxsize \$1;
+#X msg 157 212 256;
+#X msg 171 234 512;
+#X text 197 234 back to 512;
+#X obj 54 255 cyclone/uzi 512;
 #N canvas 889 66 405 380 sort 0;
 #X obj 69 212 bng 18 250 50 0 empty empty empty 0 -6 0 8 #d0d0d0 #404040 #000000;
 #X text 192 185 <= sets mode and arguments;
@@ -418,8 +413,7 @@
 #X connect 11 0 12 0;
 #X connect 12 0 6 0;
 #X connect 12 1 7 0;
-#X restore 514 226 pd sort;
-#X text 28 132 Check details about each mode in the subpatches on the right. The modes introduced in the Max5+ versions are not implemented yet., f 54;
+#X restore 524 206 pd sort;
 #N canvas 818 132 407 351 change 0;
 #X obj 71 159 bng 18 250 50 0 empty empty empty 0 -6 0 8 #d0d0d0 #404040 #000000;
 #X msg 89 102 zlclear;
@@ -440,7 +434,7 @@
 #X connect 8 0 3 0;
 #X connect 8 1 4 0;
 #X connect 10 0 8 0;
-#X restore 430 80 pd change;
+#X restore 440 60 pd change;
 #N canvas 861 239 403 352 compare 0;
 #X obj 55 175 bng 18 250 50 0 empty empty empty 0 -6 0 8 #d0d0d0 #404040 #000000;
 #X msg 73 108 zlclear;
@@ -467,7 +461,7 @@
 #X connect 9 1 13 0;
 #X connect 12 0 11 0;
 #X connect 13 0 10 0;
-#X restore 430 101 pd compare;
+#X restore 440 81 pd compare;
 #N canvas 861 239 390 258 delace 0;
 #X obj 78 137 bng 18 250 50 0 empty empty empty 0 -6 0 8 #d0d0d0 #404040 #000000;
 #X msg 96 80 zlclear;
@@ -484,7 +478,7 @@
 #X connect 5 0 8 0;
 #X connect 8 0 2 0;
 #X connect 8 1 3 0;
-#X restore 430 122 pd delace;
+#X restore 440 102 pd delace;
 #N canvas 713 142 405 306 filter 0;
 #X obj 63 173 bng 18 250 50 0 empty empty empty 0 -6 0 8 #d0d0d0 #404040 #000000;
 #X text 244 136 <= sets mode and arguments, f 14;
@@ -507,7 +501,7 @@
 #X connect 10 0 4 0;
 #X connect 10 1 11 0;
 #X connect 11 0 6 0;
-#X restore 431 164 pd filter;
+#X restore 441 144 pd filter;
 #N canvas 783 223 405 268 lace 0;
 #X obj 65 153 bng 18 250 50 0 empty empty empty 0 -6 0 8 #d0d0d0 #404040 #000000;
 #X msg 83 96 zlclear;
@@ -524,7 +518,7 @@
 #X connect 4 0 8 0;
 #X connect 6 0 8 1;
 #X connect 8 0 5 0;
-#X restore 431 268 pd lace;
+#X restore 441 248 pd lace;
 #N canvas 827 198 405 268 lookup 0;
 #X obj 65 153 bng 18 250 50 0 empty empty empty 0 -6 0 8 #d0d0d0 #404040 #000000;
 #X obj 108 227 print zl_union;
@@ -541,7 +535,7 @@
 #X connect 5 0 8 0;
 #X connect 6 0 8 0;
 #X connect 8 0 1 0;
-#X restore 431 313 pd lookup;
+#X restore 441 293 pd lookup;
 #N canvas 861 239 405 301 median 0;
 #X obj 111 145 bng 18 250 50 0 empty empty empty 0 -6 0 8 #d0d0d0 #404040 #000000;
 #X msg 129 88 zlclear;
@@ -560,7 +554,7 @@
 #X connect 4 0 9 0;
 #X connect 6 0 8 0;
 #X connect 9 0 6 0;
-#X restore 431 335 pd median;
+#X restore 441 315 pd median;
 #N canvas 861 239 441 293 scramble 0;
 #X obj 34 160 bng 18 250 50 0 empty empty empty 0 -6 0 8 #d0d0d0 #404040 #000000;
 #X msg 248 168 6.5 4 2.3 2 2 8 hi;
@@ -579,7 +573,7 @@
 #X connect 7 0 9 0;
 #X connect 9 0 5 0;
 #X connect 9 1 6 0;
-#X restore 514 164 pd scramble;
+#X restore 524 144 pd scramble;
 #N canvas 601 172 442 332 queue 0;
 #X obj 117 181 bng 18 250 50 0 empty empty empty 0 -6 0 8 #d0d0d0 #404040 #000000;
 #X msg 124 120 zlclear;
@@ -599,7 +593,7 @@
 #X connect 6 0 10 0;
 #X connect 10 0 9 0;
 #X connect 10 1 3 0;
-#X restore 514 80 pd queue;
+#X restore 524 60 pd queue;
 #N canvas 573 172 443 327 stack 0;
 #X obj 121 183 bng 18 250 50 0 empty empty empty 0 -6 0 8 #d0d0d0 #404040 #000000;
 #X msg 128 122 zlclear;
@@ -619,7 +613,7 @@
 #X connect 7 0 10 0;
 #X connect 10 0 9 0;
 #X connect 10 1 3 0;
-#X restore 514 247 pd stack;
+#X restore 524 227 pd stack;
 #N canvas 840 133 464 326 stream 0;
 #X obj 123 187 bng 18 250 50 0 empty empty empty 0 -6 0 8 #d0d0d0 #404040 #000000;
 #X obj 281 214 nbx 3 14 -1e+37 1e+37 0 0 empty empty empty 0 -8 0 10 #dcdcdc #000000 #000000 0 256;
@@ -638,7 +632,7 @@
 #X connect 6 0 9 0;
 #X connect 9 0 8 0;
 #X connect 9 1 3 0;
-#X restore 514 268 pd stream;
+#X restore 524 248 pd stream;
 #N canvas 804 199 422 308 sum 0;
 #X obj 101 167 bng 18 250 50 0 empty empty empty 0 -6 0 8 #d0d0d0 #404040 #000000;
 #X msg 148 160 1 2 3 4 5 6 7 8 9 10;
@@ -654,7 +648,7 @@
 #X connect 4 0 7 0;
 #X connect 5 0 7 0;
 #X connect 7 0 2 0;
-#X restore 514 313 pd sum;
+#X restore 524 293 pd sum;
 #N canvas 818 151 405 322 unique 0;
 #X obj 74 175 bng 18 250 50 0 empty empty empty 0 -6 0 8 #d0d0d0 #404040 #000000;
 #X text 259 138 <= sets mode and arguments, f 14;
@@ -673,7 +667,7 @@
 #X connect 6 0 9 0;
 #X connect 7 0 9 0;
 #X connect 9 0 8 0;
-#X restore 468 405 pd unique;
+#X restore 478 385 pd unique;
 #N canvas 804 199 422 308 thin 0;
 #X obj 101 167 bng 18 250 50 0 empty empty empty 0 -6 0 8 #d0d0d0 #404040 #000000;
 #X msg 108 106 zlclear;
@@ -690,7 +684,7 @@
 #X connect 4 0 8 0;
 #X connect 6 0 8 0;
 #X connect 8 0 7 0;
-#X restore 515 357 pd thin;
+#X restore 525 337 pd thin;
 #N canvas 700 167 435 325 indexmap 0;
 #X obj 57 184 bng 18 250 50 0 empty empty empty 0 -6 0 8 #d0d0d0 #404040 #000000;
 #X msg 64 133 zlclear;
@@ -707,7 +701,7 @@
 #X connect 4 0 8 1;
 #X connect 7 0 8 0;
 #X connect 8 0 3 0;
-#X restore 431 205 pd indexmap;
+#X restore 441 185 pd indexmap;
 #N canvas 601 172 441 297 swap 0;
 #X obj 101 150 bng 18 250 50 0 empty empty empty 0 -6 0 8 #d0d0d0 #404040 #000000;
 #X msg 118 93 zlclear;
@@ -726,19 +720,22 @@
 #X connect 5 0 9 1;
 #X connect 6 0 9 1;
 #X connect 9 0 2 0;
-#X restore 515 335 pd swap;
-#X text 435 46 Examples:;
-#X text 36 14 Basic:;
-#X obj 157 325 cyclone/zl.len @zlmaxsize 512;
-#X obj 167 297 cyclone/zl 512 group 512;
-#X connect 0 0 26 0;
-#X connect 1 0 20 0;
-#X connect 21 0 47 0;
-#X connect 22 0 21 0;
-#X connect 23 0 21 0;
-#X connect 26 2 48 0;
-#X connect 47 0 1 0;
-#X connect 48 0 47 0;
+#X restore 525 315 pd swap;
+#X text 415 29 Examples:;
+#X text 36 13 Basic:;
+#X obj 167 293 cyclone/zl.group 512 @zlmaxsize 512;
+#X text 38 400 In the above example \, the objects are initialized to a size of 512 but can be resized to the default (256)., f 54;
+#X obj 157 321 cyclone/zl 512 len;
+#X text 28 137 When not using a dot \, the mode argument is obrigatory \, otherwise an error is printed. This also implies there is no default mode. You can change mode as a message in any case \, by the way. Check details about each mode in the subpatches on the right., f 55;
+#X text 28 37 The default maximum size is 256 elements. When you're not using a dot to set the mode \, you can change the maximum size with a first optional float argument. In this case you need a symbol argument that specifies the mode type. If you are using a dot you can only reset the maximum size with the '@zlmaxsize' attribute. The maximum size is also set via the 'zlmaxsize' attribute or message (and it can be up to 32767)., f 55;
+#X connect 0 0 22 0;
+#X connect 1 0 17 0;
+#X connect 18 0 44 0;
+#X connect 19 0 18 0;
+#X connect 20 0 18 0;
+#X connect 22 2 42 0;
+#X connect 42 0 44 0;
+#X connect 44 0 1 0;
 #X restore 475 224 pd examples;
 #X text 178 378 - output according to the mode: see details in [pd examples];
 #X text 178 397 - output according to the mode: see details in [pd examples];
@@ -813,9 +810,10 @@
 #X text 22 62 List processor;
 #X text 36 85 [zl] processes messages with one or more elements ("list messages' or "anything") according to a mode set via argument/message or in the object name after a '.' (dot)., f 74;
 #X obj 338 198 cyclone/zl.len;
+#X text 107 285 mode <any>;
 #X connect 7 0 6 0;
-#X connect 7 0 45 0;
-#X connect 22 0 7 0;
+#X connect 7 0 44 0;
+#X connect 21 0 7 0;
+#X connect 27 0 7 0;
 #X connect 28 0 7 0;
-#X connect 29 0 7 0;
-#X connect 42 0 7 0;
+#X connect 41 0 7 0;