adapted all_about_hid_mapping and template1-about.pd into this about patch to test a new template idea and to document new mapping objects

svn path=/trunk/; revision=4522

1 files changed, 365 insertions, 0 deletions

diff --git a/doc/pddp/about/mapping-about.pd b/doc/pddp/about/mapping-about.pd
new file mode 100644
index 00000000..b3fe3c30
--- /dev/null
+++ b/doc/pddp/about/mapping-about.pd
@@ -0,0 +1,365 @@
+#N canvas 33 239 763 533 10;
+#X obj 0 0 cnv 15 750 17 empty empty Mapping 10 9 0 16 -233017 -66577
+0;
+#X obj 305 18 cnv 15 440 15 empty empty Getting_your_message_across
+10 7 0 12 -217069 -33289 0;
+#X obj 305 230 cnv 15 440 15 empty empty Broadcasting_with_sends_and_receives
+10 7 0 12 -217069 -33289 0;
+#X obj 305 18 cnv 5 5 500 empty empty empty 20 12 0 14 -233017 -66577
+0;
+#X obj 0 500 cnv 15 750 20 bs br PDDP_Project_2005 10 10 0 14 -217069
+-1 0;
+#N canvas 0 22 454 304 META 0;
+#X restore 151 502 pd META;
+#N canvas 696 168 500 380 PAGES 0;
+#X text 19 9 Put your pages here: (They must be named [pd PAGE1] [pd
+PAGE2]... (PAGE0 is the main patch).;
+#X obj 12 143 pddp_page 3;
+#X text 9 109 Don't forget to set the number of pages \, including
+the main page.;
+#N canvas 121 197 763 533 PAGE2 0;
+#X obj 0 0 cnv 15 750 17 empty empty Mapping 10 9 0 16 -233017 -66577
+0;
+#X obj 305 18 cnv 15 440 15 empty empty Internal_sends_and_receives
+10 7 0 12 -217069 -33289 0;
+#X obj 305 18 cnv 5 5 500 empty empty empty 20 12 0 14 -233017 -66577
+0;
+#X obj 0 500 cnv 15 750 20 bs br PDDP_2005 10 10 0 14 -217069 -1 0
+;
+#X obj 624 503 bng 15 250 50 0 pddpNextPage \$0- Previous -60 8 0 12
+-262144 -1 -1;
+#X obj 644 503 cnv 15 15 15 empty empty 1 0 8 0 12 -217069 -1 0;
+#X obj 660 503 cnv 15 15 15 empty empty of 0 8 0 12 -217069 -1 0;
+#X obj 676 503 cnv 15 25 15 empty pddpNumPages 3 4 8 0 12 -217069 -1
+0;
+#X obj 692 503 bng 15 250 50 0 pddpNextPage \$0- Next 20 8 0 12 -262144
+-1 -1;
+#X obj 305 200 cnv 15 440 15 empty empty Explicit_vs_hidden 10 7 0
+12 -217069 -33289 0;
+#N canvas 0 22 450 300 graph1 0;
+#X array 4throot 100 float 0;
+#X coords 0 1 99 -1 100 100 1;
+#X restore 197 168 graph;
+#N canvas 0 22 450 300 graph1 0;
+#X array cuberoot 100 float 0;
+#X coords 0 1 99 -1 100 100 1;
+#X restore 197 277 graph;
+#N canvas 0 22 450 300 graph1 0;
+#X array logarithmic 100 float 0;
+#X coords 0 1 99 -1 100 100 1;
+#X restore 197 58 graph;
+#X obj 121 58 curve_log;
+#N canvas 0 22 450 300 graph1 0;
+#X array squareroot 100 float 0;
+#X coords 0 1 99 -1 100 100 1;
+#X restore 197 387 graph;
+#X obj 109 387 curve_root 2;
+#X obj 109 277 curve_root 3;
+#X obj 109 168 curve_root 4;
+#N canvas 0 22 450 300 graph1 0;
+#X array \$0-4throot0 100 float 0;
+#X coords 0 1 99 0 100 100 1;
+#X restore 7 168 graph;
+#N canvas 0 22 450 300 graph1 0;
+#X array \$0-cuberoot0 100 float 0;
+#X coords 0 1 99 0 100 100 1;
+#X restore 7 277 graph;
+#N canvas 0 22 450 300 graph1 0;
+#X array \$0-logarithmic0 100 float 0;
+#X coords 0 1 99 0 100 100 1;
+#X restore 7 58 graph;
+#N canvas 0 22 450 300 graph1 0;
+#X array \$0-squareroot0 100 float 0;
+#X coords 0 1 99 0 100 100 1;
+#X restore 7 387 graph;
+#X text 131 27 range;
+#X text 221 28 -1 to 1;
+#X text 34 27 0 to 1;
+#N canvas 314 57 701 681 draw_arrays 0;
+#X msg 77 62 bang;
+#X obj 77 83 until;
+#X text 108 62 start;
+#X obj 77 105 f;
+#X obj 106 105 + 1;
+#X obj 152 107 sel 0;
+#X obj 106 127 mod 100;
+#X obj 183 395 tabwrite logarithmic;
+#X obj 183 300 tabwrite squareroot;
+#X obj 183 255 tabwrite cuberoot;
+#X obj 77 23 loadbang;
+#X obj 77 156 trigger float float;
+#X obj 77 217 / 50;
+#X obj 77 191 - 50;
+#X obj 183 376 curve_log;
+#X obj 183 236 curve_root 3;
+#X obj 183 281 curve_root 2;
+#X obj 183 332 curve_root 4;
+#X obj 183 351 tabwrite 4throot;
+#X obj 483 211 float;
+#X obj 183 561 curve_log;
+#X obj 183 421 curve_root 3;
+#X obj 183 466 curve_root 2;
+#X obj 183 517 curve_root 4;
+#X obj 18 217 / 100;
+#X obj 183 485 tabwrite \$0-squareroot0;
+#X obj 183 440 tabwrite \$0-cuberoot0;
+#X obj 183 536 tabwrite \$0-4throot0;
+#X obj 183 580 tabwrite \$0-logarithmic0;
+#X obj 171 33 metro 5000;
+#X obj 171 13 loadbang;
+#X connect 0 0 1 0;
+#X connect 1 0 3 0;
+#X connect 3 0 4 0;
+#X connect 3 0 11 0;
+#X connect 4 0 6 0;
+#X connect 5 0 1 1;
+#X connect 6 0 3 1;
+#X connect 6 0 5 0;
+#X connect 10 0 0 0;
+#X connect 11 0 13 0;
+#X connect 11 0 24 0;
+#X connect 11 1 19 0;
+#X connect 12 0 14 0;
+#X connect 12 0 15 0;
+#X connect 12 0 16 0;
+#X connect 12 0 17 0;
+#X connect 13 0 12 0;
+#X connect 14 0 7 0;
+#X connect 15 0 9 0;
+#X connect 16 0 8 0;
+#X connect 17 0 18 0;
+#X connect 19 0 7 1;
+#X connect 19 0 8 1;
+#X connect 19 0 9 1;
+#X connect 19 0 18 1;
+#X connect 19 0 25 1;
+#X connect 19 0 26 1;
+#X connect 19 0 27 1;
+#X connect 19 0 28 1;
+#X connect 20 0 28 0;
+#X connect 21 0 26 0;
+#X connect 22 0 25 0;
+#X connect 23 0 27 0;
+#X connect 24 0 21 0;
+#X connect 24 0 22 0;
+#X connect 24 0 23 0;
+#X connect 24 0 20 0;
+#X connect 29 0 0 0;
+#X connect 30 0 29 0;
+#X restore 106 502 pd draw_arrays;
+#X text 312 291 - CURVE TEXT IDEAS;
+#X text 342 307 - amplitude is generally perceived on a logarithmic
+scale;
+#X text 343 324 - pitch is perceived on logarithmic scale;
+#X text 343 339 - many sensors work best on other curves;
+#X text 336 234 Objects that start with "hid_" accept input data in
+the range of 0-1 and output data in the same range \, allowing you
+to chain as many of these objects together without thinking about scaling
+the resulting data with each step.;
+#X restore 14 54 pd PAGE2;
+#N canvas 25 25 763 533 PAGE4 0;
+#X obj 0 0 cnv 15 750 17 empty empty Mapping 10 9 0 16 -233017 -66577
+0;
+#X obj 6 328 cnv 15 300 15 empty empty Related_Objects 10 7 0 12 -217069
+-33289 0;
+#X obj 0 500 cnv 15 750 20 bs br PDDP_2005 10 10 0 14 -217069 -1 0
+;
+#X obj 624 503 bng 15 250 50 0 pddpNextPage \$0- Previous -60 8 0 12
+-262144 -1 -1;
+#X obj 644 503 cnv 15 15 15 empty empty 1 0 8 0 12 -217069 -1 0;
+#X obj 660 503 cnv 15 15 15 empty empty of 0 8 0 12 -217069 -1 0;
+#X obj 676 503 cnv 15 25 15 empty pddpNumPages 3 4 8 0 12 -217069 -1
+0;
+#X obj 692 503 bng 15 250 50 0 pddpNextPage \$0- Next 20 8 0 12 -262144
+-1 -1;
+#X obj 745 0 cnv 5 5 500 empty empty empty 20 12 0 14 -233017 -66577
+0;
+#X obj 0 0 cnv 5 5 500 empty empty empty 20 12 0 14 -233017 -66577
+0;
+#X obj 305 16 cnv 5 5 485 empty empty empty 20 12 0 14 -233017 -66577
+0;
+#X text 38 388 LINK: universal-help.pd;
+#X obj 18 361 cnv 15 100 17 empty empty cyclone 3 9 0 12 -233017 -1
+0;
+#X text 39 447 LINK: send13-help.pd;
+#X text 39 467 LINK: receive13-help.pd;
+#X obj 18 421 cnv 15 100 17 empty empty ext13 3 9 0 12 -233017 -1 0
+;
+#X obj 305 378 cnv 15 440 15 empty empty More_Info 10 7 0 12 -217069
+-33289 0;
+#X text 345 401 LINK: spiffy example;
+#X text 345 416 LINK: Scope and Locality;
+#X text 345 432 LINK: pd-msg docs;
+#X obj 305 18 cnv 15 440 15 empty empty Sending_And_Receiving_from_Pd_itself
+10 7 0 12 -217069 -33289 0;
+#X text 358 70 blah blah blah \, no text here yet.;
+#X text 17 123 Or draw your own curve:;
+#X obj 192 72 curve_graph;
+#X restore 158 56 pd PAGE4;
+#N canvas 466 121 771 541 PAGE3 0;
+#X obj 0 0 cnv 15 750 17 empty empty Mapping 10 9 0 16 -233017 -66577
+0;
+#X obj 305 18 cnv 15 440 15 empty empty Internal_sends_and_receives
+10 7 0 12 -217069 -33289 0;
+#X obj 305 18 cnv 5 5 500 empty empty empty 20 12 0 14 -233017 -66577
+0;
+#X obj 0 500 cnv 15 750 20 bs br PDDP_2005 10 10 0 14 -217069 -1 0
+;
+#X obj 624 503 bng 15 250 50 0 pddpNextPage \$0- Previous -60 8 0 12
+-262144 -1 -1;
+#X obj 644 503 cnv 15 15 15 empty empty 1 0 8 0 12 -217069 -1 0;
+#X obj 660 503 cnv 15 15 15 empty empty of 0 8 0 12 -217069 -1 0;
+#X obj 676 503 cnv 15 25 15 empty pddpNumPages 3 4 8 0 12 -217069 -1
+0;
+#X obj 692 503 bng 15 250 50 0 pddpNextPage \$0- Next 20 8 0 12 -262144
+-1 -1;
+#X obj 305 200 cnv 15 440 15 empty empty Explicit_vs_hidden 10 7 0
+12 -217069 -33289 0;
+#N canvas 0 22 450 300 graph1 0;
+#X array 4thpower 100 float 0;
+#X coords 0 1 99 -1 100 100 1;
+#X restore 197 168 graph;
+#N canvas 0 22 450 300 graph1 0;
+#X array cube 100 float 0;
+#X coords 0 1 99 -1 100 100 1;
+#X restore 197 277 graph;
+#N canvas 0 22 450 300 graph1 0;
+#X array exponential 100 float 0;
+#X coords 0 1 99 -1 100 100 1;
+#X restore 197 58 graph;
+#X obj 114 58 curve_exp;
+#N canvas 0 22 450 300 graph1 0;
+#X array square 100 float 0;
+#X coords 0 1 99 -1 100 100 1;
+#X restore 197 387 graph;
+#X obj 102 387 curve_power 2;
+#X obj 102 277 curve_power 3;
+#X obj 102 168 curve_power 4;
+#N canvas 0 22 450 300 graph1 0;
+#X array \$0-4thpower0 100 float 0;
+#X coords 0 1 99 0 100 100 1;
+#X restore 0 168 graph;
+#N canvas 0 22 450 300 graph1 0;
+#X array \$0-cube0 100 float 0;
+#X coords 0 1 99 0 100 100 1;
+#X restore 0 277 graph;
+#N canvas 0 22 450 300 graph1 0;
+#X array \$0-exponential0 100 float 0;
+#X coords 0 1 99 0 100 100 1;
+#X restore 0 58 graph;
+#N canvas 0 22 450 300 graph1 0;
+#X array \$0-square0 100 float 0;
+#X coords 0 1 99 0 100 100 1;
+#X restore 0 387 graph;
+#X text 124 27 range;
+#X text 221 28 -1 to 1;
+#X text 27 27 0 to 1;
+#N canvas 70 100 705 685 draw_arrays 0;
+#X msg 77 62 bang;
+#X obj 77 83 until;
+#X text 108 62 start;
+#X obj 77 105 f;
+#X obj 106 105 + 1;
+#X obj 152 107 sel 0;
+#X obj 106 127 mod 100;
+#X obj 183 395 tabwrite exponential;
+#X obj 183 300 tabwrite square;
+#X obj 183 255 tabwrite cube;
+#X obj 77 23 loadbang;
+#X obj 77 156 trigger float float;
+#X obj 77 217 / 50;
+#X obj 77 191 - 50;
+#X obj 183 376 curve_exp;
+#X obj 183 236 curve_power 3;
+#X obj 183 332 curve_power 4;
+#X obj 183 351 tabwrite 4thpower;
+#X obj 483 211 float;
+#X obj 183 561 curve_exp;
+#X obj 183 421 curve_power 3;
+#X obj 183 466 curve_power 2;
+#X obj 183 517 curve_power 4;
+#X obj 18 217 / 100;
+#X obj 183 485 tabwrite \$0-square0;
+#X obj 183 440 tabwrite \$0-cube0;
+#X obj 183 536 tabwrite \$0-4thpower0;
+#X obj 183 580 tabwrite \$0-exponential0;
+#X obj 183 281 curve_power 2;
+#X obj 149 38 metro 5000;
+#X obj 149 19 loadbang;
+#X connect 0 0 1 0;
+#X connect 1 0 3 0;
+#X connect 3 0 4 0;
+#X connect 3 0 11 0;
+#X connect 4 0 6 0;
+#X connect 5 0 1 1;
+#X connect 6 0 3 1;
+#X connect 6 0 5 0;
+#X connect 10 0 0 0;
+#X connect 11 0 13 0;
+#X connect 11 0 23 0;
+#X connect 11 1 18 0;
+#X connect 12 0 14 0;
+#X connect 12 0 15 0;
+#X connect 12 0 16 0;
+#X connect 12 0 28 0;
+#X connect 13 0 12 0;
+#X connect 14 0 7 0;
+#X connect 15 0 9 0;
+#X connect 16 0 17 0;
+#X connect 18 0 7 1;
+#X connect 18 0 8 1;
+#X connect 18 0 9 1;
+#X connect 18 0 17 1;
+#X connect 18 0 24 1;
+#X connect 18 0 25 1;
+#X connect 18 0 26 1;
+#X connect 18 0 27 1;
+#X connect 19 0 27 0;
+#X connect 20 0 25 0;
+#X connect 21 0 24 0;
+#X connect 22 0 26 0;
+#X connect 23 0 20 0;
+#X connect 23 0 21 0;
+#X connect 23 0 22 0;
+#X connect 23 0 19 0;
+#X connect 28 0 8 0;
+#X connect 29 0 0 0;
+#X connect 30 0 29 0;
+#X restore 106 502 pd draw_arrays;
+#X restore 85 54 pd PAGE3;
+#X coords 0 0 1.01598e-05 1.58148e-05 96 15 0;
+#X restore 208 502 pd PAGES;
+#X obj 624 503 bng 15 250 50 0 pddpNextPage \$0- Previous -60 8 0 12
+-262144 -1 -1;
+#X obj 644 503 cnv 15 15 15 empty empty 1 0 8 0 12 -217069 -1 0;
+#X obj 660 503 cnv 15 15 15 empty empty of 0 8 0 12 -217069 -1 0;
+#X obj 676 503 cnv 15 25 15 empty pddpNumPages 3 4 8 0 12 -217069 -1
+0;
+#X obj 692 503 bng 15 250 50 0 pddpNextPage \$0- Next 20 8 0 12 -262144
+-1 -1;
+#X obj 183 73 hid_rel2abs;
+#X obj 13 116 hid_smooth;
+#X obj 13 51 notescale;
+#X obj 91 73 hid_centered;
+#X obj 13 162 buttongate;
+#X obj 92 162 keygate;
+#X obj 92 116 hid_average;
+#X text 5 32 SCALING AND RANGING;
+#X text 5 99 SMOOTHING;
+#X obj 89 51 autoscale;
+#X text 5 145 BASIC CONTROLS;
+#X text 6 186 ONE-TO-MANY MAPPING;
+#X obj 13 211 hid_one2two;
+#X obj 98 211 hid_one2three;
+#X text 5 235 POLAR COORDINATES;
+#X text 5 279 ANGLE CONVERSIONS;
+#X obj 177 116 hid_lowpass;
+#X obj 197 211 hid_one2four;
+#X obj 13 73 reverse;
+#X obj 63 252 polar;
+#X obj 106 252 spiral;
+#X obj 13 252 vector;
+#X obj 126 319 degrees2mapping;
+#X obj 14 319 mapping2degrees;
+#X obj 126 299 radians2mapping;
+#X obj 14 299 mapping2radians;