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,9 @@
+= Target "Playtime: Browse cells"
+
+Changes the currently xref:playtime::further-concepts/matrix.adoc#active-cell[].
+
+Best uses with xref:further-concepts/mapping.adoc#rotary-endless-encoder[encoders] or previous/next-style buttons.
+
+== Axis
+
+Sets the direction into which to browse.
@@ -0,0 +1,23 @@
+= Target "Playtime: Column action"
+
+Invokes a xref:playtime::key-concepts.adoc#column[]-related action.
+
+== Action menu
+
+The kind of action to be executed.
+
+Stop::
+Stops all slots in this column.
+
+Arm/disarm::
+When hit with an _on_ value, arms the associated xref:playtime::key-concepts.adoc#column-track[], otherwise disarms it.
+
+Arm/disarm () exclusive::
+When hit with an _on_ value, arms the associated xref:playtime::key-concepts.adoc#column-track[] and disarms all other column tracks, otherwise disarms it.
+
+Activate::
+Makes this column the xref:playtime::further-concepts/matrix.adoc#active-cell[] .
+
+== Column menu
+
+The xref:playtime::key-concepts.adoc#column[] on which to carry out this action. See xref:targets/playtime.adoc#column-selector[].
@@ -0,0 +1,7 @@
+= Target "Playtime: Control unit scroll"
+
+Controls the current xref:playtime::further-concepts/matrix.adoc#control-unit-scroll-position[] of the xref:playtime::further-concepts/matrix.adoc#control-unit[] represented by this xref:key-concepts.adoc#unit[ReaLearn unit].
+
+== Axis
+
+Sets the direction into which to scroll.
@@ -0,0 +1,52 @@
+= Target "Playtime: Matrix action"
+
+Invokes a xref:playtime::key-concepts.adoc#matrix[]-related action.
+
+== Action menu
+
+The kind of action to be executed.
+
+Stop::
+Stops all clips in the matrix. See xref:playtime::user-interface/matrix-area.adoc#column-cell-stop[]. Supports real-time operation.
+
+Undo::
+When hit with an _on_ value, undoes the last matrix operation. See xref:helgobox::app/user-interface/title-bar.adoc#title-bar-undo[].
+
+Redo::
+When hit with an _on_ value, redoes the last matrix operation. See xref:helgobox::app/user-interface/title-bar.adoc#title-bar-redo[].
+
+Build scene::
+When hit with an _on_ value, builds a xref:playtime::key-concepts.adoc#scene[] of all currently playing xref:playtime::key-concepts.adoc#clip[clips] in the first empty xref:playtime::key-concepts.adoc#row[].
+
+Set record length mode::
+Switches to a specific record-length mode. At the moment, only two possible modes exist: *Open end* and *Custom length* are supported. They correspond to the off and on state of xref:playtime::user-interface/inspector/matrix/recording.adoc#inspector-matrix-recording-length[].
+
+Set custom record length in bars::
+Sets the xref:playtime::user-interface/inspector/matrix/recording.adoc#inspector-matrix-recording-length[] to the desired number of bars.
+
+Enable/disable click::
+When hit with an _on_ value, enables the xref:playtime::user-interface/toolbar.adoc#toolbar-metronome[], otherwise disables it.
+
+Enable/disable MIDI auto-quantize::
+When hit with an _on_ value, enables xref:playtime::user-interface/inspector/matrix/recording.adoc#inspector-matrix-recording-auto-quantize[], otherwise disables it.
+
+Smart record::
+When hit with an _on_ value, triggers the xref:playtime::user-interface/toolbar.adoc#toolbar-smart-record[] function. If this leads to the stop of a xref:playtime::further-concepts/matrix.adoc#feature-tempo-detection[], the operation can be carried out in real-time.
+
+Start or stop playback::
+When hit with an _on_ value, this starts Playtime playback and plays all xref:playtime::further-concepts/slot.adoc#ignited-slot[ignited] slots. Otherwise, this stops Playtime playback. This basically resembles the xref:playtime::user-interface/toolbar.adoc#toolbar-start-stop-playback[] button. This action supports real-time invocation.
+
+Enable/disable silence mode::
+When hit with an _on_ value, this stops Playtime playback. Otherwise, it starts playback _without_ playing xref:playtime::further-concepts/slot.adoc#ignited-slot[ignited] slots. This action supports real-time invocation.
+
+Panic::
+This abruptly stops all clips in the matrix. This resembles a double click on the xref:playtime::user-interface/matrix-area.adoc#matrix-cell-stop[] button. This action supports real-time invocation.
+
+Enable/disable sequencer recording::
+When hit with an _on_ value, this starts recording a new xref:playtime::key-concepts.adoc#matrix-sequence[], otherwise it stops recording.
+
+Enable/disable sequencer playing::
+When hit with an _on_ value, this starts playting the currently active xref:playtime::key-concepts.adoc#matrix-sequence[], otherwise it stops playing.
+
+Tap tempo::
+Invokes the tap-tempo function. This action supports real-time invocation. See xref:playtime::user-interface/toolbar.adoc#toolbar-tap-tempo[].
@@ -0,0 +1,26 @@
+= Target "Playtime: Row action"
+
+== Action menu
+
+The kind of action to be executed.
+
+Most of the actions only execute when the target is hit with an _on_ value. In all other cases, it's specifically mentioned.
+
+Play::
+Acts like the xref:playtime::user-interface/matrix-area.adoc#row-cell-play-scene[] button. This action supports real-time invocation.
+
+Build scene::
+Acts like the xref:playtime:ROOT:user-interface/menus/row-menu.adoc#row-build-scene-from-currently-playing-clips[] function.
+
+Clear::
+Acts like the xref:playtime:ROOT:user-interface/menus/row-menu.adoc#row-clear[] function.
+
+Copy or paste::
+If the row contains clips, copies them to a matrix-internal clipboard. If the row is empty, attempts to paste clips from the matrix-internal clipboard into that row, replacing existing ones.
+
+Activate::
+Makes this row the xref:playtime::further-concepts/matrix.adoc#active-cell[].
+
+== Row menu
+
+The xref:playtime::key-concepts.adoc#row[] on which to carry out this action. See xref:targets/playtime.adoc#row-selector[].
@@ -0,0 +1,56 @@
+= Target "Playtime: Slot management action"
+
+Invokes a xref:playtime::key-concepts.adoc#slot[]-related action that has something to do with modifying slots.
+
+== Action menu
+
+The kind of action to be executed.
+
+Most of the actions only execute when the target is hit with an _on_ value. In all other cases, it's specifically mentioned.
+
+Clear slot::
+See xref:playtime:ROOT:user-interface/menus/slot-menu.adoc#slot-clear[].
+
+Fill slot with selected item::
+See xref:playtime:ROOT:user-interface/menus/slot-menu.adoc#slot-import-selected-item[].
+
+Edit first clip::
+When hit with an _on_ value, opens the MIDI editor for the primary clip in the slot, otherwise close its. Works for MIDI clips only.
+
+Copy or paste clip::
+If the slot contains clips, copies them to a matrix-internal clipboard. If the slot is empty, attempts to paste clips from the matrix-internal clipboard into that slot, replacing existing ones.
+
+Double clip section length::
+Doubles the xref:playtime::user-interface/inspector/clip.adoc#inspector-clip-length[] of each clip contained in the slot.
+
+Halve clip section length::
+Halves the xref:playtime::user-interface/inspector/clip.adoc#inspector-clip-length[] of each clip contained in the slot.
+
+Quantization on/off state::
+When hit with an _on_ value, quantizes the first MIDI clip in this slot, otherwise un-quantizes it.
+
+Duplicate::
+Duplicates the clips of this slot to the slot below. If the slot below already contains clips, they will get replaced.
+
+Activate::
+Makes this slot the xref:playtime::further-concepts/matrix.adoc#active-cell[].
+
+include::partial$targets/playtime/slot-menu.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.clip.name
+|
+String
+|
+Name of the first clip in the slot.
+
+|===
@@ -0,0 +1,14 @@
+= Target "Playtime: Slot seek"
+
+This target exists mainly to provide xref:key-concepts.adoc#feedback[] about the current playback position of the xref:playtime::key-concepts.adoc#slot[].
+
+For example, you can use it to make an LED ring, motor fader or text display indicate the current playback position.
+
+[CAUTION]
+====
+This also works in xref:key-concepts.adoc#control[control direction], changing the current play position of the clips in that slot. But this is **experimental**.
+====
+
+include::partial$targets/feedback-frequency-menu.adoc[]
+
+include::partial$targets/playtime/slot-menu.adoc[]
@@ -0,0 +1,52 @@
+= Target "Playtime: Slot transport action"
+
+Invokes a xref:playtime::key-concepts.adoc#slot[]-related action that has something to do with transport.
+
+All actions that are about starting and stopping slots are real-time capable, which means they can be executed in real-time when controlled via xref:sources/midi.adoc[].
+
+== Action menu
+
+The kind of action to be executed.
+
+[[trigger]] Trigger::
+xref:playtime::further-concepts/matrix.adoc#trigger-slot[Triggers] the slot.
+
+Play/stop::
+When hit with an _on_ value, starts slot playback, otherwise stops it.
+
+Play/pause::
+When hit with an _on_ value, starts slot playback, otherwise pauses it.
+
+CAUTION: Pausing slots is experimental.
+
+Stop::
+When hit with an _on_ value, stops the slot.
+
+Pause::
+When hit with an _on_ value, pauses the slot.
+
+CAUTION: Pausing slots is experimental.
+
+Record/stop::
+When hit with an _on_ value, starts slot recording, otherwise stops it.
+
+Record/play/stop::
+When hit with an _on_ value and the slot is empty, starts slot recording.
+
+When hit with an _on_ value and the slot contains clips, starts playback.
+
+When hit with an _off_ value, stops the slot.
+
+Overdub/play::
+When hit with an _on_ value, starts MIDI-overdubbing the slot, otherwise stops it.
+
+Looped::
+Controls the xref:playtime::user-interface/inspector/clip.adoc#inspector-clip-looped[] setting of the clip.
+
+include::partial$targets/playtime/slot-menu.adoc[]
+
+== Stop if empty
+
+If this is checked, and you play or trigger empty slots, all slots in that column will be stopped.
+
+In other words, this makes empty slots act as stop button.
@@ -0,0 +1,5 @@
+= Target "Playtime: Slot volume"
+
+Sets the xref:playtime::user-interface/inspector/clip.adoc#inspector-clip-volume[volume] property of all clips in a xref:playtime::key-concepts.adoc#slot[].
+
+include::partial$targets/playtime/slot-menu.adoc[]