diff --git a/pd/doc/5.reference/preset_hub-help.pd b/pd/doc/5.reference/preset_hub-help.pd index 415dd98fd2103cfb861acfc16fab0b78422b4313..0fc3fbdb4cf2f42fd509def0bd974ccba97cb27d 100644 --- a/pd/doc/5.reference/preset_hub-help.pd +++ b/pd/doc/5.reference/preset_hub-help.pd @@ -1,9 +1,9 @@ -#N canvas 214 51 553 651 10; +#N canvas 214 51 553 653 10; #X obj 109 282 cnv 15 60 37 empty empty empty 20 12 0 14 -261234 -66577 0; #X obj 183 294 cnv 15 44 27 empty empty empty 20 12 0 14 -204280 -66577 0; -#X obj 0 1111 cnv 15 552 21 empty \$0-pddp.cnv.footer empty 20 12 0 +#X obj 0 1204 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 preset_hub 3 12 0 18 -204280 -1 0; @@ -18,7 +18,7 @@ to conform to the PDDP template for Pd version 0.42.; #X text 12 85 OUTLET_0 anything; #X text 12 105 AUTHOR Ivica Ico Bukvic (c) 2012 <ico@vt.edu>; #X text 12 65 INLET_0 clear purge recall reset store; -#X restore 500 1113 pd META; +#X restore 500 1206 pd META; #X obj 0 563 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 13 -228856 -1 0; #X obj 0 608 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 @@ -33,17 +33,17 @@ to conform to the PDDP template for Pd version 0.42.; #X obj 22 36 preset_node; #X text 7 1 [preset_hub] Related Objects; #X obj 98 36 preset_node_array; -#X restore 101 1113 pd Related_objects; +#X restore 101 1206 pd Related_objects; #X obj 78 572 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 -162280 0; -#X obj 4 1113 pddp/pddplink all_about_help_patches.pd -text Usage Guide +#X obj 4 1206 pddp/pddplink all_about_help_patches.pd -text Usage Guide ; #X text 11 20 universal preset system for pd-l2ork; #X obj 20 202 preset_hub test %hidden% %node% 2 31 1 %preset% 1 problems %preset% 2 skidoo %preset% 3 nights %preset% 0 stooges %node% 1 33 %preset% 0 aaa 32 1 %preset% 1 2.24 nlah 1 %preset% 2 1 2 3 4 %node% 2 39 0 %preset% 0 1 %preset% 1 5 %preset% 2 9 %node% 1 61 %preset% -0 22.1 %preset% 1 0.5 %preset% 2 3.14; +0 22.1 %preset% 1 0.5 %preset% 2 3.14 %node% 1 59; #X msg 80 125 store \$1; #X msg 80 74 recall \$1; #X msg 30 73 purge; @@ -82,12 +82,9 @@ to conform to the PDDP template for Pd version 0.42.; #X restore 119 292 pd sub; #X text 98 416 reset; #X text 99 572 anything; -#X obj 425 21 pddp/pddplink http://wiki.puredata.info/en/preset_hub --text pdpedia: preset_hub; #X text 98 376 purge; #X text 98 396 recall; #X text 98 436 store; -#X text 81 625 1) symbol; #X obj 381 305 cnv 15 44 27 empty empty empty 20 12 0 14 -204280 -66577 0; #X floatatom 386 310 5 0 0 0 - - -; @@ -105,7 +102,7 @@ of that patch's children (i.e. \, subpatches and abstractions).; #X text 168 376 - purge all orphaned/unused nodes; #X text 98 356 clear; #X text 168 356 - clears preset n for all nodes; -#X obj 479 3 preset_hub %hidden% %node% 2 10 1 %node% 2 90 37 %node% +#X obj 479 3 preset_hub %hidden% %node% 2 10 1 %node% 2 90 37 %node% 3 10 3 37; #X obj 189 271 preset_node test; #X floatatom 189 299 5 0 0 0 - - -; @@ -213,8 +210,8 @@ files into specific folders.; #X connect 16 0 2 0; #X connect 17 0 2 0; #X connect 18 0 2 0; -#X restore 461 841 pd More_info; -#X text 98 833 Writing to and reading from a file- preset_hub can also +#X restore 461 938 pd More_info; +#X text 98 930 Writing to and reading from a file- preset_hub can also write to an external file and read from it. More so \, the optional 2nd creation argument (literal symbol "file") prevents preset_hub from trying to save itself into the patch. Hub can read/write all preset @@ -225,12 +222,47 @@ in the hub. Only valid nodes will be imported. Node data that does not have a valid node in the existing patch will be silently dropped. Reading a single preset will automatically recall it as soon as the preset has been loaded.; -#X text 98 1007 Default values- messages when supplied no argument +#X text 98 1104 Default values- messages when supplied no argument default to 0 or empty string; -#X text 98 1041 Presets with Arrays- arrays cannot be accessed directly +#X text 98 1138 Presets with Arrays- arrays cannot be accessed directly as they have no direct inlets and outlets. For this reason we use preset_node_array abstraction to read/write to/from arrays. For additional info see; -#X obj 290 1080 pddp/pddplink preset_node_array-help.pd; +#X obj 290 1177 pddp/pddplink preset_node_array-help.pd; +#X text 81 625 1) symbol/float; +#X text 98 831 Modular Scope- arguments starting with $ (e.g. \$1 or +\$2blah) allow modular creation of preset_hub and node's scopes inside +embedded abstractions. As long as both hub and node share the same +scope \, they will see each other regardless of what scope is given +them at creation time \, including no scope at all (as is the case +with the rest of pd-l2ork \, \$1 with no argument given reverts to +0).; +#N canvas 186 348 428 332 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 7 1 [preset_hub] More info on modular scope; +#X obj 39 98 preset_hub \$1 %hidden% %node% 1 7 %preset% 0 555 %preset% +1 444 %preset% 2 333 %preset% 3 222 %preset% 4 111 %preset% 5 0; +#X msg 39 63 store \$1; +#X msg 106 63 recall \$1; +#X floatatom 39 42 5 0 0 0 - - -; +#X floatatom 106 41 5 0 0 0 - - -; +#X obj 38 135 preset_node \$1; +#X floatatom 38 157 5 0 0 0 - - -; +#X text 34 191 Notice how the hub and node are paired even no optional +argument has been given to this patch? Note that in this case [preset_hub +\$1] is different from [preset_hub] as latter actually is defined as +null symol or "" while former is equal to float 0 (if no argument is +given. This hub-node pairing is also independent from anything found +in parent patch since node has found its match in this patcher before +looking one level up.; +#X text 142 39 <-- recall presets 0-5; +#X text 73 155 <-- note how the value changes with each recall; +#X connect 3 0 2 0; +#X connect 4 0 2 0; +#X connect 5 0 3 0; +#X connect 6 0 4 0; +#X connect 7 0 8 0; +#X restore 461 838 pd More_info; #X connect 14 0 20 0; #X connect 15 0 14 0; #X connect 16 0 14 0; @@ -245,20 +277,20 @@ abstraction to read/write to/from arrays. For additional info see; #X connect 27 0 29 0; #X connect 28 0 27 0; #X connect 29 0 30 0; -#X connect 32 0 48 0; +#X connect 32 0 46 0; #X connect 33 0 34 0; #X connect 34 0 37 0; #X connect 35 0 34 0; #X connect 36 0 34 0; #X connect 38 0 34 0; -#X connect 49 0 16 0; -#X connect 50 0 15 0; -#X connect 51 0 19 0; -#X connect 52 0 23 0; -#X connect 61 0 62 0; -#X connect 63 0 61 0; -#X connect 64 0 61 0; -#X connect 65 0 61 0; -#X connect 66 0 65 0; -#X connect 68 0 61 0; -#X connect 69 0 61 0; +#X connect 47 0 16 0; +#X connect 48 0 15 0; +#X connect 49 0 19 0; +#X connect 50 0 23 0; +#X connect 59 0 60 0; +#X connect 61 0 59 0; +#X connect 62 0 59 0; +#X connect 63 0 59 0; +#X connect 64 0 63 0; +#X connect 66 0 59 0; +#X connect 67 0 59 0; diff --git a/pd/doc/5.reference/preset_node-help.pd b/pd/doc/5.reference/preset_node-help.pd index 4892198a467e6935277ce4301f42a71cef23e9ad..3eb0b7ea789f7deeca77f2d2db2fa6e143e0f9ca 100644 --- a/pd/doc/5.reference/preset_node-help.pd +++ b/pd/doc/5.reference/preset_node-help.pd @@ -40,12 +40,10 @@ to conform to the PDDP template for Pd version 0.42.; ; #X text 9 20 universal preset system for pd-l2ork; #X obj 472 3 preset_node; -#X obj 418 21 pddp/pddplink http://wiki.puredata.info/en/preset_node --text pdpedia: preset_node; -#X obj 18 202 preset_hub test %hidden% %node% 1 26 %preset% 1 55.2 -%preset% 2 21.4 %preset% 0 123 %node% 2 43 1 %preset% 0 zero %preset% -1 one %preset% 2 two %node% 1 46 %preset% 0 aaa 32 1 %preset% 1 2.24 -nlah 1 %preset% 2 1 2 3 4 %node% 2 52 0 %preset% 0 0 %preset% 1 1 %preset% +#X obj 18 202 preset_hub test %hidden% %node% 1 25 %preset% 1 55.2 +%preset% 2 21.4 %preset% 0 123 %node% 2 42 1 %preset% 0 zero %preset% +1 one %preset% 2 two %node% 1 45 %preset% 0 aaa 32 1 %preset% 1 2.24 +nlah 1 %preset% 2 1 2 3 4 %node% 2 51 0 %preset% 0 0 %preset% 1 1 %preset% 2 2; #X msg 78 74 store \$1; #X msg 78 124 recall \$1; @@ -72,8 +70,8 @@ nlah 1 %preset% 2 1 2 3 4 %node% 2 52 0 %preset% 0 0 %preset% 1 1 %preset% #X msg 387 60 reset; #X msg 448 184 clear \$1; #X floatatom 448 160 5 0 0 0 - - -; -#X obj 387 217 preset_hub another %hidden% %node% 1 44 %preset% 0 -5.1 -%preset% 1 22 %preset% 2 1.001 %node% 2 52 2 %preset% 0 41 %preset% +#X obj 387 217 preset_hub another %hidden% %node% 1 43 %preset% 0 -5.1 +%preset% 1 22 %preset% 2 1.001 %node% 2 51 2 %preset% 0 41 %preset% 1 101 %preset% 2 7.13; #X obj 387 244 print hub_another_says; #X obj 18 263 hub_node_abs; @@ -100,7 +98,6 @@ nlah 1 %preset% 2 1 2 3 4 %node% 2 52 0 %preset% 0 0 %preset% 1 1 %preset% #X text 167 642 - [preset_node] makes an invisible connection from the object below it back to its inlet. It can recall whatever type of message the connected object can output.; -#X text 79 705 1) symbol; #X text 96 745 Scope- [preset_hub foo] is local to its patch and all of that patch's children (i.e. \, subpatches and abstractions).; #X obj 96 773 pddp/pddplink preset_hub-help.pd; @@ -139,7 +136,7 @@ same canvas as the abstraction:; #X msg 275 406 recall \$1; #X msg 92 382 set some_scope; #X obj 58 407 preset_node some_scope; -#X obj 213 433 preset_hub %hidden% %node% 2 60 17 %preset% 0 50 %preset% +#X obj 213 433 preset_hub %hidden% %node% 2 60 17 %preset% 0 50 %preset% 1 100 %node% 2 60 19 %preset% 0 50 %preset% 1 100; #X floatatom 58 435 5 0 0 0 - - -; #X text 19 275 Setting node scope via "set" message allows for dynamic @@ -204,35 +201,36 @@ to 0 or empty string; as they have no direct inlets and outlets. For this reason we use preset_node_array abstraction to read/write to/from arrays. For additional info see; #X obj 288 900 pddp/pddplink preset_node_array-help.pd; -#X connect 16 0 25 0; -#X connect 17 0 16 0; +#X text 79 705 1) symbol/float; +#X connect 15 0 24 0; +#X connect 16 0 15 0; +#X connect 17 0 15 0; #X connect 18 0 16 0; #X connect 19 0 17 0; -#X connect 20 0 18 0; -#X connect 21 0 16 0; -#X connect 22 0 16 0; -#X connect 23 0 16 0; -#X connect 24 0 23 0; -#X connect 26 0 27 0; -#X connect 28 0 26 0; -#X connect 29 0 26 0; -#X connect 30 0 26 0; -#X connect 31 0 30 0; -#X connect 33 0 41 0; -#X connect 34 0 41 0; +#X connect 20 0 15 0; +#X connect 21 0 15 0; +#X connect 22 0 15 0; +#X connect 23 0 22 0; +#X connect 25 0 26 0; +#X connect 27 0 25 0; +#X connect 28 0 25 0; +#X connect 29 0 25 0; +#X connect 30 0 29 0; +#X connect 32 0 40 0; +#X connect 33 0 40 0; +#X connect 34 0 32 0; #X connect 35 0 33 0; -#X connect 36 0 34 0; -#X connect 37 0 41 0; -#X connect 38 0 41 0; -#X connect 39 0 41 0; -#X connect 40 0 39 0; -#X connect 41 0 42 0; -#X connect 44 0 76 0; -#X connect 46 0 47 0; -#X connect 47 0 50 0; -#X connect 48 0 47 0; -#X connect 49 0 47 0; -#X connect 51 0 47 0; -#X connect 73 0 26 0; -#X connect 74 0 26 0; -#X connect 88 0 26 0; +#X connect 36 0 40 0; +#X connect 37 0 40 0; +#X connect 38 0 40 0; +#X connect 39 0 38 0; +#X connect 40 0 41 0; +#X connect 43 0 74 0; +#X connect 45 0 46 0; +#X connect 46 0 49 0; +#X connect 47 0 46 0; +#X connect 48 0 46 0; +#X connect 50 0 46 0; +#X connect 71 0 25 0; +#X connect 72 0 25 0; +#X connect 86 0 25 0;