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>
This commit is contained in:
Paul Lipscomb
@@ -0,0 +1 @@
|
||||
This part of ReaLearn is located in the xref:helgobox::app.adoc[].
|
||||
@@ -0,0 +1 @@
|
||||
sits between source and target and filters or transforms control and feedback streams
|
||||
@@ -0,0 +1 @@
|
||||
connects a control element on your controller with an action or parameter in REAPER
|
||||
@@ -0,0 +1 @@
|
||||
identifies and describes the control element on your controller
|
||||
@@ -0,0 +1 @@
|
||||
identifies and describes the feedback element on your controller
|
||||
@@ -0,0 +1 @@
|
||||
is something in REAPER that should be controlled
|
||||
@@ -0,0 +1 @@
|
||||
is something in REAPER that provides feedback
|
||||
+8
@@ -0,0 +1,8 @@
|
||||
ifdef::pdf-theme[[[settings-controller-advanced,Advanced ⊖]]]
|
||||
ifndef::pdf-theme[[[settings-controller-advanced,Advanced ⊖]]]
|
||||
== Advanced ⊖
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
+8
@@ -0,0 +1,8 @@
|
||||
ifdef::pdf-theme[[[settings-controller-basics,Basics]]]
|
||||
ifndef::pdf-theme[[[settings-controller-basics,Basics]]]
|
||||
== Basics
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
+10
@@ -0,0 +1,10 @@
|
||||
ifdef::pdf-theme[[[settings-controller-color,Color]]]
|
||||
ifndef::pdf-theme[[[settings-controller-color,Color]]]
|
||||
=== Color
|
||||
|
||||
image::realearn::generated/screenshots/elements/settings/controller/color.png[Color]
|
||||
|
||||
Pick a color for this controller.
|
||||
|
||||
This will be used e.g. for the control unit frame in Playtime.
|
||||
|
||||
+8
@@ -0,0 +1,8 @@
|
||||
ifdef::pdf-theme[[[settings-controller-connection,Connection]]]
|
||||
ifndef::pdf-theme[[[settings-controller-connection,Connection]]]
|
||||
=== Connection
|
||||
|
||||
|
||||
|
||||
How the controller is connected to this machine.
|
||||
|
||||
+10
@@ -0,0 +1,10 @@
|
||||
ifdef::pdf-theme[[[settings-controller-default-controller-preset,Default controller preset]]]
|
||||
ifndef::pdf-theme[[[settings-controller-default-controller-preset,Default controller preset]]]
|
||||
=== Default controller preset
|
||||
|
||||
image::realearn::generated/screenshots/elements/settings/controller/default-controller-preset.png[Default controller preset]
|
||||
|
||||
In general, ReaLearn will figure out the correct controller preset based on the main preset's needs and the connected controller.
|
||||
|
||||
**Only set this if you came up with your own controller preset and want to use that instead of the auto-detected one!** Even then, ReaLearn might choose a different controller preset if your one doesn't provide at least one of the virtual control schemes required by the main preset.
|
||||
|
||||
+8
@@ -0,0 +1,8 @@
|
||||
ifdef::pdf-theme[[[settings-controller-enabled,Enabled]]]
|
||||
ifndef::pdf-theme[[[settings-controller-enabled,Enabled]]]
|
||||
=== Enabled
|
||||
|
||||
image::realearn::generated/screenshots/elements/settings/controller/enabled.png[Enabled]
|
||||
|
||||
If disabled, the controller will not have any effect.
|
||||
|
||||
+10
@@ -0,0 +1,10 @@
|
||||
ifdef::pdf-theme[[[settings-controller-main-preset,Main preset]]]
|
||||
ifndef::pdf-theme[[[settings-controller-main-preset,Main preset]]]
|
||||
=== Main preset
|
||||
|
||||
image::realearn::generated/screenshots/elements/settings/controller/main-preset.png[Main preset]
|
||||
|
||||
This preset decides how your controller will be used, i.e. what exactly it should control.
|
||||
|
||||
If you don't choose any main preset or if the main preset is not compatible with your controller, the controller will not be used at all.
|
||||
|
||||
+10
@@ -0,0 +1,10 @@
|
||||
ifdef::pdf-theme[[[settings-controller-name,Name]]]
|
||||
ifndef::pdf-theme[[[settings-controller-name,Name]]]
|
||||
=== Name
|
||||
|
||||
image::realearn::generated/screenshots/elements/settings/controller/name.png[Name]
|
||||
|
||||
Descriptive name of the controller.
|
||||
|
||||
If you use multiple controllers of the same kind, the name should make clear which particular controller instance we are talking about.
|
||||
|
||||
+8
@@ -0,0 +1,8 @@
|
||||
ifdef::pdf-theme[[[settings-controller-usage,Usage]]]
|
||||
ifndef::pdf-theme[[[settings-controller-usage,Usage]]]
|
||||
== Usage
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
+8
@@ -0,0 +1,8 @@
|
||||
ifdef::pdf-theme[[[settings-controllers-add,Add controller]]]
|
||||
ifndef::pdf-theme[[[settings-controllers-add,Add controller image:realearn::generated/screenshots/elements/settings/controllers/add.png[width=50, pdfwidth=8mm]]]]
|
||||
=== Add controller
|
||||
|
||||
image::realearn::generated/screenshots/elements/settings/controllers/add.png[Add controller, role="related thumb right", float=right]
|
||||
|
||||
Adds a new controller.
|
||||
|
||||
+8
@@ -0,0 +1,8 @@
|
||||
ifdef::pdf-theme[[[settings-controllers-delete,Delete controller]]]
|
||||
ifndef::pdf-theme[[[settings-controllers-delete,Delete controller image:realearn::generated/screenshots/elements/settings/controllers/delete.png[width=50, pdfwidth=8mm]]]]
|
||||
=== Delete controller
|
||||
|
||||
image::realearn::generated/screenshots/elements/settings/controllers/delete.png[Delete controller, role="related thumb right", float=right]
|
||||
|
||||
Deletes the controller. This can't be undone.
|
||||
|
||||
+1
@@ -0,0 +1 @@
|
||||
specifies how incoming absolute control values are interpreted and handled
|
||||
+1
@@ -0,0 +1 @@
|
||||
allows reacting to either button press or button release events
|
||||
+1
@@ -0,0 +1 @@
|
||||
applies highly customizable transformations or filtering to incoming absolute control values
|
||||
+1
@@ -0,0 +1 @@
|
||||
allows reacting to either clockwise or counter-clockwise encoder turns
|
||||
+1
@@ -0,0 +1 @@
|
||||
specifies whether to send simple numeric, simple text or script-generated feedback values to the source
|
||||
@@ -0,0 +1 @@
|
||||
allows differentiating between long-press, short-press, and double-press actions
|
||||
+1
@@ -0,0 +1 @@
|
||||
allows controlling not only this mapping but also all other mappings in the same group
|
||||
+1
@@ -0,0 +1 @@
|
||||
emulates an absolute control element with a relative encoder or with -/+ buttons (= incremental buttons)
|
||||
+1
@@ -0,0 +1 @@
|
||||
determines what to do if the absolute control value coming from the source is not within source min/max
|
||||
+1
@@ -0,0 +1 @@
|
||||
determines what to do if the feedback value is not within target min/max
|
||||
@@ -0,0 +1 @@
|
||||
inverses incoming absolute control values and changes the direction of incoming relative control values
|
||||
@@ -0,0 +1 @@
|
||||
inverses the feedback value
|
||||
+1
@@ -0,0 +1 @@
|
||||
rounds target values to the nearest integer
|
||||
+1
@@ -0,0 +1 @@
|
||||
sets the observed range of absolute control values coming from the source
|
||||
+1
@@ -0,0 +1 @@
|
||||
sets the minimum and maximum feedback value
|
||||
+1
@@ -0,0 +1 @@
|
||||
specifies how often to increase or decrease the target value when an increment or decrement is received
|
||||
+1
@@ -0,0 +1 @@
|
||||
specifies by which amount to increase the target value when an increment or decrement is received
|
||||
+1
@@ -0,0 +1 @@
|
||||
defines how to deal with potential control value jumps
|
||||
+1
@@ -0,0 +1 @@
|
||||
sets the controlled value range of the target, making sure that the target value ends up within that range
|
||||
+1
@@ -0,0 +1 @@
|
||||
sets the observed range of feedback values coming from the target
|
||||
+4
@@ -0,0 +1,4 @@
|
||||
Depending on the context, this can have different effects:
|
||||
|
||||
|===
|
||||
| Element | Direction | Effect
|
||||
+1
@@ -0,0 +1 @@
|
||||
sets discrete target values to step through
|
||||
@@ -0,0 +1 @@
|
||||
makes the target value jump back to target min when target max is reached
|
||||
+1
@@ -0,0 +1 @@
|
||||
plays a sound whenever the target has been invoked successfully
|
||||
+1
@@ -0,0 +1 @@
|
||||
enables or disables the mapping as a whole
|
||||
+1
@@ -0,0 +1 @@
|
||||
jumps to the next mapping in the list, respecting search and filter settings
|
||||
+1
@@ -0,0 +1 @@
|
||||
jumps to the previous mapping in the list, respecting search and filter settings
|
||||
+1
@@ -0,0 +1 @@
|
||||
allows defining conditions under which this mapping will become active (conditional activation)
|
||||
+1
@@ -0,0 +1 @@
|
||||
opens a dialog for accessing advanced mapping features via text-based configuration
|
||||
+1
@@ -0,0 +1 @@
|
||||
lets you disable this mapping's control direction
|
||||
+1
@@ -0,0 +1 @@
|
||||
lets you disable this mapping's feedback direction
|
||||
+1
@@ -0,0 +1 @@
|
||||
lets you adjust when ReaLearn sends feedback to improve compatibility with certain controllers
|
||||
+1
@@ -0,0 +1 @@
|
||||
scrolls the mapping list so that the corresponding row for this mapping becomes visible
|
||||
@@ -0,0 +1 @@
|
||||
allows giving the mapping a descriptive name
|
||||
+1
@@ -0,0 +1 @@
|
||||
allows excluding this mapping from ReaLearn's projection view
|
||||
@@ -0,0 +1 @@
|
||||
allows assigning arbitrary comma-separated tags to the mapping
|
||||
@@ -0,0 +1 @@
|
||||
lets you pick the source category
|
||||
@@ -0,0 +1 @@
|
||||
starts or stops learning of this mapping's source
|
||||
@@ -0,0 +1 @@
|
||||
lets you pick the type of source that you want to observe (or send feedback to)
|
||||
@@ -0,0 +1 @@
|
||||
lets you pick the target category
|
||||
+1
@@ -0,0 +1 @@
|
||||
reflects the target's current value and allows changing it
|
||||
+1
@@ -0,0 +1 @@
|
||||
selects the target display unit, used for displaying and entering target values
|
||||
@@ -0,0 +1 @@
|
||||
starts or stops learning of this mapping's target
|
||||
@@ -0,0 +1 @@
|
||||
allows picking a recently touched target and opening the target object
|
||||
@@ -0,0 +1 @@
|
||||
lets you pick the type of target that you want to control (or get feedback from)
|
||||
+7
@@ -0,0 +1,7 @@
|
||||
== Feedback menu
|
||||
|
||||
Determines how frequently ReaLearn captures feedback and sends it to your feedback output.
|
||||
|
||||
Beat:: Roughly every beat.
|
||||
|
||||
Fast:: As fast as possible, thereby giving the satisfying feeling of continuity.
|
||||
+3
@@ -0,0 +1,3 @@
|
||||
== Slot menu
|
||||
|
||||
The xref:playtime::key-concepts.adoc#slot[] on which to carry out this action. See xref:targets/playtime.adoc#slot-selector[].
|
||||
@@ -0,0 +1 @@
|
||||
NOTE: Under construction!
|
||||
Reference in New Issue
Block a user