Vendor helgoboss/helgobox (ReaLearn) as basis for custom UI fork

Stripped upstream git history; starting point for replacing the native SWELL/Win32 mapping UI with something more suited to bulk editing. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-15 17:38:29 -04:00
parent 583ed77a67
commit e58f06d9fa
2232 changed files with 685575 additions and 1 deletions
@@ -0,0 +1,32 @@
+= Target "Pot: Browse filter items"
+
+This target can be used to filter the potentially very large collection of presets in  xref:targets/pot/browse-presets.adoc[].
+The idea is to map this target to an endless rotary encoder or previous/next buttons (using xref:user-interface/mapping-panel/glue-section.adoc#incremental-button[] mode) and then navigate within the available filter items, e.g. instruments or banks.
+
+== Kind menu
+
+Choose the kind of filter items that you want to browse.
+They correspond to the filters available in xref:helgobox::products.adoc#pot-browser[].
+
+== Target-specific properties
+
+This target supports the following additional xref:further-concepts/target.adoc#target-property[target properties].
+
+[cols="m,1,3"]
+|===
+|Name|Type|Description
+
+|
+target.item.name
+|
+String
+|
+Name of the filter item.
+
+|
+target.item.parent.name
+|
+String
+|
+Name of the parent filter item if there's any. E.g. the instrument to which a bank belongs or the type to which a subtype belongs.
+|===
@@ -0,0 +1,60 @@
+= Target "Pot: Browse presets"
+
+Use this target to browse a collection of presets.
+By default, this is the complete collection of presets available in all supported databases, so potentially thousands of presets.
+If you want to browse just a subset, see xref:targets/pot/browse-filter-items.adoc[].
+
+The idea is to map this target to an endless rotary encoder or previous/next buttons (using xref:user-interface/mapping-panel/glue-section.adoc#incremental-button[] mode) and then navigate within the available presets.
+Once you have selected a preset, you can audition it via xref:targets/pot/preview-preset.adoc[] (if it's a sound preset) and load it via xref:targets/pot/load-preset.adoc[].
+
+== Target-specific properties
+
+This target supports the following additional xref:further-concepts/target.adoc#target-property[target properties].
+
+[cols="m,1,3"]
+|===
+|Name|Type|Description
+
+|
+target.preset.name
+|
+String
+|
+Name of the preset.
+
+|
+target.preset.product.name
+|
+String
+|
+Name of the product to which this preset belongs, if available.
+
+|
+target.preset.file_ext
+|
+String
+|
+File extension of the preset, in case it's a file-based preset.
+
+|
+target.preset.author
+|
+String
+|
+Name of the preset author, if available.
+
+|
+target.preset.vendor
+|
+String
+|
+Name of the preset vendor, if available.
+
+|
+target.preset.comment
+|
+String
+|
+Preset comment, if available.
+
+|===
@@ -0,0 +1,19 @@
+= Target "Pot: Load preset"
+
+Loads a preset selected via xref:targets/pot/browse-presets.adoc[].
+
+NOTE: This needs at least REAPER version 6.69+dev1030! Also, it only works if you have the VST2/VST2i version of the corresponding plug-in installed.
+
+NKS audio file presets will be loaded into ReaSamplOmatic5000.
+
+== Track/FX controls
+
+You must tell the target at which FX slot to load the corresponding plug-in.
+The best idea is to use FX selector xref:further-concepts/target.adoc#at-position-selector[].
+Selectors such as xref:further-concepts/target.adoc#particular-fx-selector[] or xref:further-concepts/target.adoc#named-fx-selector[] are not suited because the target might replace the plug-in with another one, in which the unique FX ID and the FX name can change.
+Then the target would turn inactive and stop working.
+
+== Target-specific properties
+
+This target supports the same additional xref:further-concepts/target.adoc#target-property[target properties] as xref:targets/pot/browse-presets.adoc[].
+The only difference is that the ones in this one relate to the currently loaded preset, not the one that's selected in the preset browser.
@@ -0,0 +1,4 @@
+= Target "Pot: Preview preset"
+
+Auditions a preset selected via xref:targets/pot/browse-presets.adoc[].
+Only works if it's a sound preset and a sound preview file is available.