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,12 @@
+= Target "FX: Browse presets"
+
+Steps through FX presets.
+
+This target is suited for use with xref:further-concepts/mapping.adoc#knob[knobs], xref:further-concepts/mapping.adoc#rotary-endless-encoder[encoders] and xref:user-interface/mapping-panel/glue-section.adoc#incremental-button[] because it allows you to step through the complete preset list.
+The minimum value always represents _No preset_ whereas the maximum value always represents the last available preset.
+
+It's _not_ suited for activating a particular preset (e.g. by setting xref:user-interface/mapping-panel/glue-section.adoc#target-min-max[] to the same value), because the preset list of an FX is usually not constant.
+As soon as you modify the preset list, this value will might suddenly point to a completely different preset.
+Even worse, the actual preset might have been deleted.
+
+If you want to activate a particular preset, please use the xref:targets/fx/load-snapshot.adoc[] instead.
@@ -0,0 +1,3 @@
+= Target "FX: Enable/disable"
+
+Enables the FX instance if the incoming absolute control value is greater than 0%, otherwise disables it.
@@ -0,0 +1,8 @@
+= Target "FX"
+
+A target that allows you to define an FX, in its basic variant perfect for acquiring feedback for a specific FX.
+
+== Act/Tags controls
+
+The setting **Act/Tags** allows you to optionally set/pin the declared FX as xref:further-concepts/unit.adoc#unit-fx[].
+This works pretty much the same as described in xref:targets/track/track.adoc[].
@@ -0,0 +1,13 @@
+= Target "FX: Load snapshot"
+
+Restores a certain state of a particular FX.
+Before using this target, you need to take a snapshot of the desired FX state using the btn:[Take!] button.
+This snapshot will be saved as part of ReaLearn's state itself and as a direct consequence as a part of your project.
+This makes your project nicely self-contained.
+It's perfect for activating particular FX presets because it will always restore the desired state, even if the preset list has changed.
+
+This target supports feedback, but only if the snapshot is loaded via ReaLearn itself.
+
+Please note that some plug-ins have _very large_ states.
+Therefore, you should keep an eye on the snapshot size, which will be displayed once you take the snapshot.
+ReaLearn's own state will grow with every new snapshot mapping, so this can quickly add up and make REAPER/ReaLearn slow!
@@ -0,0 +1,7 @@
+= Target "FX: Open/close"
+
+Makes the FX instance visible if the incoming control value is greater than 0%, otherwise hides it.
+
+== Display menu
+
+Here you can decide if you want to display the FX as part of the FX chain or in a dedicated floating window.
@@ -0,0 +1,3 @@
+= Target "FX: Set online/offline"
+
+Sets the FX instance online if the incoming absolute control value is greater than 0%, otherwise sets it offline.