From 7d6affca746f49f5ffb2818b8a9ccf9d91388e8f Mon Sep 17 00:00:00 2001 From: Jonathan Wilkes Date: Wed, 25 Aug 2010 00:31:27 +0000 Subject: revised help docs that conform to the PDDP template svn path=/trunk/; revision=13942 --- doc/pddp/int-help.pd | 220 +++++++++++++++++++++++++++++++-------------------- 1 file changed, 136 insertions(+), 84 deletions(-) (limited to 'doc/pddp/int-help.pd') diff --git a/doc/pddp/int-help.pd b/doc/pddp/int-help.pd index 17b1d9c9..956db8ca 100644 --- a/doc/pddp/int-help.pd +++ b/doc/pddp/int-help.pd @@ -1,90 +1,142 @@ -#N canvas 9 22 906 517 10; -#X msg 23 230 bang; -#X floatatom 13 313 0 0 0 0 - - -; -#X floatatom 13 208 0 0 0 0 - - -; -#X floatatom 56 264 0 0 0 0 - - -; -#X text 61 230 You can force the object to output the stored number. +#N canvas 0 0 555 619 10; +#X obj 0 595 cnv 15 550 21 empty empty empty 20 12 0 14 -228856 -66577 +0; +#X obj 0 0 cnv 15 550 40 empty empty int 3 12 0 18 -204280 -1 0; +#X obj 0 234 cnv 3 550 3 empty empty inlets 15 12 0 13 -228856 -1 0 +; +#N canvas 49 212 482 395 META 0; +#X text 12 125 PLATFORM windows macosx gnulinux; +#X text 12 205 LIBRARY internal; +#X text 12 245 WEBSITE http://crca.ucsd.edu/~msp/; +#X text 12 85 LICENSE SIBSD; +#X text 12 225 AUTHOR Miller Puckette; +#X text 12 305 HELP_PATCH_AUTHORS This help patch was updated for Pd +version 0.35 test 24 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 5 GENRE help; +#X text 12 65 KEYWORDS control storage; +#X text 12 105 DESCRIPTION store an integer; +#X text 12 25 NAME int; +#X text 12 45 ALIAS i; +#X text 12 145 INLET_0 bang float; +#X text 12 165 INLET_1 float; +#X text 12 185 OUTLET_0 float; +#X text 12 265 RELEASE_DATE 1997; +#X text 12 285 RELEASE_VERSION; +#X restore 500 597 pd META; +#X obj 0 375 cnv 3 550 3 empty empty outlets 15 12 0 13 -228856 -1 +0; +#X obj 0 412 cnv 3 550 3 empty empty arguments 15 12 0 13 -228856 -1 +0; +#X obj 0 475 cnv 3 550 3 empty empty more_info 15 12 0 13 -228856 -1 +0; +#X obj 78 334 cnv 17 3 30 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 +-162280 0; +#X obj 78 243 cnv 17 3 82 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +-162280 0; +#X text 501 4 or; +#X obj 100 524 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 107 165 428 375 More_Info 0; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 19 36 Integers are "whole" numbers - numbers which do not contain +fractions. The following are examples of whole numbers:; +#X text 20 66 1; +#X text 20 81 -544; +#X text 20 110 10024; +#X text 19 95 420; +#X obj 1 161 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 +0 14 -204280 -1 0; +#X text 7 1 [int] What is an integer; +#X text 7 161 [int] Note; +#X text 21 231 -8 \,; +#X text 39 231 388 \,; +#X text 63 231 608; +#X text 22 248 and:; +#X text 33 267 388 \,; +#X text 57 267 608; +#X text 22 267 8 \,; +#X text 21 290 Hence \, the [int] object takes about as much CPU as +the [float] object \; but is useful when numbers need to be truncated +and/or when patches are being designed to be compatible with Pd and +MAX/MSP.; +#X text 21 206 All numbers in Pd are kept in 32-bit floating point +and can represent real numbers between:; +#X restore 102 545 pd More_Info; +#X text 101 508 all_about_data-types.pd; +#X text 98 242 bang; +#X text 98 262 float; +#X text 98 302 list; +#X text 98 334 float; +#N canvas 93 484 428 108 Related_objects 0; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X obj 64 36 value; +#X obj 111 36 list; +#X floatatom 152 37 5 0 0 0 - - -; +#X msg 195 36; +#X obj 22 36 float; +#X obj 22 66 symbol; +#X obj 71 66 random; +#X text 7 1 [int] Related Objects; +#X restore 101 597 pd Related_objects; +#X text 99 382 float; +#X obj 474 3 int; +#X obj 522 3 i; +#X obj 470 21 pddp/pddplink http://wiki.puredata.info/en/int -text +pdpedia: int; +#X msg 115 122 bang; +#X floatatom 105 205 0 0 0 0 - - -; +#X floatatom 105 100 0 0 0 0 - - -; +#X floatatom 144 153 0 0 0 0 - - -; +#X text 153 122 You can force the object to output the stored number. ; -#X text 58 208 You can set and output the value simoultaneously.; -#X text 71 288 You can store the number \, without outputting it.; -#X text 458 142 NOTE; -#X text 10 452 This document was updated for Pd version 0.35 test 24 -by Dave Sabine as part of a project called pddp proposed by Krzysztof -Czaja to build comprehensive documentation for Pd.; -#X text 456 415 RELATED OBJECTS; -#X obj 546 442 symbol; -#X obj 45 12 int; -#X text 9 41 The int object stores an integer (which is set either -by its creation argument or by the right inlet) and then outputs that -number when it receives a "bang" message or a new number in its left -inlet.; -#X text 8 98 This object acts exactly as its nearest cousin:; -#X obj 297 97 float; -#X text 465 159 All numbers in Pd are kept in 32-bit floating point -and can represent real numbers between -8 \, 388 \, 608 and 8 \, 388 -\, 608 Hence \, the [int] object takes about as much CPU as the [float] -object \; but is useful when numbers need to be truncated and/or when -patches are being designed to be compatible with Pd and MAX/MSP.; -#X text 8 160 Tip: Press and hold SHIFT while click-n-dragging these +#X text 150 100 You can set and output the value simoultaneously.; +#X text 172 153 You can store the number \, without outputting it. +; +#X text 100 52 Tip: Press and hold SHIFT while click-n-dragging these number boxes to see how the [int] object truncates the number - drops decimal places.; -#X obj 13 287 int 6.5; -#X text 7 114 with only one exception: All decimal places are dropped! -All fractions will be truncated \; they will not be 'rounded off'. -; -#X obj 465 442 float; -#X obj 603 442 random; -#X text 457 10 WHAT IS AN INTEGER?; -#X text 463 29 Integers are "whole" numbers - numbers which do not -contain fractions. The following are examples of whole numbers:; -#X text 464 59 1; -#X text 464 74 -544; -#X text 464 103 10024; -#X text 463 88 420; -#N canvas 0 22 414 279 related_objects_from_other_libraries 0; -#X obj 22 19 list2int; -#X obj 77 19 i2l; -#X obj 104 19 probalizer 200 200 100 100 1 0 10 1 10 2 10 3 10 4 10 -5 10 6 10 7 10 8 10 9 10 10 10 11 10 12 10 13 10 14 10 15 10 16 10 -17 10 18 10 19 10 20 10 21 10 22 10 23 10 24 10 25 10 26 10 27 10 28 -10 29 10 30 10 31 10 32 10 33 10 34 10 35 10 36 10 37 10 38 10 39 10 -40 10 41 10 42 10 43 10 44 10 45 10 46 10 47 10 48 10 49 10 50 10 51 -10 52 10 53 10 54 10 55 10 56 10 57 10 58 10 59 10 60 10 61 10 62 10 -63 10 64 10 65 10 66 10 67 10 68 10 69 10 70 10 71 10 72 10 73 10 74 -10 75 10 76 10 77 10 78 10 79 10 80 10 81 10 82 10 83 10 84 10 85 10 -86 10 87 10 88 10 89 10 90 10 91 10 92 10 93 10 94 10 95 10 96 10 97 -10 98 10 99 10; -#X text 20 56 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 19 105 The best places to find information about Pd's libraries -is:; -#X text 16 127 www.puredata.org and click on "Downloads" then "Software" +#X obj 105 179 int 6.5; +#X text 100 479 Note: [int] does not 'rounded off' floats. It discards +everything to the right of the decimal point.; +#X obj 78 384 cnv 17 3 17 empty empty 0 5 9 0 16 -228856 -162280 0 ; -#X text 18 157 iem.kug.ac.at/pdb/; -#X restore 464 464 pd related_objects_from_other_libraries; -#X text 466 283 The [int] object can be used as a basis for building +#N canvas 108 391 428 173 Building_a_counter 0; +#X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 +14 -204280 -1 0; +#X text 19 37 The [int] object can be used as a basis for building simple counter mechanisms in Pd. In the example below \, the [int] object's stored value is incremented by 1 with each "bang".; -#X text 11 334 The creation argument initializes the object and stores -the number until the value is reset. The creation argument is optional. -If no creation argument is provided \, the object defaults to zero. -; -#X msg 481 340 bang; -#X obj 481 369 int; -#X obj 509 369 + 1; -#X floatatom 481 395 5 0 0 0 - - -; -#X text 456 263 EXAMPLE: BUILDING A COUNTER; -#X obj 244 12 i; -#X obj 436 3 cnv 10 2 500 empty empty empty 20 12 0 14 -166441 -262144 -0; -#X obj 506 442 f; -#X text 87 11 - STORE AN INTEGER -; -#X connect 0 0 17 0; -#X connect 2 0 17 0; -#X connect 3 0 17 1; -#X connect 17 0 1 0; -#X connect 30 0 31 0; -#X connect 31 0 32 0; -#X connect 31 0 33 0; -#X connect 32 0 31 1; +#X msg 164 84 bang; +#X obj 164 113 int; +#X obj 192 113 + 1; +#X floatatom 164 139 5 0 0 0 - - -; +#X text 7 1 [int] Example: Building a Counter; +#X connect 2 0 3 0; +#X connect 3 0 4 0; +#X connect 3 0 5 0; +#X connect 4 0 3 1; +#X restore 102 567 pd Building_a_counter; +#X text 11 20 store an integer; +#X text 169 430 - initializes the object and stores the number until +the value is reset. The creation argument is optional. If no creation +argument is provided \, the object defaults to zero.; +#X text 169 382 - outputs the stored value as a float message.; +#X text 168 242 - output the currently stored integer.; +#X text 168 262 - [int] will convert an incoming float to an integer-- +all numerals to the right of the decimal place are truncated (dropped). +This value is then sent to the outlet.; +#X text 168 302 - a list is truncated to the first element \, which +is then output and stored.; +#X text 168 334 - a float received at the right inlet is converted +to an integer and stored for later use.; +#X text 81 430 1) float; +#X obj 4 597 pddp/pddplink pddp/help.pd -text help; +#X connect 22 0 30 0; +#X connect 24 0 30 0; +#X connect 25 0 30 1; +#X connect 30 0 23 0; -- cgit v1.2.1