diff --git a/include/audiomidi-mixer-strips.html b/include/audiomidi-mixer-strips.html index 5ad2c47b..38b6e128 100644 --- a/include/audiomidi-mixer-strips.html +++ b/include/audiomidi-mixer-strips.html @@ -2,7 +2,9 @@ A mixer strip

- A mixer strip in Ardour is a vertical view of the track, from a mixing point of view. This view is convenient to deal with I/O, effects, panning/muting, gain, etc… It has a general "top to bottom" flow. + A mixer strip in Ardour is a vertical view of the track, from a + mixing point of view. This view is convenient to deal with I/O, effects, + panning/muting, gain, etc… It has a general "top to bottom" flow.

@@ -28,7 +30,9 @@

Headers

- At the top of the window, is the group tabs (here, recm…). This allows to group tracks together for common controls. + At the top of the window, is the group + tabs (here, recm…). This allows to group tracks together for + common controls.

@@ -37,18 +41,26 @@

- Right clicking on the color bar will bring up a context menu, which is exactly the same as clicking on the Track name button. + Right clicking on the color bar will bring up a context + menu, which is exactly the same as clicking on the Track name button.

Track Name

@@ -59,71 +71,113 @@
Color…
Changes the strip/track color
-
Comments…
Shows an editor to put comments about the track, see below the Comments button
+
Comments…
Shows an editor to put comments about the track, + see below the Comments button
Inputs…
Shows the Routing grid for the inputs of the track
Outputs…
Shows the Routing grid for the outputs of the track
-
Save As Template…
Allows to save the track without its media content (I/O, effects,…) for later reuse
-
Rename…
Changes the name of the track (effective both in the Mixer and the Editor)
-
Active
Select the active status of the track. An inactive track won't output any sound
-
Strict I/O
While in patchbayStrict I/O mode, a track always has as many output as it has inputs, regardless of the effects. When disabled, a stereo effect put on a mono track will result in a stereo output for the strip.
-
Pin Connections…
Shows the Pin Configuration window, that shows (and allows to modify) all the signal flows inside the track
-
Adjust Latency…
Shows the Track Latency dialog, that allows fine-tune the latency to the track, in samples, msec or period
-
Protect Against Denormals
Uses a trick to get rid of denormals, which are very small numbers the CPU can have a hard time dealing with. To be used if the CPU consumption for plugins is noticeably higher than expected
-
Duplicate…
Copies the track to a new one, optionnaly with its playlist
+
Save As Template…
Allows to save the track without its media + content (I/O, effects,…) for later reuse
+
Rename…
Changes the name of the track (effective both in the + Mixer and the Editor)
+
Active
Select the active status of the track. + An inactive track won't output any sound
+
Strict I/O
While in + patchbayStrict I/O mode, a track always has as many output as it + has inputs, regardless of the effects. When disabled, a stereo effect put on + a mono track will result in a stereo output for the strip.
+
Pin Connections…
Shows the Pin Configuration + window, that shows (and allows to modify) all the signal flows inside the track
+
Adjust Latency…
Shows the Track Latency + dialog, that allows fine-tune the latency to the track, in samples, msec or period
+
Protect Against Denormals
Uses a trick to + get rid of denormals, which are very small numbers the CPU can have + a hard time dealing with. To be used if the CPU consumption for plugins is + noticeably higher than expected
+
Duplicate…
Copies the track to a new one, optionnaly with + its playlist
Remove
Deletes the track and its playlist

Inputs

- The dropdown button shows the current input port(s), i.e. what's plugged to the "in" of the track. By default, each audio track is connected to the system inputs, ready for recording, as shown by the number(s). Clicking the dropdown Inputs button will allow to change the inputs, through a menu: + The dropdown button shows the current input port(s), i.e. what's plugged to the + "in" of the track. By default, each audio track is connected to the system + inputs, ready for recording, as shown by the number(s). Clicking the dropdown + Inputs button will allow to change the inputs, through a menu:

