made the first series on intros, many left to add...

svn path=/trunk/; revision=4794

12 files changed, 228 insertions, 122 deletions

diff --git a/doc/tutorials/intro/0.all_just_data.pd b/doc/tutorials/intro/0.all_just_data.pd
index 1c9367a4..7dd958c6 100644
--- a/doc/tutorials/intro/0.all_just_data.pd
+++ b/doc/tutorials/intro/0.all_just_data.pd
@@ -1,2 +1,92 @@
-#N canvas 0 22 454 304 10;
-#X text 152 35 Its all just data.;
+#N canvas 585 87 498 434 10;
+#X obj 180 406 import unauthorized Gem;
+#X obj 154 102 grid grid1 200 0 199 200 0 199 1 1 1 10 10 276 240;
+#X obj 25 39 pddp/dsp;
+#N canvas 446 285 646 466 guts 0;
+#X obj 20 10 inlet;
+#X obj 275 14 inlet;
+#X obj 112 127 osc~;
+#X obj 112 156 *~;
+#X obj 149 98 / 200;
+#X obj 110 185 dac~;
+#X obj 444 54 receive pd;
+#X msg 340 154 create;
+#X msg 310 154 1;
+#X obj 482 215 gemwin;
+#X msg 564 154 0;
+#X msg 504 154 destroy;
+#X obj 517 132 t b b;
+#X obj 311 125 trigger bang bang bang;
+#X obj 444 94 select 1;
+#X obj 444 74 route dsp;
+#X obj 89 229 gemhead;
+#X obj 90 375 sphere 1 20;
+#X obj 91 344 translateXYZ;
+#X obj 93 287 colorRGB 1 1 1 1;
+#X obj 90 314 alpha;
+#X msg 289 192 lighting 1;
+#X obj 418 294 gemhead;
+#X obj 419 359 world_light -120;
+#X obj 228 292 / 25;
+#X obj 30 300 / 25;
+#X obj 228 269 - 100;
+#X obj 29 279 - 100;
+#X obj 181 251 / 200;
+#X obj 53 250 / 200;
+#X msg 394 154 dimen 200 200;
+#X obj 112 51 + 250;
+#X obj 149 137 line~;
+#X msg 149 117 \$1 5;
+#X connect 0 0 4 0;
+#X connect 0 0 27 0;
+#X connect 0 0 29 0;
+#X connect 1 0 26 0;
+#X connect 1 0 28 0;
+#X connect 1 0 31 0;
+#X connect 2 0 3 0;
+#X connect 3 0 5 0;
+#X connect 3 0 5 1;
+#X connect 4 0 33 0;
+#X connect 6 0 15 0;
+#X connect 7 0 9 0;
+#X connect 8 0 9 0;
+#X connect 10 0 9 0;
+#X connect 11 0 9 0;
+#X connect 12 0 11 0;
+#X connect 12 1 10 0;
+#X connect 13 0 8 0;
+#X connect 13 0 21 0;
+#X connect 13 1 7 0;
+#X connect 13 2 30 0;
+#X connect 14 0 13 0;
+#X connect 14 1 12 0;
+#X connect 15 0 14 0;
+#X connect 16 0 19 0;
+#X connect 18 0 17 0;
+#X connect 19 0 20 0;
+#X connect 20 0 18 0;
+#X connect 21 0 9 0;
+#X connect 22 0 23 0;
+#X connect 24 0 18 2;
+#X connect 25 0 18 1;
+#X connect 26 0 24 0;
+#X connect 27 0 25 0;
+#X connect 28 0 19 2;
+#X connect 29 0 19 1;
+#X connect 30 0 9 0;
+#X connect 31 0 2 0;
+#X connect 32 0 3 1;
+#X connect 33 0 32 0;
+#X restore 256 320 pd guts;
+#X text 102 9 Its all just data. Use it however you want!;
+#X text 28 61 ^-- click here to turn it on and off;
+#X obj 154 344 nbx 5 24 -1e+37 1e+37 0 0 empty empty X -15 12 1 18
+-166441 -1 -1 121 256;
+#X obj 348 343 nbx 5 24 -1e+37 1e+37 0 0 empty empty Y -15 12 1 18
+-166441 -1 -1 61 256;
+#X text 14 121 click and drag in;
+#X text 14 137 this box ------->;
+#X connect 1 0 3 0;
+#X connect 1 0 6 0;
+#X connect 1 1 3 1;
+#X connect 1 1 7 0;
diff --git a/doc/tutorials/intro/0.bang.pd b/doc/tutorials/intro/0.bang.pd
deleted file mode 100644
index 06efcf8d..00000000
--- a/doc/tutorials/intro/0.bang.pd
+++ /dev/null
@@ -1,22 +0,0 @@
-#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
deleted file mode 100644
index 8c29ddf8..00000000
--- a/doc/tutorials/intro/0.connections.pd
+++ /dev/null
@@ -1,17 +0,0 @@
-#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
index f2186726..7ce5147f 100644
--- a/doc/tutorials/intro/0.controlling_dsp_processing.pd
+++ b/doc/tutorials/intro/0.controlling_dsp_processing.pd
@@ -1,17 +1,16 @@
-#N canvas 361 163 471 494 10;
+#N canvas 361 163 475 498 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 msg 59 321 \; pd dsp 1;
+#X msg 126 321 \; 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
+#X obj 211 314 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 obj 370 372 osc~ 250;
+#X obj 356 404 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
@@ -23,6 +22,9 @@ the DSP?;
 #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;
