Unify Manual

Your complete reference to PlugInGuru's creative playground!

User Tools

Site Tools


patch-variations

Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revision Both sides next revision
patch-variations [2021/09/03 22:37]
shane [Concept of patch variations]
patch-variations [2022/02/04 15:10]
127.0.0.1 external edit
Line 3: Line 3:
  
 To use the techniques To use the techniques
-described here, you should be comfortable with creating and editing [[midi-controller-files#about_plain-text_files|plain-text files]].+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. //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 ===== ===== Example 1: Song sections =====
Line 37: Line 45:
 {{ :unify_step_curves.zip |}} {{ :unify_step_curves.zip |}}
  
-The special "stairstep" curve presets were generated using a [[https://www.python.org/|Python program]], which you can also download here:+This //.guru// file also installs the special "stairstep" curve presets into the correct folder, so they're ready to use in your own patches. 
 + 
 +These special curves were generated using a [[https://www.python.org/|Python program]], which you can also download here:
  
 {{ ::generate-step-curves.zip |}} {{ ::generate-step-curves.zip |}}
  
-Note both of these downloads are //.zip// files; you will have to unzip them after downloading.+Both of these downloads are //.zip// files; you will have to unzip them after downloading.
 ===== Example 2: Sample maps ===== ===== Example 2: Sample maps =====
 Patch variations can also be used in combination with one or more sample-maps in [[guru-sampler|Guru Sampler]], where the parameter //osc1SampleSelect// is linked to the same macro-knob as //variation//, and the names in the variations file correspond one-to-one with the available choices on the sample-select menu in //Guru Sampler//. Patch variations can also be used in combination with one or more sample-maps in [[guru-sampler|Guru Sampler]], where the parameter //osc1SampleSelect// is linked to the same macro-knob as //variation//, and the names in the variations file correspond one-to-one with the available choices on the sample-select menu in //Guru Sampler//.
patch-variations.txt · Last modified: 2022/02/08 20:12 by shane