Disconnect
Disconnects everything, i.e. the track has no input
-
In n
Those are the system inputs, e.g. to record from the soundcard. A mono track will have In 1 and In 2 separated, while a stereo track can have In 1+2
-
Track n output
All the outputs of compatible tracks, e.g., a mono track can only receive a mono signal, a MIDI track can only receive MIDI signal, …
-
Add Audio Port
Adds an audio input to the track, i.e. a mono audio track becomes a stero one
-
Add MIDI Port
Adds a MIDI input to the track. Adding it to an audio track makes it a mixed Audio/MIDI track. This can be usefull e.g. to feed some plugins with a MIDI signal to control the audio, like a vocoder
-
Routing Grid
Shows the Routing Grid window, which allows for more complex input configuration
+
In n
Those are the system inputs, e.g. to record from the + soundcard. A mono track will have In 1 and In 2 separated, + while a stereo track can have In 1+2
+
Track n output
All the outputs of compatible tracks, e.g., + a mono track can only receive a mono signal, a MIDI track can only receive MIDI + signal, …
+
Add Audio Port
Adds an audio input to the track, i.e. a mono audio + track becomes a stero one
+
Add MIDI Port
Adds a MIDI input to the track. Adding it to an audio + track makes it a mixed Audio/MIDI track. This can be usefull e.g. to feed some + plugins with a MIDI signal to control the audio, like a vocoder
+
Routing Grid
Shows the Routing + Grid window, which allows for more complex input configuration

- The Routing Grid can also be shown by right clicking the dropdown Inputs button. It allows to make the connections through a matrix, and connect things that are not listed in the menu above, or connect to multiple sources at once, reduce the number of inputs, etc… + The Routing Grid can also be shown by right clicking the + dropdown Inputs button. It allows to make the connections through a matrix, and + connect things that are not listed in the menu above, or connect to multiple + sources at once, reduce the number of inputs, etc…

- On audio tracks, is a Trim knob, as on traditional consoles. It set the base input level for the track, avoiding any clipping. Notice that it trims both any input, but (when playing back), also the level of the playlist as displayed in the Editor. It makes sense as while playing, the input of the track is the playlist, on which the mixer strip acts. + On audio tracks, is a Trim knob, as on traditional consoles. It set the base + input level for the track, avoiding any clipping. Notice that it trims both any + input, but (when playing back), also the level of the playlist as displayed in + the Editor. It makes sense as while playing, the input of the track is the + playlist, on which the mixer strip acts.

- On midi tracks, it is replaced by a MIDI Input button, that allows/disallows MIDI input on the track. + On midi tracks, it is replaced by a MIDI Input button, that allows/disallows + MIDI input on the track.

Polarity

- On audio tracks only, the Polarity button(s), 1 per input, allow to reverse the signal, i.e. a negative value will be positive and vice-versa. This can help deal with phasing issues. + On audio tracks only, the Polarity button(s), 1 per input, allow to reverse + the signal, i.e. a negative value will be positive and vice-versa. This can help + deal with phasing issues.

Processor box

- The processor box is where the effects are added. By default, one effect is always present: the Fader (see below). The effects can be added pre-fader and appear in brown, or post-fader, where they will appear in dark green. The signal flow is represented by lines, red for the MIDI and green for the audio. + The processor box is where the effects are added. By default, one effect is + always present: the Fader (see below). The effects can be added + pre-fader and appear in brown, or post-fader, where they will + appear in dark green. The signal flow is represented by lines, red for the MIDI + and green for the audio.

- It is also where the Sends come from, wether external or auxiliary. + It is also where the Sends come from, wether + external or auxiliary.

- To learn more about the processor box, see The Processor Box. + To learn more about the processor box, see The + Processor Box.

Panner

- The Panner visually displays how the sound will be distributed between the different outputs. They'll look and behave differently if the track is mono, stereo, or has multiple channels. + The Panner visually displays how the sound will be distributed + between the different outputs. They'll look and behave differently if the + track is mono, stereo, or has multiple channels.

@@ -131,37 +185,53 @@

-
Bypass
When checked, the panner is grayed, and the signal is not affected by it
-
Reset
Resets the panner to its default settings, e.g. for a mono signal, it is centered
-
Edit…
Shows a Panner dialog, which allows for fine tuning of the panner
+
Bypass
When checked, the panner is grayed, + and the signal is not affected by it
+
Reset
Resets the panner to its default settings, e.g. for a mono + signal, it is centered
+
Edit…
Shows a Panner dialog, which + allows for fine tuning of the panner

- See Panning to learn more about how to control the panner, and what kind of panners are available inside Ardour. + See Panning to learn more about how to control the panner, + and what kind of panners are available inside Ardour.

Recording options

