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

Updated and added content

Browse Source
This commit is contained in:
Joe Kokosa 2015-05-02 08:42:53 -04:00 committed by Paul Davis
parent c81b78173d
commit b4368a9d4c
4 changed files with 149 additions and 63 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

127
_manual/21_preferences-and-session-properties/01_preferences-dialog/01_misc.html
View File

@ -13,61 +13,83 @@ misc tab"/>
<ul> <ul>
<li> <li>
DSP CPU Utilization sets how many cpu processors can be used to do signal <p>
processing. It can be set to use one up to all processors. <strong>DSP CPU Utilization</strong> sets how many cpu processors can be
used to do signal processing. It can be set to use one up to all
processors.
</p>
</li> </li>
<li> <li>
<dfn>Undo</dfn> <p>
<dfn>Undo</dfn>
</p>
<ul> <ul>
<li> <li>
<strong>Limit undo history</strong> sets how many commands can be undone <p>
using <kbd class="mod1">Z</kbd> or <strong>Limit undo history</strong> sets how many commands can be
<kbd class="menu">Edit &gt; Undo</kbd>. undone using <kbd class="mod1">Z</kbd> or
<kbd class="menu">Edit &gt; Undo</kbd>.
</p>
</li> </li>
<li> <li>
<strong>Save undo history</strong> sets how many commands are saved so <p>
they are available to be undone after reopening the session. <strong>Save undo history</strong> sets how many commands are saved so
they are available to be undone after reopening the session.
</p>
</li> </li>
<li> <li>
<strong>Verify removal of last capture</strong> when enabled prompts to <p>
verify removal the last recording capture when <strong>Verify removal of last capture</strong> when enabled prompts to
<kbd class="menu">Edit &gt; Remove Last Capture</kbd> is executed. verify removal the last recording capture when
<kbd class="menu">Edit &gt; Remove Last Capture</kbd> is executed.
</p>
</li> </li>
<li> <li>
<strong>Make periodic backups of the session file</strong> will create a <p>
backup session file after changes to the timeline. The backup file is <strong>Make periodic backups of the session file</strong> will create
the session name followed by <em>.ardour.bak</em>. The backup can be a backup session file after changes to the timeline. The backup file is
used to recover from crashes when the session had not been explicitly the session name followed by <em>.ardour.bak</em>. The backup can be
saved. used to recover from crashes when the session had not been explicitly
saved.
</p>
</li> </li>
</ul> </ul>
</li> </li>
<li> <li>
<dfn>Session Management</dfn> <p>
<dfn>Session Management</dfn>
</p>
<ul> <ul>
<li> <li>
<strong>Always copy imported files</strong> selects, and then disables, <p>
the <em>Copy files to session</em> option in the <strong>Always copy imported files</strong> selects, and then disables
<a href="/adding-pre-existing-material/import-dialog/"> changes to, the <em>Copy&nbsp;files to&nbsp;session</em> option in the
Add Existing Media</a> dialog. <a href="/adding-pre-existing-material/import-dialog/">
Add Existing Media</a> dialog.
</p>
</li> </li>
<li> <li>
<strong>Default folder for new sessions:</strong> defalts the folder <p>
where Ardour will create new session folders. This is used in the <strong>Default folder for new sessions:</strong> defalts the folder
<em>Session Setup</em> dialog displayed by where Ardour will create new session folders. This is used in the
<kbd class="menu">Session &gt; New</kbd>. <em>Session&nbsp;Setup</em> dialog displayed by
<kbd class="menu">Session &gt; New</kbd>.
</p>
</li> </li>
<li> <li>
<strong>Maximum number of recent sessions:</strong> determines how many <p>
of the last opened sessions shows in the <em>Recent Sessions</em> dialog <strong>Maximum number of recent sessions:</strong> determines how many
displayed by <kbd class="menu">Session &gt; Recent</kbd>. of the last opened sessions shows in the
<em>Recent&nbsp;Sessions</em> dialog displayed by
<kbd class="menu">Session &gt; Recent</kbd>.
</p>
</li> </li>
</ul> </ul>
</li> </li>
@ -78,36 +100,49 @@ misc tab"/>
</p> </p>
<ul> <ul>
<li> <li>
<strong>Click audio file:</strong> sets a user defined sound to be played <p>
when Ardour's metronome is enabled in the <strong>Click audio file:</strong> sets a user defined sound to be
<a href="/controlling-playback/using-the-transport-bar/"> played when Ardour's metronome is enabled in the
Transport Bar</a> <a href="/controlling-playback/using-the-transport-bar/">
Transport Bar</a>
</p>
</li> </li>
<li> <li>
<strong>Click emphasis audio file:</strong> sets an optional different <p>
sound to be played on the metronome's downbeat. <strong>Click emphasis audio file:</strong> sets an optional different
metronome sound to be played on the downbeat.
</p>
</li> </li>
<li> <li>
<strong>Click gain level:</strong> allows the metronome's click sounds <p>
to be boosted or attenuated. <strong>Click gain level:</strong> allows the metronome's click sounds
to be boosted or attenuated.
</p>
</li> </li>
</ul> </ul>
</li> </li>
<li><dfn>Automation</dfn> <li>
<p>
<dfn>Automation</dfn>
</p>
<ul> <ul>
<li> <li>
<strong>Thinning factor</strong> ranges from 0 to 1000 with larger <p>
values storing fewer automation points. Thinning is like lossy <strong>Thinning factor</strong> ranges from 0 to 1000 with larger
audio compression, removing data that is less likely to be noticed, values sending fewer automation changes. Thinning is like lossy
although the more you remove the more noticable the loss is. The audio compression, removing data that is less likely to be noticed,
advantage to thinning is it reduces CPU requirements. although the more you remove the more likely the loss will be noticed.
The advantage to thinning is reduced CPU usage.
</p>
</li> </li>
<li> <li>
<strong>Automation sampling interval</strong> ranges from 1 to <p>
1000&nbsp;ms. Determines how frequently the automation input is <strong>Automation sampling interval</strong> ranges from 1 to
sampled. The shorter the interval the higher the accuracy but also 1000&nbsp;ms. Determines how frequently the automation input is
the higher the CPU requirements. sampled. The shorter the interval the higher the accuracy but also
the higher the CPU requirements.
</p>
</li> </li>
</ul> </ul>

