ardour
/
manual
13
0
Fork 0
Code Pull Requests Releases Activity

Slight FaderPort update at the suggestion of @x42

This commit is contained in:
Alexandre Prokoudine 2022-11-22 11:49:53 +03:00
parent c03ff70ecb
commit 2cde77ff48
3 changed files with 294 additions and 226 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

443
include/using-the-presonus-faderport.html
View File

@ -1,7 +1,7 @@
<p> <p>
Since version 4.5, Ardour has had full support for the Presonus Ardour has full support for the Presonus Faderport controller.
Faderport. This is a compact control surface featuring a single This is a compact control surface featuring a single
motorized fader, a single knob (encoder) and 24 buttons with fixed motorized fader, a single knob (encoder) and 24 buttons with fixed
labels. It is a relatively low-cost device that functions very well labels. It is a relatively low-cost device that functions very well
to control a single (selected) track or bus, along with a variety of to control a single (selected) track or bus, along with a variety of
@ -64,14 +64,13 @@
</p> </p>
<h2>Using the Faderport</h2> <h2>Using the Faderport</h2>
<p> <p>
The Faderport's controls can be divided into three groups: The Faderport's controls can be divided into three groups:
<ol> <ol>
<li>Global controls such as the transport buttons</li> <li>Global controls such as the transport buttons</li>
<li>Controls which change the settings for particular track or <li>Controls which change the settings for particular track or
bus</li> bus</li>
<li>Controls which alter which track or bus is modified by the <li>Controls which alter which track or bus is modified by the
per-track/bus controls.</li> per-track/bus controls.</li>
</ol> </ol>
@ -84,295 +83,329 @@
</p> </p>
<h3>Transport Buttons</h3> <h3>Transport Buttons</h3>
<p> <p>
The transport buttons all work as you would expect. The transport buttons all work as you would expect.
<table class="dl">
<tr><th>Rewind</th>
<td>
<p>
When pressed on its own, starts the transport moving backwards. Successive presses
speed up the "rewind" behaviour.
</p>
<p>
If pressed while also holding the Stop button, the playhead will
return to the zero position on the timeline.
</p>
<p>
If pressed while also holding the Shift button, the playhead will
move to the session start marker.
</p>
</td></tr>
<tr><th>Fast Forward</th>
<td>
<p>
When pressed on its own, starts the transport moving faster than normal. Successive presses
speed up the "fast forward" behaviour.
</p>
<p>
If pressed while also holding the Shift button, the playhead
will move to the session end marker.
</p>
</td></tr>
<tr><th>Stop</th>
<td>
Stops the transport. Also used in combination with the Rewind
button to "return to zero".
</td></tr>
<tr><th>Play</th>
<td>
Starts the transport. If pressed while the transport is
already rolling at normal speed, causes the playhead to jump to
the start of the last "roll" and continue rolling ("Poor man's
looping").
</td></tr>
<tr><th>Record Enable</th>
<td>Toggles the global record enable setting
</td></tr>
</table>
</p> </p>
<table class="dl">
<tr><th>Rewind</th>
<td>
<p>
When pressed on its own, starts the transport moving backwards.
Successive presses speed up the "rewind" behaviour.
</p>
<p>
If pressed while also holding the Stop button, the playhead will
return to the zero position on the timeline.
</p>
<p>
If pressed while also holding the Shift button, the playhead will
move to the session start marker.
</p>
</td></tr>
<tr><th>Fast Forward</th>
<td>
<p>
When pressed on its own, starts the transport moving faster than normal.
Successive presses speed up the "fast forward" behaviour.
</p>
<p>
If pressed while also holding the Shift button, the playhead
will move to the session end marker.
</p>
</td></tr>
<tr><th>Stop</th>
<td>
Stops the transport. Also used in combination with the Rewind
button to "return to zero".
</td></tr>
<tr><th>Play</th>
<td>
Starts the transport. If pressed while the transport is
already rolling at normal speed, causes the playhead to jump to
the start of the last "roll" and continue rolling ("Poor man's
looping").
</td></tr>
<tr><th>Record Enable</th>
<td>Toggles the global record enable setting
</td></tr>
</table>
<h3>Other Global Controls</h3> <h3>Other Global Controls</h3>
<p> <p>
The Mix, Proj, Trns buttons do not obviously correspond any The <kbd class="button">Mix</kbd>, <kbd class="button">Proj</kbd>,
<kbd class="button">Trns</kbd> buttons do not obviously correspond to any
particular functions or operations in Ardour. We have therefore particular functions or operations in Ardour. We have therefore
allowed users to choose from a carefully curated set of possible allowed users to choose from a carefully curated set of possible
actions that seem related to the button labels in some clear actions that seem related to the button labels in some clear
way. This can be done via the Faderport configuration dialog way. This can be done via the Faderport configuration dialog
accessed via <code>Preferences &gt; Control Surfaces</code>. Each accessed via <code>Preferences&nbsp;&gt; Control Surfaces</code>. Each
button has 3 possible actions associated with it: button has 3 possible actions associated with it:
<ul> </p>
<li>Plain Press: action to be taken when the button is pressed on
its own.</li> <ul>
<li>Shift-Press: action to be taken when the button is pressed in <li>Plain Press: action to be taken when the button is pressed on
conjunction with the Shift button.</li> its own.</li>
<li>Long Press: action to be taken when the button is pressed on <li>Shift-Press: action to be taken when the button is pressed in
its own and held down for more than 0.5 seconds.</li> conjunction with the Shift button.</li>
</ul> <li>Long Press: action to be taken when the button is pressed on
its own and held down for more than 0.5 seconds.</li>
</ul>
<p>
Click on the relevant drop-down selector to pick an action as you Click on the relevant drop-down selector to pick an action as you
prefer. prefer.
</p> </p>
<p> <p>
The User button also has no obvious mapping to specific Ardour The User button also has no obvious mapping to specific Ardour
functionality, so we allow users to choose from <em>any</em> functionality, so we allow users to choose from <em>any</em>
possible GUI action. The menu for selecting the action is somewhat possible GUI action. The menu for selecting the action is somewhat
confusing and it can be hard to find what you're looking confusing and it can be hard to find what you're looking
for. However, all possible actions are there, so keep looking! for. However, all possible actions are there, so keep looking!
<p>
<table class="dl">
<tr><th>Mix</th>
<td>
<p>
Possible actions include:
<ul>
<li>Toggle Editor &amp; Mixer visibility</li>
<li>Show/Hide the Editor mixer strip</li>
</ul>
</p>
</td></tr>
<tr><th>Proj</th>
<td>
<p>
Possible actions include:
<ul>
<li>Toggle Meterbridge visibility</li>
<li>Toggle Session Summary visibility</li>
<li>Toggle Editor Lists visibility</li>
<li>Zoom to session</li>
<li>Zoom in</li>
<li>Zoom out</li>
</ul>
</p>
</td></tr>
<tr><th>Trns</th>
<td>
<p>
Possible actions include:
<ul>
<li>Toggle Locations window visibility</li>
<li>Toggle Metronome</li>
<li>Toggle external sync</li>
<li>Set Playhead at current pointer position</li>
</ul>
</p>
</td></tr>
<tr><th>Undo/Redo</th>
<td>
Undo Causes the last operation carried out in the editor to be
undone. When pressed in conjunction with the Shift button, it
causes the most recent undone operation to be re-done.
</td></tr>
<tr><th>Punch</th>
<td>
<p>
When pressed on its own, toggles punch recording. If there is no
punch range set for the session, this will do nothing.
</p>
<p>
When pressed in conjunction with the Shift button, this moves
the playhead to the previous Marker
</p>
</td></tr>
<tr><th>User</th>
<td>
<p>
See above. Any and all GUI-initiated actions can be driven with
by pressing this button on its own, or with a "long" press.
</p>
<p>
When pressed in conjunction with the Shift button, this will move
the playhead to the next marker.
</p>
</td></tr>
<tr><th>Loop</th>
<td>
<p>
When pressed on its own, this toggles loop playback. If the
Ardour preference "Loop-is-mode" is enabled, this does nothing
to the current transport state. If that preference is disabled,
then engaging loop playback will also start the transport.
</p>
<p>
When pressed in conjunction with the Shift button, this will
create a new (unnamed) marker at the current playhead
position.
</p>
</td></tr>
</table>
</p> </p>
<table class="dl">
<tr><th>Mix</th>
<td>
<p>
Possible actions include:
</p>
<ul>
<li>Toggle Editor &amp; Mixer visibility</li>
<li>Show/Hide the Editor mixer strip</li>
</ul>
</td></tr>
<tr><th>Proj</th>
<td>
<p>
Possible actions include:
<ul>
<li>Toggle Meterbridge visibility</li>
<li>Toggle Session Summary visibility</li>
<li>Toggle Editor Lists visibility</li>
<li>Zoom to session</li>
<li>Zoom in</li>
<li>Zoom out</li>
</ul>
</p>
</td></tr>
<tr><th>Trns</th>
<td>
<p>
Possible actions include:
<ul>
<li>Toggle Locations window visibility</li>
<li>Toggle Metronome</li>
<li>Toggle external sync</li>
<li>Set Playhead at current pointer position</li>
</ul>
</p>
</td></tr>
<tr><th>Undo/Redo</th>
<td>
Undo Causes the last operation carried out in the editor to be
undone. When pressed in conjunction with the Shift button, it
causes the most recent undone operation to be re-done.
</td></tr>
<tr><th>Punch</th>
<td>
<p>
When pressed on its own, toggles punch recording. If there is no
punch range set for the session, this will do nothing.
</p>
<p>
When pressed in conjunction with the Shift button, this moves
the playhead to the previous Marker
</p>
</td></tr>
<tr><th>User</th>
<td>
<p>
See above. Any and all GUI-initiated actions can be driven with
by pressing this button on its own, or with a "long" press.
</p>
<p>
When pressed in conjunction with the Shift button, this will move
the playhead to the next marker.
</p>
</td></tr>
<tr><th>Loop</th>
<td>
<p>
When pressed on its own, this toggles loop playback. If the
Ardour preference "Loop-is-mode" is enabled, this does nothing
to the current transport state. If that preference is disabled,
then engaging loop playback will also start the transport.
</p>
<p>
When pressed in conjunction with the Shift button, this will
create a new (unnamed) marker at the current playhead
position.
</p>
</td></tr>
</table>
<h3>Per-track Controls</h3> <h3>Per-track Controls</h3>
<p>
<table class="dl"> <table class="dl">
<tr><th>Mute</th> <tr>
<th>Mute</th>
<td> <td>
This toggles the mute setting of the currently controlled This toggles the mute setting of the currently controlled
track/bus. The button will be lit if the track/bus is muted. track/bus. The button will be lit if the track/bus is muted.
</td></tr> </td>
<tr><th>Solo</th> </tr>
<tr>
<th>Solo</th>
<td> <td>
This toggles the solo (or listen) setting of the currently This toggles the solo (or listen) setting of the currently
controlled track/bus. The button will be lit if the track/bus is controlled track/bus. The button will be lit if the track/bus is
soloed (or set to listen mode). soloed (or set to listen mode).
</td></tr> </td>
<tr><th>Rec</th> </tr>
<tr>
<th>Rec</th>
<td> <td>
This toggles the record-enabled setting of the currently This toggles the record-enabled setting of the currently
controlled track/bus. The button will be lit if the track is controlled track/bus. The button will be lit if the track is
record-enabled. This button will do nothing if the Faderport is record-enabled. This button will do nothing if the Faderport is
controlling a bus. controlling a bus.
</td></tr> </td>
<tr><th>Fader</th> </tr>
<tr>
<th>Fader</th>
<td> <td>
The fader controls the gain applied to the currently controlled The fader controls the gain applied to the currently controlled
track/bus. If the Faderport is powered, changing the gain in track/bus. If the Faderport is powered, changing the gain in
Ardour's GUI or via another control surface, or via automation, Ardour's GUI or via another control surface, or via automation,
will result in the fader moving under its own control. will result in the fader moving under its own control.
</td></tr> </td>
<tr><th>Knob/Dial/Encoder</th> </tr>
<tr>
<th>Knob/Dial/Encoder</th>
<td> <td>
<p> <p>
The knob controls 1 or 2 pan settings for the current The knob controls 1 or 2 pan settings for the current
controlled track/bus. When used alone, turning the knob controls controlled track/bus. When used alone, turning the knob controls
the "azimuth" or "direction" (between left and right) for the the "azimuth" or "direction" (between left and right) for the
panner in the track/bus (if any). This is all you need when panner in the track/bus (if any). This is all you need when
controlling tracks/busses with 1 input and 2 outputs. controlling tracks/busses with 1 input and 2 outputs.
</p>
<p>
If controlling a 2 input/2 output track/bus, Ardour's panner
has two controls: azimuth (direction) and width. The width
must be reduced to less than 100% before the azimuth can be
changed. Pressing the "Shift" button while turning the knob
will alter the width setting.
</p> </p>
<p> <p>
If controlling a 2 input/2 output track/bus, Ardour's panner The knob can also be turned while the "User" button is held,
has two controls: azimuth (direction) and width. The width in order to modify the input gain for the currently controlled
must be reduced to less than 100% before the azimuth can be track.
changed. Pressing the "Shift" button while turning the knob
will alter the width setting.
</p> </p>
<p> </td>
The knob can also be turned while the "User" button is held, </tr>
in order to modify the input gain for the currently controlled <tr>
track. <th>Read</th>
</p>
</td></tr>
<tr><th>Read</th>
<td> <td>
Enables playback/use of fader automation data by the controlled track/bus. Enables playback/use of fader automation data by the controlled track/bus.
</td></tr> </td>
<tr><th>Write</th> </tr>
<tr>
<th>Write</th>
<td> <td>
Puts the fader for the controlled track/bus into automation Puts the fader for the controlled track/bus into automation
write mode. While the transport is rolling, all fader changes write mode. While the transport is rolling, all fader changes
will be recorded to the fader automation lane for the relevant track/bus. will be recorded to the fader automation lane for the relevant track/bus.
</td></tr> </td>
<tr><th>Touch</th> </tr>
<tr>
<th>Touch</th>
<td> <td>
Puts the fader for the controlled track/bus into automation Puts the fader for the controlled track/bus into automation
touch mode. While the transport is rolling, touching the fader touch mode. While the transport is rolling, touching the fader
will initiate recording all fader changes until the fader is will initiate recording all fader changes until the fader is
released. When the fader is not being touched, existing released. When the fader is not being touched, existing
automation data will be played/used to control the gain level. automation data will be played/used to control the gain level.
</td></tr> </td>
<tr><th>Off</th> </tr>
<tr>
<th>Off</th>
<td> <td>
This disables all automation modes for the currently controlled This disables all automation modes for the currently controlled
track/bus. Existing automation data will be left unmodified by track/bus. Existing automation data will be left unmodified by
any fader changes, and will not be used for controlling gain. any fader changes, and will not be used for controlling gain.
</td></tr> </td>
</table> </tr>
</p> </table>
<h3>Track Selection Controls</h3> <h3>Track Selection Controls</h3>
<p> <p>
You can manually change the track/bus controlled by the Faderport by You can manually change the track/bus controlled by the Faderport by
changing the selected track in Ardour's editor window. If you select changing the selected track in Ardour's editor window. If you select
more than 1 track, the Faderport will control the first selected more than 1 track, the Faderport will control the first selected
track and <em>only</em> that track/bus. track and <em>only</em> that track/bus.
</p> </p>
<p>
<table class="dl"> <table class="dl">
<tr><th>Left (arrow)</th> <tr>
<th>Left (arrow)</th>
<td> <td>
This causes the Ardour GUI to select the previous track/bus This causes the Ardour GUI to select the previous track/bus
(using the current visual order in the editor window), which (using the current visual order in the editor window), which
will in turn cause the Faderport to control that track. If there will in turn cause the Faderport to control that track. If there
is no previous track/bus, the selected track/bus is left is no previous track/bus, the selected track/bus is left
unchanged, and the Faderport continues to control it. unchanged, and the Faderport continues to control it.
</td></tr> </td>
<tr><th>Right (arrow)</th> </tr>
<tr>
<th>Right (arrow)</th>
<td> <td>
This causes the Ardour GUI to select the next track/bus This causes the Ardour GUI to select the next track/bus
(using the current visual order in the editor window), which (using the current visual order in the editor window), which
will in turn cause the Faderport to control that track. If there will in turn cause the Faderport to control that track. If there
is no next track/bus, the selected track/bus is left is no next track/bus, the selected track/bus is left
unchanged, and the Faderport continues to control it. unchanged, and the Faderport continues to control it.
</td></tr> </td>
<tr><th>Output</th> </tr>
<tr>
<th>Output</th>
<td> <td>
<p> <p>
Pressing the Output button causes the Faderport to control Pressing the Output button causes the Faderport to control
the fader, pan, mute and solo settings of the Master bus. If the fader, pan, mute and solo settings of the Master bus. If
your session does not contain a Master bus, it does nothing. your session does not contain a Master bus, it does nothing.
This is a toggle button&mdash;pressing it again returns Faderport This is a toggle button&mdash;pressing it again returns Faderport
to controlling whichever track/bus was selected before the to controlling whichever track/bus was selected before the
first press of the Output button. first press of the Output button.
</p> </p>
<p> <p>
If your session uses Ardour's monitor section, you can use If your session uses Ardour's monitor section, you can use
Shift-Output to assign it to the Faderport in the same way Shift-Output to assign it to the Faderport in the same way
that Output assigns the Master bus. This is also a toggle that Output assigns the Master bus. This is also a toggle
setting, so the second Shift-Output will return the Faderport setting, so the second Shift-Output will return the Faderport
to controlling whichever track/bus was selected before. to controlling whichever track/bus was selected before.
</p> </p>
<p> <p>
If you press Shift-Output after a single press to Output If you press Shift-Output after a single press to Output
(i.e. control the Monitor Section while currently controlling (i.e. control the Monitor Section while currently controlling
the Master bus) or vice versa (i.e. control the Master bus the Master bus) or vice versa (i.e. control the Master bus
while currently controlling the Monitor Section), the press while currently controlling the Monitor Section), the press
will be ignored. This avoids getting into a tricky situation will be ignored. This avoids getting into a tricky situation
where it is no longer apparent what is being controlled and where it is no longer apparent what is being controlled and
what will happen if you try to change it. what will happen if you try to change it.
</p> </p>
</td></tr> </td>
<tr><th>Bank</th> </tr>
<tr>
<th>Bank</th>
<td> <td>
The "Bank" button is currently not used by Ardour The "Bank" button is currently not used by Ardour
</td></tr> </td>
</table> </tr>
</p> </table>

73
include/using-the-presonus-faderport8.html
View File

@ -1,21 +1,19 @@
<p> <p>
Since version 5.8-290, Ardour supports for the Ardour supports a variety of controllers in the <a
<a href="https://www.presonus.com/products/FaderPort-8" rel="external">Presonus href="https://www.presonus.com/products/Controllers" rel="external">Presonus
FaderPort&trade; 8</a>. FaderPort</a> product line. The documentation below is written with
</p> FaderPort&trade;&nbsp;8 in mind. However, it equally applies to
FaderPort&nbsp;2 and FaderPort&nbsp;16 as the main difference between these
<p> units is the amount of motorized faders. For the documentation on using 1st
The FaderPort&trade; 8 is a production control surface with 8 touch-sensitive, generation FaderPort devices please refer to
motorized faders, monochromatic digital scribble strips and more than 60 buttons <a href="@@using-the-presonus-faderport">this chapter</a> instead.
with fixed labels.
</p> </p>
<h2>Connecting the FaderPort 8</h2> <h2>Connecting the FaderPort 8</h2>
<p> <p>
The FaderPort 8 (FP8) comes with a USB socket on the back. Connect a The FaderPort 8 (FP8) comes with a USB socket on the back. Connect a
suitable USB cable from there to a USB port on your computer. suitable USB cable from there to a USB port on your computer.
The FP8 will be automatically recognized by your operating The FP8 will be automatically recognized by your operating
system, and will appear in any of the lists of possible MIDI ports system, and will appear in any of the lists of possible MIDI ports
in both Ardour and other similar software. in both Ardour and other similar software.
@ -170,15 +168,52 @@
The following tables shows a condensed overview of the session-navigation modes: The following tables shows a condensed overview of the session-navigation modes:
</p> </p>
<table> <table>
<tr><th></th><th><kbd>Prev</kbd> / <kbd>Next</kbd></th><th>Encoder knob</th><th>Encoder Press</th></tr> <tr>
<tr><th>Channel</th><td>Select prev/next mixer-strip</td><td>Scroll Editor up/down</td><td>Bank to show selected strip on FP8</td></tr> <th></th>
<tr><th>Master</th><td>Bank visible strips on FP8 by 1</td><td>Adjust master/monitor level</td><td>Reset master/monitor to 0dB</td></tr> <th><kbd>Prev</kbd> / <kbd>Next</kbd></th>
<tr><th>Zoom</th><td>Vertical zoom (editor track-height)</td><td>Horizontal timeline zoom (time)</td><td>Horizontal zoom to session</td></tr> <th>Encoder knob</th>
<tr><th>Scroll</th><td>Bank visible strips on FP8 by 1</td><td>Scroll the timeline (move playhead)</td><td>Horizontal zoom to session</td></tr> <th>Encoder Press</th></tr>
<tr><th>Section</th><td>Nudge the selected region</td><td>Nudge the playhead</td><td> - </td></tr> <tr>
<tr><th>Bank</th><td>Bank visible strips on FP8 by 8</td><td>Bank visible strips on FP8 by 1</td><td>Bank to show selected strip on FP8</td></tr> <th>Channel</th>
<tr><th>Marker</th><td>Move to prev/next marker</td><td>Scroll the timeline (move playhead)</td><td>Drop a new marker</td></tr> <td>Select prev/next mixer-strip</td>
<tr><th>Press and hold <kbd>Click</kbd></th><td> (mode dependent) </td><td>Adjust metronome Level </td><td>Reset metronome level to 0dBFS</td></tr> <td>Scroll Editor up/down</td>
<td>Bank to show selected strip on FP8</td></tr>
<tr>
<th>Master</th>
<td>Bank visible strips on FP8 by 1</td>
<td>Adjust master/monitor level</td>
<td>Reset master/monitor to 0dB</td></tr>
<tr>
<th>Zoom</th>
<td>Vertical zoom (editor track-height)</td>
<td>Horizontal timeline zoom (time)</td>
<td>Horizontal zoom to session</td></tr>
<tr>
<th>Scroll</th>
<td>Bank visible strips on FP8 by 1</td>
<td>Scroll the timeline (move playhead)</td>
<td>Horizontal zoom to session</td></tr>
<tr>
<th>Section</th>
<td>Nudge the selected region</td>
<td>Nudge the playhead</td>
<td> - </td></tr>
<tr>
<th>Bank</th>
<td>Bank visible strips on FP8 by 8</td>
<td>Bank visible strips on FP8 by 1</td>
<td>Bank to show selected strip on FP8</td></tr>
<tr>
<th>Marker</th>
<td>Move to prev/next marker</td>
<td>Scroll the timeline (move playhead)</td>
<td>Drop a new marker</td></tr>
<tr>
<th>Press and hold <kbd>Click</kbd></th>
<td> (mode dependent) </td>
<td>Adjust metronome Level </td>
<td>Reset metronome level to 0dBFS</td>
</tr>
</table> </table>
<h3 class="clear">Shift Button</h3> <h3 class="clear">Shift Button</h3>

4
master-doc.txt
View File

@ -2291,8 +2291,8 @@ part: chapter
--- ---
--- ---
title: Using the PreSonus FaderPort 8 title: Using the PreSonus FaderPort 2/8/16
menu_title: PreSonus FaderPort 8 menu_title: PreSonus FaderPort 2/8/16
include: using-the-presonus-faderport8.html include: using-the-presonus-faderport8.html
link: using-the-presonus-faderport8 link: using-the-presonus-faderport8
uri: using-control-surfaces/PreSonus_FaderPort8 uri: using-control-surfaces/PreSonus_FaderPort8