some updates to make things fit on the page in Mac OS X; updated some details for Pd 0.38-4

svn path=/trunk/; revision=2776

1 files changed, 283 insertions, 283 deletions

diff --git a/doc/pddp/help-operators.pd b/doc/pddp/help-operators.pd
index 2c524d0d..6ff5ae0b 100644
--- a/doc/pddp/help-operators.pd
+++ b/doc/pddp/help-operators.pd
@@ -1,283 +1,283 @@
-#N canvas 23 29 920 640 10;

-#X obj 622 350 +~;

-#X obj 626 499 trigger;

-#X text 25 8 ARITHMETIC;

-#X text 30 29 PD's arithmetic objects include:;

-#X obj 231 30 +;

-#X obj 256 30 -;

-#X obj 282 30 *;

-#X obj 308 30 /;

-#X obj 334 30 pow;

-#X obj 359 30 max;

-#X obj 385 30 min;

-#X obj 32 276 +;

-#X floatatom 32 205 0 0 0;

-#X floatatom 32 297 0 0 0;

-#X floatatom 45 228 0 0 0;

-#X msg 63 254 bang;

-#X text 98 255 Bang outputs sum;

-#X text 70 204 Numbers in left inlet add and output sum;

-#X text 87 227 Numbers in right inlet only change the inlet's value

-;

-#X text 29 171 The example below performs basic addition with two numbers:

-i.e. a + b = c;

-#X text 28 54 All of these objects operate the same way. The right

-inlet sets or changes the numeric value of the object. Sending a number

-to the left inlet forces the object to perform the operation with the

-current numeric value of the object and output the result. A "bang"

-will output the result without changing the numeric values at either

-inlet. A creation argument can be used to define the initial numeric

-value of the right inlet.;

-#X text 29 325 The example below incorporates a creation argument:

-i.e. a + 42 = b;

-#X floatatom 29 357 0 0 0;

-#X floatatom 29 400 0 0 0;

-#X obj 29 379 + 42;

-#N canvas 38 134 637 241 basic_examples 0;

-#X obj 44 129 +;

-#X obj 113 129 -;

-#X obj 179 129 *;

-#X obj 244 129 /;

-#X obj 316 129 pow;

-#X obj 394 129 max;

-#X obj 482 129 min;

-#X floatatom 44 32 5 0 0;

-#X floatatom 44 150 0 0 0;

-#X floatatom 113 149 0 0 0;

-#X floatatom 179 149 0 0 0;

-#X floatatom 244 149 0 0 0;

-#X floatatom 316 149 0 0 0;

-#X floatatom 394 150 0 0 0;

-#X floatatom 482 149 0 0 0;

-#X floatatom 495 32 5 0 0;

-#X msg 360 32 bang;

-#X connect 0 0 8 0;

-#X connect 1 0 9 0;

-#X connect 2 0 10 0;

-#X connect 3 0 11 0;

-#X connect 4 0 12 0;

-#X connect 5 0 13 0;

-#X connect 6 0 14 0;

-#X connect 7 0 0 0;

-#X connect 7 0 1 0;

-#X connect 7 0 2 0;

-#X connect 7 0 3 0;

-#X connect 7 0 4 0;

-#X connect 7 0 5 0;

-#X connect 7 0 6 0;

-#X connect 15 0 6 1;

-#X connect 15 0 5 1;

-#X connect 15 0 4 1;

-#X connect 15 0 3 1;

-#X connect 15 0 2 1;

-#X connect 15 0 1 1;

-#X connect 15 0 0 1;

-#X connect 16 0 0 0;

-#X connect 16 0 1 0;

-#X connect 16 0 2 0;

-#X connect 16 0 3 0;

-#X connect 16 0 4 0;

-#X connect 16 0 5 0;

-#X connect 16 0 6 0;

-#X restore 28 542 pd basic_examples;

-#X text 29 425 + - * / are probably self-explanatory...if you are using

-PD \, then it is safe to say that you have passed third grade.;

-#X text 27 463 However \, [pow] \, [max] \, and [min] objects may need

-some explanation.;

-#N canvas 0 0 452 302 understanding_POW 0;

