Differences

This shows you the differences between two versions of the page.

--- patch-variations [2021/09/16 11:48] – [Variations file] shane
+++ patch-variations [2021/12/09 00:58] – [Basic Concept] shane
@@ Line 4: / Line 4: @@
 To use the techniques
 described here, you should be comfortable with creating and editing [[midi-controller-files#about_plain-text_files|plain-text files]]. However, the first example includes a link to a //.guru// file you can download and try, even before you understand all the details.
+**Important Note:** when loading a patch from a library, Unify always expects to find the variations-list file in //that library's own Media folder//. This means, if you re-save a patch into a different library, you will need to copy the original variations-list file into that library's //Media// folder (and you may need to create the folder, if there isn't one already). **This is a limitation in Unify v1.6.x.** It may be fixed in a future update, but this is not guaranteed.
 -----
@@ Line 9: / Line 11: @@
 //Patch variations// were introduced in Unify v1.6.0. Any patch can optionally include a reference to a plain-text "variations" file (kept in the library's //Media// folder), which is simply a list of "variation names", one per line. The newly-added [[param-paths#top-level_paths|top-level parameter]] //variation// can be linked to a macro knob, and simply selects which of the variation names is displayed in white to the right of the patch name.
+You select the variations file for a patch (if any) when saving the patch. As of Unify v1.6.0, the patch-save dialog includes a "Variations" section as shown below:
+{{::variations-0.png|}}
+To select (or change) the referenced variations file, click the larger of the two buttons. A standard file-open dialog will appear, allowing you to select the file you want to use. When you click //Open// to complete the operation, the button text will change to the name of the selected file. You can click the button again to change the reference to a different file. If you decide not to use any variations file at all, click the //Clear Variations// button.
 ===== Example 1: Song sections =====
@@ Line 24: / Line 32: @@
 </code>
-**Important Note:** when loading a patch from a library, Unify always expects to find the variations-list file in //that library's own Media folder//. This means, if you re-save a patch into a different library, you will need to copy the original variations-list file into that library's //Media// folder (and you may need to create the folder, if there isn't one already). **This is a limitation in Unify v1.6.x.** It may be fixed in a future update, but this is not guaranteed.
 ==== Parameter links ====
 In the example //3 Parts Song Switcher// patch, macro knob #8 has been set up with some carefully-crafted links so that as the knob is turned, the layers are enabled one at a time, and the variation-text at the top of the GUI changes accordingly. Here is what the links look like: