From e900f8a1d4508929055cbbbaa4105cc635eedbd6 Mon Sep 17 00:00:00 2001 From: Jonathan Wilkes Date: Tue, 22 Feb 2011 01:04:32 +0000 Subject: fixed some awkward wording and added blurb about changing args to [pd] svn path=/trunk/; revision=14942 --- doc/pddp/inlet-help.pd | 10 +-- doc/pddp/inlet~-help.pd | 30 ++++----- doc/pddp/outlet-help.pd | 10 +-- doc/pddp/outlet~-help.pd | 29 ++++----- doc/pddp/pd-help.pd | 158 +++++++++++++++++++++++++---------------------- 5 files changed, 124 insertions(+), 113 deletions(-) diff --git a/doc/pddp/inlet-help.pd b/doc/pddp/inlet-help.pd index 3c30faf6..09c405aa 100644 --- a/doc/pddp/inlet-help.pd +++ b/doc/pddp/inlet-help.pd @@ -1,4 +1,4 @@ -#N canvas 0 0 555 619 10; +#N canvas 1 53 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 inlet 3 12 0 18 @@ -81,14 +81,14 @@ argument.; #X text 98 127 The subpatch below shows how to use [inlet] \, [inlet~] \, [outlet] \, and [outlet~] objects to get data into and out of a subpatch:; -#X text 168 434 - an outlet passes any message sent from the parent -patch to the corresponding inlet of this subpatch. When multiple [inlet~] -or [inlet] objects are in one subpatch \, their horizontal order determines -which inlet corresponds to which [inlet~]/[inlet] object.; #X text 98 77 The [inlet] object allows messages to be sent to a subpatch from an object on the parent canvas.; #X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide ; +#X text 168 434 - passes any message that is sent to the subpatch's +inlet in the parent patch. When multiple [inlet~] or [inlet] objects +are in one subpatch \, their horizontal order corresponds with the +inlets drawn on the containing object in the parent patch.; #X connect 14 0 20 1; #X connect 15 0 20 0; #X connect 19 0 13 0; diff --git a/doc/pddp/inlet~-help.pd b/doc/pddp/inlet~-help.pd index 8967c760..09d6665e 100644 --- a/doc/pddp/inlet~-help.pd +++ b/doc/pddp/inlet~-help.pd @@ -1,9 +1,9 @@ -#N canvas 0 0 555 619 10; +#N canvas 1 53 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 inlet~ 3 12 0 18 -204280 -1 0; -#X obj 0 360 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +#X obj 0 350 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 -228856 -1 0; #N canvas 46 242 494 344 META 0; #X text 12 85 LIBRARY internal; @@ -18,9 +18,9 @@ Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. #X text 12 5 KEYWORDS signal nonlocal canvas_op; #X text 12 145 RELEASE_DATE 1997; #X restore 500 597 pd META; -#X obj 0 387 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +#X obj 0 377 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 13 -228856 -1 0; -#X obj 0 464 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +#X obj 0 459 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 0 13 -228856 -1 0; #X obj 0 566 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 0 13 -228856 -1 0; @@ -35,7 +35,7 @@ Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. #X text 8 2 [inlet~] Related Objects; #X text 275 42 [switch~]; #X restore 102 598 pd Related_objects; -#X obj 78 396 cnv 17 3 60 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +#X obj 78 386 cnv 17 3 60 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 -162280 0; #X obj 369 259 print~; #X obj 369 199 sig~ 12; @@ -68,12 +68,12 @@ Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. #X connect 8 0 7 0; #X connect 10 0 9 0; #X restore 126 229 pd subpatch-with-inlets-and-outlets; -#X text 98 363 (none); +#X text 98 353 (none); #X text 11 23 signal inlet for a subpatch; #X obj 477 3 inlet~; #X obj 451 20 pddp/pddplink http://wiki.puredata.info/en/inlet~ -text pdpedia: inlet~; -#X text 98 395 signal; +#X text 98 385 signal; #N canvas 60 123 428 466 up/downsampling 0; #X obj 30 396 print~; #X obj 48 370 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1 @@ -158,20 +158,22 @@ extra samples.; #X connect 13 1 2 0; #X connect 13 2 4 0; #X restore 171 538 pd up/downsampling; -#X text 80 482 1) symbol atom; +#X text 80 477 1) symbol atom; #X text 98 127 The subpatch below shows how to use [inlet] \, [inlet~] \, [outlet] \, and [outlet~] objects to get data into and out of a subpatch:; -#X text 168 395 - the [inlet~] object outputs the signal sent to the -inlet of the subpatch in which it is found. When multiple [inlet~] -or [inlet] objects are in one subpatch \, their horizontal order determines -which inlet corresponds to which [inlet~]/[inlet] object.; -#X text 168 482 - (optional) The word "hold" will cause sample/hold +#X text 168 477 - (optional) The word "hold" will cause sample/hold upsampling/downsampling \, and the word "lin" will cause linear upsampling/downsampling. See the subpatch below for more details:; #X text 98 77 The [inlet~] object allows signals to be sent to a subpatch from objects on the parent canvas.; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X text 168 385 - the [inlet~] object outputs the signal sent to the +inlet of the subpatch in which it is found. When multiple [inlet~] +or [inlet] objects are in one subpatch \, their horizontal order corresponds +with the inlets drawn on the containing object in the parent patch. +; #X connect 10 0 16 1; #X connect 11 0 16 0; #X connect 15 0 9 0; diff --git a/doc/pddp/outlet-help.pd b/doc/pddp/outlet-help.pd index dfe1df6a..468c95ad 100644 --- a/doc/pddp/outlet-help.pd +++ b/doc/pddp/outlet-help.pd @@ -1,4 +1,4 @@ -#N canvas 0 0 555 619 10; +#N canvas 1 53 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 outlet 3 12 0 18 @@ -83,13 +83,13 @@ float argument.; subpatch:; #X text 98 77 The [outlet] object allows messages to be sent from objects in a subpatch to objects on the parent canvas.; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; #X text 168 407 - the inlet passes any message sent to [outlet] to the outlet of canvas in which it is contained. When multiple [outlet~] and/or [outlet] objects are in one subpatch \, their horizontal order -determines which outlet on the subpatch corresponds to which [outlet~]/[outlet] -object.; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; +corresponds to the outlets drawn on the containing object in the parent +patch.; #X connect 17 0 23 1; #X connect 18 0 23 0; #X connect 22 0 16 0; diff --git a/doc/pddp/outlet~-help.pd b/doc/pddp/outlet~-help.pd index 5c233046..e86d6729 100644 --- a/doc/pddp/outlet~-help.pd +++ b/doc/pddp/outlet~-help.pd @@ -3,7 +3,7 @@ 14 -228856 -66577 0; #X obj 0 0 cnv 15 552 40 empty \$0-pddp.cnv.header outlet~ 3 12 0 18 -204280 -1 0; -#X obj 0 357 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +#X obj 0 347 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 -228856 -1 0; #N canvas 46 242 494 344 META 0; #X text 12 85 LIBRARY internal; @@ -18,9 +18,9 @@ Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. #X text 12 5 KEYWORDS signal nonlocal canvas_op; #X text 12 145 RELEASE_DATE 1997; #X restore 500 597 pd META; -#X obj 0 434 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +#X obj 0 429 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 13 -228856 -1 0; -#X obj 0 464 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +#X obj 0 459 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 0 13 -228856 -1 0; #X obj 0 566 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 0 13 -228856 -1 0; @@ -35,7 +35,7 @@ Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. #X text 8 2 [outlet~] Related Objects; #X text 274 43 [switch~]; #X restore 102 598 pd Related_objects; -#X text 98 441 (none); +#X text 98 436 (none); #X text 11 23 signal outlet for a subpatch; #X obj 477 3 outlet~; #X obj 446 20 pddp/pddplink http://wiki.puredata.info/en/outlet~ -text @@ -74,14 +74,9 @@ pdpedia: outlet~; #X text 98 127 The subpatch below shows how to use [inlet] \, [inlet~] \, [outlet] \, and [outlet~] objects to get data into and out of a subpatch:; -#X obj 78 366 cnv 17 3 60 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +#X obj 78 356 cnv 17 3 60 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 -162280 0; -#X text 98 365 signal; -#X text 168 365 - the [outlet~] object passes a signal to the outlet -of the subpatch in the parent canvas. When multiple [outlet~] and/or -[outlet] objects are in one subpatch \, their horizontal order determines -which outlet on the subpatch corresponds to which [outlet~]/[outlet] -object.; +#X text 98 355 signal; #X text 98 77 The [outlet~] object allows signals to be sent from a subpatch to objects on the parent canvas.; #N canvas 60 123 428 466 up/downsampling 0; @@ -168,11 +163,17 @@ extra samples.; #X connect 13 1 2 0; #X connect 13 2 4 0; #X restore 171 538 pd up/downsampling; -#X text 80 482 1) symbol atom; -#X text 168 482 - (optional) The word "hold" will cause sample/hold +#X text 80 477 1) symbol atom; +#X text 168 477 - (optional) The word "hold" will cause sample/hold upsampling/downsampling \, and the word "lin" will cause linear upsampling/downsampling. See the subpatch below for more details:; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X text 168 355 - the [outlet~] object passes a signal to the outlet +of the subpatch in the parent canvas. When multiple [outlet~] and/or +[outlet] objects are in one subpatch \, their horizontal order corresponds +with the outlets drawn on the containing object in the parent patch. +; #X connect 13 0 19 1; #X connect 14 0 19 0; #X connect 18 0 12 0; diff --git a/doc/pddp/pd-help.pd b/doc/pddp/pd-help.pd index 013f133c..00a04d67 100644 --- a/doc/pddp/pd-help.pd +++ b/doc/pddp/pd-help.pd @@ -1,11 +1,11 @@ -#N canvas 0 0 555 619 10; +#N canvas 2 53 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 pd 3 12 0 18 -204280 -1 0; #X obj 0 175 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 -228856 -1 0; -#N canvas 46 242 494 344 META 0; +#N canvas 47 271 494 344 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/; @@ -22,13 +22,13 @@ Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. #X text 12 85 DESCRIPTION subwindow (subpatch); #X text 12 45 KEYWORDS signal canvas_op; #X restore 500 597 pd META; -#X obj 0 314 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +#X obj 0 302 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 13 -228856 -1 0; -#X obj 0 464 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +#X obj 0 432 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 0 13 -228856 -1 0; #X obj 0 539 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 0 13 -228856 -1 0; -#N canvas 54 478 428 109 Related_objects 0; +#N canvas 78 289 428 356 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 text 8 2 [pd] Related Objects; @@ -36,6 +36,18 @@ Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. #X obj 22 73 outlet; #X obj 68 43 inlet~; #X obj 68 73 outlet; +#X obj 128 43 table; +#N canvas 0 0 450 300 (subpatch) 0; +#X coords 0 1 100 -1 200 140 1 0 0; +#X restore 182 44 graph; +#N canvas 0 0 450 300 (subpatch) 0; +#X array \$0-array 100 float 3; +#A 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 +0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 +0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 +0; +#X coords 0 1 100 -1 200 140 1; +#X restore 23 203 graph; #X restore 102 598 pd Related_objects; #X obj 78 184 cnv 17 3 110 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 -162280 0; @@ -45,46 +57,42 @@ Jonathan Wilkes to conform to the PDDP template for Pd version 0.42. pd; #X text 11 23 subwindow (subpatch); #X text 98 183 anything; -#X text 98 247 signal; -#X text 80 483 1) symbol atom; -#X obj 78 323 cnv 17 3 110 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 +#X text 98 242 signal; +#X text 80 451 1) symbol atom; +#X obj 78 311 cnv 17 3 110 empty \$0-pddp.cnv.let.n n 5 9 0 16 -228856 -162280 0; -#X text 98 322 anything; -#X text 98 397 signal; -#X text 168 183 - by default \, [pd] has no inlets. For sending control -messages \, you can create one by placing an [inlet] object inside -the subpatch. One inlet is created for each [inlet] object \, with -horizontal order corresponding between the inlets and the [inlet] objects -inside the subpatch.; -#X text 168 322 - by default \, [pd] has no outlets. For sending control -messages you can create one by placing an [outlet] object inside the -subpatch. One outlet is created for each [outlet] object \, with horizontal -order corresponding between the outlets and the [outlet] objects inside -the subpatch.; -#X text 168 397 - you can create a signal outlet by placing an [outlet~] -object inside the subpatch. One outlet is created for each [outlet~] -object \, with horizontal order corresponding between the outlets and -the [outlet~] objects inside the subpatch.; -#X text 168 247 - you can create a signal inlet by placing an [inlet~] -object inside the subpatch. One inlet is created for each [inlet~] -object \, with horizontal order corresponding between the inlets and -the [inlet~] objects inside the subpatch.; +#X text 98 310 anything; +#X text 98 369 signal; #X obj 101 543 pddp/pddplink all_about_canvas_properties.pd -text all_about_canvas_properties ; -#X text 97 42 The [pd] object provides a way to nest canvases. You -can clik on the object to open the subwindow and see the objects inside. -; #X text 97 130 You can also change the graphical properties of the object so that part of the subwindow is visible on the parent (referred to as "graph on parent" or "gop").; #N canvas 0 0 450 300 (subpatch) 0; #X restore 513 3 page; -#X text 167 483 - (optional) specify a name for the subwindow. You -can then use this name with the prefix "pd-" to send messages to the -subpatch itself. Duplicate names are allowed (named messages will be -passed to both subpatches).; #X text 419 3 or (deprecated); -#N canvas 0 0 450 300 with_inlets_and_outlets 0; +#X floatatom 242 86 5 0 0 0 - - -; +#X text 309 80 For help on inlets/outlets \, see:; +#X obj 308 95 pddp/pddplink inlet-help.pd -text inlet-help; +#X obj 308 110 pddp/pddplink inlet~-help.pd -text inlet~-help; +#X obj 398 95 pddp/pddplink outlet-help.pd -text outlet-help; +#X obj 398 110 pddp/pddplink outlet~-help.pd -text outlet~-help; +#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide +; +#X obj 100 560 pddp/pddplink ../2.control.examples/12.PART2.subpatch.pd +-text doc/2.control.examples/12.PART2.subpatch.pd; +#X obj 100 575 pddp/pddplink ../3.audio.examples/G05.execution.order.pd +-text doc/3.audio.examples/G05.execution.order.pd; +#N canvas 559 53 296 107 window_position 1; +#X text 19 8 If you leave open a [pd] subwindow like; +#X text 19 53 patch.; +#X text 19 38 visible the next time you load the; +#X text 19 23 this one and save the patch \, it will be; +#X restore 382 550 pd window_position; +#X text 97 42 The [pd] object provides a way to nest canvases. You +can click on the object to open the subwindow and see the objects inside. +; +#N canvas 1 53 450 300 click_me 0; #X obj 26 50 inlet; #X obj 26 209 outlet; #X text 47 109 Use the [inlet] and [outlet] objects to add inlets and @@ -98,36 +106,41 @@ inlet -> rightmost [inlet] \, and so on.; #X obj 342 205 outlet; #X connect 0 0 1 0; #X connect 3 0 4 0; -#X restore 137 107 pd with_inlets_and_outlets; -#X floatatom 290 86 5 0 0 0 - - -; -#X text 339 78 For help on inlets/outlets \, see:; -#X obj 338 93 pddp/pddplink inlet-help.pd -text inlet-help; -#X obj 338 108 pddp/pddplink inlet~-help.pd -text inlet~-help; -#X obj 428 93 pddp/pddplink outlet-help.pd -text outlet-help; -#X obj 428 108 pddp/pddplink outlet~-help.pd -text outlet~-help; -#X obj 4 597 pddp/pddplink all_about_help_patches.pd -text Usage Guide -; -#X obj 100 560 pddp/pddplink ../2.control.examples/12.PART2.subpatch.pd --text doc/2.control.examples/12.PART2.subpatch.pd; -#X obj 100 575 pddp/pddplink ../3.audio.examples/G05.execution.order.pd --text doc/3.audio.examples/G05.execution.order.pd; -#N canvas 253 436 296 107 with_no_name 0; -#X text 19 8 You don't have to name subpatches.; -#X text 19 23 If you're in a hurry you can just; -#N canvas 256 287 264 105 (subpatch) 0; -#N canvas 257 112 240 113 (subpatch) 0; -#N canvas 244 234 309 126 (subpatch) 0; -#X text 44 34 Ok that's enough. Remember \,; -#X text 44 49 these windows will all go away; -#N canvas 255 362 264 118 thats-enough 0; +#X restore 179 107 pd click_me; +#X text 168 242 - you can create a signal inlet by placing an [inlet~] +object inside the subpatch. If there are multiple [inlet~] objects +\, their horizontal order corresponds to the inlets drawn on the [pd] +object.; +#X text 168 183 - for sending control messages \, you can create an +inlet by placing an [inlet] object inside the subpatch. If there are +multiple [inlet] objects \, their horizontal order corresponds to the +inlets drawn on the [pd] object.; +#X text 168 369 - you can create a signal outlet by placing an [outlet~] +object inside the subpatch. If there are multiple [outlet~] objects +\, their horizontal order corresponds to the outlets drawn on the [pd] +object.; +#X text 168 310 - for sending control messages you can create one by +placing an [outlet] object inside the subpatch. If there are multiple +[outlet] objects \, their horizontal order corresponds to the outlets +drawn on the [pd] object.; +#X text 167 451 - (optional) specify a name for the subwindow \, which +you can use with the prefix "pd-" to send messages to the subpatch +itself. Duplicate names are allowed (named messages will be passed +to both subpatches). For ease of use \, Pd allows you to edit and change +this argument without destroying the data inside the subpatch.; +#N canvas 250 475 296 200 nesting 0; +#N canvas 258 420 264 105 (subpatch) 0; +#N canvas 252 328 240 113 (subpatch) 0; +#N canvas 203 263 309 126 (subpatch) 0; +#N canvas 240 228 264 118 thats-enough 0; #X text 84 38 Ok \, that's it.; #X text 70 53 For real this time.; -#N canvas 3 524 272 64 Really? 0; +#N canvas 264 187 272 64 Really? 0; #X text 2 27 Seriously \,; -#N canvas 6 384 266 81 What? 0; +#N canvas 227 161 266 81 What? 0; #X text 3 58 You're being obsessive.; -#N canvas 8 249 450 72 Who? 0; -#N canvas 9 129 341 101 I 0; +#N canvas 89 146 450 72 Who? 0; +#N canvas 160 252 341 101 I 0; #X text 16 16 Third base!; #X restore 5 5 pd I don't know.; #X text 2 39 Who's on first.; @@ -136,20 +149,15 @@ inlet -> rightmost [inlet] \, and so on.; #X text 2 41 Stop.; #X restore 197 98 pd Really?; #X restore 2 102 pd thats-enough; -#X text 44 63 when you close the parent window.; +#X text 44 24 Ok that's enough. These; +#X text 44 39 windows will all go away when; +#X text 44 53 you close the main patch.; #X restore 138 46 pd; #X text 70 46 Or this:; #X restore 105 60 pd; #X text 91 33 Or this:; -#X restore 101 65 pd; -#X text 19 38 type "pd" in an object \, like this:; -#X restore 382 548 pd with_no_name; -#N canvas 0 0 450 300 click_me 0; -#X text 110 92 This is the inside of the subpatch.; -#X msg 172 122 1; -#X obj 172 149 + 41; -#X obj 172 176 print The_Answer; -#X connect 1 0 2 0; -#X connect 2 0 3 0; -#X restore 50 107 pd click_me; -#X connect 29 0 28 1; +#X restore 130 97 pd; +#X text 19 23 You can of course nest [pd] objects; +#X text 19 38 inside other [pd] objects \, like this:; +#X restore 382 572 pd nesting; +#X connect 22 0 33 1; -- cgit v1.2.1