1
_manual/21_preferences-and-session-properties/01_preferences-dialog/02_transport.html
View File

@ -21,6 +21,7 @@ transport tab"/>
level record-enable which is never changed on stop. level record-enable which is never changed on stop.
</p> </p>
</li> </li>
<li> <li>
<p> <p>
<strong>Play loop is a transport mode</strong> changes the behavior of the <strong>Play loop is a transport mode</strong> changes the behavior of the

68
_manual/21_preferences-and-session-properties/01_preferences-dialog/03_editor.html
View File

@ -36,77 +36,117 @@ editor tab"/>
</li> </li>
<li> <li>
<p> <p>
<strong>Display master-meter in the toolbar</strong> <strong>Display master-meter in the toolbar</strong> when enabled displays
a small copy of the master bus meter in the toolbar.
</p> </p>
</li> </li>
<li> <li>
<p> <p>
<strong>Default fade shape:</strong> <strong>Default fade shape:</strong> sets which
<a href="/editing-and-arranging/create-region-fades-and-crossfades/">
fade shape</a> is the default.
</p> </p>
</li> </li>
<li> <li>
<p> <p>
<strong>Regions in active edit groups are edited together:</strong> <strong>Regions in active edit groups are edited together:</strong> sets
the criteria to see if editing actions apply to tracks grouped together
in an active group.
</p> </p>
</li> </li>
<li> <li>
<p> <p>
<strong>Make rubberband selection rectangle snap to the grid</strong> <strong>Make rubberband selection rectangle snap to the grid</strong> when
enabled uses the grid when
<a href="/editing-and-arranging/select-regions/">selecting regions</a>
with a rubberband rectangle.
</p> </p>
</li> </li>
<li> <li>
<p> <p>
<strong>Show waveforms in regions</strong> <strong>Show waveforms in regions</strong> when enabled shows a visual
representation of the region's audio waveform. Changes to this setting
take affect after restarting Ardour.
</p> </p>
</li> </li>
<li> <li>
<p> <p>
<strong>Show gain envelopes in audio regions:</strong> <strong>Show gain envelopes in audio regions:</strong> sets the criteria
for displaying the gain envelope in audio regions.
</p> </p>
</li> </li>
<li> <li>
<p> <p>
<strong>Waveform scale:</strong> <strong>Waveform scale:</strong> when waveforms are shown in audio region
they can be displayed using a <em>linear</em> or a <em>logarithmic</em>
scale.
See <a href="/working-with-tracks/controlling-track-appearance/waveform-display/">
Waveform disply</a>.
</p> </p>
</li> </li>
<li> <li>
<p> <p>
<strong>Waveform shape:</strong> <strong>Waveform shape:</strong> when waveforms are shown in audio region
they can be displayed using a <em>traditional</em> or a <em>rectified</em>
shape.
See <a href="/working-with-tracks/controlling-track-appearance/waveform-display/">
Waveform disply</a>.
</p> </p>
</li> </li>
<li> <li>
<p> <p>
<strong>Waveform Clip Level (dBFS):</strong> <strong>Waveform Clip Level (dBFS):</strong> sets the level at which the
waveform shown in an audio region will be drawn in red to indicate
clipping. Setting lower than 0.0&nbsp;dBFS can be useful if any tool in
the audio chain has problems near 0.0&nbsp;dBFS.
</p> </p>
</li> </li>
<li> <li>
<p> <p>
<strong>Show waveform for audio while it is being recorded</strong> <strong>Show waveform for audio while it is being recorded</strong> when
enabled, will draw the audio waveform in regions being recorded. When
disabled only a region block will be drawn while recording reducing CPU
requirements.
</p> </p>
</li> </li>
<li> <li>
<p> <p>
<strong>Show zoom toolbar</strong> <strong>Show zoom toolbar</strong> when enabled shows a toolbar for
zoom functions. When disabled the zoom commands are still available
with keyboard short-cuts and the View menu. Changes to this setting
take affect after restarting Ardour.
</p> </p>
</li> </li>
<li> <li>
<p> <p>
<strong>Update editor window during drags of the summary</strong> <strong>Update editor window during drags of the summary</strong> when
enabled the contents of the editor window will redraw the tracks area
as the selection rectangle in the summary area is moved or resized. The
summary area is at the bottom of the editor and shows an overview of all
regions on the timelime.
</p> </p>
</li> </li>
<li> <li>
<p> <p>
<strong>Name new markers</strong> <strong>Name new markers</strong> when enabled, popup a dialog when a new
<a href="/working-with-markers/">marker</a> is created. This allows
markers to be named as they are created.
</p> </p>
</li> </li>
<li> <li>
<p> <p>
<strong>Auto-scroll editor window when dragging near its edges</strong> <strong>Auto-scroll editor window when dragging near its edges</strong>
when enabled will scroll the editor window automatically when dragging a
region. This can make it easier to see where to position the region.
</p> </p>
</li> </li>
<li> <li>
<p> <p>
<strong>After splitting selected regions, select</strong> <strong>After splitting selected regions, select</strong> determines which,
if any, regions are selected after a split operation. The options are no
regions, the regions created by the split, and if more than one region
was selected to start with, the existing selection and the new regions.
Changes to this setting take affect after restarting Ardour.
</p> </p>
</li> </li>
</ul> </ul>

16
_manual/21_preferences-and-session-properties/01_preferences-dialog/04_audio.html
View File

@ -86,17 +86,27 @@ audio tab"/>
<li> <li>
<p> <p>
<strong>Denormals</strong> <strong>Denormals</strong> are a specific type of very small numbers that
can cause issues with CPU consumption when using some plugins in some
circumstances.
</p>
<p>
Ardour provides two methods of handling the issue. Try different
combinations of these settings to to find the setting that minimizes CPU
consumption.
</p> </p>
<ul> <ul>
<li> <li>
<p> <p>
<strong>Use DC bias to protect against denormals</strong> <strong>Use DC bias to protect against denormals</strong> adds a small
constant value to numbers to move the numbers away from zero.
</p> </p>
</li> </li>
<li> <li>
<p> <p>
<strong>Processor handling</strong> <strong>Processor handling</strong>, if the computer's hardware
supports it, offers two methods that can be used individually or
combined. Flush to zero and denormals are zero.
</p> </p>
</li> </li>
</ul> </ul>