diff options
Diffstat (limited to 'doc')
-rw-r--r-- | doc/tutorials/intro/0.all_just_data.pd | 2 | ||||
-rw-r--r-- | doc/tutorials/intro/0.bang.pd | 22 | ||||
-rw-r--r-- | doc/tutorials/intro/0.connections.pd | 17 | ||||
-rw-r--r-- | doc/tutorials/intro/0.controlling_dsp_processing.pd | 28 | ||||
-rw-r--r-- | doc/tutorials/intro/0.execution_order.pd | 16 | ||||
-rw-r--r-- | doc/tutorials/intro/0.exercise-template.pd | 95 | ||||
-rw-r--r-- | doc/tutorials/intro/0.hello_world.pd | 13 | ||||
-rw-r--r-- | doc/tutorials/intro/0.hot_and_cold_inlets.pd | 43 | ||||
-rw-r--r-- | doc/tutorials/intro/0.init_to_0.pd | 33 | ||||
-rw-r--r-- | doc/tutorials/intro/0.inlets_and_outlets.pd | 20 | ||||
-rw-r--r-- | doc/tutorials/intro/0.pure_data_files.pd | 76 | ||||
-rw-r--r-- | doc/tutorials/intro/0.right_to_left_order.pd | 24 | ||||
-rw-r--r-- | doc/tutorials/intro/0.shell_sketch.pd | 16 | ||||
-rw-r--r-- | doc/tutorials/intro/0.storage_objects.pd | 41 | ||||
-rw-r--r-- | doc/tutorials/intro/TODO | 6 |
15 files changed, 452 insertions, 0 deletions
diff --git a/doc/tutorials/intro/0.all_just_data.pd b/doc/tutorials/intro/0.all_just_data.pd new file mode 100644 index 00000000..1c9367a4 --- /dev/null +++ b/doc/tutorials/intro/0.all_just_data.pd @@ -0,0 +1,2 @@ +#N canvas 0 22 454 304 10; +#X text 152 35 Its all just data.; diff --git a/doc/tutorials/intro/0.bang.pd b/doc/tutorials/intro/0.bang.pd new file mode 100644 index 00000000..06efcf8d --- /dev/null +++ b/doc/tutorials/intro/0.bang.pd @@ -0,0 +1,22 @@ +#N canvas 435 180 493 371 10; +#X text 164 19 bang; +#X text 27 47 In Pd \, "bang" means "do something". What that "something" +is depends on the object receiving the bang.; +#X obj 34 121 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 36 283 bng 25 250 50 0 empty empty do_it! -2 -8 1 10 -24198 +-1 -1; +#X obj 38 318 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1 +; +#X obj 34 150 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1 +; +#X msg 35 196 bang; +#X obj 35 221 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1 +; +#X text 56 119 <--bang button; +#X text 79 197 <--you can also send "bang" using a message box; +#X text 77 282 <-- bang buttons have configurable properties \, like +color \, labels \, fonts \, size \, etc.; +#X connect 2 0 5 0; +#X connect 3 0 4 0; +#X connect 6 0 7 0; diff --git a/doc/tutorials/intro/0.connections.pd b/doc/tutorials/intro/0.connections.pd new file mode 100644 index 00000000..8c29ddf8 --- /dev/null +++ b/doc/tutorials/intro/0.connections.pd @@ -0,0 +1,17 @@ +#N canvas 505 182 454 304 10; +#X text 41 27 Pd patches are always running and changes take effect +immediately.; +#X obj 364 241 dac~; +#X obj 373 186 osc~ 500; +#X floatatom 67 181 5 0 0 0 - - -; +#X floatatom 67 245 5 0 0 0 - - -; +#X obj 107 64 tgl 30 0 empty empty start 2 15 1 12 -24198 -1 -1 1 1 +; +#X msg 141 106 \; pd dsp \$1; +#X obj 66 106 metro 100; +#X obj 66 127 random 100; +#X text 97 214 <-- connect these \, then disconnect -->; +#X connect 5 0 6 0; +#X connect 5 0 7 0; +#X connect 7 0 8 0; +#X connect 8 0 3 0; diff --git a/doc/tutorials/intro/0.controlling_dsp_processing.pd b/doc/tutorials/intro/0.controlling_dsp_processing.pd new file mode 100644 index 00000000..f2186726 --- /dev/null +++ b/doc/tutorials/intro/0.controlling_dsp_processing.pd @@ -0,0 +1,28 @@ +#N canvas 361 163 471 494 10; +#X text 117 189 (screenshot of main Pd window); +#X msg 26 288 \; pd dsp 1; +#X msg 93 288 \; pd dsp 0; +#X text 19 252 As with most programming languages \, in Pd "1" means +on \, and "0" means off.; +#X obj 210 283 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 +1; +#X msg 209 308 \; pd dsp \$1; +#X text 28 137 To see whether the DSP is on or off \, look at the checkbox +on the main Pd window. You can also turn the DSP on and off using that +checkbox.; +#X obj 344 343 osc~ 250; +#X obj 330 375 dac~; +#X text 24 20 You can turn the processing of audio data on and off. +In order for your patch to run \, you need to make sure that "compute +audio" is turned on. This is also known as the "DSP". There are a couple +ways of turning the "DSP" on and off.; +#X text 23 100 - TODO: is Gem or PDP computation also controlled by +the DSP?; +#X text 23 407 There are also keyboard shortcuts:; +#X text 34 459 (On MacOS X \, you can also use Cmd-. and Cmd-/); +#X text 41 425 off: Ctrl-.; +#X text 48 440 on: Ctrl-/; +#X text 73 84 - TODO: messages are always processed; +#X connect 4 0 5 0; +#X connect 7 0 8 0; +#X connect 7 0 8 1; diff --git a/doc/tutorials/intro/0.execution_order.pd b/doc/tutorials/intro/0.execution_order.pd new file mode 100644 index 00000000..de421b11 --- /dev/null +++ b/doc/tutorials/intro/0.execution_order.pd @@ -0,0 +1,16 @@ +#N canvas 0 22 458 308 10; +#X text 150 11 execution order; +#X obj 77 78 trigger b f a; +#X text 58 140 audio is simultaneous; +#X obj 69 186 osc~ 500; +#X obj 91 229 *~; +#X obj 78 255 dac~; +#X obj 108 208 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 +1; +#X text 63 33 execution order is "undefined".; +#X text 41 54 If you need to specify execution order \, using [trigger]: +; +#X connect 3 0 4 0; +#X connect 4 0 5 1; +#X connect 4 0 5 0; +#X connect 6 0 4 1; diff --git a/doc/tutorials/intro/0.exercise-template.pd b/doc/tutorials/intro/0.exercise-template.pd new file mode 100644 index 00000000..6250c858 --- /dev/null +++ b/doc/tutorials/intro/0.exercise-template.pd @@ -0,0 +1,95 @@ +#N canvas 552 273 483 299 10; +#N canvas 414 102 546 555 guts 0; +#X msg 280 45 \; pd filename exercise-patch.pd /tmp \; #N canvas \; +#X pop 1 \;; +#X obj 300 328 s pd-exercise-patch.pd; +#X msg 329 216 obj 50 103 osc~; +#X msg 330 240 obj 50 153 dac~; +#X obj 103 17 inlet; +#X msg 320 155 clear; +#X obj 276 7 loadbang; +#X obj 259 108 delay 1000; +#X obj 259 129 t b b b b; +#X msg 52 155 connect 0 0 1 0; +#X msg 37 216 connect 1 0 2 0; +#X msg 31 266 connect 1 0 2 1; +#X msg 292 27 \; pd dsp 1; +#X obj 112 108 t b b; +#X msg 87 52 bang; +#X obj 34 134 delay 2000; +#X obj 21 187 delay 2000; +#X obj 10 245 delay 2000; +#N canvas 261 307 459 387 connection-effect 0; +#X obj 186 312 dac~; +#X obj 72 233 osc~ 1000; +#X obj 138 266 *~; +#X obj 253 259 *~; +#X obj 204 236 osc~ 800; +#X obj 153 236 line~; +#X obj 183 7 inlet; +#X msg 184 31 bang; +#X obj 187 61 t b b; +#X obj 168 95 delay 10; +#X msg 201 125 0 10; +#X obj 276 218 line~; +#X obj 276 191 pipe 30; +#X msg 241 125 1 10; +#X connect 1 0 2 0; +#X connect 2 0 0 0; +#X connect 3 0 0 1; +#X connect 4 0 3 0; +#X connect 5 0 2 1; +#X connect 6 0 7 0; +#X connect 7 0 8 0; +#X connect 8 0 9 0; +#X connect 8 1 13 0; +#X connect 9 0 10 0; +#X connect 10 0 5 0; +#X connect 10 0 12 0; +#X connect 11 0 3 1; +#X connect 12 0 11 0; +#X connect 13 0 5 0; +#X connect 13 0 12 0; +#X restore 22 365 pd connection-effect; +#X msg 256 453 floatatom 50 50 5 0 0 0; +#X msg 327 184 obj 50 50 hsl; +#X obj 197 18 inlet; +#X msg 205 50 bang; +#X connect 2 0 1 0; +#X connect 3 0 1 0; +#X connect 4 0 14 0; +#X connect 5 0 1 0; +#X connect 6 0 0 0; +#X connect 6 0 7 0; +#X connect 6 0 12 0; +#X connect 7 0 8 0; +#X connect 8 0 3 0; +#X connect 8 1 2 0; +#X connect 8 2 20 0; +#X connect 8 3 5 0; +#X connect 9 0 1 0; +#X connect 10 0 1 0; +#X connect 11 0 1 0; +#X connect 13 0 15 0; +#X connect 13 1 8 0; +#X connect 14 0 13 0; +#X connect 15 0 16 0; +#X connect 15 0 9 0; +#X connect 15 0 18 0; +#X connect 16 0 17 0; +#X connect 16 0 10 0; +#X connect 16 0 18 0; +#X connect 17 0 11 0; +#X connect 17 0 18 0; +#X connect 20 0 1 0; +#X connect 21 0 22 0; +#X connect 22 0 8 0; +#X restore 290 216 pd guts; +#X msg 290 185 solve; +#X text 53 28 In the exercise patch \, connect the existing objects +so that you can control the frequency of the oscillator and hear the +resulting sound.; +#X text 84 88 If you want help \, click the solve message below.; +#X msg 346 184 try again; +#X connect 1 0 0 0; +#X connect 4 0 0 1; diff --git a/doc/tutorials/intro/0.hello_world.pd b/doc/tutorials/intro/0.hello_world.pd new file mode 100644 index 00000000..1f696c8f --- /dev/null +++ b/doc/tutorials/intro/0.hello_world.pd @@ -0,0 +1,13 @@ +#N canvas 228 159 497 433 10; +#X msg 144 98 Hello world!; +#X obj 143 144 print; +#X text 235 99 <-- message box; +#X text 149 121 <-- connection \, aka "cord"; +#X text 18 28 In Pd \, programming is done with boxes which are connected +together. The boxes have "inlets" and "outlets" \, where they are connected. +; +#X text 80 137 inlet-->; +#X text 85 90 inlet-->; +#X text 77 106 outlet-->; +#X text 185 144 <-- object box; +#X connect 0 0 1 0; diff --git a/doc/tutorials/intro/0.hot_and_cold_inlets.pd b/doc/tutorials/intro/0.hot_and_cold_inlets.pd new file mode 100644 index 00000000..bb8a674c --- /dev/null +++ b/doc/tutorials/intro/0.hot_and_cold_inlets.pd @@ -0,0 +1,43 @@ +#N canvas 631 161 491 539 10; +#X text 123 18 "hot" and "cold" inlets; +#X obj 28 222 +; +#X floatatom 28 251 5 0 0 0 - - -; +#X msg 28 158 1; +#X msg 45 194 5; +#X text 23 50 For most objects in Pd \, the leftmost inlet is the "hot" +inlet. This means that it will output something whenever it receives +data on the "hot" inlet.; +#X text 24 99 All other inlets are generally "cold" inlets \, which +merely store the data they receive until input on the "hot" inlet causes +the object to do its thing.; +#X text 74 195 2) click this and there will be no new output; +#X text 74 157 1) click this first \, and [+ ] immediately ouptputs +a 1; +#X obj 190 396 +; +#X floatatom 190 425 5 0 0 0 - - -; +#X msg 113 331 1; +#X text 28 304 Try a number of different combinations to see for yourself: +; +#X text 223 390 <-- "cold" inlet; +#X text 72 390 "hot" inlet -->; +#X msg 143 331 2; +#X msg 173 331 3; +#X msg 253 331 4; +#X msg 283 331 5; +#X msg 313 331 6; +#X text 74 227 3) now click the [1( message box \, and you get a new +output; +#X text 31 458 Notice that the number is stored in the "cold" inlet +until you change it. For example \, if you click [4( \, then click +[1( \, [2( \, and [3( \, you will see that 1 \, 2 \, and 3 are all +added to 4; +#X connect 1 0 2 0; +#X connect 3 0 1 0; +#X connect 4 0 1 1; +#X connect 9 0 10 0; +#X connect 11 0 9 0; +#X connect 15 0 9 0; +#X connect 16 0 9 0; +#X connect 17 0 9 1; +#X connect 18 0 9 1; +#X connect 19 0 9 1; diff --git a/doc/tutorials/intro/0.init_to_0.pd b/doc/tutorials/intro/0.init_to_0.pd new file mode 100644 index 00000000..5ad96a65 --- /dev/null +++ b/doc/tutorials/intro/0.init_to_0.pd @@ -0,0 +1,33 @@ +#N canvas 707 44 458 308 10; +#X text 41 16 float values are automatically initialized to 0 in Pd. +; +#X obj 4 114 +; +#X obj 5 81 bng 15 250 50 0 empty empty empty 0 -6 0 8 -24198 -1 -1 +; +#X obj 118 114 *; +#X obj 227 113 float; +#X obj 347 113 trigger f; +#X obj 178 151 bng 15 250 50 0 empty empty reset 0 -6 0 8 -262144 -1 +-1; +#X obj 4 188 pddp_print; +#X obj 117 187 pddp_print; +#X obj 227 187 pddp_print; +#X obj 347 187 pddp_print; +#X obj 117 81 bng 15 250 50 0 empty empty empty 0 -6 0 8 -24198 -1 +-1; +#X obj 226 81 bng 15 250 50 0 empty empty empty 0 -6 0 8 -24198 -1 +-1; +#X obj 346 81 bng 15 250 50 0 empty empty empty 0 -6 0 8 -24198 -1 +-1; +#X connect 1 0 7 0; +#X connect 2 0 1 0; +#X connect 3 0 8 0; +#X connect 4 0 9 0; +#X connect 5 0 10 0; +#X connect 6 0 7 0; +#X connect 6 0 8 0; +#X connect 6 0 9 0; +#X connect 6 0 10 0; +#X connect 11 0 3 0; +#X connect 12 0 4 0; +#X connect 13 0 5 0; diff --git a/doc/tutorials/intro/0.inlets_and_outlets.pd b/doc/tutorials/intro/0.inlets_and_outlets.pd new file mode 100644 index 00000000..35b9d13e --- /dev/null +++ b/doc/tutorials/intro/0.inlets_and_outlets.pd @@ -0,0 +1,20 @@ +#N canvas 128 360 462 312 10; +#X obj 213 114 inlet; +#X obj 213 146 outlet; +#X text 110 26 inlets and outlets; +#X text 37 70 You connect Pd objects using their inlets and outlets. +; +#N canvas 0 22 454 304 object 0; +#X obj 175 99 inlet; +#X obj 174 206 outlet; +#X connect 0 0 1 0; +#X restore 41 117 pd object; +#X text 39 219 Connections are always made from the inlet to the outlet +since that always the direction that the data flows.; +#N canvas 0 22 454 304 another 0; +#X obj 175 99 inlet; +#X obj 174 206 outlet; +#X connect 0 0 1 0; +#X restore 40 147 pd another object; +#X text 38 258 Try making connections yourself.; +#X connect 4 0 6 0; diff --git a/doc/tutorials/intro/0.pure_data_files.pd b/doc/tutorials/intro/0.pure_data_files.pd new file mode 100644 index 00000000..2f7427e7 --- /dev/null +++ b/doc/tutorials/intro/0.pure_data_files.pd @@ -0,0 +1,76 @@ +#N canvas 19 110 649 545 10; +#X obj 191 209 textfile; +#X obj 111 239 print all; +#X msg 137 164 bang; +#X msg 191 163 rewind; +#X obj 131 307 route canvas; +#X obj 112 434 print width; +#X obj 51 385 print Xpos; +#X obj 81 410 print Ypos; +#X obj 143 459 print heigth; +#X obj 174 384 print fontsize; +#X obj 51 354 unpack f f f f f; +#X text 35 17 As much as possible \, every message in Pd uses the same +format \, hence the name "pure data".; +#X text 53 78 Here is a patch that reads the file of this patch:; +#X msg 272 167 read 0.pure_data_files.pd; +#N canvas 0 22 557 556 clone 1; +#X obj 191 209 textfile; +#X obj 111 239 print all; +#X msg 137 164 bang; +#X msg 191 163 rewind; +#X obj 131 307 route canvas; +#X obj 112 434 print width; +#X obj 51 385 print Xpos; +#X obj 81 410 print Ypos; +#X obj 143 459 print heigth; +#X obj 174 384 print fontsize; +#X obj 51 354 unpack f f f f f; +#X text 35 17 As much as possible \, every message in Pd uses the same +format \, hence the name "pure data".; +#X text 53 78 Here is a patch that reads the file of this patch:; +#X msg 272 167 read 0.pure_data_files.pd; +#X obj 356 405 s pd-clone; +#X obj 191 234 route #N #X; +#X obj 138 135 metro 1000; +#X obj 271 115 loadbang; +#X obj 138 109 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 +1; +#X obj 363 295 loadbang; +#X msg 359 319 vis 1 \, clear; +#X connect 0 0 1 0; +#X connect 0 0 16 0; +#X connect 2 0 0 0; +#X connect 3 0 0 0; +#X connect 4 0 10 0; +#X connect 10 0 6 0; +#X connect 10 1 7 0; +#X connect 10 2 5 0; +#X restore 430 484 pd clone; +#X obj 356 405 s pd-clone; +#X obj 191 234 route #N #X; +#X obj 138 135 metro 1000; +#X obj 271 115 loadbang; +#X obj 138 109 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 1 +1; +#X obj 363 295 loadbang; +#X msg 359 319 vis 1 \, clear; +#X connect 0 0 1 0; +#X connect 0 0 16 0; +#X connect 2 0 0 0; +#X connect 3 0 0 0; +#X connect 4 0 10 0; +#X connect 10 0 6 0; +#X connect 10 1 7 0; +#X connect 10 2 5 0; +#X connect 10 3 8 0; +#X connect 10 4 9 0; +#X connect 13 0 0 0; +#X connect 16 0 4 0; +#X connect 16 1 15 0; +#X connect 17 0 2 0; +#X connect 18 0 13 0; +#X connect 18 0 3 0; +#X connect 19 0 17 0; +#X connect 20 0 21 0; +#X connect 21 0 15 0; diff --git a/doc/tutorials/intro/0.right_to_left_order.pd b/doc/tutorials/intro/0.right_to_left_order.pd new file mode 100644 index 00000000..b484cd7f --- /dev/null +++ b/doc/tutorials/intro/0.right_to_left_order.pd @@ -0,0 +1,24 @@ +#N canvas 427 300 455 442 10; +#X text 19 12 In Pd \, you read a patch from right to left \, from +top to bottom.; +#X text 18 47 The [trigger] object is used to enforce execution order. +If you need things to run in a certain order \, then you use a [trigger]. +; +#X obj 74 117 bng 25 250 50 0 empty empty empty -2 -8 1 10 -24198 -1 +-1; +#X obj 74 151 trigger bang bang bang; +#X obj 85 257 +; +#X obj 136 233 +; +#X msg 197 198 1; +#X msg 127 197 2; +#X msg 78 196 3; +#X floatatom 86 280 5 0 0 0 - - -; +#X connect 2 0 3 0; +#X connect 3 0 8 0; +#X connect 3 1 7 0; +#X connect 3 2 6 0; +#X connect 4 0 9 0; +#X connect 5 0 4 1; +#X connect 6 0 5 1; +#X connect 7 0 5 0; +#X connect 8 0 4 0; diff --git a/doc/tutorials/intro/0.shell_sketch.pd b/doc/tutorials/intro/0.shell_sketch.pd new file mode 100644 index 00000000..31cffaa6 --- /dev/null +++ b/doc/tutorials/intro/0.shell_sketch.pd @@ -0,0 +1,16 @@ +#N canvas 369 214 524 457 10; +#X obj 92 138 soundfiler; +#X obj 228 139 getdir; +#X obj 168 319 shell; +#X obj 169 373 print; +#X obj 233 98 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 191 253 t a a; +#X obj 225 275 print; +#X msg 169 220 ls -1 "$1"; +#X connect 1 0 7 0; +#X connect 2 0 3 0; +#X connect 4 0 1 0; +#X connect 5 0 2 0; +#X connect 5 1 6 0; +#X connect 7 0 5 0; diff --git a/doc/tutorials/intro/0.storage_objects.pd b/doc/tutorials/intro/0.storage_objects.pd new file mode 100644 index 00000000..3d66e814 --- /dev/null +++ b/doc/tutorials/intro/0.storage_objects.pd @@ -0,0 +1,41 @@ +#N canvas 277 67 501 498 10; +#X text 157 15 storage objects; +#X obj 159 66 symbol; +#X obj 117 66 bang; +#X obj 280 66 f; +#X obj 215 66 float; +#X text 255 66 aka; +#X text 88 35 A storage object stores a value.; +#X text 26 361 If a storage object receives a value on the left inlet +\, then it outputs that value immediately in addition to storing it. +; +#X text 25 231 If a storage object receives a value on the right inlet +\, then it stores that value.; +#X text 18 100 If you bang the left inlet of a storage object \, it +outputs its stored value.; +#X obj 177 142 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 177 192 pddp_print; +#X obj 177 165 float; +#X obj 166 274 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X obj 180 325 pddp_print; +#X obj 180 298 float; +#X msg 193 274 123; +#X obj 180 455 pddp_print; +#X obj 180 428 float; +#X msg 210 403 123; +#X msg 180 403 432; +#X obj 159 404 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1 +-1; +#X msg 225 274 321; +#X connect 10 0 12 0; +#X connect 12 0 11 0; +#X connect 13 0 15 0; +#X connect 15 0 14 0; +#X connect 16 0 15 1; +#X connect 18 0 17 0; +#X connect 19 0 18 1; +#X connect 20 0 18 0; +#X connect 21 0 18 0; +#X connect 22 0 15 1; diff --git a/doc/tutorials/intro/TODO b/doc/tutorials/intro/TODO new file mode 100644 index 00000000..3dbf1ad0 --- /dev/null +++ b/doc/tutorials/intro/TODO @@ -0,0 +1,6 @@ + + +- make object which outputs previous and next files + +- make patch close itself, otherwise: + - upon [loadbang], wait, then close previous patch |