-#X text 12 25 [POW];

-#X obj 17 66 pow 2;

-#X floatatom 17 86 2 0 0;

-#X msg 17 46 2;

-#X text 61 115 - it is important to note that [pow] only works with

-NON-negative mantissas. That is to say that negative floating point

-fractions will be ignored.;

-#X obj 18 153 pow 2;

-#X floatatom 18 173 2 0 0;

-#X msg 13 111 -2;

-#X msg 24 132 -1.5;

-#X text 65 202 - however \, [pow] is capable of computing negative

-exponents!;

-#X floatatom 19 201 0 0 0;

-#X obj 19 221 pow -2;

-#X floatatom 19 242 0 0 0;

-#X text 57 39 - this object is used to exponentiate a number. The object

-returns the value at the left inlet to the power of the right inlet

-where the left inlet is the base and the right inlet is the exponent.

-For example: 2 to the power of 2 = 4 (i.e. 2 Squared);

-#X connect 1 0 2 0;

-#X connect 3 0 1 0;

-#X connect 5 0 6 0;

-#X connect 7 0 5 0;

-#X connect 8 0 5 0;

-#X connect 10 0 11 0;

-#X connect 11 0 12 0;

-#X restore 28 497 pd understanding_POW;

-#N canvas 0 0 474 341 understanding_MAX_and_MIN 0;

-#X text 34 9 [MAX];

-#X obj 32 51 max 10;

-#X floatatom 32 29 5 0 0;

-#X floatatom 32 76 5 0 0;

-#X text 87 26 - [max] returns the greater of the two numbers passed

-to its inlets. For example \, if the creation argument (or right inlet)

-is equal to 10 \, and you send 9 to the left inlet then the object

-will return 10 If you pass it an 11 \, then object returns 11;

-#X floatatom 33 116 5 0 0;

-#X floatatom 33 163 5 0 0;

-#X text 35 96 [MIN];

-#X text 88 113 - [min] returns the lesser of the two numbers passed

-to its inlets. For example \, if the creation argument (or right inlet)

-is equal to 10 \, and you send 9 to the left inlet then the object

-will return 9 If you pass it an 11 \, then object returns 10;

-#X obj 33 138 min 10;

-#X text 32 185 - It is important to note that [max] and [min] output

-a number with every number or "bang" that is sent to the left inlet.

-;

-#X floatatom 35 234 5 0 0;

-#X floatatom 35 282 5 0 0;

-#X obj 35 256 min 10;

-#X obj 76 281 bng 15 50 10 0 empty empty empty 0 -6 0 8 -262144 -1

--1;

-#X text 80 232 Move this number box above 10;

-#X connect 1 0 3 0;

-#X connect 2 0 1 0;

-#X connect 5 0 9 0;

-#X connect 9 0 6 0;

-#X connect 11 0 13 0;

-#X connect 13 0 12 0;

-#X connect 13 0 14 0;

-#X restore 28 519 pd understanding_MAX_and_MIN;

-#X obj 430 568 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1

--1;

-#X obj 430 12 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1

--1;

-#X text 469 20 THE SUM OF MANY NUMBERS;

-#X text 473 40 PD has wonderful object called [expr] which allows you

-to write mathematical expressions. I would suggest that you investigate

-the [expr] object to process basic mathematical equations with more

-than 2 separate values.;

-#X msg 481 151 bang;

-#X obj 481 203 random 10;

-#X obj 543 203 random 10;

-#X obj 605 203 random 10;

-#X text 509 222 a;

-#X text 571 223 b;

-#X text 632 222 c;

-#X text 512 288 d;

-#X floatatom 481 288 0 0 0;

-#X obj 481 172 t b b b;

-#X obj 481 245 +;

-#X obj 481 266 +;

-#X floatatom 481 223 0 0 0;

-#X floatatom 543 223 0 0 0;

-#X floatatom 605 223 0 0 0;

-#X text 474 102 Having said that \, it IS possible to build equations

-with multiple elements using these basic math objects \, as in the

-example below: (i.e. a + b + c = d);

-#X text 469 324 RELATED OBJECTS;

-#X obj 651 350 -~;

