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,49 @@
+= Meta clips
+
+We can take the previous scenario xref:advanced-usage-scenarios/control-with-items.adoc[] a step further!
+
+[[feature-meta-clips]]
+== The idea
+
+If we can control Playtime with MIDI items, shouldn't it be possible to control it with MIDI xref:key-concepts.adoc#clip[_clips_] as well? The answer is yes! I call such clips _meta clips_. *Playtime can basically play itself!*
+
+Meta clips open up a whole new world of possibilities. Here are just some of the things you can do with them:
+
+* Meta clips can be used as xref:key-concepts.adoc#scene[scenes] on steroids. You can trigger many other clips at once, no matter in which row they are.
+* You can record sequences of clip invocations and play them back at the press of a button.
+
+== Basic setup
+
+. Prepare the matrix and set up MIDI triggers as explained in  xref:advanced-usage-scenarios/control-with-items.adoc[]. This should make it possible to play clips using your MIDI keyboard. Make sure that part works.
+. Select the track "Playtime" in your REAPER project (this is the track which contains the xref:helgobox::key-concepts.adoc#instance[Helgobox instance], by default the first track in the project)
+. Right-click the xref:user-interface/matrix-area.adoc#column-cell-label[] of some column, for example the last column. Choose xref:user-interface/menus/matrix-menu.adoc#matrix-insert-column-for-each-selected-track[].
+
+This should add a new column named "Playtime" that plays back its MIDI clips on the "Playtime" track, and can therefore be used to _play other clips_.
+.
+. Now simply record a clip into the new "Playtime" column, while playing clips in other columns using your MIDI keyboard.
+. That's it! You recorded your first meta clip. When playing it back, it should trigger other clips in other columns. You can also edit that meta clip, e.g. quantize its notes.
+
+You may look at the "Playtime" column as the *leader* column (which you trigger) and the other columns as *follower* columns (which are triggered by the leader column).
+
+== Adjust the setup to your needs
+
+This was just an example setup. You can adjust it to your needs. Here are some ideas:
+
+* Introduce more leader columns
+* Move the leader column to the very left to make it obvious that it is a very important column
+* Set the xref:user-interface/inspector/column/playback.adoc#inspector-column-start-timing[] for the *Playtime* column to *1 bar*
+* Set the xref:user-interface/inspector/column/playback.adoc#inspector-column-trigger-mode[] to xref:user-interface/inspector/column/playback.adoc#inspector-column-trigger-mode-toggle[]
+
+
+IMPORTANT: Using MIDI clips to control Playtime is subject to the same considerations about _rendering_ as when using MIDI items. Read xref:usage/arrangement.adoc[] for more information.
+
+[TIP]
+.Meta clips are just the beginning
+====
+The simple fact that Playtime is a MIDI-controllable instrument opens up even more possibilities.
+
+Here are some ideas:
+
+* Use a MIDI arpeggiator to arpeggiate between different clips
+* Write a MIDI link:https://www.reaper.fm/sdk/js/js.php[JSFX] effect that controls clips
+====