- The most noticeable button here is the Record Enable one, with a red circle. When enabled, next time the Global record will be armed and playback started, everything that comes from the input of the track will be recorded. Right clicking a disabled record button allows to enable Rec-Safe, thus protecting the track against accidental recording. + The most noticeable button here is the Record Enable one, with a red circle. + When enabled, next time the Global record will be armed and playback started, + everything that comes from the input of the track will be recorded. Right clicking + a disabled record button allows to enable Rec-Safe, + thus protecting the track against accidental recording.

- The buttons on the right, In and Disk, show what the user is listening to by lighting up, between the Input and the actual content of the playlist on Disk. + The buttons on the right, In and Disk, show what the user is listening to by lighting up, + between the Input and the actual content of the playlist on + Disk.

- They also allow to override the automatic switching by pressing them to lock one source or the other to be what the user is hearing. + They also allow to override the automatic switching by pressing them to lock + one source or the other to be what the user is hearing.

Mute/Solo

- These buttons allow to Mute (or silence) the track, or Solo them, shutting down the gain of the other tracks (totally by default, can be set to partially in the options). See Muting and Soloing for more information. + These buttons allow to Mute (or silence) the track, or Solo them, shutting + down the gain of the other tracks (totally by default, can be set to partially + in the options). See Muting and Soloing for + more information.

- Notice that by default, Solo overrides Mute, i.e. if a track is both Soloed and Muted, it will play. That can be changed in the preferences. + Notice that by default, Solo overrides Mute, i.e. if a track is both Soloed and + Muted, it will play. That can be changed in the preferences.

@@ -169,36 +239,58 @@

Gain & Meter

- On the right of this part is a Meter, displaying the level of the track's output after the fader. In can be set to display the signal at any point, see below Metering Point. Right clicking this meter shows a menu allowing to switch the meter type. + On the right of this part is a Meter, + displaying the level of the track's output after the fader. In can be set to + display the signal at any point, see below Metering Point. Right + clicking this meter shows a menu allowing to switch the meter type.

- The big Gain slider on the left allows to change the gain of the track. Its default O dB value is reminded with a white horizontal line, and its precise value is shown in a text field above it, that doubles as a way to type in a numeric value. + The big Gain slider on the left allows to change the gain of the track. Its + default OdB value is reminded with a white horizontal line, and its precise + value is shown in a text field above it, that doubles as a way to type in a + numeric value.

- The text field above the meter shows the "Peak", i.e. the mawimum value that has been reached during playback. To avoid distortion, the value should stay below O dB, and if it goes above this value, the text field will turn red. Clicking on this field will reset the Peak value (for a new measurement or a new part of the track). + The text field above the meter shows the "Peak", i.e. the mawimum value that has + been reached during playback. To avoid distortion, the value should stay below OdB, + and if it goes above this value, the text field will turn red. Clicking on + this field will reset the Peak value (for a new measurement or a new part of the + track).

- Notice that if any gain automation has been set and the automation state is set on "Play" (see below), then the Gain fader is driven by the automation, and not by the user. The Gain fader will turn grey to show it's inactive. + Notice that if any gain automation has been set and the + automation state is set on "Play" (see below), then the Gain fader is driven by + the automation, and not by the user. The Gain fader will turn grey to show it's + inactive.

-

Control master

+

VCAs

- If at least one control master exists, this button will show up, allowing the user to link this track to any control master. + If at least one VCA exists, this + button will show up, allowing the user to link this track to any control master.

- Clicking the button lists all the available control masters, and a menu option to Unassign all. Notice that a track can have be a slave to as many control masters as they are in the session, hence multiplying the number of C.M. buttons. The displayed number is the number of the Control Master, not the count of C.M. linked to the track. A track with no control master assigned will show a unique button with a "-vca-" label instead of this number. + Clicking the button lists all the available control masters, and a menu option + to Unassign all. Notice that a track can have be a slave + to as many VCAs as they are in the session, hence multiplying the number + of VCA buttons. The displayed number is the number of the VCA, + not the count of VCAs linked to the track. A track with no VCA assigned + will show a unique button with a "-vca-" label instead + of this number.

Fader automation/mix group/metering point

@@ -210,22 +302,31 @@