-#X obj 680 350 *~;

-#X obj 708 350 /~;

-#X obj 736 350 max~;

-#X obj 766 350 min~;

-#X text 550 350 Audio Math;

-#X obj 622 374 ==;

-#X obj 680 374 >;

-#X obj 736 374 <;

-#X obj 708 374 >=;

-#X obj 766 373 <=;

-#X obj 652 374 !=;

-#X text 514 375 Relational Tests;

-#X text 508 398 Logical Operators;

-#X obj 623 398 &;

-#X obj 652 398 |;

-#X obj 680 398 &&;

-#X obj 708 398 ||;

-#X obj 736 398 <<;

-#X obj 766 398 >>;

-#X obj 680 499 expr;

-#X obj 622 422 mtof;

-#X obj 653 422 ftom;

-#X obj 684 422 powtodb;

-#X obj 734 422 rmstodb;

-#X obj 784 422 dbtopow;

-#X obj 834 422 dbtorms;

-#X text 455 423 Acoustical Unit Conversion;

-#X text 547 450 Higher Math;

-#X obj 793 374 mod;

-#X obj 820 374 div;

-#X obj 626 449 sin;

-#X obj 652 449 cos;

-#X obj 679 449 tan;

-#X obj 706 449 atan;

-#X obj 625 473 atan2;

-#X obj 716 499 random;

-#X obj 663 473 sqrt;

-#X obj 694 473 log;

-#X obj 720 473 exp;

-#X obj 746 473 abs;

-#X text 580 499 Other;

-#N canvas 181 122 454 304 related_objects_from_other_libraries 0;

-#X obj 37 25 vector+;

-#X obj 37 45 vector-;

-#X obj 37 65 vector*;

-#X obj 85 25 vector/;

-#X obj 85 45 rgb2hsv;

-#X obj 85 65 hsv2rgb;

-#X obj 133 25 abs~;

-#X obj 133 45 db2v;

-#X obj 133 65 v2db;

-#X obj 163 25 avg~;

-#X obj 164 45 tavg~;

-#X obj 164 65 pdf~;

-#X obj 201 24 <~;

-#X obj 201 45 ==~;

-#X obj 201 67 >~;

-#X obj 228 25 &&~;

-#X obj 228 46 ||~;

-#X obj 228 67 matrix~;

-#X obj 280 25 mavg;

-#X obj 280 46 mean;

-#X obj 280 68 divide;

-#X obj 323 27 divmod;

-#X obj 324 47 minus;

-#X obj 324 67 plus;

-#X text 29 104 These objects are offered in PD only if you have downloaded

-and properly installed the appropriate library. These objects may or

-may not exist in a single library.;

-#X text 28 153 The best places to find information about PD's libraries

-is:;

-#X text 25 175 www.puredata.org and click on "Downloads" then "Software"

-;

-#X text 27 190 or;

-#X text 27 205 iem.kug.ac.at/pdb/;

-#X obj 370 27 q8_rsqrt~;

-#X obj 370 51 q8_sqrt~;

-#X restore 520 537 pd related_objects_from_other_libraries;

-#X obj 763 499 f;

-#X obj 791 499 int;

-#X obj 794 398 %;

-#X obj 251 539 timer;

-#X text 292 584 This document was updated for PD version 0.35 test

-28 by Dave Sabine as part of a project called pddp proposed by Krzysztof

-Czaja to build comprehensive documentation for PD.;

-#X obj 739 449 pow;

-#X connect 11 0 13 0;

-#X connect 12 0 11 0;

-#X connect 14 0 11 1;

-#X connect 15 0 11 0;

-#X connect 22 0 24 0;

-#X connect 24 0 23 0;

-#X connect 31 0 30 0;

-#X connect 34 0 43 0;

-#X connect 35 0 46 0;

-#X connect 36 0 47 0;

-#X connect 37 0 48 0;

-#X connect 43 0 35 0;

-#X connect 43 1 36 0;

-#X connect 43 2 37 0;

-#X connect 44 0 45 0;

-#X connect 45 0 42 0;

-#X connect 46 0 44 0;

-#X connect 47 0 44 1;

