From 90a8e65b67724106fa0935e505c6e81d4c9e0369 Mon Sep 17 00:00:00 2001 From: Hans-Christoph Steiner Date: Tue, 18 Sep 2007 23:01:32 +0000 Subject: checked in float help patch based on the newly approved PDDP help template svn path=/trunk/; revision=8738 --- doc/pddp/float-help.pd | 207 ++++++++++++++++++++++++++++--------------------- 1 file changed, 119 insertions(+), 88 deletions(-) diff --git a/doc/pddp/float-help.pd b/doc/pddp/float-help.pd index ae2cb04b..f8fe652e 100644 --- a/doc/pddp/float-help.pd +++ b/doc/pddp/float-help.pd @@ -1,84 +1,59 @@ -#N canvas 217 31 536 593 10; -#X obj 114 560 pddp; -#X obj 8 3 cnv 15 90 578 empty empty empty 20 12 0 14 -233017 -66577 +#N canvas 282 28 573 622 10; +#X obj 5 574 cnv 15 550 20 empty empty empty 20 12 0 14 -228856 -66577 0; -#X floatatom 325 358 5 0 0 0 - - -; -#X floatatom 484 395 5 0 0 0 - - -; -#X floatatom 369 462 5 0 0 0 - - -; -#X msg 304 402 42 7; -#X obj 366 396 bng 15 250 50 0 empty empty "bang" 0 -6 0 8 -262144 --1 -1; -#X floatatom 128 422 5 0 0 0 - - -; -#X msg 128 373 bang; -#X obj 46 18 float; -#X obj 492 17 f; -#X text 111 18 - STORE A FLOATING POINT NUMBER - abbreviation:; -#X msg 249 402 7 3 4; -#X obj 369 436 f; -#X obj 128 397 float 7; -#X text 113 484 doc/2.control.examples/sendnumber.pd; -#X text 371 358 Tip: Shift+drag; -#X text 37 44 INLETS:; -#X text 37 59 - LEFT:; -#X text 104 59 Float - A float at the left inlet will update the stored -value of the object and will send the number immediately to the outlet. +#X obj 5 -12 cnv 15 550 40 empty empty float 3 12 0 18 -204280 -1 0 ; -#X text 104 114 Bang - A bang at the left inlet will force [float] -to send its value to the outlet.; -#X text 104 152 List - A list at the left inlet will be truncated to -include only the first element. The first element in the list will -update the stored value of the object and will send the number immediately -to the outlet.; -#X text 29 220 - RIGHT:; -#X text 105 220 Float - A float at the right inlet is stored for later -use. It will be sent to the left outlet when a float or bang is received -in the left inlet.; -#X text 29 324 OUTLETS:; -#X text 13 272 ARGUMENTS:; -#X text 20 354 EXAMPLES:; -#X text 22 484 SEE ALSO:; -#X text 104 272 One - [float] accepts a single float as a creation -argument which initializes the first value to be sent out the left -outlet.; -#X text 104 325 One - outputs the stored floating point value of the -object.; -#X text 249 384 lists; -#X text 106 355 creation argument; -#N canvas 58 22 401 250 Related_Objects 0; -#X text 25 11 Native Pd Objects; -#X text 23 92 Externals and other object libraries; -#X obj 42 48 int; -#X obj 109 48 symbol; -#X text 36 126 [randomF]; -#X restore 114 508 pd Related_Objects; -#N canvas 57 22 641 622 More_Info 0; -#X text 43 24 All numbers in Pd are kept in 32-bit floating point and -can represent real numbers between -8 \, 388608 and 8.388.608.00; -#X text 11 78 WHAT IS A FLOATING POINT NUMBER?; -#X text 41 267 The following are examples of floating point numbers: +#X obj 4 244 cnv 3 550 3 empty empty inlets 15 12 0 13 -228856 -1 0 ; -#X text 61 293 3; -#X text 62 334 -111.5; -#X text 61 313 0.5; -#X text 40 387 3e-05 : This example is a computer shorthand for scientific -notation. It means 3*10-5 (or 10 to the negative 5th power multiplied -by 3).; -#X text 41 108 According to Webopedia.com \, "computers are integer -machines and are capable of representing real numbers only by using -complex codes." Hence \, real numbers must be 'approximated' by computers -using the "floating point standard". In such a number \, the decimal -point can "float" meaning that there is no fixed number of digits preceding -or following the decimal. A floating point number is therefore a computer's -approximation of a real number.; -#X text 43 453 Interesting side-note: In the early 1990's \, the Intel -80486 was shipped with a math coprocessor to help accelerate the process -of computing floating point numbers (which previously required a considerable -amount of CPU power.) Math coprocessors have since found there way -into nearly every graphics card and CPU available today.; -#X text 62 358 10000 to 1e-16; -#X restore 114 534 pd More_Info; -#X text 158 561 - Dave Sabine \, November 18 \, 2002; -#N canvas 0 22 454 304 float/list 0; +#N canvas 407 510 482 332 META 0; +#X text 12 5 CATEGORY control; +#X text 12 35 KEYWORDS control number float store; +#X text 12 65 DESCRIPTION stores a number; +#X restore 505 576 pd META; +#X obj 83 156 cnv 10 50 16 empty empty empty 20 12 0 14 -262126 -66577 +0; +#X obj 346 163 cnv 10 23 16 empty empty empty 20 12 0 14 -262126 -66577 +0; +#X floatatom 384 135 5 0 0 0 - - -; +#X floatatom 345 187 5 0 0 0 - - -; +#X obj 364 135 bng 15 250 50 0 empty empty empty 20 7 0 12 -4034 -1 +-1; +#X floatatom 85 181 5 0 0 0 - - -; +#X msg 85 73 bang; +#X msg 325 79 7 3 4; +#X obj 345 162 f; +#X obj 85 156 float 7; +#X obj 4 394 cnv 3 550 3 empty empty outlet 15 12 0 13 -228856 -1 0 +; +#X obj 4 444 cnv 3 550 3 empty empty argument 15 12 0 13 -228856 -1 +0; +#X obj 4 494 cnv 3 550 3 empty empty more_info 15 12 0 13 -228856 -1 +0; +#X obj 73 350 cnv 17 3 40 empty empty 1 5 9 0 16 -228856 -162280 0 +; +#X obj 73 264 cnv 17 3 80 empty empty 0 5 9 0 16 -228856 -162280 0 +; +#X text 103 263 BANG - output the currently stored value; +#X text 103 350 FLOAT - a float received on the right inlet is stored +; +#X obj 465 9 pddp/pddplink http://wiki.puredata.info/en/float -text +pdpedia: float; +#X text 103 283 FLOAT - outputs the incoming number and stores it; +#X text 103 303 LIST - truncates to the first element \, outputs that +element \, and stores it; +#X obj 467 -9 float; +#X obj 527 -9 f; +#X text 506 -8 or; +#X msg 105 126 12; +#X msg 138 126 -0.02; +#X msg 53 102 555; +#X msg 344 102 list one 2 3; +#X text 428 101 does not work!; +#X text 104 412 FLOAT - outputs the stored value as a float message +; +#X obj 105 532 pddp/pddplink http://crca.ucsd.edu/~msp/Pd_documentation/x2.htm#s3.1 +-text Pd manual 2.3.1: anatomy of a message; +#N canvas 0 22 458 308 float/list 0; #X msg 75 133 float 1 2 3; #X text 34 22 FLOAT CONVERSION; #X msg 95 187 list 1 2 3; @@ -114,13 +89,69 @@ cut to one element.; #X connect 12 4 11 0; #X connect 14 0 12 0; #X connect 15 0 12 0; -#X restore 229 533 pd float/list conversion; -#X obj 263 506 pddp_open all_about_data_types; -#X connect 2 0 13 0; -#X connect 3 0 13 1; -#X connect 5 0 13 0; -#X connect 6 0 13 0; -#X connect 8 0 14 0; -#X connect 12 0 13 0; -#X connect 13 0 4 0; -#X connect 14 0 7 0; +#X restore 391 541 pd float/list conversion; +#N canvas 57 22 649 630 More_Info 0; +#X text 43 24 All numbers in Pd are kept in 32-bit floating point and +can represent real numbers between -8 \, 388608 and 8.388.608.00; +#X text 11 78 WHAT IS A FLOATING POINT NUMBER?; +#X text 41 267 The following are examples of floating point numbers: +; +#X text 61 293 3; +#X text 62 334 -111.5; +#X text 61 313 0.5; +#X text 40 387 3e-05 : This example is a computer shorthand for scientific +notation. It means 3*10-5 (or 10 to the negative 5th power multiplied +by 3).; +#X text 41 108 According to Webopedia.com \, "computers are integer +machines and are capable of representing real numbers only by using +complex codes." Hence \, real numbers must be 'approximated' by computers +using the "floating point standard". In such a number \, the decimal +point can "float" meaning that there is no fixed number of digits preceding +or following the decimal. A floating point number is therefore a computer's +approximation of a real number.; +#X text 43 453 Interesting side-note: In the early 1990's \, the Intel +80486 was shipped with a math coprocessor to help accelerate the process +of computing floating point numbers (which previously required a considerable +amount of CPU power.) Math coprocessors have since found there way +into nearly every graphics card and CPU available today.; +#X text 62 358 10000 to 1e-16; +#X restore 390 517 pd More_Info; +#X obj 105 549 pddp/pddplink http://en.wikipedia.org/wiki/Floating_point +; +#X text 120 72 outputs argument; +#X text 91 101 overrides argument; +#X text 103 462 [float] accepts a single number as a creation argument +which sets value that is stored.; +#N canvas 309 454 609 478 guts 0; +#X obj 117 95 textfile; +#X msg 116 24 symbol template-HCS.pd; +#X msg 116 54 read \$1 \, rewind \, bang; +#X obj 117 141 trigger bang anything; +#X obj 58 117 bang; +#X obj 240 162 route #X; +#X obj 240 183 route text; +#X obj 240 250 route DESCRIPTION; +#X obj 239 276 print; +#X obj 140 277 print TEXT; +#X connect 0 0 3 0; +#X connect 1 0 2 0; +#X connect 2 0 0 0; +#X connect 3 0 4 0; +#X connect 3 1 5 0; +#X connect 4 0 0 0; +#X connect 5 0 6 0; +#X connect 7 0 8 0; +#X restore 454 576 pd guts; +#X text 16 8 description: stores a number; +#X text 106 516 all_about_data-types.pd; +#X text 138 157 stores value; +#X connect 6 0 12 1; +#X connect 8 0 12 0; +#X connect 10 0 13 0; +#X connect 11 0 12 0; +#X connect 12 0 7 0; +#X connect 13 0 9 0; +#X connect 27 0 13 1; +#X connect 28 0 13 1; +#X connect 29 0 13 0; +#X connect 30 0 12 0; -- cgit v1.2.1