From 716c261b5796766f07fbb682790f86a5be9e8ab8 Mon Sep 17 00:00:00 2001 From: Frank Barknecht Date: Mon, 18 Oct 2004 14:35:04 +0000 Subject: Memento finally got a help file! svn path=/trunk/abstractions/rradical/; revision=2119 --- memento/commun-help.pd | 4 ++ memento/memento-help.pd | 162 +++++++++++++++++++++++++++++++++++++++++++++ memento/originator-help.pd | 4 ++ memento/originator.pd | 150 +++++++++++++++++++++-------------------- 4 files changed, 247 insertions(+), 73 deletions(-) create mode 100644 memento/commun-help.pd create mode 100644 memento/memento-help.pd create mode 100644 memento/originator-help.pd diff --git a/memento/commun-help.pd b/memento/commun-help.pd new file mode 100644 index 0000000..9684742 --- /dev/null +++ b/memento/commun-help.pd @@ -0,0 +1,4 @@ +#N canvas 303 394 496 308 10; +#X obj 181 151 memento-help; +#X text 47 80 Please see this help patch for explanation on the memento +systen \, originator \, commun and caretakers:; diff --git a/memento/memento-help.pd b/memento/memento-help.pd new file mode 100644 index 0000000..249deee --- /dev/null +++ b/memento/memento-help.pd @@ -0,0 +1,162 @@ +#N canvas 403 333 642 445 10; +#X text 14 92 originator requires two arguments: arg1 must start with +a slash and will be the general name of a state. arg2 is used to communicate +with commun objects.; +#X text 10 225 caretakers are independent of these: They can collect +all currently actuve states and save them.; +#N canvas 121 22 1029 567 originator-help 0; +#X obj 42 182 originator /name \$0; +#X text 168 238 OSC-outlet; +#X obj 170 212 print OSC-out; +#X text 36 337 Outlet 0: value outlet; +#X obj 170 146 r \$0-OSC; +#X text 40 96 Inlet 0: main method inlet; +#X text 167 125 Inlet 1: OSC-inlet; +#X obj 42 313 print value; +#X text 384 190 set: sets all commun-ized state variable to the values +stored in the originator's active state; +#X text 385 257 setsub SUBSTATE: shortcut for "substate SUBSTATE \, +set"; +#X text 384 377 copy/paste: copies and pastes a substate.; +#X obj 42 122 r \$0-or; +#X obj 849 112 s \$0-or; +#X msg 389 95 create /othername; +#X text 385 30 ======================; +#X text 385 14 Methods of originator; +#X obj 850 177 s \$0-or; +#X msg 390 160 substate 2; +#X text 384 123 substate SUBSTATE: sets originator to operate on substate +SUBSTATE. Currently has to be a float.; +#X obj 850 247 s \$0-or; +#X obj 852 292 s \$0-or; +#X obj 850 367 s \$0-or; +#X msg 387 350 get /something; +#X msg 387 403 copy; +#X msg 433 403 paste; +#X obj 850 420 s \$0-or; +#X obj 847 481 s \$0-or; +#X msg 386 464 svxdir /tmp/saved.xml; +#X msg 559 464 ldxdir /tmp/saved.xml; +#X msg 390 230 set; +#X msg 470 160 substate 0; +#X obj 106 272 print key/value; +#X text 103 292 Outlet 1: outlet for "key value(s)"; +#X text 385 298 get /VARNAME: prints out value of /VARNAME in the current +substate to the value and key/value outlets. Will print error \, if +/VARNAME wasn't set.; +#X obj 79 495 s SET_ALL_RRADICALS; +#X text 16 514 This is a global receiver in every [originator] \, that +accepts everything \, the method inlet accepts. Use with care.; +#X text 13 461 Tip:; +#X msg 598 350 get /alist; +#X msg 499 350 get /asymbol; +#X msg 475 275 setsub 2; +#X msg 388 275 setsub 0; +#X text 382 427 svxdir/ldxdir PATH: saves or restores the contents +of a substate to an xml file in PATH. Bound to be buggy!; +#X msg 79 470 setsub 0; +#X text 385 49 create /NAME: will create a (new) state called /NAME. +Beware of the slash! Also note \, that states created using this will +*not* be OSC-targets!; +#X connect 0 0 7 0; +#X connect 0 1 31 0; +#X connect 0 2 2 0; +#X connect 4 0 0 1; +#X connect 11 0 0 0; +#X connect 13 0 12 0; +#X connect 17 0 16 0; +#X connect 22 0 21 0; +#X connect 23 0 25 0; +#X connect 24 0 25 0; +#X connect 27 0 26 0; +#X connect 28 0 26 0; +#X connect 29 0 19 0; +#X connect 30 0 16 0; +#X connect 37 0 21 0; +#X connect 38 0 21 0; +#X connect 39 0 20 0; +#X connect 40 0 20 0; +#X connect 42 0 34 0; +#X restore 17 318 pd originator-help; +#N canvas 83 654 517 308 commun-help 0; +#X obj 61 65 commun /something \$0; +#X floatatom 99 32 5 0 0 0 - - -; +#X obj 65 184 commun /alist \$0; +#X obj 65 217 unpack 0 0; +#X obj 65 164 pack 0 0; +#X floatatom 97 116 5 0 0 0 - - -; +#X floatatom 141 116 5 0 0 0 - - -; +#X obj 233 212 symbol; +#X obj 233 186 commun /asymbol \$0; +#X symbolatom 233 159 10 0 0 0 - - -; +#X text 248 64 Some typical uses of [commun]; +#X obj 141 137 t b f; +#X obj 233 127 r \$0-thesymbol; +#X obj 233 238 s \$0-thesymbol; +#X text 282 211 unfortunatly this is necessary.; +#X connect 0 0 1 0; +#X connect 1 0 0 0; +#X connect 2 0 3 0; +#X connect 3 0 5 0; +#X connect 3 1 6 0; +#X connect 4 0 2 0; +#X connect 5 0 4 0; +#X connect 6 0 11 0; +#X connect 7 0 13 0; +#X connect 8 0 7 0; +#X connect 9 0 8 0; +#X connect 11 0 4 0; +#X connect 11 1 4 1; +#X connect 12 0 9 0; +#X restore 16 379 pd commun-help; +#X text 14 278 Detailed help on [originator]; +#X text 12 350 Detailed help on [commun]; +#X obj 322 314 careGUI; +#N canvas 449 91 628 618 OSC-in-originator 0; +#X obj 28 366 s \$0-OSC; +#X text 18 19 OSC in [originator]; +#X text 16 170 Setting commun-watched elements; +#X text 19 33 ==================; +#X text 15 184 --------------------------------; +#X text 22 204 OSC messages are build by concatenating the originator's +arg1 with the intended commun's arg1.; +#X text 24 244 In this help patch \, originator's arg1 is: "/name" +\, and there are three communs: /something \, /alist \, /asymbol. So +we have three possible OSC targets:; +#X msg 28 337 /name/alist 1 2; +#X msg 27 317 /name/asymbol puredata; +#X msg 27 295 /name/something 300; +#X text 24 385 sends to originator in "pd originator-help". Watch "pd +commun-help" for changes!; +#X text 25 440 Substate changing through OSC; +#X text 24 454 -----------------------------; +#X obj 34 564 s \$0-OSC; +#X msg 191 349 /name/*symbol wildcards_are_possible_too; +#X msg 34 529 /name/preset 0; +#X msg 154 529 /name/substate 2; +#X text 21 471 An OSC-message using "/preset" or "substate" as final +target will generate a "setsub" message:; +#X text 21 51 The OSC-outlet of originator will print out OSC formatted +messages of any change you do to the commun-watched elements. Substate +changes will let the OSC-outlet print a "/NAME/preset preset#" message. +(/NAME being arg1 in originator.); +#X text 21 125 The OSC-inlet of originator accepts OSC formatted messages +to remotely set all commun-watched elements and do a basic substate +management.; +#X connect 7 0 0 0; +#X connect 8 0 0 0; +#X connect 9 0 0 0; +#X connect 14 0 0 0; +#X connect 15 0 13 0; +#X connect 16 0 13 0; +#X restore 158 317 pd OSC-in-originator; +#X text 324 284 Select a FILE to SAVE to or RESTORE from.; +#X obj 1 2 cnv 15 640 30 empty empty Memento_-_Flexible_State_Saving_For_Pure_data +20 12 0 14 -260818 -123526 0; +#X text 13 54 Memento consists of three abstractions: [originator] +\, [commun] \, [care*] (care* can be careGUI \, careOSC \, ...); +#X text 14 146 commun requires two args: arg1 must start with a slash +and will be the variable name of one "thing" to save inside the state +specified by originator's arg1. arg2 will select the originator to +use: communs will talk to all originators \, whose arg2 equals its +own arg2.; diff --git a/memento/originator-help.pd b/memento/originator-help.pd new file mode 100644 index 0000000..9684742 --- /dev/null +++ b/memento/originator-help.pd @@ -0,0 +1,4 @@ +#N canvas 303 394 496 308 10; +#X obj 181 151 memento-help; +#X text 47 80 Please see this help patch for explanation on the memento +systen \, originator \, commun and caretakers:; diff --git a/memento/originator.pd b/memento/originator.pd index 71afcd0..5d9fbc5 100644 --- a/memento/originator.pd +++ b/memento/originator.pd @@ -69,10 +69,9 @@ variables.; #X msg 170 103 create help; #X msg 261 103 set memento; #X obj 777 348 inlet; -#X obj 535 300 prepend set; #X obj 178 297 s \$0-substate; -#X obj 787 463 r \$0-substate; -#X msg 787 492 substate \$1; +#X obj 828 482 r \$0-substate; +#X msg 828 511 substate \$1; #X msg 99 471 copy; #X msg 210 472 paste; #X obj 134 514 s \$0-pool; @@ -82,7 +81,7 @@ variables.; #X obj 563 460 s \$2-in; #X obj 197 418 r \$0-set; #X obj 148 472 s \$0-set; -#X obj 787 521 s \$0-pool; +#X obj 828 540 s \$0-pool; #X obj 225 274 s \$0-pool; #X text 462 154 a state is the content of a memento subdirectory named by a number.; @@ -159,7 +158,6 @@ by a number.; #X text 641 515 OSC outlet; #X obj 637 461 OSCprepend \$1; #X msg 720 487 setsub \$1; -#X obj 764 437 OSCroute /preset; #X obj 720 547 s \$0-setsub; #X obj 173 77 r \$0-setsub; #X obj 161 378 select copy paste set; @@ -176,71 +174,77 @@ by a number.; #X text 795 218 \$2 == \$0 parent; #X msg 818 270 set \$1; #X obj 818 298 s \$2-parentstate; -#X connect 5 0 68 0; -#X connect 10 0 55 0; -#X connect 11 0 62 1; -#X connect 12 0 68 0; -#X connect 13 0 68 0; -#X connect 14 0 32 0; -#X connect 15 0 55 0; -#X connect 17 0 18 0; -#X connect 18 0 28 0; -#X connect 19 0 21 0; -#X connect 20 0 21 0; -#X connect 22 0 67 0; -#X connect 23 0 27 0; -#X connect 23 1 20 0; -#X connect 24 0 37 0; -#X connect 26 0 6 0; -#X connect 32 0 36 0; -#X connect 32 0 64 0; -#X connect 34 0 15 0; -#X connect 34 0 62 0; -#X connect 37 0 25 0; -#X connect 39 0 41 0; -#X connect 40 0 29 0; -#X connect 41 0 29 0; -#X connect 41 1 40 0; -#X connect 42 0 37 0; -#X connect 43 0 50 0; -#X connect 44 0 43 1; -#X connect 44 0 49 1; -#X connect 44 1 42 1; -#X connect 45 0 39 0; -#X connect 45 1 46 0; -#X connect 47 0 48 0; -#X connect 48 0 43 0; -#X connect 49 0 38 0; -#X connect 54 0 69 0; -#X connect 54 1 53 0; -#X connect 55 0 42 0; -#X connect 55 0 48 0; -#X connect 55 0 49 0; -#X connect 55 1 24 0; -#X connect 55 1 47 0; -#X connect 55 2 11 0; -#X connect 56 0 72 0; -#X connect 56 1 71 0; -#X connect 57 0 59 0; -#X connect 58 0 59 0; -#X connect 62 0 60 0; -#X connect 63 0 65 0; -#X connect 64 0 63 0; -#X connect 66 0 68 0; -#X connect 67 0 19 0; -#X connect 67 1 23 0; -#X connect 67 2 6 0; -#X connect 68 0 4 0; -#X connect 68 1 16 0; -#X connect 68 2 45 0; -#X connect 68 3 54 0; -#X connect 68 4 22 0; -#X connect 68 4 56 0; -#X connect 70 0 57 0; -#X connect 71 0 58 0; -#X connect 72 0 73 0; -#X connect 72 1 70 0; -#X connect 73 0 22 0; -#X connect 75 0 68 0; -#X connect 77 0 79 0; -#X connect 79 0 80 0; +#X obj 535 300 prepend set; +#X obj 764 437 OSCroute /preset /substate; +#X msg 745 513 /preset \$1; +#X connect 5 0 66 0; +#X connect 10 0 54 0; +#X connect 11 0 61 1; +#X connect 12 0 66 0; +#X connect 13 0 66 0; +#X connect 14 0 31 0; +#X connect 16 0 17 0; +#X connect 16 0 81 0; +#X connect 17 0 27 0; +#X connect 18 0 20 0; +#X connect 19 0 20 0; +#X connect 21 0 65 0; +#X connect 22 0 26 0; +#X connect 22 1 19 0; +#X connect 23 0 36 0; +#X connect 25 0 6 0; +#X connect 31 0 35 0; +#X connect 31 0 80 0; +#X connect 33 0 61 0; +#X connect 33 0 79 0; +#X connect 36 0 24 0; +#X connect 38 0 40 0; +#X connect 39 0 28 0; +#X connect 40 0 28 0; +#X connect 40 1 39 0; +#X connect 41 0 36 0; +#X connect 42 0 49 0; +#X connect 43 0 42 1; +#X connect 43 0 48 1; +#X connect 43 1 41 1; +#X connect 44 0 38 0; +#X connect 44 1 45 0; +#X connect 46 0 47 0; +#X connect 47 0 42 0; +#X connect 48 0 37 0; +#X connect 53 0 67 0; +#X connect 53 1 52 0; +#X connect 54 0 41 0; +#X connect 54 0 47 0; +#X connect 54 0 48 0; +#X connect 54 1 23 0; +#X connect 54 1 46 0; +#X connect 54 2 11 0; +#X connect 55 0 70 0; +#X connect 55 1 69 0; +#X connect 56 0 58 0; +#X connect 57 0 58 0; +#X connect 61 0 59 0; +#X connect 62 0 63 0; +#X connect 64 0 66 0; +#X connect 65 0 18 0; +#X connect 65 1 22 0; +#X connect 65 2 6 0; +#X connect 66 0 4 0; +#X connect 66 1 15 0; +#X connect 66 2 44 0; +#X connect 66 3 53 0; +#X connect 66 4 21 0; +#X connect 66 4 55 0; +#X connect 68 0 56 0; +#X connect 69 0 57 0; +#X connect 70 0 71 0; +#X connect 70 1 68 0; +#X connect 71 0 21 0; +#X connect 73 0 66 0; +#X connect 75 0 77 0; +#X connect 77 0 78 0; +#X connect 79 0 54 0; +#X connect 80 0 62 0; +#X connect 80 1 62 0; +#X connect 81 0 61 0; -- cgit v1.2.1