-
Manual
(default) The playback won't use the fader automation data
+
Manual
(default) The playback won't use the fader automation + data
Play
Enables playback/use of fader automation data
-
Write
While the transport is rolling, all fader changes will be recorded to the fader automation lane
-
Touch
While the transport is rolling, touching the fader will initiate recording all fader changes until the fader is released. When the fader is not being touched, existing automation data will be played/used to control the gain level.
+
Write
While the transport is rolling, all fader changes will be + recorded to the fader automation lane
+
Touch
While the transport is rolling, touching the fader will initiate + recording all fader changes until the fader is released. When the fader is not + being touched, existing automation data will be played/used to control the gain + level.

Mix group

- This button displays the mix group information as does the tab in the header (see above). It is convenient though, as it allows to quickly switch the track from one group to another with a drop down menu, also allowing to affect the track to a non-adjascent group (which the tab won't easily allow). + This button displays the mix group information as does the tab in the header + (see above). It is convenient though, as it allows to quickly switch the track + from one group to another with a drop down menu, also allowing to affect the + track to a non-adjascent group (which the tab won't easily allow).

Metering Point

- The metering displayed in the meter is by default is 'Post', i.e. Post fader. It can be changed with this button to Any point of the signal flow: + The metering displayed in the meter is by default is 'Post', i.e. Post fader. + It can be changed with this button to Any point of the signal flow:

@@ -233,18 +334,23 @@
Pre
Pre-fader
Post
Post-fader
Out
The output of the track
-
Custom
A Meter processor is added to the processor box an can be set anywhere (by dragging and dropping) to probe the signal flow at that pointat the point
+
Custom
A Meter processor is added to the processor box and + can be set anywhere (by dragging and dropping) to probe the signal flow at + that point

Output(s)

- This button is exactly the same as the Input button, but applies to the output of the track. + This button is exactly the same as the Input button, but applies to + the output of the track.

Comments

- This buttons open up a little text editor, that can be used to add some written notes to the track, as e.g. a particular setting. The button's caption is replaced by the beginning of the text, so it can be used as a "sub" name for the track. + This buttons open up a little text editor, that can be used to add some + written notes to the track, as e.g. a particular setting. The button's caption + is replaced by the beginning of the text, so it can be used as a "sub" name for + the track.

- diff --git a/include/grid-controls.html b/include/grid-controls.html index 07191a92..5b60ae20 100644 --- a/include/grid-controls.html +++ b/include/grid-controls.html @@ -2,17 +2,26 @@ Editor toolbar's grid

- Ardour's editor utilizes a grid to assist in the placement of regions on the timeline, or with editing functions that need to happen at a specific point in time. You can choose if you want the cursor and various objects to snap to this grid, and how you want the snapping to behave. You can modify the grid units to fit your needs. + Ardour's editor utilizes a grid to assist in the placement of regions + on the timeline, or with editing functions that need to happen at a specific + point in time. This snapping of the cursor and various objects to the + grid can be toggled on or off, as does its behaviour, and grid units.

About Snapping

- There are two ways to think about aligning material to a grid. The first and most obvious one is where an object's position is clamped to grid lines. In Ardour, this is called absolute snap and is commonly used when working with sampled material where audio begins exactly at the beginning of a file, note or region. + There are two ways to think about aligning material to a grid. The first and + most obvious one is where an object's position is clamped to grid lines. In + Ardour, this is called absolute snap and is commonly used when + working with sampled material where audio begins exactly at the beginning of a + file, note or region.

- The second, relative snap, is used when an object's position relative to the grid lines is important. In music, this allows you to move objects around without changing the "feel" (or timing) of a performance. + The second, relative snap, is used when an object's position relative + to the grid lines is important. In music, this allows to move objects around + without changing the "feel" (or timing) of a performance.

@@ -20,60 +29,87 @@

- While dragging objects you may switch from absolute to relative snap by pressing the absolute snap modifier key(s). + While dragging objects, pressing the absolute snap modifier key(s) switches + from absolute to relative snap.

- You may also disable snap entirely by using the snap modifier (see below). + The snap can also be entirely disabled by using the snap modifier (see below).

- Note that in relative snap mode the reference point is taken to be the distance to the nearest grid line. + Note that in relative snap mode the reference point is taken to be the distance + to the nearest grid line.

- Note also that when an object lies exactly on a grid line, there will be no difference between relative and absolute snap modes. + Note also that when an object lies exactly on a grid line, there will be no + difference between relative and absolute snap modes.

