ev_storage-help.pd 46 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989990991992993994995996997998999100010011002100310041005100610071008100910101011101210131014101510161017
  1. #N canvas 124 22 960 756 10;
  2. #X declare -path . -path .. -path data -path ../data -path ev-in -path
  3. ../ev-in -path ev-main -path ../ev-main -path ev-pano -path ../ev-pano
  4. -path ev-pro -path ../ev-pro -path libs/gil -path ../libs/gil -path
  5. libs/kollabs -path ../libs/kollabs -path media -path ../media;
  6. #X obj 40 35 cnv 15 750 16 empty empty EXTENDED_VIEW_PRESET_MANAGEMENT
  7. 20 8 0 14 -233017 -66577 0;
  8. #X obj 40 355 cnv 15 370 80 empty empty description 5 8 0 14 -233017
  9. -66577 0;
  10. #X obj 40 285 cnv 15 370 60 empty empty inlets/outlets 5 8 0 12 -233017
  11. -66577 0;
  12. #X obj 40 189 cnv 15 370 40 empty empty creation_arguments: 3 8 0 12
  13. -191407 -1 0;
  14. #X text 45 208 1st: domain;
  15. #X text 44 381 This is the standard state saving system for the Extended
  16. View Toolkit. Most of the variables of the EV-abstractions are registered
  17. to this system.;
  18. #X text 44 314 Outlet 1: data-stream in osc-style;
  19. #X obj 40 865 cnv 15 370 50 empty empty Load_preset_file_on_startup
  20. 20 12 0 14 -261682 -66577 0;
  21. #X obj 40 445 cnv 15 370 70 empty empty GUI_CONTROLS 20 12 0 14 -232576
  22. -66577 0;
  23. #X obj 40 525 cnv 15 370 170 empty empty Access_controls_from_"outside"
  24. 20 12 0 14 -261682 -66577 0;
  25. #X msg 145 585 0;
  26. #X msg 175 585 1;
  27. #X msg 205 585 2;
  28. #X obj 145 611 s /help/ds/scene;
  29. #X text 45 55 Presets are located in the "../data" folder.;
  30. #X text 61 893 Look inside here:;
  31. #X text 60 646 Look inside here for a list of the most important parameters:
  32. ;
  33. #X text 46 240 By the first creation argument \, the domain of the
  34. module is set (here: "help").;
  35. #X obj 420 62 cnv 15 370 500 empty empty empty 20 12 0 14 -204786 -66577
  36. 0;
  37. #X obj 432 381 gemhead;
  38. #X obj 432 414 ev_grid id0 help;
  39. #X obj 432 306 print ev_storage_output;
  40. #X obj 432 282 spigot;
  41. #X obj 465 260 tgl 15 0 empty empty print 17 7 0 10 -262144 -1 -1 0
  42. 1;
  43. #X text 431 506 This module has specified a save domain by the second
  44. creation argument. It is registered to the "help" domain.;
  45. #X obj 646 456 gemwin 20;
  46. #X msg 646 396 create \, 1;
  47. #X msg 658 418 0 \, destroy;
  48. #X text 575 395 CLICK HERE:;
  49. #X text 60 561 Change scene by clicking these message boxes:;
  50. #X obj 40 925 cnv 15 370 80 empty empty File_layout 20 12 0 14 -228856
  51. -66577 0;
  52. #X text 54 978 Have a look on the syntax:;
  53. #X text 53 951 You can easily edit the preset files with any text editor.
  54. ;
  55. #X text 58 480 The GUI controls are explained in here:;
  56. #X obj 420 571 cnv 15 370 80 empty empty Registering_variables 20 12
  57. 0 14 -261234 -66577 0;
  58. #X text 438 600 Look inside to see how new variables can get registered:
  59. ;
  60. #X obj 420 662 cnv 15 370 700 empty empty Scene_transitions 20 12 0
  61. 14 -203904 -66577 0;
  62. #X obj 618 692 bng 15 250 50 0 /help/ds/advanced/vis /help/ds/advanced/vis
  63. advanced 17 7 0 10 -262144 -1 -1;
  64. #X text 438 691 Go to the advanced settings:;
  65. #X obj 618 719 bng 15 250 50 0 /help/ds/reg/dialog /help/ds/reg/dialog
  66. register_settings 17 7 0 10 -4032 -1 -1;
  67. #X text 438 721 And open the register list:;
  68. #X text 438 741 There \, you can enter the scene transition dialog
  69. for all registered variables of this domain.;
  70. #X text 438 771 The scene transition settings are saved with the DESTINATION
  71. scene.;
  72. #X text 367 35 (c)2012 Marian Weger;
  73. #X obj 425 897 cnv 15 360 80 empty empty Delaying_&_Chaining_Recalls
  74. 20 12 0 14 -204800 -66577 0;
  75. #X obj 425 806 cnv 15 360 80 empty empty Fade_/_Morph 20 12 0 14 -204800
  76. -66577 0;
  77. #X text 443 835 Look inside to see how it is possible to fade between
  78. scenes:;
  79. #X text 443 926 It is also possible to delay recalls or to chain them
  80. to another one:;
  81. #X obj 424 987 cnv 15 360 80 empty empty Occupy 20 12 0 14 -204800
  82. -66577 0;
  83. #X text 442 1016 A variable can be set to ignore all recalls \, until
  84. it is fully dispatched.;
  85. #X obj 424 1077 cnv 15 360 80 empty empty Additional_register_options
  86. 20 12 0 14 -204800 -66577 0;
  87. #X text 442 1106 There are some additional options for registers:;
  88. #X text 543 35 This module uses "kollabs" as a backend.;
  89. #X obj 40 1015 cnv 15 370 120 empty empty Playlist_View 20 12 0 14
  90. -261682 -66577 0;
  91. #X obj 40 1143 cnv 15 370 120 empty empty Advanced_File_Operations
  92. 20 12 0 14 -261234 -66577 0;
  93. #X obj 154 1198 bng 15 250 50 0 /help/ds/edit/dialog /help/ds/edit/dialog
  94. edit 17 7 0 10 -258113 -1 -1;
  95. #X obj 239 1172 bng 15 250 50 0 /help/ds/advanced/vis /help/ds/advanced/vis
  96. advanced 17 7 0 10 -262144 -1 -1;
  97. #X text 59 1171 Go to the advanced settings:;
  98. #X text 59 1198 Click "edit":;
  99. #N canvas 185 56 831 476 \$0-file_layout 0;
  100. #X obj 11 15 cnv 15 810 450 empty empty PRESET_FILE_LAYOUT 20 12 0
  101. 14 -233017 -66577 0;
  102. #X text 215 22 The textfile can also be edited with a simple text editor.
  103. ;
  104. #X text 25 62 The File is formatted as follows:;
  105. #X obj 22 93 cnv 20 420 350 empty empty empty 20 12 0 14 -262144 -66577
  106. 0;
  107. #X text 29 101 ======================== GLOBAL ========================
  108. ;
  109. #X text 29 201 #data;
  110. #X text 29 271 ======================== SCENE <nr> <name>;
  111. #X text 288 271 ========================;
  112. #X text 455 152 After the #settings header \, the settings of the global
  113. data are saved.;
  114. #X text 455 182 After the #data header \, the global data is saved.
  115. ;
  116. #X text 455 302 After the #settings header \, the settings of the scene
  117. data are saved.;
  118. #X text 455 342 After the #data header \, the scene data is saved.
  119. ;
  120. #X text 455 112 After this header \, the global data is saved.;
  121. #X text 455 92 Every preset file starts with a GLOBAL SECTION:;
  122. #X text 455 222 For every scene \, there is a SCENE header \, and two
  123. sections for settings and data.;
  124. #X text 455 252 After this header \, a scene begins. It has a number
  125. (from 0 to N) and a name. The name can only be set by an external text
  126. editor.;
  127. #X text 29 131 #settings;
  128. #X text 29 177 ...;
  129. #X text 29 234 <variable_name_2> <value>;
  130. #X text 29 221 <variable_name_1> <value>;
  131. #X text 29 247 ...;
  132. #X text 29 151 <setting_name_1> <value>;
  133. #X text 29 164 <setting_name_2> <value>;
  134. #X text 29 371 #data;
  135. #X text 29 301 #settings;
  136. #X text 29 347 ...;
  137. #X text 29 404 <variable_name_2> <value>;
  138. #X text 29 391 <variable_name_1> <value>;
  139. #X text 29 417 ...;
  140. #X text 29 321 <setting_name_1> <value>;
  141. #X text 29 334 <setting_name_2> <value>;
  142. #X restore 238 978 pd \$0-file_layout;
  143. #N canvas 185 36 576 616 \$0-controls 0;
  144. #X text 96 -373 (c)2011 Marian Weger /part of EXTENDED VIEW toolkit/
  145. gpl v3;
  146. #X obj 3 -394 cnv 15 550 600 empty empty CONTROLS 20 12 0 14 -228856
  147. -66577 0;
  148. #X obj 41 -354 nbx 3 15 0 999 0 0 /help/ds/scene/current /help/ds/scene/current
  149. scene 0 -8 0 12 -204786 -1 -1 0 256;
  150. #X obj 22 -354 bng 15 250 50 0 /0/ds/scene/current/prev /0/ds/scene/current/prev
  151. < 4 7 0 10 -204786 -1 -1;
  152. #X obj 92 -354 bng 15 250 50 0 /help/ds/scene/current/next /help/ds/scene/current/next
  153. > 5 7 0 10 -204786 -1 -1;
  154. #X obj 115 -354 bng 15 250 50 0 /help/ds/recall /help/ds/recall recall
  155. 17 7 0 10 -4034 -1 -1;
  156. #X obj 24 -193 bng 15 250 50 0 /help/ds/save /help/ds/save save 17
  157. 7 0 10 -258113 -1 -1;
  158. #X obj 24 -99 bng 15 250 50 0 /help/ds/load /help/ds/load load 17 7
  159. 0 10 -4034 -1 -1;
  160. #X obj 94 -193 bng 15 250 50 0 /help/ds/resave /help/ds/resave resave
  161. 17 7 0 10 -258113 -1 -1;
  162. #X obj 94 -99 bng 15 250 50 0 /help/ds/reload /help/ds/reload reload
  163. 17 7 0 10 -4034 -1 -1;
  164. #X obj 114 -270 bng 15 250 50 0 /help/ds/store /help/ds/store store
  165. 17 7 0 10 -258113 -1 -1;
  166. #X obj 41 -270 nbx 3 15 0 999 0 0 /help/ds/scene/selected /help/ds/scene/selected
  167. empty 0 -8 0 12 -261234 -1 -1 0 256;
  168. #X obj 22 -270 bng 15 250 50 0 /help/ds/scene/selected/prev /help/ds/scene/selected/prev
  169. < 4 7 0 10 -261234 -1 -1;
  170. #X obj 92 -270 bng 15 250 50 0 /help/ds/scene/selected/next /help/ds/scene/selected/next
  171. > 5 7 0 10 -261234 -1 -1;
  172. #X text 195 -205 The SAVE section lets you save all scenes from RAM
  173. to a textfile on the HDD. Click "save" to open a save dialog. "resave"
  174. will let you save to the last specified filename.;
  175. #X text 195 -105 The LOAD section lets you load all scenes from a textfile
  176. to RAM. Click "load" to open a load dialog. "reload" will let you load
  177. the last specified filename.;
  178. #X text 195 -355 In the RECALL section \, you can recall a scene from
  179. RAM.;
  180. #X text 195 -275 In the STORE section \, you can store the current
  181. state of the patch into RAM. Select a destination scene and press "store".
  182. ;
  183. #X text 195 -325 Switch between presets 0-2 to see the effect.;
  184. #X obj 24 -39 bng 15 250 50 0 /help/ds/advanced/vis /help/ds/advanced/vis
  185. advanced 17 7 0 10 -262144 -1 -1;
  186. #X obj 24 66 bng 15 250 50 0 /ev/storage/help/playlist/vis /ev/storage/help/playlist/vis
  187. playlist 17 7 0 10 -262144 -1 -1;
  188. #X text 195 -39 This button opens the advanced options.;
  189. #X text 195 68 This button opens the playlist view.;
  190. #X obj 200 -9 cnv 15 260 60 empty empty advanced_settings 20 12 0 14
  191. -204800 -66577 0;
  192. #X text 230 23 Look inside:;
  193. #X obj 200 101 cnv 15 260 60 empty empty playlist_view 20 12 0 14 -204800
  194. -66577 0;
  195. #X text 230 133 Look inside:;
  196. #N canvas 67 22 573 744 \$0-advanced_settings 0;
  197. #X obj 4 8 cnv 15 550 750 empty empty empty 20 12 0 14 -228856 -66577
  198. 0;
  199. #X obj 23 119 tgl 15 1 /help/ds/settings/state /help/ds/settings/state
  200. recall_settings 17 7 0 10 -262144 -1 -1 1 1;
  201. #X obj 23 39 tgl 15 1 /help/ds/data/state /help/ds/data/state recall_data
  202. 17 7 0 10 -262144 -1 -1 1 1;
  203. #X obj 23 282 bng 15 250 50 0 /help/ds/reg/dialog /help/ds/reg/dialog
  204. register_settings 17 7 0 10 -4032 -1 -1;
  205. #X obj 23 206 tgl 15 1 /help/ds/global/state /help/ds/global/state
  206. recall_global 17 7 0 10 -262144 -1 -1 0 1;
  207. #X text 163 37 "recall_data" must be enabled to load the saved data
  208. on a recall.;
  209. #X text 163 117 "recall_settings" must be enabled to recall the scene
  210. transition settings for the saved data.;
  211. #X text 163 204 "recall_global" must be enabled to recall the global
  212. parameters for this storage domain with each recall.;
  213. #X text 163 281 This button opens a list of all variables that are
  214. registered with this domain.;
  215. #X text 163 67 (All variables are saved within the "data" section)
  216. ;
  217. #X text 163 147 (The scene transition settings for the variables are
  218. saved within the "settings" section);
  219. #X text 163 234 ("recall_data" and "recall_settings" are saved in the
  220. "GLOBAL" section);
  221. #X obj 168 349 bng 15 250 50 0 /i/am/a/variable/ds/dialog /i/am/a/variable/ds/dialog
  222. /i/am/a/variable 20 7 0 10 -262144 -1 -1;
  223. #X text 166 325 Click on a variable to get to its scene transition
  224. dialog.;
  225. #X obj 164 386 cnv 15 280 60 empty empty Scene_transition_dialog 20
  226. 12 0 14 -204800 -66577 0;
  227. #X text 174 418 Look inside:;
  228. #N canvas 71 22 960 756 \$0-scene_transition_dialog 0;
  229. #X obj 4 6 cnv 15 910 850 empty empty empty 20 12 0 14 -228856 -66577
  230. 0;
  231. #X obj 23 168 nbx 4 14 -1e+37 1e+37 0 0 /i/am/a/variable/ds/morph/time
  232. /i/am/a/variable/ds/morph/time time/s 47 7 0 10 -4034 -1 -1 0 256;
  233. #X obj 23 128 tgl 15 0 /i/am/a/variable/ds/morph /i/am/a/variable/ds/morph
  234. morph 17 7 0 10 -4034 -1 -1 0 1;
  235. #X obj 23 631 bng 15 250 50 0 /i/am/a/variable/ds/print /i/am/a/variable/ds/print
  236. print_current_value 17 7 0 10 -262144 -1 -1;
  237. #X obj 23 288 nbx 4 14 -1e+37 1e+37 0 0 /i/am/a/variable/ds/morph/curve/shape
  238. /i/am/a/variable/ds/morph/curve/shape shape 47 7 0 10 -204786 -1 -1
  239. 0 256;
  240. #X obj 23 308 nbx 4 14 0 1 0 0 /i/am/a/variable/ds/morph/curve/weight
  241. /i/am/a/variable/ds/morph/curve/weight weight 47 7 0 10 -204786 -1
  242. -1 0 256;
  243. #X obj 23 338 nbx 4 14 10 10000 0 0 /i/am/a/variable/ds/morph/curve/resolution
  244. /i/am/a/variable/ds/morph/curve/resolution resolution 47 7 0 10 -204786
  245. -1 -1 100 256;
  246. #X obj 23 378 hradio 15 1 0 4 /i/am/a/variable/ds/morph/curve/quality
  247. /i/am/a/variable/ds/morph/curve/quality quality 0 -8 0 10 -204786 -1
  248. -1 0;
  249. #X obj 23 244 bng 15 250 50 0 /i/am/a/variable/ds/morph/curve/vis /i/am/a/variable/ds/morph/curve/vis
  250. show_curve 17 7 0 10 -204786 -1 -1;
  251. #X obj 23 188 nbx 4 14 -1e+37 1e+37 0 0 /i/am/a/variable/ds/morph/timegrain
  252. /i/am/a/variable/ds/morph/timegrain time-grain/ms 47 7 0 10 -4034 -1
  253. -1 20 256;
  254. #X obj 23 88 nbx 4 14 -1e+37 1e+37 0 0 /i/am/a/variable/ds/delay /i/am/a/variable/ds/delay
  255. delay 47 7 0 10 -204800 -1 -1 0 256;
  256. #X obj 23 461 tgl 15 0 /i/am/a/variable/ds/occupy /i/am/a/variable/ds/occupy
  257. occupy 17 7 0 10 -262130 -1 -1 1 1;
  258. #X text 173 85 To delay the recall of one variable \, a delay (in seconds)
  259. can be set.;
  260. #X text 173 125 Turn on "morph" to get a smooth fade from the last
  261. value to the value that is saved in the current scene.;
  262. #X text 173 165 Set the fade time in seconds.;
  263. #X text 173 189 Set the data-rate of the fade in ms (default = 20 ms)
  264. ;
  265. #X text 173 199 comment;
  266. #X text 173 228 If no curve is specified \, a linear fade will be applied.
  267. ;
  268. #X text 173 40 The values are saved separately for each parameter in
  269. every scene. They are saved in the "settings" section.;
  270. #X text 173 245 Show the current appearance of the fade curve.;
  271. #X text 173 286 Shape lets you chose a shape for the curve.;
  272. #X text 173 306 Weight is a mix factor between a linear fade and the
  273. chosen shape.;
  274. #X text 173 339 This lets you specify the resolution of the fade curve.
  275. ;
  276. #X text 538 420 2: linear interpolation;
  277. #X text 538 434 3: tabread4 4-point polynomianl interpolation;
  278. #X text 538 406 1: no interpolation;
  279. #X text 538 392 0: bypass --> output=input (default);
  280. #X text 173 379 Choose the quality in which the fade curve will be
  281. applied:;
  282. #X obj 539 268 cnv 15 370 90 empty empty fadecurve 20 12 0 14 -249661
  283. -66577 0;
  284. #X obj 657 329 fadecurve-help;
  285. #X text 549 300 See [fadecurve-help] for more information on these
  286. values.;
  287. #X text 173 462 If "occupy" is set \, the variable will not respond
  288. to another scene recall while it is fading.;
  289. #X text 173 632 For debug reasons \, you can print the current value
  290. of the variable to the console.;
  291. #X obj 23 683 tgl 15 0 \$2/ds/set \$2/ds/set set 17 7 0 10 -228856
  292. -1 -1 0 1;
  293. #X obj 23 736 tgl 15 0 \$2/ds/change \$2/ds/change change 17 7 0 10
  294. -228856 -1 -1 0 1;
  295. #X obj 23 783 tgl 15 0 \$2/ds/nomorph \$2/ds/nomorph morph_deactivate
  296. 17 7 0 10 -228856 -1 -1 0 1;
  297. #X text 173 678 If "set" is activated \, a "set" message will be prepended
  298. to the message when recalled. This option is to prevent loops. It aims
  299. on special cases \, which are not explained here.;
  300. #X text 173 736 If the "change" parameter is set \, the message will
  301. be recalled if the new value differs from the old value.;
  302. #X obj 659 741 change;
  303. #X text 528 742 See [change object]:;
  304. #X text 173 782 Deactivate morphing functionality for this variable.
  305. This needs to be set as a creation argument for [ds_reg] \, when a
  306. variable gets registered to the storage.;
  307. #X text 609 810 nomorph argument deactivates morph functionality.;
  308. #X obj 610 790 ds_reg foo /\$0/bar nomorph;
  309. #X obj 14 536 cnv 15 130 60 empty empty empty 20 12 0 14 -191407 -66577
  310. 0;
  311. #X obj 21 542 bng 15 250 50 0 /i/am/a/variable/ds/settings/copy /i/am/a/variable/ds/settings/copy
  312. COPY_to_buffer 17 7 0 10 -4160 -1 -1;
  313. #X obj 21 576 bng 15 250 50 0 /i/am/a/variable/ds/settings/paste /i/am/a/variable/ds/settings/paste
  314. PASTE_from_buffer 17 7 0 10 -260097 -1 -1;
  315. #X text 173 535 Copy all the settings from above to the register settings
  316. buffer.;
  317. #X text 173 576 Paste the register settings buffer to this register.
  318. ;
  319. #X coords 0 756 1 755 85 60 0;
  320. #X restore 257 418 pd \$0-scene_transition_dialog;
  321. #X obj 23 656 bng 15 250 50 0 /help/ds/edit/dialog /help/ds/edit/dialog
  322. edit 17 7 0 10 -258113 -1 -1;
  323. #X text 163 651 Click on this button to open the file editing dialog.
  324. ;
  325. #X obj 164 676 cnv 15 280 60 empty empty edit 20 12 0 14 -204800 -66577
  326. 0;
  327. #X text 174 708 Look inside:;
  328. #N canvas 162 190 716 469 \$0-edit 0;
  329. #X obj 4 3 cnv 15 700 450 empty empty EDITING_ACTIONS 20 12 0 14 -233017
  330. -66577 0;
  331. #X obj 20 230 bng 15 250 50 0 /help/ds/edit/scene/cut /help/ds/edit/scene/cut
  332. cut 17 7 0 10 -257985 -1 -1;
  333. #X obj 20 270 bng 15 250 50 0 /help/ds/edit/scene/delete /help/ds/edit/scene/delete
  334. delete 17 7 0 10 -258113 -1 -1;
  335. #X obj 20 290 bng 15 250 50 0 /help/ds/edit/scene/paste-override /help/ds/edit/scene/paste-override
  336. paste_overwrite 17 7 0 10 -4032 -1 -1;
  337. #X obj 20 250 bng 15 250 50 0 /help/ds/edit/scene/copy /help/ds/edit/scene/copy
  338. copy 17 7 0 10 -159808 -1 -1;
  339. #X obj 20 310 bng 15 250 50 0 /help/ds/edit/scene/insert /help/ds/edit/scene/insert
  340. insert_blank 17 7 0 10 -204800 -1 -1;
  341. #X obj 20 330 bng 15 250 50 0 /help/ds/edit/scene/paste-insert /help/ds/edit/scene/paste-insert
  342. paste_insert 17 7 0 10 -204800 -1 -1;
  343. #X obj 20 142 bng 15 250 50 0 /help/ds/edit/clear /help/ds/edit/clear
  344. clear_all 17 7 0 10 -262144 -1 -1;
  345. #X obj 20 210 bng 15 250 50 0 /help/ds/edit/scene/clear /help/ds/edit/scene/clear
  346. clear 17 7 0 10 -260097 -1 -1;
  347. #X obj 20 390 bng 15 250 50 0 /main/ds/print/buffer /main/ds/print/buffer
  348. print_clipboard 17 7 0 10 -228856 -1 -1;
  349. #X text 14 182 Actions for the currently selected scene:;
  350. #X text 14 367 Debug:;
  351. #X obj 20 411 bng 15 250 50 0 /main/ds/print /main/ds/print print_all
  352. 17 7 0 10 -262144 -1 -1;
  353. #X text 16 121 Actions on the whole buffer:;
  354. #X obj 532 165 nbx 5 14 -1e+37 1e+37 0 0 /help/ds/scene/selected /help/ds/scene/selected
  355. selected 0 -8 0 10 -261234 -1 -1 0 256;
  356. #X text 412 130 They apply on the currently SELECTED scene:;
  357. #X text 153 398 For debugging: Print contents to the console.;
  358. #X text 153 309 Insert blank scene before the selected scene.;
  359. #X text 153 329 Insert copied/cut scene before the selected scene.
  360. ;
  361. #X text 153 289 Paste scene replacing the selected scene.;
  362. #X text 153 269 Delete selected scene.;
  363. #X text 153 249 Copy selected scene to clipboard.;
  364. #X text 153 229 Cut selected scene to clipboard.;
  365. #X text 153 209 Clear contents of the selected scene.;
  366. #X text 153 141 Clear the whole file.;
  367. #X text 15 35 This dialog provides some file operations on the preset
  368. file.;
  369. #X text 15 65 It is possible to undo these operations by reloading
  370. the preset file from the HDD.;
  371. #X restore 267 713 pd \$0-edit;
  372. #X obj 23 474 bng 15 250 50 0 /help/ds/reg/settings/buffer /help/ds/reg/settings/buffer
  373. register_settings_buffer 17 7 0 10 -257985 -1 -1;
  374. #X text 166 505 The register settings buffer acts as a clipboard for
  375. scene transition settings. The individual registers can copy their
  376. settings to it or take the contents of the buffer. The buffer can also
  377. be edited by hand.;
  378. #X obj 164 566 cnv 15 280 60 empty empty register_settings_buffer 20
  379. 12 0 14 -204800 -66577 0;
  380. #X text 174 598 Look inside:;
  381. #N canvas 428 83 731 472 \$0-buffer 0;
  382. #X obj -6 3 cnv 15 700 450 empty empty Register_Settings_Buffer 20
  383. 12 0 14 -233017 -66577 0;
  384. #X obj 97 100 nbx 4 14 -1e+37 1e+37 0 0 /help/ds/reg/settings/buffer/morph/time
  385. /help/ds/reg/settings/buffer/morph/time time/s 47 7 0 10 -4034 -1 -1
  386. 0 256;
  387. #X obj 11 100 tgl 15 0 /help/ds/reg/settings/buffer/morph /help/ds/reg/settings/buffer/morph
  388. morph 17 7 0 10 -4034 -1 -1 0 1;
  389. #X obj 11 50 tgl 15 0 /help/ds/reg/settings/buffer/slave /help/ds/reg/settings/buffer/slave
  390. slave 17 7 0 10 -203904 -1 -1 0 1;
  391. #X obj 97 140 nbx 4 14 -1e+37 1e+37 0 0 /help/ds/reg/settings/buffer/morph/curve/shape
  392. /help/ds/reg/settings/buffer/morph/curve/shape shape 47 7 0 10 -204786
  393. -1 -1 0 256;
  394. #X obj 97 160 nbx 4 14 0 1 0 0 /help/ds/reg/settings/buffer/morph/curve/weight
  395. /help/ds/reg/settings/buffer/morph/curve/weight weight 47 7 0 10 -204786
  396. -1 -1 0 256;
  397. #X obj 97 180 nbx 4 14 10 10000 0 0 /help/ds/reg/settings/buffer/morph/curve/resolution
  398. /help/ds/reg/settings/buffer/morph/curve/resolution resolution 47 7
  399. 0 10 -204786 -1 -1 100 256;
  400. #X obj 11 180 hradio 15 1 0 4 /help/ds/reg/settings/buffer/morph/curve/quality
  401. /help/ds/reg/settings/buffer/morph/curve/quality quality 0 -8 0 10
  402. -204786 -1 -1 0;
  403. #X obj 11 140 bng 15 250 50 0 /help/ds/reg/settings/buffer/morph/curve/vis
  404. /help/ds/reg/settings/buffer/morph/curve/vis show_curve 17 7 0 10 -204786
  405. -1 -1;
  406. #X obj 97 120 nbx 4 14 -1e+37 1e+37 0 0 /help/ds/reg/settings/buffer/morph/timegrain
  407. /help/ds/reg/settings/buffer/morph/timegrain time-grain/ms 47 7 0 10
  408. -4034 -1 -1 20 256;
  409. #X obj 11 70 nbx 4 14 -1e+37 1e+37 0 0 /help/ds/reg/settings/buffer/delay
  410. /help/ds/reg/settings/buffer/delay delay 47 7 0 10 -204800 -1 -1 0
  411. 256;
  412. #X obj 11 220 tgl 15 0 /help/ds/reg/settings/buffer/occupy /help/ds/reg/settings/buffer/occupy
  413. occupy 17 7 0 10 -262130 -1 -1 1 1;
  414. #X obj 11 322 bng 15 250 50 0 /help/ds/reg/settings/buffer/paste/all
  415. /help/ds/reg/settings/buffer/paste/all send_to_all_registers 17 7 0
  416. 10 -258113 -1 -1;
  417. #X text 285 87 These controls also exist in the "scene transition dialog"
  418. of the individual registers. In this buffer \, they work exactly the
  419. same. The registers can copy their settings to the buffer and paste
  420. the buffer settings to themselves.;
  421. #X text 201 321 This button pastes the buffer settings from above to
  422. all the registers of the current domain. This is sometimes useful if
  423. all parameters should be morphed the same way.;
  424. #X restore 267 603 pd \$0-buffer;
  425. #X restore 314 23 pd \$0-advanced_settings;
  426. #N canvas 394 102 717 314 \$0-playlist 0;
  427. #X obj 2 -168 cnv 15 700 300 empty empty playlist_view 20 12 0 14 -228856
  428. -66577 0;
  429. #X text 14 -142 It is possible to create multiple playlist windows
  430. by using the object [ds_pl_gui <domain>].;
  431. #X text 337 -103 The green column on the left marks the current scene.
  432. ;
  433. #X text 337 -63 The second column (purple) shows the scene numbers.
  434. ;
  435. #X text 337 -23 The big row in the center shows the scene names.;
  436. #X text 337 -8 The names must be set by a text editor in the corresponding
  437. preset file. Per default \, they are set to "<unnamed>".;
  438. #X text 337 32 The red row on the right marks the currently selected
  439. scene.;
  440. #X text 337 51 With the scrollbar on the right \, it is possible to
  441. scroll throgh the scenes.;
  442. #X text 337 101 On the bottom \, the current scene number and its name
  443. are shown.;
  444. #X text 337 -88 Click on it to move the cursor.;
  445. #X obj 14 -100 ds_pl_gui help;
  446. #X coords 0 314 1 313 85 60 0;
  447. #X restore 314 133 pd \$0-playlist;
  448. #X restore 308 480 pd \$0-controls;
  449. #N canvas 131 51 603 374 \$0-init 0;
  450. #X obj 77 79 loadbang;
  451. #X obj 57 79 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1
  452. -1;
  453. #X obj 77 103 del 1000;
  454. #X text 222 45 If you want the storage to recall a scene from a textfile
  455. on startup \, you can specify it as follows:;
  456. #X text 222 140 use the "/<domain>/ds/loadfile" message to load a given
  457. file path:;
  458. #X text 222 98 Delay the load by one second to make sure that the patch
  459. got fully loaded.;
  460. #X obj 77 125 t b b;
  461. #X obj 77 240 del 2000;
  462. #X text 222 238 Delay the recall by two seconds to make sure that the
  463. textfile got fully loaded to RAM.;
  464. #X text 232 283 Recall scene "0".;
  465. #X text 150 103 <--------;
  466. #X text 150 242 <--------;
  467. #X text 188 282 <----;
  468. #X msg 77 282 \; /help/ds/scene 0 \;;
  469. #X msg 104 173 \; /help/ds/loadfile ../../data/ev_storage-help.txt
  470. ;
  471. #X text 140 208 (pathes relative to "./libs/kollabs");
  472. #X connect 0 0 2 0;
  473. #X connect 1 0 2 0;
  474. #X connect 2 0 6 0;
  475. #X connect 6 0 7 0;
  476. #X connect 6 1 14 0;
  477. #X connect 7 0 13 0;
  478. #X restore 179 892 pd \$0-init;
  479. #N canvas 0 22 619 624 \$0-parameter_list 0;
  480. #X obj 6 5 cnv 15 600 600 empty empty control_parameters 20 12 0 14
  481. -233017 -66577 0;
  482. #X text 223 532 reloads the last given filepath from harddisk.;
  483. #X text 223 452 resaves the current scene-set to the last given path.
  484. ;
  485. #X text 223 547 loads the scene-set of the given filepath;
  486. #X text 223 502 opens a dialog to load a scene-set from a file from
  487. the harddisk.;
  488. #X text 223 422 opens a dialog to save the current scene-set to a preset
  489. file on the harddisk.;
  490. #X text 223 467 saves the current scene-set to the given filepath;
  491. #X text 223 249 recalls the selected scene of the current scene-set
  492. ;
  493. #X text 223 264 sets the scene number to be recalled by "recall" or
  494. to be automatically recalled if autorecall=1;
  495. #X text 223 294 decrement scene number by 1;
  496. #X text 223 309 increment scene number by 1;
  497. #X text 223 407 sets the filepath to be loaded/saved on next reload/resave
  498. ;
  499. #X text 11 502 /<domain>/ds/load;
  500. #X text 11 422 /<domain>/ds/save;
  501. #X text 11 532 /<domain>/ds/reload;
  502. #X text 11 452 /<domain>/ds/resave;
  503. #X text 11 407 /<domain>/ds/filename;
  504. #X text 11 547 /<domain>/ds/loadfile;
  505. #X text 11 467 /<domain>/ds/savefile;
  506. #X text 11 249 /<domain>/ds/recall;
  507. #X text 11 294 /<domain>/ds/scene/current/prev;
  508. #X text 11 309 /<domain>/ds/scene/current/next;
  509. #X text 11 279 /<domain>/ds/scene/current;
  510. #X text 11 264 /<domain>/ds/scene OR;
  511. #X text 11 334 /<domain>/ds/scene/selected;
  512. #X text 223 334 sets the scene destination of a file operation;
  513. #X text 11 349 /<domain>/ds/scene/selected/prev;
  514. #X text 11 364 /<domain>/ds/scene/selected/next;
  515. #X text 223 349 decrement destination scene number by 1;
  516. #X text 223 364 increment destination scene number by 1;
  517. #X text 11 379 /<domain>/ds/store;
  518. #X text 223 379 store the current state to the selected scene;
  519. #X text 61 101 There are many other parameters that can be controlled
  520. from outside. If you are familiar with Pure Data \, you can look them
  521. up unside the abstractions.;
  522. #X text 61 51 This is a list of the most important parameters \, that
  523. can be controlled by their receive name.;
  524. #X restore 143 666 pd \$0-parameter_list;
  525. #X obj 60 1061 bng 15 250 50 0 /ev/storage/help/playlist/vis /ev/storage/help/playlist/vis
  526. playlist 17 7 0 10 -262144 -1 -1;
  527. #X obj 228 1198 bng 15 250 50 0 empty empty click_here_for_explanation!
  528. 17 7 0 10 -262144 -1 -1;
  529. #X msg 228 1217 vis 1;
  530. #X obj 228 1238 s pd-\$0-edit;
  531. #X text 53 1040 Click on "playlist" to show the playlist window.;
  532. #X obj 208 1061 bng 15 250 50 0 empty empty click_here_for_explanation!
  533. 17 7 0 10 -262144 -1 -1;
  534. #X msg 208 1080 vis 1;
  535. #X obj 208 1101 s pd-\$0-playlist;
  536. #X obj 40 1273 cnv 15 370 120 empty empty Multiple_domains 20 12 0
  537. 14 -261682 -66577 0;
  538. #X text 54 1306 It is possible to create multiple storage domains.
  539. But variables can not be registered to both domains at the same time.
  540. ;
  541. #N canvas 396 22 602 396 \$0-multiple_domains 0;
  542. #X obj 4 4 cnv 15 370 370 empty empty multiple_domains 20 12 0 14 -228856
  543. -66577 0;
  544. #X obj 385 4 cnv 15 200 370 empty empty empty 20 12 0 14 -204786 -66577
  545. 0;
  546. #N canvas 131 51 603 374 \$0-init 0;
  547. #X obj 77 79 loadbang;
  548. #X obj 57 79 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144 -1
  549. -1;
  550. #X obj 77 103 del 1000;
  551. #X text 222 45 If you want the storage to recall a scene from a textfile
  552. on startup \, you can specify it as follows:;
  553. #X text 222 140 use the "/<domain>/ds/loadfile" message to load a given
  554. file path:;
  555. #X text 222 98 Delay the load by one second to make sure that the patch
  556. got fully loaded.;
  557. #X obj 77 125 t b b;
  558. #X obj 77 220 del 2000;
  559. #X text 222 218 Delay the recall by two seconds to make sure that the
  560. textfile got fully loaded to RAM.;
  561. #X text 232 263 Recall scene "0".;
  562. #X text 150 103 <--------;
  563. #X text 150 222 <--------;
  564. #X text 188 262 <----;
  565. #X msg 77 262 \; /help2/ds/scene 0 \;;
  566. #X msg 104 173 \; /help2/ds/loadfile ../../data/ev_storage-help2.txt
  567. ;
  568. #X connect 0 0 2 0;
  569. #X connect 1 0 2 0;
  570. #X connect 2 0 6 0;
  571. #X connect 6 0 7 0;
  572. #X connect 6 1 14 0;
  573. #X connect 7 0 13 0;
  574. #X restore 441 48 pd \$0-init;
  575. #X obj 401 90 ev_storage help2;
  576. #X text 407 27 Load textfile on startup:;
  577. #X text 14 42 In this example \, we add another domain to the patch.
  578. The module [ev_storage help2] adds a storage with domain "help2". Variables
  579. can be registered to it:;
  580. #X msg 437 292 0;
  581. #X msg 467 292 1;
  582. #X msg 497 292 2;
  583. #X text 387 265 Change scene for domain "help2":;
  584. #X obj 437 334 s /help2/ds/scene;
  585. #X obj 98 163 hsl 128 15 0 127 0 0 /i/am/from/another/domain /i/am/from/another/domain
  586. /i/am/from/another/domain -2 -8 0 10 -262144 -1 -1 3600 1;
  587. #X obj 48 115 ds_reg help2 /i/am/from/another/domain;
  588. #X text 11 227 Variables that are registered with another domain will
  589. not be affected by this storage;
  590. #X connect 6 0 10 0;
  591. #X connect 7 0 10 0;
  592. #X connect 8 0 10 0;
  593. #X restore 144 1350 pd \$0-multiple_domains;
  594. #N canvas 248 152 423 323 \$0-register_options 0;
  595. #X obj 15 -399 cnv 15 370 300 empty empty Register_options 20 12 0
  596. 14 -228856 -66577 0;
  597. #X obj 39 -291 tgl 15 0 /i/must/be/set/ds/set /i/must/be/set/ds/set
  598. set 17 7 0 10 -228856 -1 -1 1 1;
  599. #X obj 41 -148 tgl 15 0 /i/got/changed/ds/change /i/got/changed/ds/change
  600. change 17 7 0 10 -228856 -1 -1 1 1;
  601. #X text 32 -355 To prevent loops creating stack overflows \, it is
  602. possible to prepend a "set" message to a variable if it gets recalled.
  603. This way \, i.e. numberboxes show the new value \, but will not give
  604. it out on the outlet.;
  605. #X text 23 -230 Per default \, saved variables only get dispatched
  606. \, if the recalled value differs from the current value. If a variable
  607. needs to get dispatched \, even if the current value would not change
  608. \, a "nochange" argument can be added to the register.;
  609. #X obj 125 -264 bng 15 250 50 0 /i/must/be/set/ds/dialog /i/must/be/set/ds/dialog
  610. /i/must/be/set 20 7 0 10 -262144 -1 -1;
  611. #X obj 139 -122 bng 15 250 50 0 /i/got/changed/ds/dialog /i/got/changed/ds/dialog
  612. /i/got/changed 20 7 0 10 -262144 -1 -1;
  613. #X obj 121 -291 ds_reg help /i/must/be/set set;
  614. #X obj 121 -149 ds_reg help /i/got/changed nochange;
  615. #X coords 0 323 1 322 85 60 0;
  616. #X restore 531 1128 pd \$0-register_options;
  617. #N canvas 502 147 399 317 \$0-occupy 0;
  618. #X obj 15 -380 cnv 15 370 300 empty empty Occupy 20 12 0 14 -228856
  619. -66577 0;
  620. #X obj 35 -298 bng 15 250 50 0 /i/am/occupied/ds/dialog /i/am/occupied/ds/dialog
  621. /i/am/occupied 20 7 0 10 -262144 -1 -1;
  622. #X obj 35 -264 tgl 15 0 /i/am/occupied/ds/occupy /i/am/occupied/ds/occupy
  623. occupy 17 7 0 10 -262130 -1 -1 1 1;
  624. #X text 23 -235 If "occupy" is set \, the variable will not respond
  625. to another scene recall until it got fully dispatched.;
  626. #X text 23 -195 Per default \, this option is activated. It is saved
  627. individually for each scene.;
  628. #X obj 35 -328 ds_reg help /i/am/occupied;
  629. #X coords 0 317 1 316 85 60 0;
  630. #X restore 573 1040 pd \$0-occupy;
  631. #N canvas 89 22 609 740 \$0-delaying_recalls 0;
  632. #X obj 15 328 cnv 15 370 400 empty empty Recall_Chains 20 12 0 14 -228856
  633. -66577 0;
  634. #X obj 230 450 bng 15 250 50 0 /i/am/a/master/ds/dialog /i/am/a/master/ds/dialog
  635. /i/am/a/master 20 7 0 10 -262144 -1 -1;
  636. #X obj 247 578 bng 15 250 50 0 /i/am/a/slave/ds/dialog /i/am/a/slave/ds/dialog
  637. /i/am/a/slave 20 7 0 10 -262144 -1 -1;
  638. #X text 25 359 It is possible to chain recalls of variables. So that
  639. a variable starts its recall after another one finished recalling.
  640. ;
  641. #X text 25 399 For example \, if one variable should be recalled after
  642. a fade of another one is finished \, no matter how long that fade is.
  643. ;
  644. #X text 51 468 The first outlet bangs after a recall is finished.;
  645. #X text 51 498 The first inlet takes a bang to start the recall. The
  646. "slave" argument sets the register to slave mode.;
  647. #X text 51 558 The slave mode can also be set in the scene transition
  648. dialog. Click here to open it:;
  649. #X text 41 638 You can also do the chaining through sends & receives:
  650. ;
  651. #X obj 392 328 cnv 15 200 400 empty empty empty 20 12 0 14 -204786
  652. -66577 0;
  653. #X obj 415 494 hsl 128 15 0 127 0 0 /i/am/a/master /i/am/a/master /i/am/a/master
  654. -2 -8 0 10 -262144 -1 -1 1100 1;
  655. #X obj 415 554 hsl 128 15 0 127 0 0 /i/am/a/slave /i/am/a/slave /i/am/a/slave
  656. -2 -8 0 10 -262144 -1 -1 1200 1;
  657. #X msg 439 394 0;
  658. #X msg 469 394 1;
  659. #X msg 499 394 2;
  660. #X obj 439 420 s /help/ds/scene;
  661. #X text 394 369 Change scene to see the effect:;
  662. #X obj 15 18 cnv 15 370 300 empty empty Delaying_recalls 20 12 0 14
  663. -228856 -66577 0;
  664. #X obj 392 18 cnv 15 200 300 empty empty empty 20 12 0 14 -204786 -66577
  665. 0;
  666. #X obj 419 162 hsl 128 15 0 127 0 0 /i/am/a/delayed/variable /i/am/a/delayed/variable
  667. /i/am/a/delayed/variable -2 -8 0 10 -262144 -1 -1 1000 1;
  668. #X obj 86 124 bng 15 250 50 0 /i/am/a/delayed/variable/ds/dialog /i/am/a/delayed/variable/ds/dialog
  669. /i/am/a/delayed/variable 20 7 0 10 -262144 -1 -1;
  670. #X msg 439 234 0;
  671. #X msg 469 234 1;
  672. #X msg 499 234 2;
  673. #X obj 439 260 s /help/ds/scene;
  674. #X text 394 209 Change scene to see the effect:;
  675. #X obj 419 92 hsl 128 15 0 127 0 0 /i/am/a/variable /i/am/a/variable
  676. /i/am/a/variable -2 -8 0 10 -262144 -1 -1 900 1;
  677. #X obj 86 184 nbx 4 14 -1e+37 1e+37 0 0 /i/am/a/delayed/variable/ds/delay
  678. /i/am/a/delayed/variable/ds/delay delay 47 7 0 10 -204800 -1 -1 1 256
  679. ;
  680. #X text 25 89 To delay the recall of a variable in a specific scene
  681. \, go to the scene transition dialog:;
  682. #X text 25 159 And set the delay time for the current scene:;
  683. #X text 25 221 The delay time will be saved with the scene.;
  684. #X obj 40 533 ds_reg help /i/am/a/slave slave;
  685. #X obj 63 689 s <name>/ds/slave/start;
  686. #X obj 63 664 r <name>/ds/dispatched;
  687. #X obj 40 449 ds_reg help /i/am/a/master;
  688. #X obj 112 57 ds_reg help /i/am/a/delayed/variable;
  689. #X connect 12 0 15 0;
  690. #X connect 13 0 15 0;
  691. #X connect 14 0 15 0;
  692. #X connect 21 0 24 0;
  693. #X connect 22 0 24 0;
  694. #X connect 23 0 24 0;
  695. #X connect 33 0 32 0;
  696. #X connect 34 0 31 0;
  697. #X coords 0 740 1 739 85 60 0;
  698. #X restore 534 950 pd \$0-delaying_recalls;
  699. #N canvas 85 22 610 756 \$0-scene_transitions 0;
  700. #X obj 4 4 cnv 15 370 370 empty empty Linear_fade_between_scenes 20
  701. 12 0 14 -228856 -66577 0;
  702. #X obj 383 4 cnv 15 200 370 empty empty empty 20 12 0 14 -204786 -66577
  703. 0;
  704. #X obj 393 309 hsl 128 15 0 127 0 0 /i/am/a/morphing/variable /i/am/a/morphing/variable
  705. /i/am/a/morphing/variable -2 -8 0 10 -262144 -1 -1 300 1;
  706. #X msg 428 175 0;
  707. #X msg 458 175 1;
  708. #X msg 488 175 2;
  709. #X obj 428 201 s /help/ds/scene;
  710. #X text 408 146 Change scene here:;
  711. #X obj 99 146 bng 15 250 50 0 /i/am/a/morphing/variable/ds/dialog /i/am/a/morphing/variable/ds/dialog
  712. /i/am/a/morphing/variable 20 7 0 10 -262144 -1 -1;
  713. #X text 12 35 Note: Only variables of type "float" can be morphed!!!
  714. ;
  715. #X text 8 78 The variable "/i/am/a/morphing/variable" has a linear
  716. fade to each of the scenes 0-2.;
  717. #X obj 65 267 nbx 4 14 -1e+37 1e+37 0 0 /i/am/a/morphing/variable/ds/morph/time
  718. /i/am/a/morphing/variable/ds/morph/time time/s 47 7 0 10 -4034 -1 -1
  719. 1 256;
  720. #X obj 64 216 tgl 15 0 /i/am/a/morphing/variable/ds/morph /i/am/a/morphing/variable/ds/morph
  721. morph 17 7 0 10 -4034 -1 -1 1 1;
  722. #X obj 65 336 nbx 4 14 -1e+37 1e+37 0 0 /i/am/a/morphing/variable/ds/morph/timegrain
  723. /i/am/a/morphing/variable/ds/morph/timegrain time-grain/ms 47 7 0 10
  724. -4034 -1 -1 20 256;
  725. #X text 8 181 The "morph" toggle enables a fade from another scene
  726. to the current scene for this variable.;
  727. #X text 8 245 The morph time can be set in seconds:;
  728. #X text 8 297 This sets the samplerate of the fade. For video \, a
  729. time-grain faster than the framerate would make no sense.;
  730. #X text 208 336 (Default = 20 ms);
  731. #X obj 4 384 cnv 15 370 600 empty empty Fade_curves 20 12 0 14 -228856
  732. -66577 0;
  733. #X obj 383 384 cnv 15 200 370 empty empty empty 20 12 0 14 -204786
  734. -66577 0;
  735. #X obj 393 418 hsl 128 15 0 127 0 0 /i/am/another/morphing/variable
  736. /i/am/another/morphing/variable /i/am/another/morphing/variable -2
  737. -8 0 10 -262144 -1 -1 400 1;
  738. #X obj 90 447 bng 15 250 50 0 /i/am/another/morphing/variable/ds/dialog
  739. /i/am/another/morphing/variable/ds/dialog /i/am/another/morphing/variable
  740. 20 7 0 10 -262144 -1 -1;
  741. #X obj 4 1088 cnv 15 370 80 empty empty Deactivate_morphing_in_registers
  742. 20 12 0 14 -261234 -66577 0;
  743. #X text 9 1112 For individual variables \, the morphing functionality
  744. can be deactivated permanently:;
  745. #X obj 12 560 nbx 4 14 -1e+37 1e+37 0 0 /i/am/another/morphing/variable/ds/morph/curve/shape
  746. /i/am/another/morphing/variable/ds/morph/curve/shape shape 47 7 0 10
  747. -204786 -1 -1 0 256;
  748. #X obj 11 677 nbx 4 14 0 1 0 0 /i/am/another/morphing/variable/ds/morph/curve/weight
  749. /i/am/another/morphing/variable/ds/morph/curve/weight weight 47 7 0
  750. 10 -204786 -1 -1 0.8 256;
  751. #X obj 14 756 nbx 4 14 10 10000 0 0 /i/am/another/morphing/variable/ds/morph/curve/resolution
  752. /i/am/another/morphing/variable/ds/morph/curve/resolution resolution
  753. 47 7 0 10 -204786 -1 -1 200 256;
  754. #X obj 19 888 hradio 15 1 0 4 /i/am/another/morphing/variable/ds/morph/curve/quality
  755. /i/am/another/morphing/variable/ds/morph/curve/quality quality 0 -8
  756. 0 10 -204786 -1 -1 3;
  757. #X obj 98 518 bng 15 250 50 0 /i/am/another/morphing/variable/ds/morph/curve/vis
  758. /i/am/another/morphing/variable/ds/morph/curve/vis show_curve 17 7
  759. 0 10 -204786 -1 -1;
  760. #X msg 428 564 0;
  761. #X msg 458 564 1;
  762. #X msg 488 564 2;
  763. #X obj 428 590 s /help/ds/scene;
  764. #X text 408 535 Change scene here:;
  765. #X text 8 491 Click here to show the current fade characteristic:;
  766. #X text 8 581 Shape lets you chose a suitable base form of the fade.
  767. A value of "0" will result in one half sine wave. "1" gives a quarter
  768. sinewave \, and 2 to N will give a x^n function. The shape values in
  769. between two integers will provide a linear interpolation of the both.
  770. ;
  771. #X text 8 697 The "weight" factor lets you interpolate between the
  772. selected shape and a straight line.;
  773. #X text 97 891 2: linear interpolation;
  774. #X text 97 905 3: tabread4 4-point polynomianl interpolation;
  775. #X text 97 877 1: no interpolation;
  776. #X text 97 863 0: bypass --> output=input (default);
  777. #X obj 4 990 cnv 15 370 90 empty empty fadecurve 20 12 0 14 -262130
  778. -66577 0;
  779. #X obj 122 1051 fadecurve-help;
  780. #X text 14 1022 See [fadecurve-help] for more information on these
  781. values.;
  782. #X text 8 827 By using the quality setting \, you can chose \, how
  783. the fade curve is read:;
  784. #X text 107 675 (0...1);
  785. #X text 107 559 (-Inf...+Inf);
  786. #X text 150 754 (10...10000);
  787. #X text 8 775 The "resolution" parameter sets the resolution of the
  788. fade curve table (default = 100 points).;
  789. #N canvas 657 58 603 331 \$0-nomorph 0;
  790. #X obj 4 5 cnv 15 370 300 empty empty Deactivate_morphing_in_registers
  791. 20 12 0 14 -233017 -66577 0;
  792. #X text 14 34 For some types of variables \, it is never desired to
  793. morph between two states (For example lists \, symbols \, toggles \,
  794. etc.). To save computing power and keep file sizes small \, the morphing
  795. functionality can be turned off for individual variables.;
  796. #X text 14 181 "nomorph" can also be set in the transition dialog \,
  797. but will not be saved this way:;
  798. #X obj 91 216 bng 15 250 50 0 /i/am/no/morphing/variable/ds/dialog
  799. /i/am/no/morphing/variable/ds/dialog /i/am/no/morphing/variable 20
  800. 7 0 10 -262144 -1 -1;
  801. #X text 14 114 The "nomorph" argument for [ds_reg] deactivates morphing
  802. for this register permanently.;
  803. #X text 14 241 Anyway \, the controls for morphing will always be visible
  804. \, even if deactivated. But they will no more be saved in the storage.
  805. ;
  806. #X obj 383 5 cnv 15 200 300 empty empty empty 20 12 0 14 -204786 -66577
  807. 0;
  808. #X obj 408 174 hsl 128 15 0 127 0 0 /i/am/no/morphing/variable /i/am/no/morphing/variable
  809. /i/am/no/morphing/variable -2 -8 0 10 -262144 -1 -1 0 1;
  810. #X msg 428 73 0;
  811. #X msg 458 73 1;
  812. #X msg 488 73 2;
  813. #X obj 428 99 s /help/ds/scene;
  814. #X text 408 44 Change scene here:;
  815. #X obj 72 151 ds_reg help /i/am/no/morphing/variable nomorph;
  816. #X connect 8 0 11 0;
  817. #X connect 9 0 11 0;
  818. #X connect 10 0 11 0;
  819. #X restore 203 1140 pd \$0-nomorph;
  820. #X obj 64 115 ds_reg help /i/am/a/morphing/variable;
  821. #X obj 57 418 ds_reg help /i/am/another/morphing/variable;
  822. #X connect 3 0 6 0;
  823. #X connect 4 0 6 0;
  824. #X connect 5 0 6 0;
  825. #X connect 29 0 32 0;
  826. #X connect 30 0 32 0;
  827. #X connect 31 0 32 0;
  828. #X coords 0 756 1 755 85 60 0;
  829. #X restore 533 858 pd \$0-scene_transitions;
  830. #N canvas 577 104 604 391 \$0-registering_variables 0;
  831. #X obj 4 4 cnv 15 370 370 empty empty Registering_variables 20 12 0
  832. 14 -204800 -66577 0;
  833. #X text 16 143 SYNTAX: [ds_reg <domain> <variable_name>] \, where <domain>
  834. is the name of the storage you want to register to \, and <variable_name>
  835. is the complete name of your variable.;
  836. #X text 16 37 New variables can be registered to a storage domain with
  837. the [ds_reg] module.;
  838. #X text 16 72 Warning: Do not register variables to more than one domain!
  839. ;
  840. #X text 16 102 Variables can be any type of data \, like 'list' \,
  841. 'float' \, 'symbol' \, etc.;
  842. #X text 8 198 This registers "/i/am/a/variable" to domain "help":;
  843. #X text 9 270 This registers "/i/am/also/a/variable" to domain "help":
  844. ;
  845. #X obj 383 4 cnv 15 200 370 empty empty empty 20 12 0 14 -204786 -66577
  846. 0;
  847. #X obj 405 248 hsl 128 15 0 127 0 0 /i/am/also/a/variable /i/am/also/a/variable
  848. /i/am/also/a/variable -2 -8 0 10 -262144 -1 -1 6300 1;
  849. #X obj 402 178 hsl 128 15 0 127 0 0 /i/am/a/variable /i/am/a/variable
  850. /i/am/a/variable -2 -8 0 10 -262144 -1 -1 900 1;
  851. #X msg 428 75 0;
  852. #X msg 458 75 1;
  853. #X msg 488 75 2;
  854. #X obj 428 101 s /help/ds/scene;
  855. #X text 408 46 Change scene here:;
  856. #X obj 64 225 ds_reg help /i/am/a/variable;
  857. #X obj 67 297 ds_reg help /i/am/also/a/variable;
  858. #X connect 10 0 13 0;
  859. #X connect 11 0 13 0;
  860. #X connect 12 0 13 0;
  861. #X restore 508 623 pd \$0-registering_variables;
  862. #X obj 40 704 cnv 15 370 70 empty empty store_&_recall 20 12 0 14 -261682
  863. -66577 0;
  864. #X obj 432 74 ev_storage help;
  865. #N canvas 297 229 562 466 \$0-store&recall 0;
  866. #X text 96 -373 (c)2011 Marian Weger /part of EXTENDED VIEW toolkit/
  867. gpl v3;
  868. #X obj 3 -394 cnv 15 550 450 empty empty store_&_recall 20 12 0 14
  869. -228856 -66577 0;
  870. #X obj 41 -354 nbx 3 15 0 999 0 0 /help/ds/scene/current /help/ds/scene/current
  871. scene 0 -8 0 12 -204786 -1 -1 0 256;
  872. #X obj 22 -354 bng 15 250 50 0 /0/ds/scene/current/prev /0/ds/scene/current/prev
  873. < 4 7 0 10 -204786 -1 -1;
  874. #X obj 92 -354 bng 15 250 50 0 /help/ds/scene/current/next /help/ds/scene/current/next
  875. > 5 7 0 10 -204786 -1 -1;
  876. #X obj 115 -354 bng 15 250 50 0 /help/ds/recall /help/ds/recall recall
  877. 17 7 0 10 -4034 -1 -1;
  878. #X obj 114 -270 bng 15 250 50 0 /help/ds/store /help/ds/store store
  879. 17 7 0 10 -258113 -1 -1;
  880. #X obj 41 -270 nbx 3 15 0 999 0 0 /help/ds/scene/selected /help/ds/scene/selected
  881. empty 0 -8 0 12 -261234 -1 -1 0 256;
  882. #X obj 22 -270 bng 15 250 50 0 /help/ds/scene/selected/prev /help/ds/scene/selected/prev
  883. < 4 7 0 10 -261234 -1 -1;
  884. #X obj 92 -270 bng 15 250 50 0 /help/ds/scene/selected/next /help/ds/scene/selected/next
  885. > 5 7 0 10 -261234 -1 -1;
  886. #X text 195 -355 In the RECALL section \, you can recall a scene from
  887. RAM.;
  888. #X text 195 -275 In the STORE section \, you can store the current
  889. state of the patch into RAM. Select a destination scene and press "store".
  890. ;
  891. #X text 195 -325 Switch between presets 0-2 to see the effect.;
  892. #X msg 233 -143 0;
  893. #X msg 263 -143 1;
  894. #X msg 293 -143 2;
  895. #X obj 233 -117 s /help/ds/scene;
  896. #X text 56 -197 You can change access those parameters also through
  897. sends and receives.;
  898. #X text 59 -142 Click here to change scene:;
  899. #X obj 305 -36 bng 15 250 50 0 empty empty empty 17 7 0 10 -262144
  900. -1 -1;
  901. #X msg 305 -17 vis 1;
  902. #X text 63 -57 For more information on that \, and for a complete list
  903. of controllable parameters \, click here:;
  904. #X obj 305 4 s pd-\$0-parameter_list;
  905. #X connect 13 0 16 0;
  906. #X connect 14 0 16 0;
  907. #X connect 15 0 16 0;
  908. #X connect 19 0 20 0;
  909. #X connect 20 0 22 0;
  910. #X restore 137 749 pd \$0-store&recall;
  911. #X text 58 729 Look here how to store and recall scenes:;
  912. #X obj 40 784 cnv 15 370 70 empty empty save_&_load 20 12 0 14 -261682
  913. -66577 0;
  914. #X text 46 807 Look here how to save scene sets to a textfile and how
  915. to load them from there:;
  916. #N canvas 509 208 564 464 \$0-save&load 0;
  917. #X obj 3 -394 cnv 15 550 450 empty empty save_&_load 20 12 0 14 -228856
  918. -66577 0;
  919. #X obj 24 -343 bng 15 250 50 0 /help/ds/save /help/ds/save save 17
  920. 7 0 10 -258113 -1 -1;
  921. #X obj 24 -269 bng 15 250 50 0 /help/ds/load /help/ds/load load 17
  922. 7 0 10 -4034 -1 -1;
  923. #X obj 94 -343 bng 15 250 50 0 /help/ds/resave /help/ds/resave resave
  924. 17 7 0 10 -258113 -1 -1;
  925. #X obj 94 -269 bng 15 250 50 0 /help/ds/reload /help/ds/reload reload
  926. 17 7 0 10 -4034 -1 -1;
  927. #X text 195 -355 The SAVE section lets you save all scenes from RAM
  928. to a textfile on the HDD. Click "save" to open a save dialog. "resave"
  929. will let you save to the last specified filename.;
  930. #X text 195 -275 The LOAD section lets you load all scenes from a textfile
  931. to RAM. Click "load" to open a load dialog. "reload" will let you load
  932. the last specified filename.;
  933. #X text 59 -197 This example uses "ev_storage-help.txt" in the ../data
  934. folder to save its contents.;
  935. #X text 59 -127 Have a look at this file in a text editor to see the
  936. syntax.;
  937. #X text 59 -107 More on that here:;
  938. #X obj 187 -105 bng 15 250 50 0 empty empty click_me! 17 7 0 10 -262144
  939. -1 -1;
  940. #X msg 187 -86 vis 1;
  941. #X obj 187 -65 s pd-\$0-file_layout;
  942. #X connect 10 0 11 0;
  943. #X connect 11 0 12 0;
  944. #X restore 199 829 pd \$0-save&load;
  945. #X obj 427 1263 cnv 15 360 80 empty empty Copy&Paste_Settings 20 12
  946. 0 14 -262130 -66577 0;
  947. #N canvas 295 94 390 415 \$0-settings_buffer 0;
  948. #X obj 2 2 cnv 15 370 400 empty empty Settings_Buffer 20 12 0 14 -228856
  949. -66577 0;
  950. #X text 12 38 The Register Settings Buffer has the same controls \,
  951. as the scene transition dialog for the individual variables.;
  952. #X text 12 78 The buffer can be edited and then pasted into variables.
  953. ;
  954. #X text 12 148 In the scene transition dialog of the individual variables
  955. \, there is a copy&paste section to communicate with the buffer:;
  956. #X obj 23 219 bng 15 250 50 0 /i/am/a/morphing/variable/ds/dialog /i/am/a/morphing/variable/ds/dialog
  957. /i/am/a/morphing/variable 20 7 0 10 -262144 -1 -1;
  958. #X obj 209 193 cnv 15 130 60 empty empty empty 20 12 0 14 -191407 -66577
  959. 0;
  960. #X obj 216 209 bng 15 250 50 0 /i/am/a/morphing/variable/ds/settings/copy
  961. /i/am/a/morphing/variable/ds/settings/copy COPY_to_buffer 17 7 0 10
  962. -4160 -1 -1;
  963. #X obj 216 229 bng 15 250 50 0 /i/am/a/morphing/variable/ds/settings/paste
  964. /i/am/a/morphing/variable/ds/settings/paste PASTE_from_buffer 17 7
  965. 0 10 -260097 -1 -1;
  966. #X obj 189 117 bng 15 250 50 0 /help/ds/reg/settings/buffer /help/ds/reg/settings/buffer
  967. register_settings_buffer 17 7 0 10 -257985 -1 -1;
  968. #X text 20 117 Open the Buffer window:;
  969. #X obj 125 321 bng 15 250 50 0 /\$1/ds/reg/settings/buffer/paste/all
  970. /\$1/ds/reg/settings/buffer/paste/all send_to_all_registers 17 7 0
  971. 10 -258113 -1 -1;
  972. #X text 12 278 The buffer contents can be sent to all registered variables
  973. in this domain by pressing the red button:;
  974. #X coords 0 415 1 414 85 60 0;
  975. #X restore 508 1314 pd \$0-settings_buffer;
  976. #X text 432 1178 There is also a buffer for scene transition settings
  977. \, which can be edited independently. Settings can be copied to that
  978. buffer and pasted from it.;
  979. #X obj 607 1231 bng 15 250 50 0 /help/ds/reg/settings/buffer /help/ds/reg/settings/buffer
  980. register_settings_buffer 17 7 0 10 -257985 -1 -1;
  981. #X text 438 1231 Open the Buffer window:;
  982. #X text 488 1291 More detailed description:;
  983. #X text 619 77 Load all the needed pathes:;
  984. #X text 441 224 At every recall \, the variable names and values are
  985. dumped to the first outlet.;
  986. #X text 45 69 This example uses "ev_storage-help.txt". If you accidentally
  987. changed it by testing the examples \, you can load the backup "ev_storage-help_bak.txt".
  988. ;
  989. #X obj 632 98 ../ev-main/ev_declare;
  990. #X text 43 120 If you take a look inside [ev_storage] \, you will see
  991. that it consists of two abstractions from the "kollabs" library: It
  992. only combines [ds_gui] and [ds_logic] to one single module.;
  993. #X obj 420 1371 cnv 15 370 80 empty empty Multiple_GUIs_for_the_same_domain
  994. 20 12 0 14 -228856 -66577 0;
  995. #X text 424 1400 Look inside here how to create multiple GUIs for one
  996. domain:;
  997. #N canvas 147 251 432 243 \$0-multiple_guis 0;
  998. #X obj 132 71 ds_gui help;
  999. #X text 42 27 Of course \, it is possible to create more GUIs for the
  1000. same storage domain. Put a [ds_gui <domain>] object to create one:
  1001. ;
  1002. #X restore 500 1421 pd \$0-multiple_guis;
  1003. #X connect 10 0 13 0;
  1004. #X connect 11 0 13 0;
  1005. #X connect 12 0 13 0;
  1006. #X connect 19 0 20 0;
  1007. #X connect 22 0 21 0;
  1008. #X connect 23 0 22 1;
  1009. #X connect 26 0 25 0;
  1010. #X connect 27 0 25 0;
  1011. #X connect 64 0 65 0;
  1012. #X connect 65 0 66 0;
  1013. #X connect 68 0 69 0;
  1014. #X connect 69 0 70 0;
  1015. #X connect 80 0 22 0;
  1016. #X coords 0 756 1 755 150 115 0;