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
+12
@@ -0,0 +1,12 @@
|
||||
= Content panel
|
||||
|
||||
include::partial$user-interface/content-panel-desc.adoc[]
|
||||
|
||||
You can close the content panel by pressing the icon:close[] button on the left side, which appears as soon as your mouse hovers over the area.
|
||||
|
||||
include::partial$generated/elements/waveform-view.adoc[]
|
||||
|
||||
The waveform view shows only the relevant section of the actual audio file.
|
||||
Which part is relevant, is dictated by the clip properties xref:user-interface/inspector/clip.adoc#inspector-clip-source-cut-start[] and xref:user-interface/inspector/clip.adoc#inspector-clip-source-cut-length[].
|
||||
|
||||
If you set the clip properties xref:user-interface/inspector/clip.adoc#inspector-clip-start-position[] or xref:user-interface/inspector/clip.adoc#inspector-clip-length[], you will see start and end markers.
|
||||
@@ -0,0 +1,3 @@
|
||||
= Dialogs
|
||||
|
||||
Dialogs are small windows that are opened on demand.
|
||||
+9
@@ -0,0 +1,9 @@
|
||||
= Arrangement writing mode dialog
|
||||
|
||||
This dialog opens when pressing the xref:user-interface/toolbar.adoc#toolbar-write-to-arrangement[] button in the title bar and the current arrangement is dirty. It gives you multiple options how to deal with the fact that there are already items in the arrangement.
|
||||
|
||||
image::generated/screenshots/main/arrangement-writing-mode.png[]
|
||||
|
||||
include::partial$generated/elements/arrangement-writing-mode/replace.adoc[]
|
||||
include::partial$generated/elements/arrangement-writing-mode/merge-at-cursor.adoc[]
|
||||
include::partial$generated/elements/arrangement-writing-mode/append.adoc[]
|
||||
+17
@@ -0,0 +1,17 @@
|
||||
= Purchase & Activate dialog
|
||||
|
||||
This dialog opens when clicking the button xref:user-interface/title-bar.adoc#title-bar-purchase-playtime[].
|
||||
|
||||
image::generated/screenshots/main/purchase.png[]
|
||||
|
||||
include::partial$generated/elements/purchase/verify-license-key.adoc[]
|
||||
|
||||
If unlocking Playtime doesn't work, please write an email to info@helgoboss.org!
|
||||
|
||||
[NOTE]
|
||||
====
|
||||
The copy protection mechanism of Playtime is as unobtrusive as the one used in REAPER: No iLok, no online verification.
|
||||
Just a regular license key that is checked offline.
|
||||
|
||||
No need to worry that you run in demo mode when your gig comes up!
|
||||
====
|
||||
+15
@@ -0,0 +1,15 @@
|
||||
= Sequences dialog
|
||||
|
||||
This dialog opens when pressing the xref:user-interface/toolbar.adoc#toolbar-matrix-sequence-picker[] button in the title bar.
|
||||
|
||||
image::generated/screenshots/main/sequences.png[]
|
||||
|
||||
Clicking on a sequence makes it the active sequence.
|
||||
|
||||
include::partial$generated/elements/sequences/edit.adoc[]
|
||||
|
||||
At the moment, all you can do here is to adjust its name.
|
||||
|
||||
include::partial$generated/elements/sequences/delete.adoc[]
|
||||
|
||||
You can undo this operation using Playtime's built-in undo function.
|
||||
+31
@@ -0,0 +1,31 @@
|
||||
= Settings dialog
|
||||
|
||||
This dialog opens when pressing the xref:helgobox:ROOT:app/user-interface/title-bar.adoc#title-bar-settings[] button in the title bar and navigating to the Playtime section.
|
||||
|
||||
image::generated/screenshots/main/settings.png[]
|
||||
|
||||
== Appearance
|
||||
|
||||
include::partial$generated/elements/settings/show-control-unit-frames.adoc[]
|
||||
|
||||
See xref:further-concepts/matrix.adoc#control-unit-frame[].
|
||||
|
||||
include::partial$generated/elements/settings/show-column-numbers.adoc[]
|
||||
|
||||
Disabling this will give you more vertical space, but also hides the shortcut buttons such as xref:user-interface/matrix-area.adoc#column-cell-exclusive-mode[]. In that case, you can still change those things in the xref:user-interface/inspector/column.adoc[].
|
||||
|
||||
include::partial$generated/elements/settings/show-clip-activity.adoc[]
|
||||
include::partial$generated/elements/settings/show-cell-selection-as-crosshair.adoc[]
|
||||
include::partial$generated/elements/settings/show-hypothetical-play-cursor.adoc[]
|
||||
include::partial$generated/elements/settings/cell-color-position.adoc[]
|
||||
include::partial$generated/elements/settings/cell-progress-position.adoc[]
|
||||
|
||||
include::partial$generated/elements/settings/cell-width.adoc[]
|
||||
|
||||
include::partial$generated/elements/settings/cell-height.adoc[]
|
||||
|
||||
In addition, you might be interested in the xref:helgobox::app/user-interface/settings-dialog.adoc#settings-overall-size[] setting, located in the general appearance section.
|
||||
|
||||
== Engine
|
||||
|
||||
include::partial$generated/elements/settings/tempo-latency.adoc[]
|
||||
+14
@@ -0,0 +1,14 @@
|
||||
= Tempo settings dialog
|
||||
|
||||
This dialog opens when right-clicking the xref:user-interface/toolbar.adoc#toolbar-metronome[] button in the title bar.
|
||||
It lets you adjust various tempo-related settings.
|
||||
|
||||
NOTE: The settings in here are not global!
|
||||
They are saved as part of the matrix and therefore together with the REAPER project.
|
||||
|
||||
image::generated/screenshots/main/tempo-settings.png[]
|
||||
|
||||
include::partial$generated/elements/tempo-settings/click-and-tap.adoc[]
|
||||
include::partial$generated/elements/tempo-settings/click-volume.adoc[]
|
||||
include::partial$generated/elements/tempo-settings/tap-volume.adoc[]
|
||||
include::partial$generated/elements/tempo-settings/count-in.adoc[]
|
||||
@@ -0,0 +1,3 @@
|
||||
= General usage
|
||||
|
||||
See xref:helgobox::app/user-interface/general.adoc[general usage] in the Helgobox Reference.
|
||||
@@ -0,0 +1,27 @@
|
||||
= Info panel
|
||||
|
||||
include::partial$user-interface/info-panel-desc.adoc[]
|
||||
|
||||
== Help
|
||||
|
||||
This tab displays helpful information about the item under the mouse.
|
||||
|
||||
== Stats
|
||||
|
||||
This tab displays information about the current state of the Playtime engine.
|
||||
|
||||
include::partial$generated/elements/info-panel/stats/tempo-buffer-size.adoc[]
|
||||
|
||||
See xref:user-interface/dialogs/settings-dialog.adoc#settings-tempo-latency[].
|
||||
|
||||
include::partial$generated/elements/info-panel/stats/pre-buffered-blocks-playing-min.adoc[]
|
||||
|
||||
include::partial$generated/elements/info-panel/stats/pre-buffered-blocks-playing-avg.adoc[]
|
||||
|
||||
include::partial$generated/elements/info-panel/stats/pre-buffered-blocks-playing-max.adoc[]
|
||||
|
||||
include::partial$generated/elements/info-panel/stats/pre-buffer-fallback-count.adoc[]
|
||||
|
||||
include::partial$generated/elements/info-panel/stats/pre-buffer-miss-count.adoc[]
|
||||
|
||||
include::partial$generated/elements/info-panel/warnings.adoc[]
|
||||
@@ -0,0 +1,11 @@
|
||||
= Inspector
|
||||
|
||||
include::partial$user-interface/inspector-desc.adoc[]
|
||||
|
||||
What exactly the inspector shows, depends on the current selection:
|
||||
|
||||
* xref:user-interface/inspector/matrix.adoc[]
|
||||
* xref:user-interface/inspector/column.adoc[]
|
||||
* xref:user-interface/inspector/row.adoc[]
|
||||
* xref:user-interface/inspector/slot.adoc[]
|
||||
* xref:user-interface/inspector/track.adoc[]
|
||||
+167
@@ -0,0 +1,167 @@
|
||||
= Clip inspector
|
||||
|
||||
include::partial$generated/elements/inspector/clip/quick-actions.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/clip/overdub.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/clip/quantize.adoc[]
|
||||
|
||||
See xref:user-interface/inspector/matrix/playback.adoc#inspector-matrix-midi-quantization-grid[].
|
||||
|
||||
[NOTE]
|
||||
====
|
||||
Playtime uses its own quantization algorithm, but it remembers the original event positions in a way that is compatible with REAPER.
|
||||
|
||||
If you open a MIDI clip quantized by Playtime in REAPER's MIDI editor, you will see that the MIDI events are quantized there as well, and you have the possibility to unquantize directly in the MIDI editor.
|
||||
|
||||
Vice versa, Playtime detects correctly if a clip has been quantized in REAPER's MIDI editor.
|
||||
That means you can use both quantization methods interchangeably!
|
||||
====
|
||||
|
||||
include::partial$generated/elements/inspector/clip/basics.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/clip/name.adoc[]
|
||||
|
||||
TIP: Another way to change the sanem is to press kbd:[F2] when the slot is selected.
|
||||
|
||||
include::partial$generated/elements/inspector/clip/looped.adoc[]
|
||||
|
||||
See xref:key-concepts.adoc#loop[] and xref:key-concepts.adoc#one-shot[].
|
||||
|
||||
include::partial$generated/elements/inspector/clip/volume.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/clip/pitch.adoc[]
|
||||
|
||||
For audio, pitch shifting is done using REAPER's pitch-shifting/time-stretching engine with the clip's xref:user-interface/inspector/clip.adoc#inspector-clip-time-stretch-mode[].
|
||||
|
||||
include::partial$clip-prop-applied-quantized.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/clip/velocity-sensitivity.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/clip/source-info.adoc[]
|
||||
|
||||
See xref:key-concepts.adoc#source[].
|
||||
|
||||
TIP: Right-clicking this area opens the xref:user-interface/menus/source-menu.adoc[].
|
||||
|
||||
include::partial$generated/elements/inspector/clip/color.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/clip/triggering.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/clip/start-timing.adoc[]
|
||||
|
||||
See xref:key-concepts.adoc#clip-start-timing[].
|
||||
|
||||
include::partial$generated/elements/inspector/clip/start-timing/immediately.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/clip/start-timing/custom.adoc[]
|
||||
|
||||
TIP: In most cases, picking one of the pre-defined quantizations (e.g. **1 bar**) should be sufficient.
|
||||
|
||||
include::partial$generated/elements/inspector/clip/stop-timing.adoc[]
|
||||
include::partial$generated/elements/inspector/clip/stop-timing/like-start-timing.adoc[]
|
||||
include::partial$generated/elements/inspector/clip/stop-timing/until-end-of-clip.adoc[]
|
||||
|
||||
CAUTION: This can easily lead to unintentional concurrent playback of clips when using xref:user-interface/inspector/column/playback.adoc#inspector-column-exclusive-mode[].
|
||||
|
||||
include::partial$generated/elements/inspector/clip/stop-timing/immediately.adoc[]
|
||||
include::partial$generated/elements/inspector/clip/stop-timing/custom.adoc[]
|
||||
|
||||
|
||||
include::partial$generated/elements/inspector/clip/synchronization.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/clip/sync-to-project-tempo.adoc[]
|
||||
|
||||
TIP: This alone doesn't guarantee yet that your clip will be played in time.
|
||||
It's just one of multiple ingredients for in-sync playback.
|
||||
See xref:key-concepts.adoc#in-sync[].
|
||||
|
||||
NOTE: This is comparable to REAPER's item time base setting.
|
||||
In fact, this will be translated to different item time base settings when xref:user-interface/toolbar.adoc#toolbar-write-to-arrangement[writing to the arrangement].
|
||||
|
||||
include::partial$generated/elements/inspector/clip/tempo.adoc[]
|
||||
|
||||
TIP: This is available for audio clips only.
|
||||
MIDI clips are by its very nature tempo-agnostic.
|
||||
|
||||
include::partial$clip-prop-applied-quantized.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/clip/time-signature.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/clip/downbeat.adoc[]
|
||||
|
||||
TIP: This can be used to realize an link:https://en.wikipedia.org/wiki/Anacrusis[Anacrusis] (or pick-up beat).
|
||||
See xref:user-interface/inspector/matrix/recording.adoc#inspector-matrix-recording-detect-downbeat[].
|
||||
|
||||
include::partial$generated/elements/inspector/clip/section.adoc[]
|
||||
|
||||
.Usage with MIDI clips
|
||||
CAUTION: These properties work for both audio and MIDI clips.
|
||||
When using it on MIDI clips, be aware that the REAPER MIDI editor doesn't indicate the start position or length in any way, which can be confusing.
|
||||
If you want to change the start position and length permanently, it's usually better to adjust the underlying MIDI data.
|
||||
|
||||
include::partial$generated/elements/inspector/clip/start-position.adoc[]
|
||||
|
||||
include::partial$user-interface/clip-prop-adjust-in-beats.adoc[]
|
||||
|
||||
include::partial$clip-prop-applied-quantized.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/clip/length.adoc[]
|
||||
|
||||
The value **Original** means that the source will end at the original end of the source material.
|
||||
|
||||
Use the ÷2 and ×2 buttons to halve or double the current length.
|
||||
|
||||
include::partial$user-interface/clip-prop-adjust-in-beats.adoc[]
|
||||
|
||||
include::partial$clip-prop-applied-quantized.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/clip/midi.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/clip/midi-reset-behavior.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/clip/midi-reset-behavior/none.adoc[]
|
||||
include::partial$generated/elements/inspector/clip/midi-reset-behavior/light-left.adoc[]
|
||||
include::partial$generated/elements/inspector/clip/midi-reset-behavior/extreme-left.adoc[]
|
||||
include::partial$generated/elements/inspector/clip/midi-reset-behavior/light-right.adoc[]
|
||||
include::partial$generated/elements/inspector/clip/midi-reset-behavior/extreme-right.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/clip/midi-channel.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/clip/audio.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/clip/source-fades.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/clip/time-stretch-mode.adoc[]
|
||||
|
||||
Playtime uses this algorithm whenever it needs to adjust beat-based audio clips to the current tempo while keeping the original pitch, but also when xref:user-interface/inspector/clip.adoc#inspector-clip-pitch[adjusting the pitch] of audio clips.
|
||||
|
||||
include::partial$clip-prop-applied-quantized.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/clip/time-stretch-mode/vari-speed.adoc[]
|
||||
include::partial$generated/elements/inspector/clip/time-stretch-mode/keeping-pitch.adoc[]
|
||||
|
||||
When selecting this option, you can choose between all pitch shifting modes and corresponding sub modes that are supported by REAPER.
|
||||
|
||||
include::partial$generated/elements/inspector/clip/resample-mode.adoc[]
|
||||
|
||||
Playtime uses resampling in the following cases:
|
||||
|
||||
. Vari-speed time stretching
|
||||
. Adjusting to play rate changes
|
||||
. Adjusting clips that have a sample rate other than the project/hardware sample rate
|
||||
|
||||
You can choose between all resample modes that are supported by REAPER.
|
||||
|
||||
include::partial$clip-prop-applied-quantized.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/clip/expert-settings.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/clip/source-cut-start.adoc[]
|
||||
|
||||
include::partial$clip-prop-applied-quantized.adoc[]
|
||||
|
||||
|
||||
include::partial$generated/elements/inspector/clip/source-cut-length.adoc[]
|
||||
|
||||
include::partial$clip-prop-applied-quantized.adoc[]
|
||||
+11
@@ -0,0 +1,11 @@
|
||||
= Column inspector
|
||||
|
||||
You will see this when selecting a xref:user-interface/matrix-area.adoc#column-cell[].
|
||||
|
||||
This inspector is divided into two areas:
|
||||
|
||||
xref:user-interface/inspector/column/playback.adoc[]::
|
||||
Settings that are mainly about playing clips
|
||||
|
||||
xref:user-interface/inspector/column/recording.adoc[]::
|
||||
Settings that are mainly about recording clips
|
||||
+43
@@ -0,0 +1,43 @@
|
||||
= Column playback settings
|
||||
|
||||
You will see this when selecting a xref:user-interface/matrix-area.adoc#column-cell[].
|
||||
|
||||
include::partial$generated/elements/inspector/column/basics.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/column/playback-track.adoc[]
|
||||
|
||||
See xref:key-concepts.adoc#column-track[].
|
||||
|
||||
include::partial$generated/elements/inspector/column/custom-name.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/column/exclusive-mode.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/column/follow-scenes.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/column/more.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/column/start-timing.adoc[]
|
||||
|
||||
See xref:user-interface/inspector/clip.adoc#inspector-clip-start-timing[].
|
||||
|
||||
include::partial$generated/elements/inspector/column/stop-timing.adoc[]
|
||||
|
||||
See xref:user-interface/inspector/clip.adoc#inspector-clip-stop-timing[].
|
||||
|
||||
include::partial$generated/elements/inspector/column/trigger-mode.adoc[]
|
||||
include::partial$generated/elements/inspector/column/trigger-mode/toggle.adoc[]
|
||||
include::partial$generated/elements/inspector/column/trigger-mode/momentary.adoc[]
|
||||
include::partial$generated/elements/inspector/column/trigger-mode/retrigger.adoc[]
|
||||
|
||||
|
||||
include::partial$generated/elements/inspector/column/velocity-sensitivity.adoc[]
|
||||
|
||||
See xref:user-interface/inspector/clip.adoc#inspector-clip-velocity-sensitivity[].
|
||||
|
||||
include::partial$generated/elements/inspector/column/time-stretch-mode.adoc[]
|
||||
|
||||
See xref:user-interface/inspector/clip.adoc#inspector-clip-time-stretch-mode[].
|
||||
|
||||
include::partial$generated/elements/inspector/column/resample-mode.adoc[]
|
||||
|
||||
See xref:user-interface/inspector/clip.adoc#inspector-clip-resample-mode[].
|
||||
+5
@@ -0,0 +1,5 @@
|
||||
= Column recording settings
|
||||
|
||||
You will see this when selecting a xref:user-interface/matrix-area.adoc#column-cell[].
|
||||
|
||||
NOTE: There are no column-specific recording settings yet. This section is reserved for the future,
|
||||
+11
@@ -0,0 +1,11 @@
|
||||
= Matrix inspector
|
||||
|
||||
You will see this when selecting the xref:user-interface/matrix-area.adoc#matrix-cell[].
|
||||
|
||||
This inspector is divided into two areas:
|
||||
|
||||
xref:user-interface/inspector/matrix/playback.adoc[]::
|
||||
Settings that are mainly about playing clips
|
||||
|
||||
xref:user-interface/inspector/matrix/recording.adoc[]::
|
||||
Settings that are mainly about recording clips
|
||||
+41
@@ -0,0 +1,41 @@
|
||||
= Matrix playback settings
|
||||
|
||||
You will see this when selecting the xref:user-interface/matrix-area.adoc#matrix-cell[].
|
||||
|
||||
include::partial$generated/elements/inspector/matrix/playback-basics.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/matrix/start-timing.adoc[]
|
||||
|
||||
See xref:user-interface/inspector/clip.adoc#inspector-clip-start-timing[].
|
||||
|
||||
include::partial$generated/elements/inspector/matrix/stop-timing.adoc[]
|
||||
|
||||
See xref:user-interface/inspector/clip.adoc#inspector-clip-stop-timing[].
|
||||
|
||||
include::partial$generated/elements/inspector/matrix/trigger-mode.adoc[]
|
||||
|
||||
See xref:user-interface/inspector/column/playback.adoc#inspector-column-trigger-mode[].
|
||||
|
||||
include::partial$generated/elements/inspector/matrix/velocity-sensitivity.adoc[]
|
||||
|
||||
See xref:user-interface/inspector/clip.adoc#inspector-clip-velocity-sensitivity[].
|
||||
|
||||
include::partial$generated/elements/inspector/matrix/activate-slot-on-trigger.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/matrix/transport-sync.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/matrix/midi-quantization-grid.adoc[]
|
||||
|
||||
See xref:user-interface/inspector/clip.adoc#inspector-clip-quantize[].
|
||||
|
||||
TIP: If you want more advanced quantization options, do quantization in REAPER's MIDI editor instead.
|
||||
|
||||
include::partial$generated/elements/inspector/matrix/playback-more.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/matrix/time-stretch-mode.adoc[]
|
||||
|
||||
See xref:user-interface/inspector/clip.adoc#inspector-clip-time-stretch-mode[].
|
||||
|
||||
include::partial$generated/elements/inspector/matrix/resample-mode.adoc[]
|
||||
|
||||
See xref:user-interface/inspector/clip.adoc#inspector-clip-resample-mode[].
|
||||
+45
@@ -0,0 +1,45 @@
|
||||
= Matrix recording settings
|
||||
|
||||
You will see this when selecting the xref:user-interface/matrix-area.adoc#matrix-cell[].
|
||||
|
||||
include::partial$generated/elements/inspector/matrix/recording-basics.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/matrix/recording-looped.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/matrix/recording-allow-tempo-detection-recording.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/matrix/limit-recording-length.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/matrix/recording-length.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/matrix/recording-midi.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/matrix/recording-detect-downbeat.adoc[]
|
||||
|
||||
See xref:user-interface/inspector/clip.adoc#inspector-clip-downbeat[].
|
||||
|
||||
include::partial$generated/elements/inspector/matrix/recording-auto-quantize.adoc[]
|
||||
|
||||
See xref:user-interface/inspector/clip.adoc#inspector-clip-quantize[] and xref:user-interface/inspector/matrix/playback.adoc#inspector-matrix-midi-quantization-grid[].
|
||||
|
||||
include::partial$generated/elements/inspector/matrix/recording-settings-for-new-clips.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/matrix/recording-sync-to-project-tempo.adoc[]
|
||||
|
||||
See xref:user-interface/inspector/clip.adoc#inspector-clip-sync-to-project-tempo[].
|
||||
|
||||
include::partial$generated/elements/inspector/matrix/recording-sync-to-project-tempo/auto.adoc[]
|
||||
include::partial$generated/elements/inspector/matrix/recording-sync-to-project-tempo/no.adoc[]
|
||||
include::partial$generated/elements/inspector/matrix/recording-sync-to-project-tempo/yes.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/matrix/recording-midi-reset-behavior.adoc[]
|
||||
|
||||
See xref:user-interface/inspector/clip.adoc#inspector-clip-midi-reset-behavior[].
|
||||
|
||||
include::partial$generated/elements/inspector/matrix/tempo-detection-range.adoc[]
|
||||
|
||||
.Simple example
|
||||
====
|
||||
Playtime might detect that imported audio material has the following valid tempos: 30bpm, 60bpm, 120bpm, 240 bpm.
|
||||
By setting the tempo detection range to 80bpm - 180bpm, Playtime will for sure pick 120bpm.
|
||||
====
|
||||
+11
@@ -0,0 +1,11 @@
|
||||
= Row inspector
|
||||
|
||||
You will see this when selecting a xref:user-interface/matrix-area.adoc#row-cell[].
|
||||
|
||||
include::partial$generated/elements/inspector/row/basics.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/row/name.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/row/tempo.adoc[]
|
||||
|
||||
WARNING: This is an experimental feature.
|
||||
+18
@@ -0,0 +1,18 @@
|
||||
= Slot inspector
|
||||
|
||||
You will see this when selecting a xref:user-interface/matrix-area.adoc#slot-cell[].
|
||||
|
||||
include::partial$generated/elements/inspector/slot/clip-picker.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/slot/clip.adoc[]
|
||||
|
||||
For details about the actual clip, see xref:user-interface/inspector/clip.adoc[].
|
||||
|
||||
TIP: Right-clicking one of the clips opens the xref:user-interface/menus/clip-menu.adoc[].
|
||||
|
||||
[[clip-drag-and-drop]]
|
||||
.Drag-and-drop support
|
||||
****
|
||||
Move a clip to another slot::
|
||||
Drag one clip onto another slot in order to move it there.
|
||||
****
|
||||
+9
@@ -0,0 +1,9 @@
|
||||
= Track inspector
|
||||
|
||||
You will see this when selecting a xref:user-interface/track-area.adoc[track panel].
|
||||
|
||||
include::partial$generated/elements/inspector/track/basics.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/track/name.adoc[]
|
||||
|
||||
include::partial$generated/elements/inspector/track/color.adoc[]
|
||||
+64
@@ -0,0 +1,64 @@
|
||||
= Keyboard shortcuts
|
||||
|
||||
Playtime provides keyboard shortcuts in addition to the xref:helgobox::app/user-interface/keyboard-shortcuts.adoc[general ones].
|
||||
|
||||
[cols = "1,1a"]
|
||||
|===
|
||||
|Shortcut |Purpose
|
||||
|
||||
|kbd:[Cmd+Z]
|
||||
|Invokes Playtime's undo function.
|
||||
|
||||
|kbd:[Cmd+R]
|
||||
|Invokes Playtime's redo function.
|
||||
|
||||
|kbd:[Backspace/Delete]
|
||||
|Deletes the currently selected column or row, or clears the selected slot's contents.
|
||||
|
||||
|kbd:[Cmd/Ctrl+C]
|
||||
|Copies the currently selected row or slot contents to the clipboard.
|
||||
|
||||
|kbd:[Cmd/Ctrl+X]
|
||||
|Cuts the currently selected row or slot contents to the clipboard.
|
||||
|
||||
|kbd:[Cmd/Ctrl+V]
|
||||
|Pastes row or slot contents from the clipboard to the currently selected row or slot.
|
||||
|
||||
|kbd:[Space]
|
||||
|Starts or stops playback.
|
||||
|
||||
|[[enter,Enter]] kbd:[Enter]
|
||||
|
|
||||
Carries out an action depending on the current selection:
|
||||
|
||||
* When the xref:user-interface/matrix-area.adoc#matrix-cell[] is selected, stops all clips in the xref:key-concepts.adoc#matrix[].
|
||||
* When a xref:user-interface/matrix-area.adoc#column-cell[] is selected, stops all clips in the xref:key-concepts.adoc#column[].
|
||||
* When a xref:user-interface/matrix-area.adoc#row-cell[] is selected, plays all clips in the xref:key-concepts.adoc#row[] whose column follows scenes.
|
||||
* When a xref:user-interface/matrix-area.adoc#slot-cell[] is selected, xref:further-concepts/matrix.adoc#trigger-slot[triggers] the xref:key-concepts.adoc#slot[].
|
||||
|
||||
|kbd:[F2]
|
||||
|Renames the currently selected column, row, clip or track.
|
||||
|
||||
|kbd:[T]
|
||||
|Taps the tempo.
|
||||
|
||||
|kbd:[M]
|
||||
|Toggles the metronome.
|
||||
|
||||
|kbd:[E]
|
||||
|Edits the first clip in the currently selected slot.
|
||||
|
||||
|kbd:[Q]
|
||||
|Quantizes the first clip in the currently selected slot.
|
||||
|
||||
|kbd:[O]
|
||||
|Overdubs the first clip in the currently selected slot, if it's a MIDI clip.
|
||||
|
||||
|kbd:[A]
|
||||
|Exports the complete matrix or the currently selected column, row or clip to the arrangement.
|
||||
|
||||
|kbd:[Shift+Cmd/Ctrl+P]
|
||||
|Executes the REAPER action xref:reaper-actions.adoc#show-hide-playtime[].
|
||||
|
||||
|===
|
||||
|
||||
+131
@@ -0,0 +1,131 @@
|
||||
= Matrix area
|
||||
|
||||
include::partial$user-interface/matrix-area-desc.adoc[]
|
||||
|
||||
.Column cells of the matrix area
|
||||
image::generated/screenshots/elements/area/matrix-area-1.png[]
|
||||
|
||||
.Row cells of the matrix area
|
||||
image::generated/screenshots/elements/area/matrix-area-2.png[width=100]
|
||||
|
||||
.Slot cells of the matrix area
|
||||
image::generated/screenshots/elements/area/matrix-area-3.png[]
|
||||
|
||||
include::partial$generated/elements/matrix/template-panel.adoc[]
|
||||
|
||||
This is only shown if the matrix doesn't have any columns yet.
|
||||
|
||||
include::partial$generated/elements/matrix/audio-template-button.adoc[]
|
||||
include::partial$generated/elements/matrix/midi-template-button.adoc[]
|
||||
include::partial$generated/elements/matrix/mixed-template-button.adoc[]
|
||||
|
||||
== General
|
||||
|
||||
include::partial$generated/elements/matrix/add-column.adoc[]
|
||||
|
||||
Adding a new column automatically creates a corresponding REAPER track, on which clips in this column will be played back.
|
||||
See xref:key-concepts.adoc#column-track[].
|
||||
|
||||
include::partial$generated/elements/matrix/add-row.adoc[]
|
||||
|
||||
include::partial$generated/elements/matrix/scroll-indicator.adoc[]
|
||||
|
||||
// Matrix cell
|
||||
|
||||
include::partial$generated/elements/matrix-cell.adoc[]
|
||||
|
||||
include::partial$generated/elements/matrix-cell/stop.adoc[]
|
||||
|
||||
include::partial$generated/elements/matrix-cell/settings.adoc[]
|
||||
|
||||
See xref:user-interface/inspector/matrix.adoc[].
|
||||
|
||||
TIP: Right-clicking this area opens the xref:user-interface/menus/matrix-menu.adoc[].
|
||||
|
||||
// Column cell
|
||||
|
||||
include::partial$generated/elements/column-cell.adoc[]
|
||||
|
||||
If you don't see the upper part, check xref:user-interface/dialogs/settings-dialog.adoc#settings-show-column-numbers[].
|
||||
|
||||
[[column-drag-and-drop]]
|
||||
.Column drag-and-drop support
|
||||
****
|
||||
Reorder column::
|
||||
Drag the cell left or right to change the position of the column.
|
||||
****
|
||||
|
||||
include::partial$generated/elements/column-cell/exclusive-mode.adoc[]
|
||||
|
||||
This is a shortcut for xref:user-interface/inspector/column/playback.adoc#inspector-column-exclusive-mode[].
|
||||
|
||||
include::partial$generated/elements/column-cell/follow-scenes.adoc[]
|
||||
|
||||
This is a shortcut for xref:user-interface/inspector/column/playback.adoc#inspector-column-follow-scenes[].
|
||||
|
||||
include::partial$generated/elements/column-cell/has-overrides.adoc[]
|
||||
|
||||
include::partial$generated/elements/column-cell/stop.adoc[]
|
||||
|
||||
include::partial$generated/elements/column-cell/label.adoc[]
|
||||
|
||||
See xref:user-interface/inspector/column.adoc[].
|
||||
|
||||
TIP: Right-clicking this area opens the xref:user-interface/menus/column-menu.adoc[].
|
||||
|
||||
// Row cell
|
||||
|
||||
include::partial$generated/elements/row-cell.adoc[]
|
||||
|
||||
[[row-drag-and-drop]]
|
||||
.Row drag-and-drop support
|
||||
****
|
||||
Reorder row::
|
||||
Drag the cell up or down to change the position of the row.
|
||||
****
|
||||
|
||||
include::partial$generated/elements/row-cell/play-scene.adoc[]
|
||||
|
||||
See xref:key-concepts.adoc#scene[].
|
||||
|
||||
include::partial$generated/elements/row-cell/label.adoc[]
|
||||
|
||||
See xref:user-interface/inspector/row.adoc[].
|
||||
|
||||
TIP: Right-clicking this area opens the xref:user-interface/menus/row-menu.adoc[].
|
||||
|
||||
// Slot cell
|
||||
|
||||
include::partial$generated/elements/slot-cell.adoc[]
|
||||
|
||||
include::partial$generated/elements/slot-cell/trigger.adoc[]
|
||||
|
||||
include::partial$generated/elements/slot-cell/record.adoc[]
|
||||
|
||||
This is only available if the corresponding xref:key-concepts.adoc#column-track[] is armed.
|
||||
|
||||
include::partial$generated/elements/slot-cell/content.adoc[]
|
||||
|
||||
See xref:user-interface/inspector/slot.adoc[].
|
||||
|
||||
TIP: Right-clicking this area opens the xref:user-interface/menus/slot-menu.adoc[].
|
||||
|
||||
[[slot-drag-and-drop]]
|
||||
.Slot drag-and-drop support
|
||||
****
|
||||
Move slot contents::
|
||||
Drag this area onto another slot in order to move all clips within this slot to the other slot.
|
||||
|
||||
Copy slot contents::
|
||||
Drag this area onto another slot while holding kbd:[Cmd/Ctrl] in order to copy all clips within this slot to the other slot.
|
||||
|
||||
Import content::
|
||||
Drag a MIDI or audio file from outside onto this area in order to import it as a clip. This should work from the REAPER media explorer, from other plug-ins that offer dragging out content as files and from most file managers.
|
||||
+
|
||||
NOTE: Dragging REAPER items onto the slot won't work, because REAPER items are not real files. Use xref:user-interface/menus/slot-menu.adoc#slot-import-selected-item[] instead!
|
||||
****
|
||||
|
||||
include::partial$generated/elements/slot-cell/clip-count.adoc[]
|
||||
|
||||
If there's more than one clip in the slot, all will be triggered at the same time.
|
||||
However, each one will start according to its individual start timing.
|
||||
@@ -0,0 +1,3 @@
|
||||
= Menus
|
||||
|
||||
Most of the menus in Playtime are context menus that you can open by right-clicking certain areas.
|
||||
+7
@@ -0,0 +1,7 @@
|
||||
= Clip context menu
|
||||
|
||||
Right-clicking one of the clips in the xref:user-interface/inspector/slot.adoc#inspector-slot-clip-picker[] opens this context menu.
|
||||
|
||||
include::partial$generated/menus/clip/remove-from-slot.adoc[]
|
||||
include::partial$generated/menus/clip/promote-to-top.adoc[]
|
||||
|
||||
+13
@@ -0,0 +1,13 @@
|
||||
= Column context menu
|
||||
|
||||
Right-clicking xref:user-interface/matrix-area.adoc#column-cell-label[] opens this context menu.
|
||||
|
||||
include::partial$generated/menus/column/rename-column-or-track.adoc[]
|
||||
include::partial$generated/menus/column/duplicate.adoc[]
|
||||
include::partial$generated/menus/column/insert-column-left.adoc[]
|
||||
include::partial$generated/menus/column/insert-column-right.adoc[]
|
||||
include::partial$generated/menus/column/insert-column-for-each-selected-track.adoc[]
|
||||
include::partial$generated/menus/column/remove.adoc[]
|
||||
include::partial$generated/menus/column/remove-keep-track.adoc[]
|
||||
include::partial$generated/menus/column/export-to-arrangement.adoc[]
|
||||
include::partial$generated/menus/column/export-to-clipboard-as-lua.adoc[]
|
||||
+11
@@ -0,0 +1,11 @@
|
||||
= Export to clipboard menu
|
||||
|
||||
This menu can be found in the xref:helgobox::plug-in/user-interface.adoc[plug-in window].
|
||||
|
||||
The following list only describes the Playtime-related menu entries. For the rest, see xref:helgobox::plug-in/user-interface/menu-bar.adoc#export-to-clipboard[] in the Helgobox Reference.
|
||||
|
||||
[[export-playtime-matrix-as-json]] Export Playtime matrix as JSON::
|
||||
Copies a dump of the xref:key-concepts.adoc#matrix[] (including its settings and contents) to the clipboard in JSON format.
|
||||
|
||||
Export Playtime matrix as Lua::
|
||||
Like <<export-playtime-matrix-as-json>> but generates Lua/Luau code instead. This can be helpful if you want to xref:advanced-usage-scenarios/generate-matrix.adoc[generate a matrix using code].
|
||||
+9
@@ -0,0 +1,9 @@
|
||||
= Matrix context menu
|
||||
|
||||
Right-clicking xref:user-interface/matrix-area.adoc#matrix-cell-settings[] opens this context menu.
|
||||
|
||||
include::partial$generated/menus/matrix/insert-column-for-each-selected-track.adoc[]
|
||||
include::partial$generated/menus/matrix/insert-column-right.adoc[]
|
||||
include::partial$generated/menus/matrix/insert-row-below.adoc[]
|
||||
include::partial$generated/menus/matrix/export-to-arrangement.adoc[]
|
||||
include::partial$generated/menus/matrix/export-to-clipboard-as-lua.adoc[]
|
||||
+15
@@ -0,0 +1,15 @@
|
||||
= Row context menu
|
||||
|
||||
Right-clicking xref:user-interface/matrix-area.adoc#row-cell-label[] opens this context menu.
|
||||
|
||||
include::partial$generated/menus/row/rename.adoc[]
|
||||
include::partial$generated/menus/row/build-scene-from-currently-playing-clips.adoc[]
|
||||
include::partial$generated/menus/row/copy.adoc[]
|
||||
include::partial$generated/menus/row/cut.adoc[]
|
||||
include::partial$generated/menus/row/paste.adoc[]
|
||||
include::partial$generated/menus/row/clear.adoc[]
|
||||
include::partial$generated/menus/row/duplicate.adoc[]
|
||||
include::partial$generated/menus/row/insert-row-above.adoc[]
|
||||
include::partial$generated/menus/row/insert-row-below.adoc[]
|
||||
include::partial$generated/menus/row/remove.adoc[]
|
||||
include::partial$generated/menus/row/export-to-arrangement.adoc[]
|
||||
+15
@@ -0,0 +1,15 @@
|
||||
= Slot context menu
|
||||
|
||||
Right-clicking xref:user-interface/matrix-area.adoc#slot-cell-content[] opens this context menu.
|
||||
|
||||
include::partial$generated/menus/slot/rename-primary-clip.adoc[]
|
||||
include::partial$generated/menus/slot/copy.adoc[]
|
||||
include::partial$generated/menus/slot/cut.adoc[]
|
||||
include::partial$generated/menus/slot/paste.adoc[]
|
||||
include::partial$generated/menus/slot/clear.adoc[]
|
||||
include::partial$generated/menus/slot/import-selected-item.adoc[]
|
||||
include::partial$generated/menus/slot/import-files.adoc[]
|
||||
include::partial$generated/menus/slot/export-primary-clip-to-arrangement.adoc[]
|
||||
include::partial$generated/menus/slot/export-primary-clip-to-clipboard-as-lua.adoc[]
|
||||
|
||||
This can be helpful if you want to xref:advanced-usage-scenarios/generate-matrix.adoc[generate a matrix using code].
|
||||
+5
@@ -0,0 +1,5 @@
|
||||
= Source context menu
|
||||
|
||||
Right-clicking xref:user-interface/inspector/clip.adoc#inspector-clip-source-info[] opens this context menu.
|
||||
|
||||
include::partial$generated/menus/source-info/open-in-media-explorer.adoc[]
|
||||
+5
@@ -0,0 +1,5 @@
|
||||
= Navigation bar
|
||||
|
||||
include::partial$user-interface/nav-bar-desc.adoc[]
|
||||
|
||||
See xref:helgobox::app/user-interface/navigation-bar.adoc[] in the Helgobox documentation.
|
||||
+7
@@ -0,0 +1,7 @@
|
||||
= Smart-record menu
|
||||
|
||||
Right-clicking xref:user-interface/toolbar.adoc#toolbar-smart-record[] opens this menu.
|
||||
|
||||
include::partial$generated/menus/smart-record/limit-recording-length.adoc[]
|
||||
|
||||
This is a shortcut for xref:user-interface/inspector/matrix/recording.adoc#inspector-matrix-limit-recording-length[].
|
||||
@@ -0,0 +1,14 @@
|
||||
= Title bar
|
||||
|
||||
include::partial$user-interface/title-bar-desc.adoc[]
|
||||
|
||||
This section focuses solely on the Playtime-specific functions.
|
||||
For more information on the general functions, refer to the xref:helgobox::app/user-interface/title-bar.adoc[] section in the Helgobox documentation.
|
||||
|
||||
include::partial$generated/elements/title-bar/tempo-detection-recording-hint.adoc[]
|
||||
|
||||
include::partial$generated/elements/title-bar/purchase-playtime.adoc[]
|
||||
|
||||
This button is displayed only if your copy of Playtime has not been activated yet.
|
||||
|
||||
See xref:user-interface/dialogs/purchase-and-activate-dialog.adoc[].
|
||||
@@ -0,0 +1,123 @@
|
||||
= Toolbar
|
||||
|
||||
include::partial$user-interface/toolbar-desc.adoc[]
|
||||
|
||||
.Toolbar
|
||||
image::generated/screenshots/elements/area/toolbar-0.png[]
|
||||
|
||||
// Tempo section
|
||||
|
||||
include::partial$generated/elements/toolbar/tempo-section.adoc[]
|
||||
|
||||
include::partial$generated/elements/toolbar/metronome.adoc[]
|
||||
|
||||
See xref:user-interface/dialogs/tempo-settings-dialog.adoc[].
|
||||
|
||||
NOTE: The Playtime metronome is only audible when REAPER is not playing. When REAPER is playing, REAPER's normal metronome takes over. This is also the reason why Playtime automatically syncs Playtime's metronome on/off status to REAPER's metronome on/off status.
|
||||
|
||||
include::partial$generated/elements/toolbar/tempo.adoc[]
|
||||
|
||||
include::partial$generated/elements/toolbar/tap-tempo.adoc[]
|
||||
|
||||
include::partial$generated/elements/toolbar/time-signature.adoc[]
|
||||
|
||||
include::partial$generated/elements/toolbar/play-rate.adoc[]
|
||||
|
||||
// Transport section
|
||||
|
||||
include::partial$generated/elements/toolbar/transport-section.adoc[]
|
||||
|
||||
Those are different from the REAPER transport controls, as Playtime is capable of playing and recording while REAPER is stopped.
|
||||
|
||||
include::partial$generated/elements/toolbar/smart-record.adoc[]
|
||||
|
||||
TIP: Right-clicking the smart-record button opens the xref:user-interface/smart-record-menu.adoc[].
|
||||
|
||||
include::partial$generated/elements/toolbar/start-stop-playback.adoc[]
|
||||
|
||||
If you want to start REAPER playback together with Playtime, you have two options:
|
||||
|
||||
[loweralpha]
|
||||
. Start playback within REAPER itself (which automatically starts Playtime playback)
|
||||
. Switch xref:user-interface/inspector/matrix/playback.adoc#inspector-matrix-transport-sync[] to **Full**
|
||||
|
||||
// Visual metronome
|
||||
|
||||
include::partial$generated/elements/toolbar/visual-metronome.adoc[]
|
||||
|
||||
// Start timing
|
||||
|
||||
include::partial$generated/elements/toolbar/matrix-start-timing.adoc[]
|
||||
|
||||
See xref:key-concepts.adoc#clip-start-timing[].
|
||||
|
||||
// Matrix sequencer
|
||||
|
||||
include::partial$generated/elements/toolbar/matrix-sequencer.adoc[]
|
||||
|
||||
See xref:key-concepts.adoc#matrix-sequence[].
|
||||
|
||||
include::partial$generated/elements/toolbar/record-matrix-sequence.adoc[]
|
||||
|
||||
This will always create a new sequence.
|
||||
Old sequences are retained, so you can press this anytime without worrying to overwrite old sequences.
|
||||
|
||||
Even though the button turns red right after clicking it, you don't need to rush with your performance.
|
||||
After recording, Playtime will automatically remove silence at the beginning of the sequence.
|
||||
|
||||
include::partial$generated/elements/toolbar/matrix-sequence-picker.adoc[]
|
||||
|
||||
See xref:user-interface/dialogs/sequences-dialog.adoc[].
|
||||
|
||||
include::partial$generated/elements/toolbar/play-stop-matrix-sequence.adoc[]
|
||||
|
||||
include::partial$generated/elements/toolbar/write-to-arrangement.adoc[]
|
||||
|
||||
If the Playtime column tracks already contain items, pressing this button will show the xref:user-interface/dialogs/arrangement-writing-mode-dialog.adoc[].
|
||||
|
||||
See xref:usage/arrangement.adoc#feature-arrangement[] for details.
|
||||
|
||||
include::partial$generated/elements/toolbar/show-hide-midi-triggers.adoc[]
|
||||
|
||||
[IMPORTANT]
|
||||
====
|
||||
The purpose of this feature is to quickly create *simple* and *xref:helgobox:ROOT:key-concepts.adoc#instance[instance-specific]* mappings of MIDI keys/pads/buttons to cells.
|
||||
|
||||
* If you are looking for out-of-the-box support for full-featured grid controllers, such as the Launchpad, see xref:usage/grid-controllers.adoc[].
|
||||
* If you are looking for advanced, highly-customizable control scenarios, you should use xref:realearn::introduction.adoc[ReaLearn] with its dedicated xref:realearn::targets/playtime.adoc[].
|
||||
====
|
||||
|
||||
Here's how you assign a new MIDI trigger to a cell or toolbar button, after showing the MIDI triggers:
|
||||
|
||||
. Click the MIDI trigger area in the cell or next to the toolbar button. It should turn red, which indicates that Playtime waits for you to press something.
|
||||
. Press a key or foot switch on your music keyboard. The area should now turn back to its original color and the corresponding note name or MIDI CC number should appear.
|
||||
. You can now use the note or foot switch to trigger the cell or invoke the toolbar function.
|
||||
|
||||
.Powered by ReaLearn
|
||||
[TIP]
|
||||
====
|
||||
Playtime's MIDI triggers are powered by xref:realearn::introduction.adoc[ReaLearn], Helgobox's controller integration solution. In fact, each Playtime MIDI trigger corresponds to one xref:realearn::key-concepts.adoc#mapping[] in ReaLearn's xref:realearn::key-concepts.adoc#unit[Main unit].
|
||||
|
||||
When you learn a MIDI trigger, you are actually learning the source of a ReaLearn mapping that Playtime automatically creates for you. The target is pre-configured by Playtime and is nothing more than one of the xref:realearn::targets/playtime.adoc[]. The beauty of this is that under the hood, you have the complete power of ReaLearn at your disposal, including its xref:realearn::key-concepts.adoc#feedback[] capabilities!
|
||||
====
|
||||
|
||||
|
||||
[[midi-trigger-troubleshooting]]
|
||||
.Troubleshooting
|
||||
****
|
||||
If nothing happens when you press the note or foot switch, we need to check the MIDI signal flow.
|
||||
|
||||
. Press the xref:helgobox::app/user-interface/navigation-bar.adoc#navbar-show-helgobox-plugin[] button in the navigation bar on the left. This should open the xref:helgobox::plug-in/user-interface.adoc[plug-in window] starring ReaLearn's xref:realearn::user-interface/main-panel.adoc[].
|
||||
. Check ReaLearn's xref:realearn::user-interface/main-panel/input-output-section.adoc[input]!
|
||||
|
||||
By default, the input should be set to xref:realearn::user-interface/main-panel/input-output-section.adoc#fx-input[]. This means that ReaLearn captures MIDI messages from the surrounding REAPER track (the one containing this xref:helgobox::key-concepts.adoc#instance[Helgobox instance]). *In this case, make sure that the track is armed and input monitoring is switched on!*
|
||||
|
||||
If you want, you can also set the input to a specific device instead! In that case, the Helgobox track doesn't need to be armed.
|
||||
|
||||
After that, try again learning the MIDI trigger within Playtime!
|
||||
|
||||
.Leveraging button LEDs using ReaLearn's feedback capabilities
|
||||
TIP: If the buttons on your device have LEDs, you might want to set ReaLearn's output to the same device. With a bit of luck, that makes the LEDs reflect the current clip playback or function state. However, depending on the specific controller, that part might need a bit more work.
|
||||
****
|
||||
|
||||
include::partial$generated/elements/toolbar/pane-toggler.adoc[]
|
||||
+150
@@ -0,0 +1,150 @@
|
||||
= Track area
|
||||
|
||||
include::partial$user-interface/track-area-desc.adoc[]
|
||||
|
||||
NOTE: Since multiple columns can have the same playback track, it's possible that you see one track panel multiple times!
|
||||
|
||||
.Master track panel
|
||||
image::generated/screenshots/elements/area/track-area-0.png[width=80]
|
||||
|
||||
.Column track panels
|
||||
image::generated/screenshots/elements/area/track-area-1.png[]
|
||||
|
||||
== Track panel header
|
||||
|
||||
The top of the track panel is the _track panel header_.
|
||||
|
||||
.Drag-and-drop support
|
||||
****
|
||||
Reorder column::
|
||||
Drag the header left or right to change the position of the corresponding column.
|
||||
****
|
||||
|
||||
include::partial$generated/elements/track-panel/input-type-indicator.adoc[]
|
||||
|
||||
include::partial$generated/elements/track-panel/label.adoc[]
|
||||
|
||||
== Track input section
|
||||
|
||||
include::partial$generated/elements/track-panel/input.adoc[]
|
||||
|
||||
WARNING: Playtime captures audio or MIDI input more or less directly from the hardware.
|
||||
That also means that the track's _input_ FX chain will not have any effect on the recording!
|
||||
You can work around this limitation by using *Loopback* channels instead of input FX.
|
||||
|
||||
TIP: Selecting *Loopback* channels as audio input doesn't automatically enable them!
|
||||
Make sure that the REAPER setting *Virtual loopback audio hardware channels* in menu:Options[Preferences/Settings... > Audio] is high enough!
|
||||
|
||||
NOTE: This directly sets the input of the corresponding REAPER track.
|
||||
Although technically not necessary for recording because Playtime doesn't use REAPER's track recording facility, it is important for input monitoring.
|
||||
|
||||
include::partial$generated/elements/track-panel/midi-channel-filter.adoc[]
|
||||
|
||||
NOTE: This directly sets the input MIDI channel of the corresponding REAPER track.
|
||||
|
||||
include::partial$generated/elements/track-panel/map-to-midi-channel.adoc[]
|
||||
|
||||
NOTE: This directly sets the "Map input to channel" value of the corresponding REAPER track.
|
||||
|
||||
include::partial$generated/elements/track-panel/input-monitoring.adoc[]
|
||||
|
||||
include::partial$generated/elements/track-panel/input-monitoring-off.adoc[]
|
||||
|
||||
include::partial$generated/elements/track-panel/input-monitoring-auto.adoc[]
|
||||
|
||||
include::partial$generated/elements/track-panel/input-monitoring-on.adoc[]
|
||||
|
||||
NOTE: Which input monitoring mode you choose also has an effect on how Playtime does latency compensation during recording. Read more about that in xref:further-concepts/general.adoc#latency-compensation[].
|
||||
|
||||
[[input-monitoring-explained, Playtime input monitoring explained]]
|
||||
[NOTE]
|
||||
.Playtime input monitoring explained
|
||||
====
|
||||
Playtime input monitoring options are slightly different from REAPER's input monitoring options.
|
||||
Each input monitoring option mode translates to a certain combination of REAPER track properties:
|
||||
|
||||
[cols="s,s,1,1,1"]
|
||||
|===
|
||||
|Track input monitoring in Playtime | Track armed in Playtime | Track monitoring in REAPER | Track record input in REAPER | Track armed in REAPER
|
||||
|
||||
|Off
|
||||
|No
|
||||
|Off
|
||||
|Record: input (audio or MIDI)
|
||||
|No
|
||||
|
||||
|Off
|
||||
|Yes
|
||||
|Off
|
||||
|Record: input (audio or MIDI)
|
||||
|Yes
|
||||
|
||||
|Auto
|
||||
|No
|
||||
|On (Monitor Input)
|
||||
|Record: input (audio or MIDI)
|
||||
|No
|
||||
|
||||
|Auto
|
||||
|Yes
|
||||
|On (Monitor Input)
|
||||
|Record: input (audio or MIDI)
|
||||
|Yes
|
||||
|
||||
|On
|
||||
|No
|
||||
|On (Monitor Input)
|
||||
|Record: disable (input monitoring only)
|
||||
|Yes
|
||||
|
||||
|On
|
||||
|Yes
|
||||
|On (Monitor Input)
|
||||
|Record: input (audio or MIDI)
|
||||
|Yes
|
||||
|===
|
||||
====
|
||||
|
||||
== Track output section
|
||||
|
||||
=== PDC info
|
||||
|
||||
If the track is affected by xref:further-concepts/general.adoc#pdc[], a small icon will light up.
|
||||
|
||||
include::partial$generated/elements/track-panel/pdc-tiny.adoc[]
|
||||
include::partial$generated/elements/track-panel/pdc-significant.adoc[]
|
||||
include::partial$generated/elements/track-panel/pdc-critical.adoc[]
|
||||
|
||||
include::partial$generated/elements/track-panel/pan.adoc[]
|
||||
|
||||
NOTE: This directly sets the pan value of the corresponding REAPER track.
|
||||
|
||||
include::partial$generated/elements/track-panel/volume.adoc[]
|
||||
|
||||
When not enough vertical space is available, this turns into a drag field, visualizing the peaks as color changes.
|
||||
|
||||
NOTE: This directly sets the volume of the corresponding REAPER track.
|
||||
|
||||
include::partial$generated/elements/track-panel/instrument-fx.adoc[]
|
||||
|
||||
This icon is only visible if there's at least one instrument in the FX chain.
|
||||
|
||||
include::partial$generated/elements/track-panel/fx-chain.adoc[]
|
||||
|
||||
The button is displayed in bold font if there's at least one FX in the chain.
|
||||
|
||||
include::partial$generated/elements/track-panel/routing.adoc[]
|
||||
|
||||
include::partial$generated/elements/track-panel/arm.adoc[]
|
||||
|
||||
NOTE: See <<input-monitoring-explained>> to learn how this translates to REAPER track properties.
|
||||
|
||||
|
||||
include::partial$generated/elements/track-panel/mute.adoc[]
|
||||
|
||||
NOTE: This directly sets the mute state of the corresponding REAPER track.
|
||||
|
||||
include::partial$generated/elements/track-panel/solo.adoc[]
|
||||
|
||||
NOTE: This directly sets the solo state of the corresponding REAPER track.
|
||||
|
||||
Reference in New Issue
Block a user