- The realtive snap and snap modifiers (along with other modifier keys) may be set in Edit > Preferences > User Interaction + The realtive snap and snap modifiers (along with other modifier keys) may be set + in Edit > Preferences > User Interaction

- For common use patterns, it is recommended that you assign a unique key for one snap modifier and two keys for the other in such a way that they share an otherwise unused key. For example, you may choose the snap modifier to be the   key and the relative snap modifier to be the   and   keys. + For common use patterns, it is recommended to assign a unique key for one + snap modifier and two keys for the other in such a way that they share an + otherwise unused key. For example, the snap modifier may be chosen to be the + key and the relative snap modifier to be the and keys.

.

Snap Modes

- Using the above modifications, Ardour supports three different modes of snapping to the grid: + Using the above modifications, Ardour supports three different modes of snapping + to the grid:

No Grid
-
disables the grid. All objects move freely in this mode.
- In No Grid mode, you may temporarily activate the grid by pressing the snap modifier (for absolute snap) or switch to relative snap by pressing the relative snap modifier.
+
disables the grid. All objects move freely in this mode.
+ In No Grid mode, the grid may be temporarily activated + by pressing the snap modifier (for absolute snap) or switch to relative snap + by pressing the relative snap modifier.
Grid
-
activates normal snapping. All positions of objects snap to the grid. (See Grid Units below to change the grid). If you try to move an object in "Grid"-mode, it does not change its position until you move the mouse far enough for the object to reach the next grid line.
- Sometimes you may wish to maintain an objects' position relative to the grid line. In order to do this, use the "snap relative" modifier. When holding down this modifier during a drag, the dragged object will jump while maintaining its original distance from the line.
- New objects will always be created at grid points.
- Holding down the snap modifier will disable the current grid setting and allow you to move the object freely.
-
+
activates normal snapping. All positions of objects snap to the grid. (See + Grid Units below to change the grid). + Moving an object in "Grid"-mode, does not change its position until + the mouse is far enough for the object to reach the next grid line.
+ To maintain an objects' position relative to the grid line, the "snap relative" + modifier can be used. When holding down this + modifier during a drag, the dragged object will jump while maintaining its + original distance from the line.
+ New objects will always be created at grid + points.
+ Holding down the snap modifier will disable the current grid + setting and allow you to move the object freely.
Magnetic
-
is a less strict type of snapping. Objects can still be moved to any position, but positions close to the relative or absolute grid points will snap. In order to move an object very close to a snap point, it may be necessary to zoom in to prevent snapping to that point, or to use the snap modifier to disable snap completely.
- As with Grid mode, the snap modifier will disable snap completely while the absolute snap modifier will move the "notch" of Magnetic snap to the grid lines.
+
is a less strict type of snapping. Objects can still be moved to any + position, but positions close to the relative or absolute grid points will snap. + In order to move an object very close to a snap point, it may be necessary to + zoom in to prevent snapping to that point, or to use the snap modifier to + disable snap completely.
As with Grid mode, the snap modifier will disable + snap completely while the absolute snap modifier will move the "notch" of + Magnetic snap to the grid lines.

Syncing Regions to the Grid

- By default, a region's beginning will be used as the reference for both types of snapping, but you can change this behaviour by setting a sync point in the region. Select the region(s) and press V. This will set the sync point to your edit point. + By default, a region's beginning will be used as the reference for both types of + snapping, this behaviour can be changed by setting a sync point + in the region, by selecting the region(s) and pressing V. This will set the + sync point to the current edit point.

Grid Units

- The selector next to the grid mode selector defines the size of the grid elements. You can set your grid to several different units: + The selector next to the grid mode selector defines the size of the grid + elements. The grid can be set to several different units:

@@ -102,15 +138,21 @@

- To use Region starts/ends/syncs/bounds as snap choices, you must have either + To use Region starts/ends/syncs/bounds as snap choices, it is necessary to have either:

- If you are moving items on a track, and only the current track is selected, then you will only be able to snap to other regions on the same track. This means that enabling Edit > Preferences > Editor > Link Selections of Regions and Tracks will make the "Region" grid unit unusable. Avoid the use of this option if you are going to use any of the Region grid units. + If items are moved on a track, and only the current track is selected, then + snapping will only happen with other regions on the same track. This means + that enabling Edit > Preferences > Editor > Link + Selections of Regions and Tracks will make the "Region" grid unit + unusable. This option should not be used in conjunction with the use any of the + Region grid units.

-