Paul Lipscomb
7ecc718f5d
app -> app-desktop-macos, presets -> app-presets, server -> remote-server, daw-config-reaper -> osc-config-daw, plugin-reaper-realearn -> plugin-reaper-relearn. Updated run.py and presets.py path references accordingly. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
141 lines
5.7 KiB
Plaintext
141 lines
5.7 KiB
Plaintext
= Target section
|
|
|
|
image:realearn/screenshots/mapping-panel-target.png[Screenshot]
|
|
|
|
All xref:targets.adoc[] share the following UI elements.
|
|
|
|
[#learn]
|
|
== Learn button
|
|
|
|
Starts or stops learning the target of this mapping.
|
|
|
|
[#menu]
|
|
== Menu
|
|
|
|
Opens a small menu related to the target section:
|
|
|
|
Pick recently touched target (by type)::
|
|
Gives you a list of recently touched parameters or executed actions in REAPER.
|
|
When you click one of it, the target will be populated accordingly.
|
|
It's an alternative to btn:[Learn].
|
|
+
|
|
Please note that not all targets can be picked that way, some have to be configured manually.
|
|
|
|
Go there (if supported):: If applicable, this makes the target of this mapping visible in REAPER.
|
|
E.g. if the target is a track FX parameter, the corresponding track FX window will be displayed.
|
|
|
|
[#category]
|
|
== Category menu
|
|
|
|
Lets you choose the target category.
|
|
|
|
[#type]
|
|
== Type menu
|
|
|
|
Lets you choose a target type within that category.
|
|
See xref:targets.adoc[].
|
|
|
|
[#current-value]
|
|
== Value section and field
|
|
|
|
Reflects the current value of this mapping target and lets you change it (either via slider and text field or via buttons, depending on the target character).
|
|
|
|
If the target can't be resolved at the moment, it will show "Target currently inactive!" instead.
|
|
|
|
[[display-unit]]
|
|
== Display unit button
|
|
|
|
On the right side of the current value you will see a button with a label such as `1. dB (%)`.
|
|
This button displays the currently selected target unit (unrelated to the xref:key-concepts.adoc#unit[] concept) which is used for displaying and entering target values.
|
|
|
|
The number in the parentheses denotes the unit which is used for displaying and entering target step sizes.
|
|
|
|
Clicking the button switches between available target units.
|
|
Currently, there are two options:
|
|
|
|
(1) Use native target units::
|
|
Uses the target-specific unit, e.g. dB for volume targets.
|
|
If the target doesn't have any specific units, it will be displayed as `1. - (-)`.
|
|
|
|
(2) Use percentages::
|
|
Uses percentages for everything, which can be nice to get a uniform way of displaying/entering values instead of having to deal with the sometimes clunky target-specific units.
|
|
|
|
== Common elements for track targets
|
|
|
|
When choosing a track, the following additional elements are available.
|
|
|
|
[[track-must-be-selected]]
|
|
=== Track must be selected checkbox
|
|
|
|
If checked, this mapping will be active only if the track set in _Track_ is currently selected.
|
|
See xref:further-concepts/target.adoc#target-activation-condition[].
|
|
|
|
=== Selection ganging checkbox
|
|
|
|
If checked and if the track in question is selected, all other selected tracks will be adjusted as well.
|
|
This uses REAPER's built-in selection-ganging feature and therefore should behave exactly like it.
|
|
|
|
=== Respect grouping checkbox
|
|
|
|
If checked, track grouping will be taken into account when adjusting the value.
|
|
This uses REAPER's built-in track grouping feature and therefore should behave exactly like it.
|
|
|
|
NOTE: In older REAPER versions (< 6.69+dev1102), this can only be enabled together with selection ganging when using it on volume, pan or width targets.
|
|
|
|
== Common elements for on/off targets
|
|
|
|
Targets which control an on/off-style property of tracks (e.g. xref:targets/track/solo-unsolo.adoc[]) additionally provide the following elements.
|
|
|
|
[[exclusive]]
|
|
=== Exclusive menu
|
|
|
|
By default, this is set to <<exclusive-no>>.
|
|
|
|
[[exclusive-no]] No:: Makes the track target affect just this track.
|
|
Within project:: Switches the property on (off) for this track and off (on) for all other tracks in the project.
|
|
Within folder:: Switches the property on (off) for this track and off (on) for all other tracks in the same folder and same level.
|
|
Within project (on only):: Variation of _Within project_ that applies exclusivity only when switching the property on for this track.
|
|
In other words, it never switches the property on for other tracks.
|
|
Within folder (on only):: Variation of _Within folder_ that applies exclusivity only when switching the property on for this track.
|
|
In other words, it never switches the property on for other tracks.
|
|
|
|
== Common elements for FX targets
|
|
|
|
The following elements and selectors are available for targets associated with a particular FX instance.
|
|
|
|
=== FX section
|
|
|
|
The FX instance associated with this target.
|
|
ReaLearn will search for the FX in the output or input FX chain of the above selected track.
|
|
|
|
=== Input FX checkbox
|
|
|
|
If unchecked, the _FX_ dropdown will show FX instances in the track's normal FX chain.
|
|
If checked, it will show FX instances in the track's input FX chain.
|
|
|
|
=== Monitoring FX checkbox
|
|
|
|
This appears instead of the input FX checkbox if you select track `<Master>`.
|
|
If you check this, you can target FX instances on REAPER's global monitoring FX chain.
|
|
|
|
WARNING: Because of a limitation in the REAPER API, learning and feedback for monitoring FX doesn't work!
|
|
|
|
[[fx-must-have-focus]]
|
|
=== FX must have focus checkbox
|
|
|
|
If checked, this mapping will be active only if the selected FX instance is currently _focused_.
|
|
|
|
If the FX instance is displayed in a floating window, _focused_ means that the floating window is active.
|
|
If it's displayed within the FX chain window, _focused_ means that the FX chain window is currently open and the FX instance is the currently selected FX in that FX chain.
|
|
|
|
Of course, this flag doesn't have any effect if you chose the xref:further-concepts/target.adoc#fx-focused-selector[].
|
|
|
|
== Common elements for pollable targets
|
|
|
|
The following elements are available only for the few targets that might need polling (= regular value querying) in order to support automatic feedback in all cases.
|
|
|
|
=== Poll for feedback checkbox
|
|
|
|
Enables or disables xref:further-concepts/target.adoc#target-value-polling[].
|
|
In the probably rare case that the polling causes performance issues, you can untick this checkbox.
|