diff options
Diffstat (limited to 'doc/additional')
28 files changed, 1012 insertions, 0 deletions
diff --git a/doc/additional/pd-msg/0.intro.txt b/doc/additional/pd-msg/0.intro.txt new file mode 100755 index 00000000..55b15591 --- /dev/null +++ b/doc/additional/pd-msg/0.intro.txt @@ -0,0 +1,152 @@ +Here some documentation about internal pd messages.
+(pd-msg_05)
+
+1) Thoses msg are sent directly to pd (pd selector) or to a loaded patch (pd-patch.pd selector).
+ all thoses msg has to be finnished by a ";"
+ you can test them using :
+ in the file menu : message
+ pdsend
+ the tclsend2pd in the 4.msg_from_tcl folder.
+
+ Thoses message allows you (examples):
+ To control pd without the gui :
+ Take benefit of the no-gui option
+ open a patch via socket... (tcl, python, sh, c++,...)
+ modify or create new patch
+ Create patch that will create some other
+ Deals with massive polyphonie (100 osc~ or more...)
+ load patchs from an other
+ construct generative patch
+ Create new gui
+ etc...
+
+2) Here an list of those msg (* are documented somewhere in this doc):
+
+ messages to pd:
+ init [gimme]
+ filename [symbol] [symbol]
+ * open [symbol] [symbol]
+ * quit
+ foo [gimme]
+ * dsp [gimme]
+ meters [float]
+ key [gimme]
+ * audiostatus
+ finderror
+ ping
+
+ messages to canvas:
+ * obj [gimme]
+ * msg [gimme]
+ * floatatom [gimme]
+ * symbolatom [gimme]
+ * text [gimme]
+ * graph [gimme]
+ * array
+ * scalar [gimme]
+ bng [gimme]
+ toggle [gimme]
+ vslider [gimme]
+ hslider [gimme]
+ radio [gimme]
+ vumeter [gimme]
+ mycnv [gimme]
+ * connect [float] [float] [float] [float]
+ * restore [gimme]
+ write [symbol] [defsymbol]
+ read [symbol] [defsymbol]
+ mergefile [symbol] [defsymbol]
+ sort
+ * click [float] [float] [float] [float]
+ * mouseup [float] [float] [float]
+ * key [gimme]
+ * motion [float] [float] [float]
+ * print [symbol]
+ * menusave
+ * menusaveas
+ * menuclose [deffloat]
+ * saveto [symbol] [symbol]
+ * cut
+ * copy
+ * paste
+ * duplicate
+ * selectall
+ * tidy
+ * texteditor
+ * editmode [deffloat]
+ protectmode [deffloat]
+ * print [symbol]
+ * pop [deffloat]
+ * loadbang
+ * relocate [symbol] [symbol]
+ * menufont
+ * font [float] [float] [float]
+ * find [gimme]
+ * findagain
+ * findparent
+ * vis [float]
+ properties [float] [float]
+ help [float] [float]
+ arraydialog [symbol] [float] [float] [float]
+ map [float]
+ clear
+ intatom [gimme]
+ atom [gimme]
+
+
+
+3) Here the map of the documentation :
+ 1.msg_and_patch
+ describe msg that can be sent to patch.
+ contains pd files
+
+ 2.msg_and_pd
+ describe msg that can be sent to pd.
+ contains pd files
+
+ 3.pdscript
+ it's sh scrip using pdsend to create patch into pd.
+ pdscript has been done by Guenter Geiger
+ contains it's own readme + files.
+
+ 4.msg_from_tcl/tk
+ decribe how to use tcl/tk to create, open patch, etc...
+
+ 5.Examples
+ Contain an example of how a "obj x y myOsc~" message can be use
+ to deal with massive polyphonie
+
+4) Releases :
+
+ release 0.5 : pd-msg_05.tar.gz
+ add some more msg.
+ Thanks to Krzysztof Czaja
+ all msg are listed for pd0.34
+
+ release 0.4 : pd-msg_04.tar.gz
+ add many message :
+ the events messages
+ the menu messages
+ the cut&paste msg, etc...
+ complete the polyphonie example
+
+ release 0.3 : pd-msg
+ Rearenge patch & examples in diferents directory.
+ add polyphonie examples
+ add tcl scripts...
+
+ release 0.2 : self-generation
+ add messages to open and close patch.
+
+ release 0.1 : self-construction
+ first release
+
+5) To do list :
+
+ some msg are not well explain or not explain at all.
+
+6) Reference :
+ Look @ the end of code of g_canvas.c in the source directory.
+
+
+Damien HENRY
\ No newline at end of file diff --git a/doc/additional/pd-msg/1.msg_and_patch/0.all_msg.pd b/doc/additional/pd-msg/1.msg_and_patch/0.all_msg.pd new file mode 100755 index 00000000..53427be0 --- /dev/null +++ b/doc/additional/pd-msg/1.msg_and_patch/0.all_msg.pd @@ -0,0 +1,82 @@ +#N canvas 708 185 541 701 10; +#X text 14 2 Here the list of all the messages :; +#X msg 40 207 array 500 190; +#X msg 40 233 scalar 500 220; +#X msg 40 318 restore; +#X msg 40 292 connect \$1 \$2 \$3 \$4; +#X text 16 28 objects; +#X text 17 267 methods for reading files; +#X text 20 345 events; +#X msg 40 376 click \$1 \$2 \$3 \$4; +#X msg 40 426 mouseup \$1 \$2 \$3; +#X text 375 6 GUI stuff; +#X msg 375 30 menusave; +#X msg 375 56 menusaveas; +#X msg 375 82 menuclose; +#X msg 375 108 saveto; +#X msg 375 194 cut; +#X msg 375 217 copy; +#X msg 375 266 duplicate; +#X msg 375 134 tidy; +#X msg 375 160 texteditor; +#X msg 375 464 editmode \$1; +#X msg 375 536 print; +#X msg 375 622 pop; +#X msg 375 500 loadbang; +#X msg 375 572 relocate; +#X msg 375 307 menufont; +#X msg 375 331 font 10 100 100; +#X msg 375 402 findagain; +#X msg 375 426 findparent; +#X msg 375 598 vis; +#X obj 40 631 s pd-0.all_msg.pd; +#X obj 375 652 s pd-0.all_msg.pd; +#X msg 40 51 obj 300 10 r test; +#X msg 40 77 msg 300 40 bang; +#X msg 40 129 symbolatom 300 100 symbol; +#X msg 40 155 text 300 130 comment; +#X msg 40 181 graph; +#X msg 40 499 key 1 \$1; +#X text 456 81 Warnnig !!!; +#X text 426 109 ?????; +#X text 149 234 ?????; +#X msg 375 242 paste; +#X msg 375 379 find test; +#X text 443 570 ?????; +#X msg 40 401 motion \$1 \$2 \$3; +#X msg 40 103 floatatom 300 70; +#X connect 1 0 30 0; +#X connect 2 0 30 0; +#X connect 3 0 30 0; +#X connect 4 0 30 0; +#X connect 8 0 30 0; +#X connect 9 0 30 0; +#X connect 11 0 31 0; +#X connect 12 0 31 0; +#X connect 13 0 31 0; +#X connect 14 0 31 0; +#X connect 15 0 31 0; +#X connect 16 0 31 0; +#X connect 17 0 31 0; +#X connect 18 0 31 0; +#X connect 19 0 31 0; +#X connect 20 0 31 0; +#X connect 21 0 31 0; +#X connect 22 0 31 0; +#X connect 23 0 31 0; +#X connect 24 0 31 0; +#X connect 25 0 31 0; +#X connect 26 0 31 0; +#X connect 27 0 31 0; +#X connect 28 0 31 0; +#X connect 29 0 31 0; +#X connect 32 0 30 0; +#X connect 33 0 30 0; +#X connect 34 0 30 0; +#X connect 35 0 30 0; +#X connect 36 0 30 0; +#X connect 37 0 30 0; +#X connect 41 0 31 0; +#X connect 42 0 31 0; +#X connect 44 0 30 0; +#X connect 45 0 30 0; diff --git a/doc/additional/pd-msg/1.msg_and_patch/1.0.objects.pd b/doc/additional/pd-msg/1.msg_and_patch/1.0.objects.pd new file mode 100755 index 00000000..cacf9eef --- /dev/null +++ b/doc/additional/pd-msg/1.msg_and_patch/1.0.objects.pd @@ -0,0 +1,28 @@ +#N canvas 656 148 543 410 10; +#X msg 39 237 array 500 190; +#X msg 39 263 scalar 500 220; +#X msg 39 348 restore; +#X msg 39 322 connect \$1 \$2 \$3 \$4; +#X text 15 58 objects; +#X text 16 297 methods for reading files; +#X msg 39 81 obj 300 10 r test; +#X msg 39 107 msg 300 40 bang; +#X msg 39 133 floatatom 300 70 symbol; +#X msg 39 159 symbolatom 300 100 symbol; +#X msg 39 185 text 300 130 comment; +#X msg 39 211 graph; +#X text 148 264 ?????; +#X obj 39 383 s pd-1.0.objects.pd; +#X text 110 348 ??????; +#X text 16 7 Here the list of all the messages; +#X text 17 24 that deals with objects.; +#X connect 0 0 13 0; +#X connect 1 0 13 0; +#X connect 2 0 13 0; +#X connect 3 0 13 0; +#X connect 6 0 13 0; +#X connect 7 0 13 0; +#X connect 8 0 13 0; +#X connect 9 0 13 0; +#X connect 10 0 13 0; +#X connect 11 0 13 0; diff --git a/doc/additional/pd-msg/1.msg_and_patch/1.1.add_objects.pd b/doc/additional/pd-msg/1.msg_and_patch/1.1.add_objects.pd new file mode 100755 index 00000000..f9ba0822 --- /dev/null +++ b/doc/additional/pd-msg/1.msg_and_patch/1.1.add_objects.pd @@ -0,0 +1,59 @@ +#N canvas 67 167 711 648 10;
+#X text 42 13 To add an object into patch just send a message to the
+patch itself :;
+#X msg 42 49 msg 500 10 bang;
+#X text 42 98 The selector should be "msg" \, "floatatom" \, "obj"
+\, "text" \, "array" \, "symbolatom" \, "scalar" and "graph";
+#X text 224 53 <= Click here first;
+#X text 42 279 For connecting objects use the selector "connect". it
+take 4 arguments : the number of the first object \, the number of
+the outlet \, the number of the second object \, and the number of
+the inlet :;
+#X text 207 232 <= and here;
+#X text 236 204 <= Then click here (and have a look to the properties
+of the object created);
+#X text 193 348 <= click here <= and here;
+#X text 42 437 And now the end of this exemple :;
+#X text 42 143 The next 2 numbers are X & Y position in the canvas.
+Then it's a symbol for the name of the obj \, the content of the msg
+\, etc... and some additionals parameters.;
+#X msg 42 205 floatatom 600 10 7 50 5000;
+#X msg 42 230 obj 500 40 metro 500;
+#X msg 42 482 obj 500 70 random 127;
+#X msg 42 532 floatatom 500 100 5;
+#X msg 42 582 text 500 130 That's it !;
+#X text 16 53 1;
+#X text 20 204 2;
+#X text 20 226 3;
+#X text 18 348 4;
+#X text 18 370 5;
+#X text 20 483 6;
+#X text 20 509 7;
+#X text 20 532 8;
+#X text 19 556 9;
+#X text 14 582 10;
+#X text 276 530 !!! W A R N N I N G !!! It's very important to respect
+the order the objects are created. If you don't the "connect" selector
+won't work correctly. If you are not sure \, reload this patch and
+try again.;
+#X msg 43 349 connect 34 0 36 0;
+#X msg 43 374 connect 35 0 36 1;
+#X msg 42 507 connect 36 0 37 0;
+#X msg 42 557 connect 37 0 38 0;
+#X obj 42 74 s pd-1.add_objects.pd;
+#X obj 42 255 s pd-1.add_objects.pd;
+#X obj 43 399 s pd-1.add_objects.pd;
+#X obj 42 612 s pd-1.add_objects.pd;
+#X connect 1 0 30 0;
+#X connect 10 0 31 0;
+#X connect 11 0 31 0;
+#X connect 12 0 33 0;
+#X connect 13 0 33 0;
+#X connect 14 0 33 0;
+#X connect 26 0 32 0;
+#X connect 27 0 32 0;
+#X connect 27 0 32 0;
+#X connect 27 0 32 0;
+#X connect 27 0 32 0;
+#X connect 28 0 33 0;
+#X connect 29 0 33 0;
diff --git a/doc/additional/pd-msg/1.msg_and_patch/1.2.create_patch.pd b/doc/additional/pd-msg/1.msg_and_patch/1.2.create_patch.pd new file mode 100755 index 00000000..2e422d5f --- /dev/null +++ b/doc/additional/pd-msg/1.msg_and_patch/1.2.create_patch.pd @@ -0,0 +1,29 @@ +#N canvas 181 410 915 475 10; +#X msg 38 150 msg 10 10 bang; +#X msg 38 198 obj 10 40 metro 500; +#X msg 38 174 floatatom 100 10 7 50 5000; +#X msg 38 270 obj 10 70 random 127; +#X msg 38 318 floatatom 10 100 5; +#X msg 38 366 text 10 130 That's it !; +#X msg 38 222 connect 0 0 2 0; +#X msg 38 246 connect 1 0 2 1; +#X msg 38 294 connect 2 0 3 0; +#X msg 38 342 connect 3 0 4 0; +#X text 205 37 click here first; +#X obj 38 404 s pd-new_patch; +#X text 33 13 This will create a sub patch in this windows and open +it :; +#X msg 33 37 obj 500 200 pd new_patch; +#X text 40 127 and then click here to fill it :; +#X obj 33 62 s pd-1.2.create_patch.pd; +#X connect 0 0 11 0; +#X connect 1 0 11 0; +#X connect 2 0 11 0; +#X connect 3 0 11 0; +#X connect 4 0 11 0; +#X connect 5 0 11 0; +#X connect 6 0 11 0; +#X connect 7 0 11 0; +#X connect 8 0 11 0; +#X connect 9 0 11 0; +#X connect 13 0 15 0; diff --git a/doc/additional/pd-msg/1.msg_and_patch/1.3.show_hide.pd b/doc/additional/pd-msg/1.msg_and_patch/1.3.show_hide.pd new file mode 100755 index 00000000..b0f866a0 --- /dev/null +++ b/doc/additional/pd-msg/1.msg_and_patch/1.3.show_hide.pd @@ -0,0 +1,9 @@ +#N canvas 198 107 383 241 10;
+#N canvas 209 154 262 142 my-subpatch 0;
+#X text 37 40 This is the sub patch;
+#X restore 215 98 pd my-subpatch;
+#X msg 33 62 \; pd-my-subpatch vis 1;
+#X msg 37 127 \; pd-my-subpatch vis 0;
+#X text 43 42 pop-up;
+#X text 40 109 close;
+#X text 13 17 pop-up and close a subpatch :;
diff --git a/doc/additional/pd-msg/1.msg_and_patch/2.menu.pd b/doc/additional/pd-msg/1.msg_and_patch/2.menu.pd new file mode 100755 index 00000000..7256ffe4 --- /dev/null +++ b/doc/additional/pd-msg/1.msg_and_patch/2.menu.pd @@ -0,0 +1,36 @@ +#N canvas 22 196 222 608 10; +#X text 17 121 GUI stuff; +#X msg 17 145 menusave; +#X msg 17 171 menusaveas; +#X msg 17 197 menuclose; +#X msg 17 223 saveto; +#X msg 17 249 tidy; +#X msg 17 275 texteditor; +#X msg 17 434 editmode \$1; +#X msg 35 408 0; +#X msg 69 408 1; +#X msg 17 460 print; +#X msg 17 301 menufont; +#X msg 17 353 findagain; +#X msg 17 379 findparent; +#X text 68 222 ?????; +#X msg 17 327 find test; +#X obj 17 496 s pd-2.menu.pd; +#X text 98 196 Warnning !!!; +#X text 15 14 Thoes msg will do exactly; +#X text 17 33 what the corresponding; +#X text 19 52 menu do.; +#X connect 1 0 16 0; +#X connect 2 0 16 0; +#X connect 3 0 16 0; +#X connect 4 0 16 0; +#X connect 5 0 16 0; +#X connect 6 0 16 0; +#X connect 7 0 16 0; +#X connect 8 0 7 0; +#X connect 9 0 7 0; +#X connect 10 0 16 0; +#X connect 11 0 16 0; +#X connect 12 0 16 0; +#X connect 13 0 16 0; +#X connect 15 0 16 0; diff --git a/doc/additional/pd-msg/1.msg_and_patch/3.0.events.pd b/doc/additional/pd-msg/1.msg_and_patch/3.0.events.pd new file mode 100755 index 00000000..f864ad40 --- /dev/null +++ b/doc/additional/pd-msg/1.msg_and_patch/3.0.events.pd @@ -0,0 +1,32 @@ +#N canvas 204 161 381 325 10; +#X msg 36 86 click \$1 \$2 \$3 \$4; +#X obj 111 182 key; +#X floatatom 111 208 0 0 0; +#X floatatom 50 184 0 0 0; +#X msg 50 158 0; +#X msg 6 6 bang; +#X text 56 41 left; +#X text 124 41 rigth; +#X text 70 4 Msg-dealing with events :; +#X text 89 28 click; +#X text 218 47 \$1 x; +#X text 219 65 \$2 y; +#X text 218 117 \$4 mod (0:nomod \; 1 shift \; 2 crtl \; 3 alt \; 4 +right click); +#X obj 36 290 s pd-3.0.events.pd; +#X text 218 86 \$3 (unuse ???); +#X msg 36 129 mouseup \$1 \$2 \$4; +#X msg 113 60 15 15 0 8; +#X msg 36 60 15 15 0 1; +#X text 59 232 \$1 number of the key; +#X msg 36 209 key 1 \$1; +#X msg 36 257 motion \$1 \$2 \$4; +#X connect 0 0 13 0; +#X connect 1 0 2 0; +#X connect 3 0 19 0; +#X connect 4 0 3 0; +#X connect 15 0 13 0; +#X connect 16 0 0 0; +#X connect 17 0 0 0; +#X connect 19 0 13 0; +#X connect 20 0 13 0; diff --git a/doc/additional/pd-msg/1.msg_and_patch/3.1.motion.pd b/doc/additional/pd-msg/1.msg_and_patch/3.1.motion.pd new file mode 100755 index 00000000..f281242f --- /dev/null +++ b/doc/additional/pd-msg/1.msg_and_patch/3.1.motion.pd @@ -0,0 +1,35 @@ +#N canvas 184 269 411 486 10; +#N canvas 654 338 332 294 testing 0; +#X obj 95 11 loadbang; +#X msg 95 36 0; +#X obj 12 37 random 127; +#X floatatom 66 94 0 0 0; +#X msg 12 11 bang; +#X connect 0 0 1 0; +#X connect 1 0 3 0; +#X connect 2 0 3 0; +#X connect 4 0 2 0; +#X restore 119 439 pd testing; +#X obj 20 438 s pd-testing; +#X obj 89 247 pack f f; +#X text 8 54 Start here; +#X floatatom 120 185 0 0 0; +#X floatatom 89 186 0 0 0; +#X obj 100 219 t b f; +#X text 7 363 Stop here; +#X text 85 154 try this !!!; +#X text 9 9 This example will show you how to use the motion msg.; +#X msg 20 101 click 15 15 0 0; +#X msg 89 271 motion \$1 \$2 0; +#X msg 20 390 motion 15 15 0 \, editmode 0 \, vis 0; +#X msg 20 75 vis 1 \, editmode 1 \, click 5 5 0 0 \, mouseup 200 200 +0; +#X connect 2 0 11 0; +#X connect 4 0 6 0; +#X connect 5 0 2 0; +#X connect 6 0 2 0; +#X connect 6 1 2 1; +#X connect 10 0 1 0; +#X connect 11 0 1 0; +#X connect 12 0 1 0; +#X connect 13 0 1 0; diff --git a/doc/additional/pd-msg/1.msg_and_patch/3.2.cut_paste.pd b/doc/additional/pd-msg/1.msg_and_patch/3.2.cut_paste.pd new file mode 100755 index 00000000..48db2a4f --- /dev/null +++ b/doc/additional/pd-msg/1.msg_and_patch/3.2.cut_paste.pd @@ -0,0 +1,55 @@ +#N canvas 175 194 409 473 10; +#N canvas 591 210 328 290 testing 0; +#X obj 95 10 loadbang; +#X msg 95 35 0; +#X obj 12 37 random 127; +#X floatatom 66 93 0 0 0; +#X msg 12 11 bang; +#X obj 95 10 loadbang; +#X msg 95 35 0; +#X obj 12 37 random 127; +#X floatatom 66 93 0 0 0; +#X msg 12 11 bang; +#X connect 0 0 1 0; +#X connect 1 0 3 0; +#X connect 2 0 3 0; +#X connect 4 0 2 0; +#X connect 5 0 6 0; +#X connect 6 0 8 0; +#X connect 7 0 8 0; +#X connect 9 0 7 0; +#X restore 315 439 pd testing; +#X obj 20 438 s pd-testing; +#X obj 248 211 pack f f; +#X text 7 40 Start here; +#X floatatom 279 149 0 0 0; +#X floatatom 248 148 0 0 0; +#X obj 259 183 t b f; +#X text 7 374 Stop here; +#X text 17 11 This example will show you how to use the motion msg. +; +#X msg 194 322 cut; +#X msg 194 348 duplicate; +#X msg 20 60 vis 1 \, editmode 1 \, click 5 5 0 0 \, mouseup 200 200 +0; +#X msg 20 399 motion 15 15 \, editmode0 \, vis 0; +#X text 50 81 show and select what's in the patch; +#X text 151 419 close all; +#X text 232 324 you can try thoses too.; +#X text 66 125 and then here to copy and here to move; +#X msg 31 256 mouseup 200 200 0; +#X text 49 236 to acheive the pasting; +#X msg 37 146 copy \, paste \, click 15 15 0 0; +#X msg 248 235 motion \$1 \$2 0; +#X connect 2 0 20 0; +#X connect 4 0 6 0; +#X connect 5 0 2 0; +#X connect 6 0 2 0; +#X connect 6 1 2 1; +#X connect 9 0 1 0; +#X connect 10 0 1 0; +#X connect 11 0 1 0; +#X connect 12 0 1 0; +#X connect 17 0 1 0; +#X connect 19 0 1 0; +#X connect 20 0 1 0; diff --git a/doc/additional/pd-msg/1.msg_and_patch/4.fonts.pd b/doc/additional/pd-msg/1.msg_and_patch/4.fonts.pd new file mode 100755 index 00000000..c7ee019b --- /dev/null +++ b/doc/additional/pd-msg/1.msg_and_patch/4.fonts.pd @@ -0,0 +1,24 @@ +#N canvas 43 70 405 234 10; +#X msg 12 26 menufont; +#X msg 32 64 font 10 100 100; +#X msg 32 88 font 14 100 100; +#X msg 30 114 font 24 100 100; +#X msg 158 86 50; +#X msg 198 86 200; +#X msg 158 112 font 10 100 \$1; +#X msg 274 84 50; +#X msg 314 84 200; +#X msg 274 112 font 10 \$1 100; +#X text 14 3 Here the list of all the messages dealing with fonts : +; +#X obj 14 196 s pd-4.fonts.pd; +#X connect 0 0 11 0; +#X connect 1 0 11 0; +#X connect 2 0 11 0; +#X connect 3 0 11 0; +#X connect 4 0 6 0; +#X connect 5 0 6 0; +#X connect 6 0 11 0; +#X connect 7 0 9 0; +#X connect 8 0 9 0; +#X connect 9 0 11 0; diff --git a/doc/additional/pd-msg/1.msg_and_patch/5.loadbang.pd b/doc/additional/pd-msg/1.msg_and_patch/5.loadbang.pd new file mode 100755 index 00000000..68d79b6a --- /dev/null +++ b/doc/additional/pd-msg/1.msg_and_patch/5.loadbang.pd @@ -0,0 +1,16 @@ +#N canvas 619 324 275 289 10; +#X msg 39 236 loadbang; +#X obj 62 122 loadbang; +#X msg 62 148 1; +#X floatatom 62 174 0 0 0; +#X obj 29 93 random 127; +#X msg 29 68 bang; +#X text 26 13 The loadbang message; +#X text 81 68 <= click here first; +#X text 118 234 <= then click here; +#X obj 39 262 s pd-5.loadbang.pd; +#X connect 0 0 9 0; +#X connect 1 0 2 0; +#X connect 2 0 3 0; +#X connect 4 0 3 0; +#X connect 5 0 4 0; diff --git a/doc/additional/pd-msg/2.msg_and_pd/1.pd_basic.pd b/doc/additional/pd-msg/2.msg_and_pd/1.pd_basic.pd new file mode 100755 index 00000000..48ec9f24 --- /dev/null +++ b/doc/additional/pd-msg/2.msg_and_pd/1.pd_basic.pd @@ -0,0 +1,15 @@ +#N canvas 312 164 378 475 10;
+#X text 20 51 turn DSP calculation off & on;
+#X msg 98 94 \; pd dsp 0 \;;
+#X msg 172 94 \; pd dsp 1 \;;
+#X msg 24 301 \; pd quit \;;
+#X floatatom 26 73 1 0 1;
+#X obj 26 123 s pd;
+#X msg 26 97 dsp \$1;
+#X msg 25 218 \; pd audiostatus \;;
+#X text 22 194 same as "DIO errors";
+#X text 25 12 Here some message we can send to pd.;
+#X text 21 275 Quit pd (WARNNING);
+#X text 21 356 There are many more that i don't know :-(;
+#X connect 4 0 6 0;
+#X connect 6 0 5 0;
diff --git a/doc/additional/pd-msg/2.msg_and_pd/2.open_close.pd b/doc/additional/pd-msg/2.msg_and_pd/2.open_close.pd new file mode 100755 index 00000000..6b0adabf --- /dev/null +++ b/doc/additional/pd-msg/2.msg_and_pd/2.open_close.pd @@ -0,0 +1,9 @@ +#N canvas 189 280 494 273 10;
+#X text 10 4 open and close an abstraction;
+#X text 23 85 (you have to put a corect name & valid path);
+#X text 25 114 close;
+#X text 26 30 open;
+#X msg 25 50 \; pd open your_abs.pd ./your_path \;;
+#X msg 26 135 \; pd pd-your_abs.pd menuclose \;;
+#X text 23 171 (you have to put a corect name & valid path);
+#X text 64 197 Those last 2 tricks came from Miller \, but i didn't succed to make them work. hope somebody will be more lucky.;
diff --git a/doc/additional/pd-msg/3.pdscript/README b/doc/additional/pd-msg/3.pdscript/README new file mode 100755 index 00000000..dbfc7054 --- /dev/null +++ b/doc/additional/pd-msg/3.pdscript/README @@ -0,0 +1,16 @@ +This is a short example how to "script" a pd patch
+with pd commands.
+
+First start pd
+# pd lisp.pd
+
+Then either start the automated shell script
+# ./test.sh
+
+or pipe the pd commands to pdsend directly:
+
+# pdsend 3005 < test.txt
+
+Read through text.txt for further explanations
+
+Guenter
diff --git a/doc/additional/pd-msg/3.pdscript/lisp.pd b/doc/additional/pd-msg/3.pdscript/lisp.pd new file mode 100755 index 00000000..34dfa190 --- /dev/null +++ b/doc/additional/pd-msg/3.pdscript/lisp.pd @@ -0,0 +1,2 @@ +#N canvas 417 30 252 94 10;
+#X obj 39 27 netreceive 3005 0 old;
diff --git a/doc/additional/pd-msg/3.pdscript/pdsend b/doc/additional/pd-msg/3.pdscript/pdsend Binary files differnew file mode 100755 index 00000000..cf6339e6 --- /dev/null +++ b/doc/additional/pd-msg/3.pdscript/pdsend diff --git a/doc/additional/pd-msg/3.pdscript/test.sh b/doc/additional/pd-msg/3.pdscript/test.sh new file mode 100755 index 00000000..107d3ec0 --- /dev/null +++ b/doc/additional/pd-msg/3.pdscript/test.sh @@ -0,0 +1,38 @@ +#!/bin/sh
+
+PORT=3005
+
+
+function setfreq()
+{
+./pdsend $PORT <<EOF
+freq $1 $2;
+EOF
+}
+
+#
+# Read in the script
+#
+./pdsend $PORT < test.txt
+
+sleep 3
+setfreq 220 5000
+sleep 5
+setfreq 1000 100
+sleep 1
+setfreq 100 50
+sleep 1
+setfreq 3000 1000
+sleep 1
+setfreq 100 1000
+sleep 1
+setfreq 3000 1000
+sleep 1
+setfreq 100 1000
+sleep 1
+setfreq 3000 1000
+sleep 1
+setfreq 100 1000
+# and so on
+
+
diff --git a/doc/additional/pd-msg/3.pdscript/test.txt b/doc/additional/pd-msg/3.pdscript/test.txt new file mode 100755 index 00000000..652bfed8 --- /dev/null +++ b/doc/additional/pd-msg/3.pdscript/test.txt @@ -0,0 +1,83 @@ +
+// create a new canvas with name "new";
+// important to terminate each command to pd with a ";";
+pd filename new ./;
+#N canvas;
+#X pop 1;
+
+// now we create a osc~ i, *~ and a dac~;
+// the first word is the name of the canvas where the objects;
+// are put (with "pd-" prepended .. hence pd-new);
+// then the "obj" keyword;
+// then comes the position x y, propose to increment y for each;
+// object by 30, then the patch can still be read with the gui ;
+// then comes the object name and eventual parameters;
+// object number 0 and 1 and 2;
+
+pd-new obj 10 0 osc~ 220;
+pd-new obj 10 30 *~ 0.1;
+pd-new obj 10 60 dac~;
+
+// we connect them together;
+// we kept track of the objects we have created and can;
+// access them via numbers;
+// pd-new same as above, message connect, then the four parameters;
+// <number-of object> <outlet number> <number of 2nd object> <inlet number>;
+
+pd-new connect 0 0 1 0;
+pd-new connect 1 0 2 0;
+pd-new connect 1 0 2 1;
+
+// we put a comment;
+// object number 3;
+pd-new text 80 0 This is a comment;
+
+// a Message object;
+// object number 4;
+
+pd-new msg 10 90 440;
+
+// connect it to the osc~;
+
+pd-new connect 4 0 0 0;
+
+// and a number object;
+// nr 5;
+
+pd-new floatatom 10 120;
+
+// connect it;
+
+pd-new connect 5 0 0 0;
+
+// put a communication channel for the frequency (a "receive");
+// nr 6;
+
+pd-new obj 10 150 r freq;
+// a line;
+// nr 7;
+pd-new obj 10 180 line;
+
+// connect receive to the line;
+
+pd-new connect 6 0 7 0;
+
+// line to the osc~;
+
+pd-new connect 7 0 0 0;
+
+// turn on audio;
+
+pd dsp 1;
+
+// and ... control it the first word is the name of the receive above;
+
+freq 500 4000;
+
+// that's it, there will be several things to figure out, but by writing;
+// this patch down in ascii I get the feeling that coding pd in lisp;
+// will be a killer ... defininitely.;
+// we will be able to automate lots of things I had to do by hand here;
+
+
+
diff --git a/doc/additional/pd-msg/4.msg_from_tcl/0.create_dummy_patch b/doc/additional/pd-msg/4.msg_from_tcl/0.create_dummy_patch new file mode 100755 index 00000000..030d0687 --- /dev/null +++ b/doc/additional/pd-msg/4.msg_from_tcl/0.create_dummy_patch @@ -0,0 +1,18 @@ +#!/usr/bin/wish -f
+
+#damien HENRY le 2001 07 14
+
+puts "***********************************************"
+puts "* This will create a patch in pure-data *"
+puts "* be sure that the recv.pd file is loadded *"
+puts "***********************************************"
+
+set to_pd [socket localhost 3006]
+
+puts $to_pd "pd-recv.pd obj 10 10 pd new_patch;"
+puts $to_pd "pd-new_patch msg 10 10 bang;"
+puts $to_pd "pd-new_patch msg 10 30 message;"
+puts $to_pd "pd-new_patch connect 0 0 1 0;"
+
+exit
+
diff --git a/doc/additional/pd-msg/4.msg_from_tcl/1.tcl2pd b/doc/additional/pd-msg/4.msg_from_tcl/1.tcl2pd new file mode 100755 index 00000000..883cc78e --- /dev/null +++ b/doc/additional/pd-msg/4.msg_from_tcl/1.tcl2pd @@ -0,0 +1,33 @@ +#!/usr/bin/wish -f
+
+#Here a small exemple that show how to send msg to pd from TCL.
+#damien HENRY
+#dh20010806
+
+puts "*********************"
+puts "* pd -nogui example *"
+puts "* (c) Damien HENRY *"
+puts "* This is GPL... *"
+puts "*********************"
+puts ""
+puts "WARNING : you need to run pd -open and load recv.pd first"
+
+#definition of the procedure that send msg to pd
+proc pd_send {string2send} {
+ set to_pd [socket localhost 3006]
+ puts $to_pd $string2send
+ .lmsg configure -text $string2send
+ close $to_pd
+}
+
+#create the gui
+wm title . "a simple tcl/tk gui msg-sender to pd"
+button .bsend -text "send to pd" -width 20 -command {pd_send "$pd_rcv $text2send;"}
+button .bq -text "quit" -width 20 -command {exit}
+entry .msg -textvariable text2send -width 30
+entry .pd_rcv -textvariable pd_rcv -width 10
+label .l1 -text "destination"
+label .l2 -text "msg to send"
+label .lmsg
+
+pack .l1 .pd_rcv .l2 .msg .lmsg .bsend .bq
\ No newline at end of file diff --git a/doc/additional/pd-msg/4.msg_from_tcl/2.nogui b/doc/additional/pd-msg/4.msg_from_tcl/2.nogui new file mode 100755 index 00000000..7911e4b5 --- /dev/null +++ b/doc/additional/pd-msg/4.msg_from_tcl/2.nogui @@ -0,0 +1,35 @@ +#!/usr/bin/wish -f
+
+#Here a small exemple that show a way to use the -nogui option.
+#damien HENRY
+#dh20010730
+
+puts "*********************"
+puts "* pd -nogui example *"
+puts "* (c) Damien HENRY *"
+puts "* This is GPL... *"
+puts "*********************"
+puts ""
+puts "WARNING : you need to run pd -open recv.pd -nogui first"
+
+#definition of the procedure that send msg to pd
+proc pd_send {string2send} {
+ set to_pd [socket localhost 3006]
+ puts $to_pd "$string2send;"
+ .lmsg configure -text "$string2send;"
+ close $to_pd
+}
+
+#create the gui
+wm title . "a simple tcl/tk gui to open pd-patch"
+label .l1 -text "open : patch & path"
+entry .pd_patch -textvariable pd_patch -width 23
+entry .pd_path -textvariable pd_path -width 23
+button .bload -text Load -width 20 -command {pd_send "pd open $pd_patch $pd_path" }
+button .bclose -text close -width 20 -command {pd_send "pd-$pd_patch menuclose" }
+button .bdspon -text "dsp on" -width 20 -command {pd_send "pd dsp 1" }
+button .bdspoff -text "dsp off" -width 20 -command {pd_send "pd dsp 0" }
+label .lmsg
+button .bq -text "quit" -width 20 -command {exit}
+
+pack .l1 .pd_patch .pd_path .bload .bclose .bdspon .bdspoff .lmsg .bq
\ No newline at end of file diff --git a/doc/additional/pd-msg/4.msg_from_tcl/2.nogui.txt b/doc/additional/pd-msg/4.msg_from_tcl/2.nogui.txt new file mode 100755 index 00000000..6bac6017 --- /dev/null +++ b/doc/additional/pd-msg/4.msg_from_tcl/2.nogui.txt @@ -0,0 +1,12 @@ +This small example show an easy way to use pd without the classical gui.
+
+
+0) run pd -open recv.pd -nogui
+1) run 2.nogui (use wish83 if you are under win xx)
+2) chose an abstraction to open, for example test.pd (in this folder)
+3) turn the dsp on
+4) here you can listen to your abstraction !!!
+
+Enjoy !!!
+
+Damien HENRY.
diff --git a/doc/additional/pd-msg/4.msg_from_tcl/recv.pd b/doc/additional/pd-msg/4.msg_from_tcl/recv.pd new file mode 100755 index 00000000..554ab101 --- /dev/null +++ b/doc/additional/pd-msg/4.msg_from_tcl/recv.pd @@ -0,0 +1,5 @@ +#N canvas 357 509 628 150 10;
+#X obj 453 26 netreceive 3006 0 old;
+#X text 32 10 This patch is here to receive the commands sended by tcl scripts;
+#X text 27 66 Execute the tcl files in 4.msg_from_tcl. (use wish83if your under Win xx);
+#X text 25 92 Have a look to the TCL source to understand how does this work.;
diff --git a/doc/additional/pd-msg/4.msg_from_tcl/test.pd b/doc/additional/pd-msg/4.msg_from_tcl/test.pd new file mode 100755 index 00000000..0cf63b09 --- /dev/null +++ b/doc/additional/pd-msg/4.msg_from_tcl/test.pd @@ -0,0 +1,9 @@ +#N canvas 357 509 468 150 10;
+#X text 18 101 Have a look to the TCL source to understand how does this work.;
+#X text 32 10 This patch is here to test the 2.nogui script;
+#X obj 35 32 osc~ 440;
+#X obj 34 82 dac~;
+#X obj 35 56 /~ 50;
+#X connect 2 0 4 0;
+#X connect 4 0 3 0;
+#X connect 4 0 3 1;
diff --git a/doc/additional/pd-msg/5.examples/1.polyphonie.pd b/doc/additional/pd-msg/5.examples/1.polyphonie.pd new file mode 100755 index 00000000..3f44cf03 --- /dev/null +++ b/doc/additional/pd-msg/5.examples/1.polyphonie.pd @@ -0,0 +1,99 @@ +#N canvas 96 191 894 406 10; +#X obj 486 176 s as_b; +#X floatatom 542 147 0 0 0; +#X obj 542 171 s as_f; +#X floatatom 617 150 0 0 0; +#X obj 617 174 s as_bw; +#X msg 486 107 127; +#X msg 486 130 1; +#X msg 486 154 10; +#X obj 93 110 float; +#X obj 147 110 + 1; +#X obj 93 155 select 1; +#X obj 34 128 delay 0; +#X msg 93 45 bang; +#X floatatom 486 201 0 0 0; +#X obj 486 225 s as_sl; +#X obj 93 68 t b 0; +#X text 541 128 mean freq.; +#X text 616 130 freq. bandwith; +#X text 530 203 time for change (log); +#X text 488 87 % of osc that will change; +#X msg 745 80 127 50 13 74; +#X obj 745 177 unpack f f f f; +#X msg 745 101 127 0 75 127; +#X msg 745 60 127 127 6 127; +#X text 745 38 examples...; +#X obj 93 134 < 100; +#X text 85 -4 kill Asound in the upper left corner to removes all the +osc.; +#X msg 745 124 127 64 64 127; +#X text 487 50 the controler :; +#X obj 807 204 s as_f; +#X obj 838 225 s as_bw; +#X text 95 345 this msg do all the job !!!; +#X text 532 106 <= ACTIVE INLET !!!; +#X text 95 21 FIRST; +#X text 303 20 SECOND; +#X msg 745 147 127 0 0 10; +#X obj 745 203 s as_b; +#X obj 776 225 s as_sl; +#X obj 245 220 float; +#X obj 299 220 + 1; +#X obj 245 265 select 1; +#X obj 186 238 delay 0; +#X msg 245 155 bang; +#X obj 245 178 t b 0; +#X obj 245 244 < 100; +#X text 135 60 100 asound patch; +#X text 137 46 this will load; +#X text 289 171 100 asound patch; +#X text 289 156 this will remove the; +#X msg 92 300 \; pd-1.polyphonie.pd obj 10 10 asound \;; +#X msg 375 464 editmode \$1; +#X msg 361 284 \; pd-1.polyphonie.pd editmode 1 \; pd-1.polyphonie.pd +click 12 12 1 1 \; pd-1.polyphonie.pd cut \; pd-1.polyphonie.pd editmode +0 \;; +#X msg 306 54 1; +#X msg 341 55 0; +#X text 285 37 turn on and off all asound; +#X text 744 24 FIRD; +#X text 300 186 if created \, if not...; +#X obj 306 79 switch~; +#X connect 1 0 2 0; +#X connect 3 0 4 0; +#X connect 5 0 0 0; +#X connect 6 0 0 0; +#X connect 7 0 0 0; +#X connect 8 0 9 0; +#X connect 8 0 25 0; +#X connect 9 0 8 1; +#X connect 10 0 49 0; +#X connect 10 0 11 0; +#X connect 11 0 8 0; +#X connect 12 0 15 0; +#X connect 13 0 14 0; +#X connect 15 0 8 0; +#X connect 15 1 8 0; +#X connect 20 0 21 0; +#X connect 21 0 36 0; +#X connect 21 1 37 0; +#X connect 21 2 29 0; +#X connect 21 3 30 0; +#X connect 22 0 21 0; +#X connect 23 0 21 0; +#X connect 25 0 10 0; +#X connect 27 0 21 0; +#X connect 35 0 21 0; +#X connect 38 0 39 0; +#X connect 38 0 44 0; +#X connect 39 0 38 1; +#X connect 40 0 41 0; +#X connect 40 0 51 0; +#X connect 41 0 38 0; +#X connect 42 0 43 0; +#X connect 43 0 38 0; +#X connect 43 1 38 0; +#X connect 44 0 40 0; +#X connect 52 0 57 0; +#X connect 53 0 57 0; diff --git a/doc/additional/pd-msg/5.examples/2.create_new_abstract.pd b/doc/additional/pd-msg/5.examples/2.create_new_abstract.pd new file mode 100755 index 00000000..2c1f844a --- /dev/null +++ b/doc/additional/pd-msg/5.examples/2.create_new_abstract.pd @@ -0,0 +1,29 @@ +#N canvas 228 85 505 524 10;
+#X msg 77 224 msg 10 10 bang;
+#X msg 77 272 obj 10 40 metro 500;
+#X msg 77 248 floatatom 100 10 7 50 5000;
+#X msg 77 344 obj 10 70 random 127;
+#X msg 77 392 floatatom 10 100 5;
+#X msg 78 440 text 10 130 That's it !;
+#X obj 30 475 s pd-new;
+#X msg 77 296 connect 0 0 2 0;
+#X msg 77 319 connect 1 0 2 1;
+#X msg 77 368 connect 2 0 3 0;
+#X msg 77 416 connect 3 0 4 0;
+#X msg 40 79 \; pd filename new ./ \; #N canvas \; #X pop 1 \;;
+#X text 53 59 click here first;
+#X text 28 176 And then we fill it with the way describe in 1.add_objects.pd;
+#X text 26 15 This describe how to create a new abstraction :;
+#X msg 290 457 menuclose;
+#X text 294 483 this will kill it !;
+#X connect 0 0 6 0;
+#X connect 1 0 6 0;
+#X connect 2 0 6 0;
+#X connect 3 0 6 0;
+#X connect 4 0 6 0;
+#X connect 5 0 6 0;
+#X connect 7 0 6 0;
+#X connect 8 0 6 0;
+#X connect 9 0 6 0;
+#X connect 10 0 6 0;
+#X connect 15 0 6 0;
diff --git a/doc/additional/pd-msg/5.examples/asound.pd b/doc/additional/pd-msg/5.examples/asound.pd new file mode 100755 index 00000000..601726d3 --- /dev/null +++ b/doc/additional/pd-msg/5.examples/asound.pd @@ -0,0 +1,52 @@ +#N canvas 220 255 452 479 10; +#X obj 105 408 osc~; +#X obj 105 332 mtof; +#X obj 105 459 dac~; +#X obj 105 432 /~ 100; +#X obj 122 91 random 127; +#X obj 106 30 r as_b; +#X obj 106 140 select 1; +#X obj 106 115 >; +#X obj 106 52 t f b; +#X obj 106 164 t b b; +#X obj 105 308 +; +#X obj 105 256 -; +#X obj 56 224 *; +#X obj 173 225 *; +#X obj 173 199 random 100000; +#X obj 56 198 random 100000; +#X obj 105 283 / 100000; +#X obj 155 262 r as_f; +#X obj 100 225 r as_bw; +#X obj 105 382 line~; +#X obj 105 357 pack f f; +#X obj 221 282 r as_sl; +#X obj 221 305 mtof; +#X text 12 7 This patch is to illustrate how to use contructions msg +for polyphonie; +#X connect 0 0 3 0; +#X connect 1 0 20 0; +#X connect 3 0 2 0; +#X connect 3 0 2 1; +#X connect 4 0 7 1; +#X connect 5 0 8 0; +#X connect 6 0 9 0; +#X connect 7 0 6 0; +#X connect 8 0 7 0; +#X connect 8 1 4 0; +#X connect 9 0 15 0; +#X connect 9 1 14 0; +#X connect 10 0 1 0; +#X connect 11 0 16 0; +#X connect 12 0 11 0; +#X connect 13 0 11 1; +#X connect 14 0 13 0; +#X connect 15 0 12 0; +#X connect 16 0 10 0; +#X connect 17 0 10 1; +#X connect 18 0 13 1; +#X connect 18 0 12 1; +#X connect 19 0 0 0; +#X connect 20 0 19 0; +#X connect 21 0 22 0; +#X connect 22 0 20 1; |