-#X connect 48 0 45 1;

+#N canvas 23 29 924 644 10;
+#X obj 637 350 +~;
+#X obj 641 499 trigger;
+#X text 25 8 ARITHMETIC;
+#X text 30 29 PD's arithmetic objects include:;
+#X obj 231 30 +;
+#X obj 256 30 -;
+#X obj 282 30 *;
+#X obj 308 30 /;
+#X obj 334 30 pow;
+#X obj 359 30 max;
+#X obj 385 30 min;
+#X obj 32 276 +;
+#X floatatom 32 205 0 0 0 0 - - -;
+#X floatatom 32 297 0 0 0 0 - - -;
+#X floatatom 45 228 0 0 0 0 - - -;
+#X msg 63 254 bang;
+#X text 98 255 Bang outputs sum;
+#X text 70 204 Numbers in left inlet add and output sum;
+#X text 87 227 Numbers in right inlet only change the inlet's value
+;
+#X text 29 171 The example below performs basic addition with two numbers:
+i.e. a + b = c;
+#X text 28 54 All of these objects operate the same way. The right
+inlet sets or changes the numeric value of the object. Sending a number
+to the left inlet forces the object to perform the operation with the
+current numeric value of the object and output the result. A "bang"
+will output the result without changing the numeric values at either
+inlet. A creation argument can be used to define the initial numeric
+value of the right inlet.;
+#X text 29 325 The example below incorporates a creation argument:
+i.e. a + 42 = b;
+#X floatatom 29 357 0 0 0 0 - - -;
+#X floatatom 29 400 0 0 0 0 - - -;
+#X obj 29 379 + 42;
+#N canvas 38 134 637 241 basic_examples 0;
+#X obj 44 129 +;
+#X obj 113 129 -;
+#X obj 179 129 *;
+#X obj 244 129 /;
+#X obj 316 129 pow;
+#X obj 394 129 max;
+#X obj 482 129 min;
+#X floatatom 44 32 5 0 0 0 - - -;
+#X floatatom 44 150 0 0 0 0 - - -;
+#X floatatom 113 149 0 0 0 0 - - -;
+#X floatatom 179 149 0 0 0 0 - - -;
+#X floatatom 244 149 0 0 0 0 - - -;
+#X floatatom 316 149 0 0 0 0 - - -;
+#X floatatom 394 150 0 0 0 0 - - -;
+#X floatatom 482 149 0 0 0 0 - - -;
+#X floatatom 495 32 5 0 0 0 - - -;
+#X msg 360 32 bang;
+#X connect 0 0 8 0;
+#X connect 1 0 9 0;
+#X connect 2 0 10 0;
+#X connect 3 0 11 0;
+#X connect 4 0 12 0;
+#X connect 5 0 13 0;
+#X connect 6 0 14 0;
+#X connect 7 0 0 0;
+#X connect 7 0 1 0;
+#X connect 7 0 2 0;
+#X connect 7 0 3 0;
+#X connect 7 0 4 0;
+#X connect 7 0 5 0;
+#X connect 7 0 6 0;
+#X connect 15 0 6 1;
+#X connect 15 0 5 1;
+#X connect 15 0 4 1;
+#X connect 15 0 3 1;
+#X connect 15 0 2 1;
+#X connect 15 0 1 1;
+#X connect 15 0 0 1;
+#X connect 16 0 0 0;
+#X connect 16 0 1 0;
+#X connect 16 0 2 0;
+#X connect 16 0 3 0;
+#X connect 16 0 4 0;
+#X connect 16 0 5 0;
+#X connect 16 0 6 0;
+#X restore 28 542 pd basic_examples;
+#X text 29 425 + - * / are probably self-explanatory...if you are using
+PD \, then it is safe to say that you have passed third grade.;
+#X text 27 463 However \, [pow] \, [max] \, and [min] objects may need
+some explanation.;
+#N canvas 0 22 452 302 understanding_POW 0;
+#X text 12 25 [POW];
+#X obj 17 66 pow 2;
+#X floatatom 17 86 2 0 0 0 - - -;
+#X msg 17 46 2;
+#X text 61 115 - it is important to note that [pow] only works with
+NON-negative mantissas. That is to say that negative floating point
+fractions will be ignored.;
+#X obj 18 153 pow 2;
+#X floatatom 18 173 2 0 0 0 - - -;
+#X msg 13 111 -2;
+#X msg 24 132 -1.5;
+#X text 65 202 - however \, [pow] is capable of computing negative
+exponents!;
+#X floatatom 19 201 0 0 0 0 - - -;
+#X obj 19 221 pow -2;
+#X floatatom 19 242 0 0 0 0 - - -;
+#X text 57 39 - this object is used to exponentiate a number. The object
+returns the value at the left inlet to the power of the right inlet
+where the left inlet is the base and the right inlet is the exponent.
+For example: 2 to the power of 2 = 4 (i.e. 2 Squared);
+#X connect 1 0 2 0;
+#X connect 3 0 1 0;
+#X connect 5 0 6 0;
+#X connect 7 0 5 0;
+#X connect 8 0 5 0;
+#X connect 10 0 11 0;
+#X connect 11 0 12 0;
+#X restore 28 497 pd understanding_POW;
+#N canvas 0 22 474 341 understanding_MAX_and_MIN 0;
+#X text 34 9 [MAX];
+#X obj 32 51 max 10;
+#X floatatom 32 29 5 0 0 0 - - -;
+#X floatatom 32 76 5 0 0 0 - - -;
+#X text 87 26 - [max] returns the greater of the two numbers passed
+to its inlets. For example \, if the creation argument (or right inlet)
+is equal to 10 \, and you send 9 to the left inlet then the object
+will return 10 If you pass it an 11 \, then object returns 11;
+#X floatatom 33 116 5 0 0 0 - - -;
+#X floatatom 33 163 5 0 0 0 - - -;
+#X text 35 96 [MIN];
+#X text 88 113 - [min] returns the lesser of the two numbers passed
+to its inlets. For example \, if the creation argument (or right inlet)
+is equal to 10 \, and you send 9 to the left inlet then the object
+will return 9 If you pass it an 11 \, then object returns 10;
+#X obj 33 138 min 10;
+#X text 32 185 - It is important to note that [max] and [min] output
+a number with every number or "bang" that is sent to the left inlet.
+;
+#X floatatom 35 234 5 0 0 0 - - -;
+#X floatatom 35 282 5 0 0 0 - - -;
+#X obj 35 256 min 10;
+#X obj 76 281 bng 15 50 10 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X text 80 232 Move this number box above 10;
+#X connect 1 0 3 0;
+#X connect 2 0 1 0;
+#X connect 5 0 9 0;
+#X connect 9 0 6 0;
+#X connect 11 0 13 0;
+#X connect 13 0 12 0;
+#X connect 13 0 14 0;
+#X restore 28 519 pd understanding_MAX_and_MIN;
+#X obj 430 568 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X obj 430 12 bng 15 250 50 0 empty empty empty 0 -6 0 8 -262144 -1
+-1;
+#X text 469 20 THE SUM OF MANY NUMBERS;
+#X text 473 40 PD has wonderful object called [expr] which allows you
+to write mathematical expressions. I would suggest that you investigate
+the [expr] object to process basic mathematical equations with more
+than 2 separate values.;
+#X msg 481 151 bang;
+#X obj 481 203 random 10;
+#X obj 543 203 random 10;
+#X obj 605 203 random 10;
+#X text 509 222 a;
+#X text 571 223 b;
+#X text 632 222 c;
+#X text 512 288 d;
+#X floatatom 481 288 0 0 0 0 - - -;
+#X obj 481 172 t b b b;
+#X obj 481 245 +;
+#X obj 481 266 +;
+#X floatatom 481 223 0 0 0 0 - - -;
+#X floatatom 543 223 0 0 0 0 - - -;
+#X floatatom 605 223 0 0 0 0 - - -;
+#X text 474 102 Having said that \, it IS possible to build equations
+with multiple elements using these basic math objects \, as in the
+example below: (i.e. a + b + c = d);
+#X text 469 324 RELATED OBJECTS;
+#X obj 666 350 -~;
+#X obj 695 350 *~;
+#X obj 723 350 /~;
+#X obj 751 350 max~;
+#X obj 781 350 min~;
+#X text 540 350 Audio Math;
+#X obj 637 374 ==;
+#X obj 695 374 >;
+#X obj 751 374 <;
+#X obj 723 374 >=;
+#X obj 781 373 <=;
+#X obj 667 374 !=;
+#X text 504 375 Relational Tests;
+#X text 498 398 Logical Operators;
+#X obj 638 398 &;
+#X obj 667 398 |;
+#X obj 695 398 &&;
+#X obj 723 398 ||;
+#X obj 751 398 <<;
+#X obj 781 398 >>;
+#X obj 695 499 expr;
+#X obj 637 422 mtof;
+#X obj 668 422 ftom;
+#X obj 699 422 powtodb;
+#X obj 749 422 rmstodb;
+#X obj 799 422 dbtopow;
+#X obj 849 422 dbtorms;
+#X text 445 423 Acoustical Unit Conversion;
+#X text 537 450 Higher Math;
+#X obj 808 374 mod;
+#X obj 835 374 div;
+#X obj 641 449 sin;
+#X obj 667 449 cos;
+#X obj 694 449 tan;
+#X obj 721 449 atan;
+#X obj 640 473 atan2;
+#X obj 731 499 random;
+#X obj 678 473 sqrt;
+#X obj 709 473 log;
+#X obj 735 473 exp;
+#X obj 761 473 abs;
+#X text 570 499 Other;
+#N canvas 181 122 454 304 related_objects_from_other_libraries 0;
+#X obj 37 25 vector+;
+#X obj 37 45 vector-;
+#X obj 37 65 vector*;
+#X obj 85 25 vector/;
+#X obj 85 45 rgb2hsv;
+#X obj 85 65 hsv2rgb;
+#X obj 133 25 abs~;
+#X obj 133 45 db2v;
+#X obj 133 65 v2db;
+#X obj 163 25 avg~;
+#X obj 164 45 tavg~;
+#X obj 164 65 pdf~;
+#X obj 201 24 <~;
+#X obj 201 45 ==~;
+#X obj 201 67 >~;
+#X obj 228 25 &&~;
+#X obj 228 46 ||~;
+#X obj 228 67 matrix~;
+#X obj 280 25 mavg;
+#X obj 280 46 mean;
+#X obj 280 68 divide;
+#X obj 323 27 divmod;
+#X obj 324 47 minus;
+#X obj 324 67 plus;
+#X text 29 104 These objects are offered in PD only if you have downloaded
+and properly installed the appropriate library. These objects may or
+may not exist in a single library.;
+#X text 28 153 The best places to find information about PD's libraries
+is:;
+#X text 25 175 www.puredata.org and click on "Downloads" then "Software"
+;
+#X text 27 190 or;
+#X text 27 205 iem.kug.ac.at/pdb/;
+#X obj 370 27 q8_rsqrt~;
+#X obj 370 51 q8_sqrt~;
+#X restore 520 537 pd related_objects_from_other_libraries;
+#X obj 778 499 f;
+#X obj 806 499 int;
+#X obj 809 398 %;
+#X obj 251 539 timer;
+#X text 292 584 This document was updated for PD version 0.35 test
+28 by Dave Sabine as part of a project called pddp proposed by Krzysztof
+Czaja to build comprehensive documentation for PD.;
+#X obj 754 449 pow;
+#X connect 11 0 13 0;
+#X connect 12 0 11 0;
+#X connect 14 0 11 1;
+#X connect 15 0 11 0;
+#X connect 22 0 24 0;
+#X connect 24 0 23 0;
+#X connect 31 0 30 0;
+#X connect 34 0 43 0;
+#X connect 35 0 46 0;
+#X connect 36 0 47 0;
+#X connect 37 0 48 0;
+#X connect 43 0 35 0;
+#X connect 43 1 36 0;
+#X connect 43 2 37 0;
+#X connect 44 0 45 0;
+#X connect 45 0 42 0;
+#X connect 46 0 44 0;
+#X connect 47 0 44 1;
+#X connect 48 0 45 1;