diff options
Diffstat (limited to 'doc/pddp/operators-help.pd')
-rw-r--r-- | doc/pddp/operators-help.pd | 388 |
1 files changed, 107 insertions, 281 deletions
diff --git a/doc/pddp/operators-help.pd b/doc/pddp/operators-help.pd index f64e8c53..f7aee80b 100644 --- a/doc/pddp/operators-help.pd +++ b/doc/pddp/operators-help.pd @@ -1,283 +1,109 @@ -#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 +#N canvas 0 0 555 619 10; +#X obj 0 595 cnv 15 552 21 empty \$0-pddp.cnv.footer empty 20 12 0 +14 -228856 -66577 0; +#X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header (binops1) 3 12 0 +18 -204280 -1 0; +#X obj 0 324 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +-228856 -1 0; +#N canvas 51 246 507 358 META 0; +#X text 12 105 PLATFORM windows macosx gnulinux; +#X text 12 165 LIBRARY internal; +#X text 12 205 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 65 LICENSE SIBSD; +#X text 12 185 AUTHOR Miller Puckette; +#X text 12 265 HELP_PATCH_AUTHORS This help patch 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. Jonathan Wilkes revised the patch to conform to the PDDP template +for Pd version 0.42.; +#X text 12 125 DATATYPE_IN bang float list; +#X text 12 145 DATATYPE_OUT float; +#X text 12 85 DESCRIPTION binary arithmetic operators; +#X text 12 25 NAME + - * / pow max min; +#X text 12 5 GENRE help; +#X text 12 45 KEYWORDS control trigonometry; +#X text 12 225 RELEASE_DATE 1997; +#X text 12 245 RELEASE_VERSION; +#X restore 500 597 pd META; +#X obj 0 442 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +13 -228856 -1 0; +#X obj 0 479 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +0 13 -228856 -1 0; +#X obj 0 523 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +0 13 -228856 -1 0; +#N canvas 94 481 428 109 Related_objects 0; +#X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X obj 56 75 cos~; +#X obj 88 75 osc~; +#X obj 22 75 expr; +#X obj 22 42 sin; +#X obj 48 42 cos; +#X obj 75 42 tan; +#X obj 108 42 atan; +#X obj 143 42 atan2; +#X obj 181 42 exp; +#X obj 208 42 log; +#X obj 236 42 abs; +#X obj 265 42 sqrt; +#X text 7 1 (arithmetic_operators) Related Objects; +#X restore 102 597 pd Related_objects; +#X obj 78 333 cnv 17 3 70 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 98 386 list; +#X text 98 450 float; +#X obj 78 451 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X obj 78 414 cnv 17 3 17 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X text 98 413 float; +#X text 78 499 1) float; +#X obj 363 3 +; +#X obj 388 3 -; +#X obj 414 3 *; +#X obj 440 3 /; +#X obj 466 3 pow; +#X obj 491 3 max; +#X obj 517 3 min; +#X obj 429 20 pddp/pddplink http://wiki.puredata.info/en/operators +-text pdpedia: operators; +#X obj 128 166 +; +#X msg 94 124 3 4; +#X floatatom 128 124 5 0 0 0 - - -; +#X floatatom 169 124 5 0 0 0 - - -; +#X floatatom 128 193 5 0 0 0 - - -; +#X msg 54 124 bang; +#X text 98 332 bang; +#X text 98 357 float; +#X text 168 413 - a float to the right inlet is stored.; +#X text 168 332 - perform the operation using the last values stored +at the inlets.; +#X text 168 357 - store the incoming value at the left inlet and perform +the operation.; +#X text 168 384 - a pair of floats will be distributed to the two inlets. ; -#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 floatatom 259 124 5 0 0 0 - - -; +#X floatatom 259 193 5 0 0 0 - - -; +#X obj 259 168 * 2; +#X text 118 239 All of these objects share the same behavior.; +#X obj 364 170 pow 4; +#X floatatom 364 193 0 0 0 0 - - -; +#X floatatom 403 126 5 0 0 0 - - -; +#X floatatom 364 126 5 0 0 0 - - -; +#X obj 98 542 pddp/pddplink pow-help.pd; +#X text 168 499 - initializes the value of the right inlet.; +#X text 98 527 Click below for individual help patches:; +#X obj 98 557 pddp/pddplink min-help.pd; +#X obj 98 572 pddp/pddplink max-help.pd; +#X text 11 23 binary arithmetic operators; +#X obj 4 597 pddp/pddplink pddp/help.pd -text help; +#X connect 23 0 27 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; +#X connect 25 0 23 0; +#X connect 26 0 23 1; +#X connect 28 0 23 0; +#X connect 35 0 37 0; +#X connect 37 0 36 0; +#X connect 39 0 40 0; +#X connect 41 0 39 1; +#X connect 42 0 39 0; |