diff --git a/pd/doc/5.reference/preset_hub-help.pd b/pd/doc/5.reference/preset_hub-help.pd index c5c6c66028ce77e1269920989e17abe0b63fef21..fae1643c9245f77c3f5e9d7e15ffd78376c72947 100644 --- a/pd/doc/5.reference/preset_hub-help.pd +++ b/pd/doc/5.reference/preset_hub-help.pd @@ -3,7 +3,7 @@ 0; #X obj 183 294 cnv 15 44 27 empty empty empty 20 12 0 14 -204280 -66577 0; -#X obj 0 1378 cnv 15 552 21 empty \$0-pddp.cnv.footer empty 20 12 0 +#X obj 0 1458 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,14 +18,14 @@ 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 1380 pd META; -#X obj 0 607 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +#X restore 500 1460 pd META; +#X obj 0 687 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 13 -228856 -1 0; -#X obj 0 742 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 +#X obj 0 822 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 0 13 -228856 -1 0; -#X obj 0 912 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 +#X obj 0 992 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 12 0 13 -228856 -1 0; -#X obj 78 357 cnv 17 3 240 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +#X obj 78 357 cnv 17 3 305 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 -162280 0; #N canvas 102 481 428 97 Related_objects 0; #X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 @@ -33,10 +33,10 @@ 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 1380 pd Related_objects; -#X obj 78 616 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +#X restore 101 1460 pd Related_objects; +#X obj 78 696 cnv 17 3 120 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 -162280 0; -#X obj 4 1380 pddp/pddplink all_about_help_patches.pd -text Usage Guide +#X obj 4 1460 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 @@ -54,10 +54,10 @@ to conform to the PDDP template for Pd version 0.42.; #X obj 376 50 cnv 15 159 290 empty empty empty 20 12 0 14 -228856 -66577 0; #X msg 447 139 store \$1; -#X msg 447 80 recall \$1; +#X msg 455 80 recall \$1; #X floatatom 447 115 5 0 0 0 - - -, f 5; -#X msg 395 82 purge; -#X msg 386 60 reset; +#X msg 395 79 purge; +#X msg 386 57 reset; #X msg 447 190 clear \$1; #X floatatom 447 166 5 0 0 0 - - -, f 5; #X obj 386 217 preset_hub another %hidden% %node% 1 32 %preset% 0 99 @@ -82,7 +82,7 @@ to conform to the PDDP template for Pd version 0.42.; #X connect 2 0 3 0; #X restore 119 292 pd sub; #X text 98 416 reset; -#X text 99 616 anything; +#X text 99 696 anything; #X text 98 376 purge; #X text 98 396 recall; #X text 98 436 store; @@ -93,11 +93,11 @@ to conform to the PDDP template for Pd version 0.42.; -1 0; #X floatatom 80 102 5 0 0 0 - - -, f 5; #X floatatom 80 151 5 0 0 0 - - -, f 5; -#X obj 447 58 hradio 15 1 0 4 empty empty empty 0 -8 0 10 -262144 -1 +#X obj 455 58 hradio 15 1 0 4 empty empty empty 0 -8 0 10 -262144 -1 -1 0; -#X obj 98 977 pddp/pddplink preset_node-help.pd; +#X obj 98 1057 pddp/pddplink preset_node-help.pd; #X text 168 436 - store the current state at index n; -#X text 98 949 Scope- [preset_hub foo] is local to its patch and all +#X text 98 1029 Scope- [preset_hub foo] is local to its patch and all of that patch's children (i.e. \, subpatches and abstractions).; #X text 168 376 - purge all orphaned/unused nodes; #X text 98 356 clear; @@ -112,25 +112,25 @@ of that patch's children (i.e. \, subpatches and abstractions).; #X floatatom 249 189 5 0 0 0 - - -, f 5; #X msg 232 244 set another; #X msg 311 244 set test; -#X text 171 759 - OPTIONAL scope for this preset (defaults to null +#X text 171 839 - OPTIONAL scope for this preset (defaults to null or ""); #X text 168 416 - reset all preset node data (wipes hub clean); -#X text 98 499 read; -#X text 81 779 2) symbol file; -#X text 81 869 3) float; -#X text 171 779 - OPTIONAL literal "file" argument instructs hub not +#X text 98 561 read; +#X text 81 859 2) symbol file; +#X text 81 949 3) float; +#X text 171 859 - OPTIONAL literal "file" argument instructs hub not to embed its preset data into the patch but rather assumes that the user will save this data into an external file (see read \, write \, readpreset \, and writepreset message above)--this also means that changes to the preset will not trigger "patch dirty" message; -#X text 171 869 - OPTIONAL argument used exclusively in the K12 mode +#X text 171 949 - OPTIONAL argument used exclusively in the K12 mode that renders preset_hub invisible to GUI operations; -#X text 98 519 write; -#X text 98 539 readpreset; -#X text 168 539 - read one preset (optional 3rd argumemnt \, otherwise +#X text 98 581 write; +#X text 98 601 readpreset; +#X text 168 601 - read one preset (optional 3rd argumemnt \, otherwise preset 0) from a file named in the second argument; -#X text 98 569 writepreset; -#X text 168 569 - write one preset (optional 3rd argumemnt \, otherwise +#X text 98 631 writepreset; +#X text 168 631 - write one preset (optional 3rd argumemnt \, otherwise preset 0) to a file named in the second argument; #N canvas 186 348 428 292 More_info 0; #X obj 30 165 cnv 15 349 98 empty \$0-pddp.cnv.subheading empty 3 12 @@ -152,7 +152,7 @@ same canvas as the abstraction:; #X text 168 205 inside it.; #X text 40 171 [preset_hub foo] <-- this won't apply to [bar] because ; -#X restore 461 955 pd More_info; +#X restore 461 1027 pd More_info; #N canvas 512 381 640 292 More_info 0; #X obj -9 -1 cnv 15 639 20 empty \$0-pddp.cnv.subheading empty 3 12 0 14 -204280 -1 0; @@ -203,8 +203,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 1102 pd More_info; -#X text 98 1094 Writing to and reading from a file- preset_hub can +#X restore 461 1174 pd More_info; +#X text 98 1174 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 @@ -215,18 +215,18 @@ 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 1312 Presets with Arrays- arrays cannot be accessed directly +#X text 98 1392 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 1351 pddp/pddplink preset_node_array-help.pd; -#X text 81 759 1) symbol/float; -#X text 98 995 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).; +#X obj 290 1431 pddp/pddplink preset_node_array-help.pd; +#X text 81 839 1) symbol/float; +#X text 98 1075 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; @@ -253,30 +253,36 @@ looking one level up.; #X connect 5 0 3 0; #X connect 6 0 4 0; #X connect 7 0 8 0; -#X restore 461 1002 pd More_info; +#X restore 461 1074 pd More_info; #X text 168 396 - recall the values stored at index n (n must be >= 0); -#X text 98 1268 Default values- depending on the expected data format +#X text 98 1348 Default values- depending on the expected data format messages when supplied no argument default to null (empty string) or 0; -#X text 98 918 Preset names- only values 0 or greater are valid. No +#X text 98 998 Preset names- only values 0 or greater are valid. No negative preset numbers are possible.; #X text 98 456 sort; #X text 168 456 - sort all presets chronologically and assign them new preset numbers one after another starting with a value n or 0 if no value provided; -#X text 168 499 - reads all presets from a file named in the first +#X text 168 561 - reads all presets from a file named in the first argument; -#X text 168 519 - write all presets to a file named in the first argument +#X text 168 581 - write all presets to a file named in the first argument ; -#X text 169 616 - print message in response to input followed by 1 +#X text 98 502 status; +#X text 168 502 - outputs status via outlet whether any of hub's nodes +have been altered since the last time a preset was stored (0=no \, +1=yes) \, effectively reporting if the current hub's state is saved +or not (also referred to as dirty); +#X text 169 696 - print message in response to input followed by 1 for successful and 0 for failed operation. Some messages provide value pairs (e.g. store and recall) where first value reflects requested preset number and second value reflects whether this action was successful -or not (1 or 0). In addition \, hub outputs "dirty" message whenever -one of its nodes has had its value changed. This allows for implementing -visual cues for reminding user that hub's latest state has not been -saved.; +or not (1 or 0). For example \, hub outputs status message whenever +either hub receives a status message \, or is requested status from +one of its nodes. This allows for implementing visual cues for reminding +user that hub's latest state has not been saved.; +#X msg 403 101 status; #X connect 14 0 20 0; #X connect 15 0 14 0; #X connect 16 0 14 0; @@ -308,3 +314,4 @@ saved.; #X connect 63 0 62 0; #X connect 64 0 58 0; #X connect 65 0 58 0; +#X connect 96 0 29 0; diff --git a/pd/doc/5.reference/preset_node-help.pd b/pd/doc/5.reference/preset_node-help.pd index 109b2117097db9cacc2e252fe7317753663e1d61..9f670c7bce5998ee08ab91dba38a7c9b87a19a04 100644 --- a/pd/doc/5.reference/preset_node-help.pd +++ b/pd/doc/5.reference/preset_node-help.pd @@ -1,13 +1,13 @@ -#N canvas 135 24 553 653 10; -#X obj 180 291 cnv 15 44 27 empty empty empty 20 12 0 14 -204280 -66577 +#N canvas 180 33 553 653 10; +#X obj 180 333 cnv 15 44 27 empty empty empty 20 12 0 14 -204280 -66577 0; #X obj 105 279 cnv 15 60 37 empty empty empty 20 12 0 14 -261234 -66577 0; -#X obj -2 1027 cnv 15 552 21 empty \$0-pddp.cnv.footer empty 20 12 +#X obj -2 1279 cnv 15 552 21 empty \$0-pddp.cnv.footer empty 20 12 0 14 -228856 -66577 0; #X obj -2 0 cnv 15 552 40 empty \$0-pddp.cnv.header preset_node 3 12 0 18 -204280 -1 0; -#X obj -2 339 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 +#X obj -2 372 cnv 3 550 3 empty \$0-pddp.cnv.inlets inlets 8 12 0 13 -228856 -1 0; #N canvas 418 235 482 332 META 0; #X text 12 125 HELP_PATCH_AUTHORS Jonathan Wilkes revised the patch @@ -18,14 +18,14 @@ to conform to the PDDP template for Pd version 0.42.; #X text 12 65 INLET_0 anything; #X text 12 85 OUTLET_0 anything; #X text 12 105 AUTHOR Ivica Ico Bukvic (c) 2012 <ico@vt.edu>; -#X restore 498 1029 pd META; -#X obj -2 693 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 +#X restore 498 1281 pd META; +#X obj -2 796 cnv 3 550 3 empty \$0-pddp.cnv.outlets outlets 8 12 0 13 -228856 -1 0; -#X obj -2 748 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 -0 13 -228856 -1 0; -#X obj -2 798 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 +#X obj -2 1000 cnv 3 550 3 empty \$0-pddp.cnv.argument arguments 8 12 0 13 -228856 -1 0; -#X obj 76 347 cnv 17 3 340 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +#X obj -2 1050 cnv 3 550 3 empty \$0-pddp.cnv.more_info more_info 8 +12 0 13 -228856 -1 0; +#X obj 76 380 cnv 17 3 410 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 -162280 0; #N canvas 102 481 428 93 Related_objects 0; #X obj 1 1 cnv 15 425 20 empty \$0-pddp.cnv.subheading empty 3 12 0 @@ -33,10 +33,10 @@ to conform to the PDDP template for Pd version 0.42.; #X text 7 1 [preset_node] Related Objects; #X obj 22 36 preset_hub default %hidden%; #X obj 141 36 preset_node_array; -#X restore 99 1029 pd Related_objects; -#X obj 76 702 cnv 17 3 17 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 +#X restore 99 1281 pd Related_objects; +#X obj 76 805 cnv 17 3 40 empty \$0-pddp.cnv.let.0 0 5 9 0 16 -228856 -162280 0; -#X obj 2 1029 pddp/pddplink all_about_help_patches.pd -text Usage Guide +#X obj 2 1281 pddp/pddplink all_about_help_patches.pd -text Usage Guide ; #X text 9 20 universal preset system for pd-l2ork; #X obj 472 3 preset_node; @@ -44,7 +44,7 @@ to conform to the PDDP template for Pd version 0.42.; %preset% 2 21.4 %preset% 0 123 %node% 2 42 1 %preset% 0 zero %preset% 1 one %preset% 2 two %node% 1 44 %preset% 0 aaa 32 1 %preset% 1 2.24 nlah 1 %preset% 2 1 2 3 4 %node% 2 50 0 %preset% 0 0 %preset% 1 1 %preset% -2 2; +2 2 %node% 2 98 0; #X msg 78 74 store \$1; #X msg 78 124 recall \$1; #X floatatom 78 50 5 0 0 0 - - -, f 5; @@ -54,12 +54,12 @@ nlah 1 %preset% 2 1 2 3 4 %node% 2 50 0 %preset% 0 0 %preset% 1 1 %preset% #X msg 79 174 clear \$1; #X floatatom 79 150 5 0 0 0 - - -, f 5; #X obj 18 231 print hub_test_says; -#X obj 186 267 preset_node test; -#X floatatom 186 295 5 0 0 0 - - -, f 5; -#X msg 195 213 purge; -#X msg 143 190 reset; -#X msg 246 212 clearall \$1; -#X floatatom 246 191 5 0 0 0 - - -, f 5; +#X obj 186 309 preset_node test; +#X floatatom 186 337 5 0 0 0 - - -, f 5; +#X msg 195 255 purge; +#X msg 143 232 reset; +#X msg 246 254 clearall \$1; +#X floatatom 246 233 5 0 0 0 - - -, f 5; #X obj 377 50 cnv 15 156 279 empty empty empty 20 12 0 14 -233017 -66577 0; #X msg 448 83 store \$1; @@ -76,30 +76,30 @@ nlah 1 %preset% 2 1 2 3 4 %node% 2 50 0 %preset% 0 0 %preset% 1 1 %preset% #X obj 387 244 print hub_another_says; #X obj 18 263 hub_node_abs; #X obj 387 270 preset_node another; -#X obj 185 55 preset_node test; -#X obj 185 139 list; -#X msg 223 75 aaa 32 1; -#X msg 233 95 2.24 nlah 1; -#X obj 185 161 print ----result----; -#X msg 238 115 list 1 2 3 4; -#N canvas 523 458 404 229 sub 0; -#X obj 237 69 preset_node test; -#X floatatom 237 92 5 0 0 0 - - -, f 5; -#X obj 113 69 preset_node another; -#X floatatom 113 91 5 0 0 0 - - -, f 5; -#X text 111 41 a preset in a subpatch; +#X obj 145 73 preset_node test; +#X obj 185 181 list; +#X msg 223 117 aaa 32 1; +#X msg 233 137 2.24 nlah 1; +#X obj 185 203 print ----result----; +#X msg 238 157 list 1 2 3 4; +#N canvas 523 458 404 185 sub 0; +#X obj 216 83 preset_node test; +#X floatatom 216 106 5 0 0 0 - - -, f 5; +#X obj 92 83 preset_node another; +#X floatatom 92 105 5 0 0 0 - - -, f 5; +#X text 90 55 a preset in a subpatch; #X connect 0 0 1 0; #X connect 2 0 3 0; #X restore 115 289 pd sub; -#X text 96 366 clearall; -#X text 96 386 purge; -#X text 97 701 anything; -#X text 167 701 - [preset_node] makes an invisible connection from +#X text 96 399 clearall; +#X text 96 419 purge; +#X text 97 804 anything; +#X text 167 804 - [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 96 839 Scope- [preset_hub foo] is local to its patch and all +#X text 96 1091 Scope- [preset_hub foo] is local to its patch and all of that patch's children (i.e. \, subpatches and abstractions).; -#X obj 96 867 pddp/pddplink preset_hub-help.pd; +#X obj 96 1119 pddp/pddplink preset_hub-help.pd; #N canvas 411 177 428 483 More_info 0; #X obj 271 378 cnv 15 39 23 empty empty empty 20 12 0 14 -261234 -66577 0; @@ -131,7 +131,7 @@ same canvas as the abstraction:; 0; #X msg 213 406 store \$1; #X obj 213 382 hradio 15 1 0 2 empty empty empty 0 -8 0 10 -262144 --1 -1 1; +-1 -1 0; #X msg 275 406 recall \$1; #X msg 92 382 set some_scope; #X obj 58 407 preset_node some_scope; @@ -152,63 +152,92 @@ hub.; #X connect 17 0 20 0; #X connect 18 0 19 0; #X connect 19 0 21 0; -#X restore 457 844 pd More_info; -#X text 166 386 - purge all orphaned/unused nodes (forwarded to hub) +#X restore 457 1091 pd More_info; +#X text 166 419 - purge all orphaned/unused nodes (forwarded to hub) ; -#X text 96 437 reset; -#X text 96 406 recall; -#X text 96 477 store; -#X text 166 437 - reset all preset node data (forwarded to hub); -#X text 166 477 - store the current state at index n (forwarded to +#X text 96 470 reset; +#X text 96 439 recall; +#X text 96 510 store; +#X text 166 470 - reset all preset node data (forwarded to hub); +#X text 166 510 - store the current state at index n (forwarded to hub); -#X text 166 366 - clear all node data at preset n (forwarded to hub) +#X text 166 399 - clear all node data at preset n (forwarded to hub) ; -#X text 96 346 clear; -#X text 166 346 - clear this node data at preset n (forwarded to hub) +#X text 96 379 clear; +#X text 166 379 - clear this node data at preset n (forwarded to hub) ; -#X text 96 457 set; -#X text 166 457 - change context (hub) node is paired with; -#X msg 229 242 set another; -#X msg 308 242 set test; +#X text 96 490 set; +#X text 166 490 - change context (hub) node is paired with; +#X msg 229 284 set another; +#X msg 308 284 set test; #X obj 381 293 cnv 15 44 27 empty empty empty 20 12 0 14 -204280 -66577 0; #X floatatom 387 298 5 0 0 0 - - -, f 5; -#X text 169 765 - OPTIONAL scope for this preset (defaults to null +#X text 169 1017 - OPTIONAL scope for this preset (defaults to null or ""); -#X text 96 543 read; -#X text 96 573 write; -#X text 96 603 readpreset; -#X text 96 643 writepreset; -#X text 166 603 - read one preset (optional 3rd argumemnt \, otherwise +#X text 96 658 read; +#X text 96 688 write; +#X text 96 718 readpreset; +#X text 96 758 writepreset; +#X text 166 718 - read one preset (optional 3rd argumemnt \, otherwise preset 0) from a file named in the second argument (forwarded to hub) ; -#X text 166 643 - write one preset (optional 3rd argumemnt \, otherwise +#X text 166 758 - write one preset (optional 3rd argumemnt \, otherwise preset 0) to a file named in the second argument (forwarded to hub) ; -#X text 96 887 Reading and writing- see preset_hub-help.pd for more +#X text 96 1139 Reading and writing- see preset_hub-help.pd for more info.; -#X obj 96 901 pddp/pddplink preset_hub-help.pd; -#X msg 186 190 clear 0; -#X text 96 962 Presets with Arrays- arrays cannot be accessed directly +#X obj 96 1153 pddp/pddplink preset_hub-help.pd; +#X msg 186 232 clear 0; +#X text 96 1214 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 288 1001 pddp/pddplink preset_node_array-help.pd; -#X text 79 765 1) symbol/float; -#X text 166 406 - recall the values stored at index n where n must +#X obj 288 1253 pddp/pddplink preset_node_array-help.pd; +#X text 79 1017 1) symbol/float; +#X text 166 439 - recall the values stored at index n where n must be >= 0 (forwarded to hub); -#X text 96 808 Recall values- only values 0 or greater are valid. No -negative preset numbers are possible.; -#X text 96 919 Default values- depending on the expected data format +#X text 96 1060 Recall values- only values 0 or greater are valid. +No negative preset numbers are possible.; +#X text 96 1171 Default values- depending on the expected data format messages when supplied no argument default to null (empty string) or 0; -#X text 96 496 sort; -#X text 166 496 - sort all presets chronologically and assign them +#X text 96 529 sort; +#X text 166 529 - sort all presets chronologically and assign them new preset numbers one after another starting with a value n or 0 if no value provided (forwarded to hub); -#X text 166 573 - write all presets to a file named in the first argument +#X text 166 688 - write all presets to a file named in the first argument (forwarded to hub); -#X text 166 543 - reads all presets from a file named in the first +#X text 166 658 - reads all presets from a file named in the first argument (forwarded to hub); +#X obj 76 853 cnv 17 3 142 empty \$0-pddp.cnv.let.0 1 5 9 0 16 -228856 +-162280 0; +#X msg 145 51 status; +#X obj 238 94 print node_test_says; +#X text 97 852 list; +#N canvas 433 184 450 243 preset_without_a_hub_example 0; +#X msg 93 108 status; +#X obj 252 151 print node_test_says; +#X obj 93 130 preset_node nonexistent_hub; +#X text 51 66 click on status and note how its status is -1 \, meaning +there is no hub it is compatible with; +#X connect 0 0 2 0; +#X connect 2 1 1 0; +#X restore 167 976 pd preset_without_a_hub_example; +#X text 96 574 status; +#X text 166 574 - outputs status via node's right (status) outlet whether +any of hub's nodes have been altered since the last time a preset was +stored (0=no \, 1=yes) \, effectively reporting if the current hub's +state is saved or not (also referred to as dirty) \; in addition to +reporting hub's state \, if the node is not paired with any hub \, +it will report a -1; +#X text 167 852 - status outlet where [preset_node] outputs status +of the hub it is paired with (if any). Like hubs \, nodes report hub's +two states: 0 for state being clean (as in no nodes have changed values +since last preset was stored) \, and 1 for dirty (meaning one or more +nodes have changed values since last store). In addition \, node can +also report a state of -1 which means it has not been paired with a +hub yet (or in other words \, it did not find a hub it can pair with +based on requested parameters \, namely scope).; #X connect 15 0 24 0; #X connect 16 0 15 0; #X connect 17 0 15 0; @@ -234,6 +263,7 @@ argument (forwarded to hub); #X connect 40 0 41 0; #X connect 43 0 72 0; #X connect 44 0 45 0; +#X connect 44 1 95 0; #X connect 45 0 48 0; #X connect 46 0 45 0; #X connect 47 0 45 0; @@ -241,3 +271,4 @@ argument (forwarded to hub); #X connect 69 0 25 0; #X connect 70 0 25 0; #X connect 82 0 25 0; +#X connect 94 0 44 0;