]> Shamusworld >> Repos - ardour-manual-diverged/commitdiff
Updated and added content
authorJoe Kokosa <hotguac@comcast.net>
Sat, 2 May 2015 12:42:53 +0000 (08:42 -0400)
committerPaul Davis <paul@linuxaudiosystems.com>
Mon, 4 May 2015 12:08:57 +0000 (08:08 -0400)
_manual/21_preferences-and-session-properties/01_preferences-dialog/01_misc.html
_manual/21_preferences-and-session-properties/01_preferences-dialog/02_transport.html
_manual/21_preferences-and-session-properties/01_preferences-dialog/03_editor.html
_manual/21_preferences-and-session-properties/01_preferences-dialog/04_audio.html

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