+#X floatatom 211 339 5 0 0 0 - - -;
+#X obj 277 332 pddp/dsp;
+#X text 271 311 [pddp/dsp];
+#X connect 4 0 15 0;
+#X connect 6 0 7 0;
+#X connect 6 0 7 1;
diff --git a/doc/tutorials/intro/0.storage_objects.pd b/doc/tutorials/intro/0.storage_objects.pd
deleted file mode 100644
index 3d66e814..00000000
--- a/doc/tutorials/intro/0.storage_objects.pd
+++ /dev/null
@@ -1,41 +0,0 @@
-#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/0.hello_world.pd b/doc/tutorials/intro/00.hello_world.pd
index e1ff0833..e1ff0833 100644
--- a/doc/tutorials/intro/0.hello_world.pd
+++ b/doc/tutorials/intro/00.hello_world.pd
diff --git a/doc/tutorials/intro/04.connections.pd b/doc/tutorials/intro/04.connections.pd
new file mode 100644
index 00000000..ae5bd053
--- /dev/null
+++ b/doc/tutorials/intro/04.connections.pd
@@ -0,0 +1,22 @@
+#N canvas 250 153 666 425 12;
+#X text 14 65 Pd patches are always running and changes take effect
+immediately.;
+#X floatatom 40 242 5 0 0 0 - - -;
+#X floatatom 40 306 5 0 0 0 - - -;
+#X obj 39 130 tgl 30 0 empty empty start 2 15 1 12 -24198 -1 -1 1 1
+;
+#X obj 39 174 metro 100;
+#X obj 39 205 random 100;
+#X text 85 134 <-- click here to start;
+#X text 81 264 connect by clicking on the outlet of the top number
+box \, then drag and drop on the inlet of the bottom number box;
+#X text 45 264 ^--;
+#X text 87 346 Disconnect the cable by clicking on it to highlight
+it \, then press the backspace key on your keyboard.;
+#X text 50 25 comment;
+#X obj 8 10 cnv 15 400 40 empty empty connections 20 12 0 24 -228992
+-66577 0;
+#X text 214 190 switch to edit mode;
+#X connect 3 0 4 0;
+#X connect 4 0 5 0;
+#X connect 5 0 1 0;
diff --git a/doc/tutorials/intro/05.objects.pd b/doc/tutorials/intro/05.objects.pd
new file mode 100644
index 00000000..d4b7f381
--- /dev/null
+++ b/doc/tutorials/intro/05.objects.pd
@@ -0,0 +1,31 @@
+#N canvas 359 93 607 497 12;
+#X obj 28 151 float;
+#X text 10 61 The fundamental building block of a Pd program is the
+object. Each object is itself like a tiny program that does a very
+specific thing.;
+#X text 11 124 These are all objects which store data:;
+#X obj 96 151 symbol;
+#X obj 174 151 list;
+#X text 13 188 With most objects \, you can read the name of the object
+in the object box:;
+#X obj 16 230 moses;
+#X obj 92 230 select;
+#X obj 176 230 route;
+#X obj 251 230 trigger;
+#X text 11 264 GUI objects convert themselves into a GUI element \,
+usually some kind of control. In the process \, they often hide the
+text name of the object:;
+#X obj 27 358 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X text 15 329 [bng];
+#X obj 108 355 vsl 15 128 0 127 0 0 empty empty empty 0 -8 0 8 -262144
+-1 -1 10000 1;
+#X text 85 329 [vslider];
+#X text 227 331 [hslider];
+#X obj 197 353 hsl 128 15 0 127 0 0 empty empty empty -2 -6 0 8 -262144
+-1 -1 0 1;
+#X obj 393 351 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0
+1;
+#X text 382 326 [tgl];
+#X obj 8 10 cnv 15 400 40 empty empty objects 20 12 0 24 -228992 -66577
+0;
diff --git a/doc/tutorials/intro/06.make_your_first_patch.pd b/doc/tutorials/intro/06.make_your_first_patch.pd
new file mode 100644
index 00000000..a110d0b3
--- /dev/null
+++ b/doc/tutorials/intro/06.make_your_first_patch.pd
@@ -0,0 +1,12 @@
+#N canvas 359 93 674 494 12;
+#X obj 8 10 cnv 15 400 40 empty empty make_your_first_patch 20 12 0
+24 -228992 -66577 0;
+#X text 15 71 Its time to make your first patch. Follow the instructions
+on the right:;
+#X text 204 195 2 make a new object box \, in it \, type: symbol;
+#X text 204 235 3 make a new symbol box;
+#X text 204 275 4 connect the message box to the object box;
+#X text 204 315 5 connect the object box to the symbol box;
+#X text 203 353 6 click the message box \, and viola!;
+#X text 163 439 You are now a Pd patcher!;
+#X text 204 159 1 make a message box \, in it \, type any word;
diff --git a/doc/tutorials/intro/07.storage_objects.pd b/doc/tutorials/intro/07.storage_objects.pd
new file mode 100644
index 00000000..38d06854
--- /dev/null
+++ b/doc/tutorials/intro/07.storage_objects.pd
@@ -0,0 +1,42 @@
+#N canvas 315 88 628 510 12;
+#X obj 179 89 symbol;
+#X obj 120 89 bang;
+#X obj 360 89 f;
+#X obj 265 89 float;
+#X text 325 89 aka;
+#X text 98 58 A storage object stores a value.;
+#X text 36 384 If a storage object receives a value on the left inlet
+\, then it outputs that value immediately in addition to storing it.
+;
+#X text 35 254 If a storage object receives a value on the right inlet
+\, then it stores that value.;
+#X text 28 123 If you bang the left inlet of a storage object \, it
+outputs its stored value.;
+#X obj 187 165 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 187 188 float;
+#X obj 176 297 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 190 328 float;
+#X msg 203 297 123;
+#X obj 190 451 float;
+#X msg 236 425 123;
+#X msg 190 426 432;
+#X obj 169 427 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X msg 245 296 321;
+#X floatatom 190 352 5 0 0 0 - - -;
+#X floatatom 187 217 5 0 0 0 - - -;
+#X floatatom 190 480 5 0 0 0 - - -;
+#X obj 12 13 cnv 15 400 40 empty empty storage_objects 20 12 0 24 -228992
+-66577 0;
+#X connect 9 0 10 0;
+#X connect 10 0 20 0;
+#X connect 11 0 12 0;
+#X connect 12 0 19 0;
+#X connect 13 0 12 1;
+#X connect 14 0 21 0;
+#X connect 15 0 14 1;
+#X connect 16 0 14 0;
+#X connect 17 0 14 0;
+#X connect 18 0 12 1;
diff --git a/doc/tutorials/intro/08.bang.pd b/doc/tutorials/intro/08.bang.pd
new file mode 100644
index 00000000..e7a0affa
--- /dev/null
+++ b/doc/tutorials/intro/08.bang.pd
@@ -0,0 +1,17 @@
+#N canvas 435 180 496 390 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 32 159 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 32 188 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 1 1
+;
+#X msg 32 248 bang;
+#X obj 32 273 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0 1
+;
+#X text 54 157 <--bang button;
+#X text 76 249 <--you can also send "bang" using a message box;
+#X text 28 105 Here \, this toggle changes state when it receives a
+bang:;
+#X connect 2 0 3 0;
+#X connect 4 0 5 0;
diff --git a/doc/tutorials/intro/objects.pd b/doc/tutorials/intro/objects.pd
deleted file mode 100644
index 4df7dd8d..00000000
--- a/doc/tutorials/intro/objects.pd
+++ /dev/null
@@ -1,30 +0,0 @@
-#N canvas 413 64 476 559 10;
-#X obj 38 151 float;
-#X text 19 22 objects;
-#X text 20 61 The fundamental building block of a Pd program is the
-object. Each object is itself like a tiny program that does a very
-specific thing.;
-#X text 21 124 These are all objects which store data:;
-#X obj 86 151 symbol;
-#X obj 142 151 list;
-#X text 23 188 With most objects \, you can read the name of the object
-in the object box:;
-#X obj 26 230 moses;
-#X obj 82 230 select;
-#X obj 141 230 route;
-#X obj 198 230 trigger;
-#X text 21 264 GUI objects convert themselves into a GUI element \,
-usually some kind of control. In the process \, they often hide the
-text name of the object:;
-#X obj 37 358 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
--1;
-#X text 25 329 [bng];
-#X obj 118 355 vsl 15 128 0 127 0 0 empty empty empty 0 -8 0 8 -262144
--1 -1 0 1;
-#X text 95 329 [vslider];
-#X text 237 331 [hslider];
-#X obj 207 353 hsl 128 15 0 127 0 0 empty empty empty -2 -6 0 8 -262144
--1 -1 0 1;
-#X obj 403 351 tgl 15 0 empty empty empty 0 -6 0 8 -262144 -1 -1 0
-1;
-#X text 392 326 [tgl];