added a number of sketches for the help structure; most are not close to completion

svn path=/trunk/; revision=1770

1 files changed, 126 insertions, 0 deletions

diff --git a/doc/pddp/all_about_data_types.pd b/doc/pddp/all_about_data_types.pd
new file mode 100644
index 00000000..49fbae03
--- /dev/null
+++ b/doc/pddp/all_about_data_types.pd
@@ -0,0 +1,126 @@
+#N canvas 290 43 848 640 10;
+#X obj 434 530 route;
+#X obj 213 411 symbol;
+#X obj 153 432 int;
+#X floatatom 91 286 5 0 0 0 - - -;
+#X text 130 286 float;
+#X symbolatom 182 286 10 0 0 0 - - -;
+#X text 263 287 symbol;
+#X obj 271 411 pointer;
+#X obj 519 109 symbol;
+#X symbolatom 519 156 0 0 0 0 - - -;
+#X msg 528 133 word;
+#X msg 519 91 test;
+#X obj 42 414 bang;
+#X obj 42 434 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X text 61 434 aka [bng];
+#X msg 502 69 symbol this;
+#X text 576 111 casting as a symbol;
+#X text 593 68 set type directly;
+#X text 567 134 does not work (check console messages);
+#X floatatom 432 131 5 0 0 0 - - -;
+#X msg 437 110 12;
+#X msg 420 90 float 83;
+#X obj 18 556 int;
+#X obj 26 536 / 5.23;
+#X floatatom 26 508 5 0 0 0 - - -;
+#X floatatom 59 576 5 0 0 0 - - -;
+#X floatatom 18 576 5 0 0 0 - - -;
+#X text 5 308 casting and storage objects:;
+#X obj 153 412 float;
+#X text 5 326 There a number of objects which are used for storing
+messages \, or casting messages as a specific data type \, sometimes
+converting from one data type to another. The right inlet on these
+objects is stores that value \, which can be later output using a bang.
+;
+#N canvas 770 126 474 324 Related_Objects 0;
+#X obj 32 54 ftos;
+#X obj 68 54 list2symbol;
+#X text 23 22 data type conversion;
+#X obj 155 55 tosymbol;
+#X obj 219 55 fromsymbol;
+#X obj 36 252 lister;
+#X obj 34 98 atoi;
+#X obj 30 138 list2int;
+#X obj 94 137 l2i;
+#X obj 96 163 a2l;
+#X obj 29 164 any2list;
+#X obj 158 138 list2symbol;
+#X obj 158 159 symbol2list;
+#X obj 247 138 l2s;
+#X obj 247 158 s2l;
+#X restore 680 577 pd Related_Objects;
+#X text 10 240 Data types are known as 'atoms' in Pd. float and symbol
+atoms have 'atom boxes'for realtime display and control from within
+a patch.;
+#X obj 404 19 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 404 594 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X text 411 279 Many objects cast the data they receive when they output
+it:;
+#X text 530 376 Some objects do not cast the data:;
+#X obj 428 347 trigger anything;
+#X msg 428 322 this is a list without a cast;
+#X obj 428 370 print;
+#X text 414 420 Some objects need to have the data explicitly declared
+in order to handle it. These are mostly symbol handling objects.;
+#X text 414 487 Objects which route data generally can handle explicitly
+or implicitly defined data.;
+#X obj 480 530 trigger;
+#X obj 538 530 niagara;
+#X obj 430 463 select;
+#X text 411 41 symbols need to be declared explicitly \, floats do
+not \, but can be:;
+#X obj 213 434 lister;
+#X obj 4 -3 cnv 15 750 20 empty empty all_about_data_types 20 10 1
+18 -233017 -66577 0;
+#X obj 719 -1 pddp;
+#X text 17 604 by Hans-Christoph Steiner <hans@at.or.at>;
+#X text 12 81 the "anything" data type allows anything to pass through
+unchanged.;
+#X text 17 470 examples of casting:;
+#X text 424 557 click on these for more info:;
+#X text 629 606 updated for Pd version 0.37.1;
+#X text 82 49 anything bang float list pointer scalar symbol;
+#X text 6 34 data types (atoms):;
+#X text 0 68 "anything";
+#X text 0 184 "list";
+#X text 0 170 "float";
+#X text 0 211 "symbol";
+#X text 0 197 "scalar";
+#X text 0 157 "bang";
+#X msg 100 105 anything 1 two three;
+#X msg 251 105 one 2 3;
+#X obj 156 188 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 160 162 t a b f l p s;
+#X obj 190 189 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X msg 253 139 list one 2 3;
+#X msg 292 169 1 2 3;
+#X obj 108 506 tosymbol;
+#X obj 172 507 fromsymbol;
+#X obj 255 506 list2symbol;
+#X obj 259 548 ftos;
+#X obj 445 577 all_about_lists_vs_anythings;
+#X connect 8 0 9 0;
+#X connect 10 0 9 0;
+#X connect 11 0 8 0;
+#X connect 15 0 9 0;
+#X connect 20 0 19 0;
+#X connect 21 0 19 0;
+#X connect 22 0 26 0;
+#X connect 23 0 22 0;
+#X connect 23 0 25 0;
+#X connect 24 0 23 0;
+#X connect 32 0 33 0;
+#X connect 36 0 38 0;
+#X connect 37 0 36 0;
+#X connect 61 0 64 0;
+#X connect 62 0 64 0;
+#X connect 64 0 63 0;
+#X connect 64 3 65 0;
+#X connect 66 0 64 0;
+#X connect 67 0 64 0;