#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 -233017 -33289 0; #X obj 0 168 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 -228856 -1 0; #N canvas 507 26 494 625 META 0; #X text 12 95 RELEASE_VERSION 0.41.4; #X text 158 96 Keywords:; #X text 12 5 GENRE help; #X text 12 65 DESCRIPTION using help patches in Pure Data; #X text 12 25 KEYWORDS needs_work (mention how pd finds help files and replace 'common_terminology' subpatch with link to glossary); #X text 117 111 control- control rate objects \; signal- audiorate objects \; data_structure- objects for creating and managing data structures \; nonlocal- objects that can make nonlocal connections to other objects (i.e. \, communicate with other objects without using wires) \; storage- objects whose main function is to store a value \; array- objects for creating and editing arrays \; GUI- objects that provide a graphical user interface \; MIDI- objects that provide MIDI functionality \; time- objects that measure time or which the user can use to manipulate time \; unfinished- help patches under construction \; orphan- help patches that can't get accessed by right clicking on the corresponding object (like [drawsymbol]) \; block-oriented- see Matju's definition \; analysis- object that does analysis \; conversion- convert from one set of units to another \; filter \; network \; trigonometry \; soundfile- object that can play \, manipulate \, and/or save a sound file (wav \, ogg \, mp3 \, etc.). \; random- object outputs a random value \, list \, or signal \; symbol_op- object that manipulates or stores a symbol \; list_op- object that manipulates or stores a list \; canvas_op- object whose behavior only makes sense in terms of a canvas \; patchfile_op- object whose behavior only makes sense in terms of a patchfile \; ramp - a ramp \; bandlimited \; pd-op - object that can report on or manipulate global Pd operation \; anything_op - store or manipulate an anything \; abstraction_op - object that only makes sense in terms of abstractions; #X restore 500 597 pd META; #X obj 0 390 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 13 -228856 -1 0; #X obj 0 427 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 0 13 -228856 -1 0; #X obj 0 503 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 0 13 -228856 -1 0; #N canvas 78 483 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 text 6 1 Related Objects; #X obj 19 57 pddp/helplink pddp/pddplink; #X obj 19 83 pddp/helplink pddp/helplink; #X obj 21 33 pddp/pddplink all_about_externals.pd -text _________; #X obj 21 33 pddp/pddplink all_about_externals.pd -text Externals; #X restore 101 597 pd Related_objects; #X obj 78 177 cnv 17 3 42 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 -162280 0; #X obj 78 399 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 -162280 0; #X obj 78 298 cnv 17 3 35 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 -162280 0; #X obj 78 344 cnv 17 3 35 empty \$0-pddp.cnv.let.r r 5 9 0 16 -228856 -162280 0; #N canvas 117 160 428 384 More_about_creation_arguments 0; #X obj 110 143 float 6.5; #X obj 110 118 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 -1; #X floatatom 110 175 5 0 0 0 - - -; #X obj 260 143 symbol foo; #X obj 260 118 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 -1; #X symbolatom 260 175 10 0 0 0 - - -; #X text 40 143 Examples:; #X obj 22 292 delwrite~ help-delay 500; #X obj 0 210 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 14 -204280 -1 0; #X text 7 211 Creation Argument Numbers; #X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 14 -204280 -1 0; #X text 7 1 More About Creation Arguments; #X text 20 332 Arguments: 1 symbol atom "help-delay"; #X text 86 347 2 float "500"; #X text 19 246 For most objects in Pd \, the zeroth argument is the class name (i.e. \, the name of the object itself) \, so it isn't written explicitly.; #X text 80 317 (0 symbol atom "delwrite~"); #X text 19 37 Creation arguments initialize an object's behavior. They can be numbers or symbols. Some objects \, like [route] \, can take an arbitrary number of arguments. In the example below \, the arguments "6.5" and "foo" specify initial values for [float] and [symbol] objects \, respectively.; #X connect 0 0 2 0; #X connect 1 0 0 0; #X connect 3 0 5 0; #X connect 4 0 3 0; #X restore 101 527 pd More_about_creation_arguments; #N canvas 70 265 428 280 Message_types 0; #X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 14 -204280 -1 0; #X text 7 1 Message types; #X text 19 108 float; #X text 19 128 list; #X text 69 108 - floating point number; #X text 19 78 bang; #X text 19 199 symbol; #X text 19 179 pointer; #X text 19 218 signal; #X text 19 35 anything; #X text 69 218 - audio signal; #X text 69 179 - the so-called "gpointer" (used with data-structures) ; #X text 69 78 - the single selector "bang". Usually it is used to trigger the object to perform an action.; #X text 69 128 - message with the "list" selector plus two or more elements. Also includes implicit lists-- messages made up of two or more atoms in which the first atom is a float atom.; #X text 69 199 - selector "symbol" \, followed by a symbol atom; #X text 69 35 - any message (including messages with custom selectors) ; #N canvas 95 140 428 253 about_custom_selectors 0; #X msg 24 90 set 20; #X msg 24 117 clear; #X text 111 61 Documented as:; #X text 19 61 Message:; #X text 112 90 "set" message or "set"; #X text 111 117 "clear" message or "clear"; #X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 14 -204280 -33289 0; #X msg 168 162 set 20; #X floatatom 131 196 5 0 0 0 - - -; #X obj 131 215 print OUTPUT; #X floatatom 131 164 5 0 0 0 - - -; #X text 19 37 Many objects accept custom messages like:; #X text 7 1 [help] Messages with Custom Selectors; #X connect 7 0 8 0; #X connect 8 0 9 0; #X connect 10 0 8 0; #X restore 84 56 pd about_custom_selectors; #X text 19 238 (inactive); #X text 79 238 - some objects like [noise~] will draw an inlet that accepts no messages. These xlets are labeled (inactive).; #X restore 101 202 pd Message_types; #X text 98 507 mention how pd finds help files; #X text 98 176 message type; #X text 178 176 - description of behavior; #X msg 151 125 42; #X floatatom 151 147 5 0 0 0 - - -; #X text 180 125 <-- Click the message box; #X obj 455 51 pddp/dsp; #X obj -1 0 cnv 15 552 40 empty \$0-pddp.cnv.header help_patches 3 12 0 18 -204280 -1 0; #X obj 465 20 pddp/pddplink http://wiki.puredata.info/en/help -text pdpedia: help; #X obj 426 89 cnv 15 122 44 empty empty empty 20 12 0 10 -191407 -1 0; #X obj 423 86 cnv 15 122 44 empty empty empty 20 12 0 10 -1 -1 0; #X obj 424 87 cnv 15 120 42 empty empty empty 20 12 0 10 -261106 -1 0; #X text 426 110 that produce sound.; #X text 426 98 appears in patches; #X obj 120 301 cnv 15 352 31 empty empty empty 20 12 0 10 -191407 -1 0; #X obj 117 298 cnv 15 352 31 empty empty empty 20 12 0 10 -1 -1 0; #X obj 118 299 cnv 15 350 29 empty empty empty 20 12 0 10 -261106 -1 0; #X obj 78 229 cnv 17 3 57 empty \$0-pddp.cnv.let.1 1 5 9 0 16 -228856 -162280 0; #X obj 120 347 cnv 15 352 31 empty empty empty 20 12 0 10 -191407 -1 0; #X obj 117 344 cnv 15 352 31 empty empty empty 20 12 0 10 -1 -1 0; #X obj 118 345 cnv 15 350 29 empty empty empty 20 12 0 10 -261106 -1 0; #X text 120 344 Some objects have a final \, rightmost inlet that has a specific behavior. This is identified by the letter "r".; #X obj 120 231 cnv 15 355 54 empty empty empty 20 12 0 10 -191407 -1 0; #X obj 117 228 cnv 15 355 54 empty empty empty 20 12 0 10 -1 -1 0; #X obj 118 229 cnv 15 353 52 empty empty empty 20 12 0 10 -261106 -1 0; #X obj 44 64 cnv 15 356 55 empty empty empty 20 12 0 10 -191407 -1 0; #X obj 41 61 cnv 15 356 55 empty empty empty 20 12 0 10 -1 -1 0; #X obj 42 62 cnv 15 354 53 empty empty empty 20 12 0 10 -261106 -1 0; #X text 44 60 Help patches start with a short example that demonstrates the object being used. Most are interactive \, like the one below. Help patches are read-only by default \, so you can't accidentally overwrite anything in them.; #X text 98 398 message type; #X text 178 398 - description of behavior; #X obj 269 4 cnv 15 172 33 empty 411-cnv65 empty 20 12 0 10 -191407 -1 0; #X obj 265 0 cnv 15 172 33 empty 411-cnv66 empty 20 12 0 10 -1 -1 0 ; #X obj 266 1 cnv 15 170 31 empty 411-cnv67 empty 20 12 0 10 -261106 -1 0; #X text 268 12 it's shown at the right -->; #X text 269 1 If the object has an alias; #X obj 454 4 trigger; #X obj 523 4 t; #X text 502 4 or; #X text 80 445 1) atom type; #X text 167 445 - description of behavior; #X obj 336 439 cnv 15 198 53 empty empty empty 20 12 0 10 -191407 -1 0; #X obj 333 436 cnv 15 198 53 empty empty empty 20 12 0 10 -1 -1 0; #X obj 334 437 cnv 15 196 51 empty empty empty 20 12 0 10 -261106 -1 0; #X text 337 448 after the object name to define; #X text 337 470 initialize its value(s).; #X text 337 437 Many objects accept arguments; #N canvas 71 285 428 178 Argument_types 0; #X obj 0 0 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 14 -204280 -1 0; #X text 7 1 Argument types; #X text 19 35 float; #X text 89 35 - a float atom; #X text 19 55 symbol atom; #X text 89 55 - symbol atom; #X text 19 75 comma; #X text 19 95 semicolon; #X text 19 125 Note: dollar atoms ("\$1") and dollsym atoms ("\$1-foo") are automatically expanded by Pd. They therefore may be used in any object box.; #X text 89 75 - comma atom (used in objects like [expr] \, msg box) ; #X text 89 95 - semicolon atom (also used in [expr] \, msg box); #X restore 101 467 pd Argument_types; #X obj 336 525 cnv 15 169 55 empty empty empty 20 12 0 10 -191407 -1 0; #X obj 333 522 cnv 15 169 55 empty empty empty 20 12 0 10 -1 -1 0; #X obj 334 523 cnv 15 167 53 empty empty empty 20 12 0 10 -261106 -1 0; #X text 336 534 as well as links to; #X text 336 546 tutorials or other help; #X text 336 557 patches \, may be found here.; #X text 336 523 Important object behavior \,; #X text 121 227 Inlet numbers are listed \, starting from zero and in left-to-right order. The same goes for the outlets. Additional information may sometimes appear in a subpatch \, like the one above-- click it with the mouse to open it.; #X obj 99 572 pddp/pddplink all_about_messages.pd; #X text 337 459 the object's behavior or to; #X text 120 298 "n" means there is a variable number of inlets \, the exact number of which is determined by creation argument(s).; #X text 11 23 usage guide for internal help patches; #X obj 99 552 pddp/pddplink glossary.pd; #X obj 5 597 pddp/pddplink all_about.pd -text All About Pd; #X text 426 87 The 'dsp' button; #X connect 16 0 17 0;