the <kbd class="menu">Session > New...</kbd> dialog and the <kbd class="menu">Audio/MIDI Setup</kbd> dialog.
See <a href="/working-with-sessions/new-session-dialog/">New/Open Session Dialog</a> for a description of those dialogs.
</p>
-
+
+<h2>Starting Ardour From the Command Line (Linux)</h2>
+
+<p>
+ Like (almost) any other program on Linux, Ardour can be started on the
+ command line. Type the following command in a terminal window:
+</p>
+<kbd class="cmd lin">Ardour5</kbd>
+<p>
+ To start Ardour with an existing session:
+</p>
+<kbd class="cmd lin">Ardour5 <em>/path/to/session</em></kbd>
+<p>
+ replacing /path/to/session with the actual path to your session. You can
+ specify either the session folder or any session file inside the folder,
+ including snapshots.
+</p>
+<p>
+ To start Ardour with a new, named session:
+</p>
+<kbd class="cmd lin">Ardour5 -N <em>/path/to/session</em></kbd>
+
-{% children %}
+++ /dev/null
----
-layout: default
-title: Starting Ardour From the Command Line (Linux)
-menu_title: Starting from Linux Cmdline
----
-
-<p>
- Like (almost) any other program on Linux, Ardour can be started on the
- command line. Type the following command in a terminal window:
-</p>
-<kbd class="cmd lin">Ardour5</kbd>
-<p>
- To start Ardour with an existing session:
-</p>
-<kbd class="cmd lin">Ardour5 <em>/path/to/session</em></kbd>
-<p>
- replacing /path/to/session with the actual path to your session. You can
- specify either the session folder or any session file inside the folder,
- including snapshots.
-</p>
-<p>
- To start Ardour with a new, named session:
-</p>
-<kbd class="cmd lin">Ardour5 -N <em>/path/to/session</em></kbd>
-
-<h3>Other Command Line Options</h3>
--- /dev/null
+---
+title: The Ruler
+---
+
+<img src="/images/ruler.png" alt="Ardour's Ruler">
+
+<p>
+ The <dfn>Ruler</dfn> scales the session along time, allows navigating, and can be marked for different uses. The main use of the Ruler is to move the playhead : clicking anywhere on the timeline will bring the playhead at this location in time.
+</p>
+
+<p>
+ It is made of a succession of rows, each having a special role related to time.From top to bottom, those rows are :
+</p>
+
+<dl>
+ <dt><dfn>Timecode</dfn></dt><dd>scaling the session whith the traditionnal Hours:Mins:Secs:Frames notation</dd>
+ <dt><dfn>Bars:Beats</dfn></dt><dd>slicing the time according to the time signature ot the Meter</dd>
+ <dt><dfn>Meter</dfb></dt><dd>shows the time signature. It can be changed along the timeline, by <kbd class="mouse">Right click</kbd> > <kbd class="menu">New Meter</kbd>. The Bars:Beats ruler will reflect the change.</dd>
+ <dt><dfn>Tempo</dfn></dt><dd>shows the BPM. It can be changed along the timeline, by <kbd class="mouse">Right click</kbd> > <kbd class="menu">New Tempo</kbd>. The Bars:Beats ruler will reflect the change.</dd>
+ <dt><dfn>Range Markers</dfn></dt><dd>allow to create and modify ranges directly on the Ruler.</dd>
+ <dt><dfn>Loop/Punch Ranges</dfn></dt><dd>are special kind of ranges designed to be played as a loop and to do punch recording, i.e. recording on a precise section of time, respectively.</dd>
+ <dt><dfn>CD Markers</dfn></dt><dd>are markers designed to be used while creating a recording that has to be split in time, as an audio CD</dd>
+ <dt><dfn>Location Markers</dfn></dt><dd>is meant to receive any kind of marker, user generated or from Ardour itself.</dd>
+</dl>
+
+<p>Most of the operations on the markers are described in <a href="/working-with-markers/">Working with Markers</a>, while the Meter, Tempo, Bars:Beats and Timecode use are described in <a href="/tempo-meter/tempo-and-meter/">Tempo and Meter</a>.</p>
+
+
+
+
+
+
+
+++ /dev/null
----
-layout: default
-title: The Main Menu
-menu_title: The Main Menu
----
+++ /dev/null
----
-layout: default
-title: The Status Bar
-menu_title: The Status Bar
----
+++ /dev/null
----
-layout: default
-title: The Transport Bar
-menu_title: The Transport Bar
----
-
-<p>
- The <dfn>Transport Bar</dfn> groups all the actions regarding the control of
-playback and recording.
-</p>
-<img src="/images/transport.png"
-alt="The transport controls" />
-
-<p>This bar is made of (from left to right):</p>
-
-<ul>
- <li><dfn>Midi Panic</dfn>: allows to immediately stop all midi output.</li>
- <li><dfn>Enable/disable Audio Click</dfn>: Toggles (on/off) a click track (metronome) along the <a href="/tempo-meter/tempo-and-meter/">tempo</a>.</li>
- <li><dfn>Go to Start of the Session</dfn>: Jumps back at the beginning of the session, as defined by the <a href="/working-with-markers/">start marker</a>.</li>
- <li><dfn>Go to End of the Session</dfn>: Jumps forward to the end of the session, as defined by the <a href="/working-with-markers/">end marker</a>.</li>
- <li><dfn>Play Loop Range</dfn>: Repeats the defined <a href="/controlling-playback/looping-the-transport/">loop</a> as defined by the <a href="/working-with-markers/loop-range/">Loop range</a>, until the "Stop playback" button is pressed. Clicking the "Play loop Range" button while already active switches to normal Play mode, which allows to exit the loop without stopping and restarting the playback.</li>
- <li><dfn>Play Range/Selection</dfn>: If a range has been defined using the Range Mode button, plays the range, of if an audio or MIDI region is selected,plays this region. In both cases, the playback stops at the end of the range or selected region.</li>
- <li><dfn>Play from playhead</dfn>: Starts the playback and optionnally record (more below).</li>
- <li><dfn>Stop</dfn>: Whatever the playing mode (loop, range, ...)
- stops all playback. Depending on other settings, some effects (like
- chorus or reverb) might still be audible for a while.</li>
- <li><dfn>Toggle Record</dfn>: Global switch button to activate/desactivate recording. While active, the button blinks red. The button doesn"t start the recording itself : if one or more tracks are marked as record-enabled, pressing the "Play from Playhead" starts the recording on this/these track(s). See <a href="/recording/">Recording</a>.</li>
-</ul>
-
-<p class="note">All this actions are bound to keyboard shortcuts, which allow for a speedier use, and a more focused work</p>
-
-<p>Under these buttons is the <dfn>Shuttle Speed Control</dfn> that allows to scrub through the audio quickly.</p>
-
-<p>The Shuttle Speed Control supports 2 operating modes, that can be chosen with right click > Mode :</p>
-<ul>
- <li><dfn>Sprung mode</dfn> that allows for a temporary scrub : it only scubs while the mouse is left clicked on the control.</li>
- <li><dfn>Wheel mode</dfn> that allows to set a playback speed until the "Stop" button is pressed, which stops the playback and resets its speed.
-</ul>
-<p>The mode is displayed on the right of the control. The current playback speed is shown by a green slider, that is square and centered when the playback speed is normal (1X) and becomes a circle when its changed. The further from the center the slider is set, the faster the playback will scrub in both directions, as displayed on the left of the control.<p>
-
-<p>The 3 vertical buttons on the right of the transport bar control the behviour of the playhead :</p>
-<ul>
- <li>The positional sync button (which might show <dfn>Internal</dfn>,
- or <dfn>MTC</dfn> or several other values) can be used to control
- whether or not the transport position and start is controlled by Ardour, or by an
- external positional synchronization source, such as MIDI Time Code (MTC),
- Linear Time Code (LTC) or JACK. (see <a href="/synchronization/timecode-generators-and-slaves/">Timecode Generators and Slaves</a>).</li>
- <li><dfn>Follow Edits</dfn> is a toggle that can be used to control
- whether or not making a selection (range or object) will move the playhead to the
- start of the selection.</li>
- <li><dfn>Auto Return</dfn> is a toggle switch too. When active, pressing the Stop button returns the playhead to its previous position, and when inactive, pressing Stop keeps the playhead at its current location. Activating Auto Return can be useful for earing back the same part of the audio before and after having tweaked it, without having to loop on it.</li>
-</ul>
+++ /dev/null
----
-layout: default
-title: Times, Punches and indicators
-menu_title: Times
----
+++ /dev/null
----
-layout: default
-title: The Editor
-menu_title: The Editor
----
+++ /dev/null
----
-layout: default
-title: The Editor's List
-menu_title: The Editor's List
----
+++ /dev/null
----
-layout: default
-title: The Mixer
-menu_title: The Mixer
----
+++ /dev/null
----
-layout: default
-title: Favorite Plugins
-menu_title: Favorite Plugins
----
+++ /dev/null
----
-layout: default
-title: Track's List
-menu_title: Track's List
----
+++ /dev/null
----
-layout: default
-title: Group List
-menu_title: Group List
----
+++ /dev/null
-<p>
- The <dfn>Editor</dfn> window includes the editor track <dfn>canvas</dfn>
- where you can arrange audio and MIDI data along a timeline. This is the
- window you will be in while editing and arranging a project. The window
- has a general "horizontal" sense to it: the timeline flows from left to
- right, the playhead showing the current position in the session moves
- from left to right — the window really represents <dfn>time</dfn>
- in a fairly literal way.
-</p>
-
-<p>
- The <dfn>Mixer</dfn> window on the other hand represents signal flow and
- is the window you will probably be using most when mixing a session. It
- includes <dfn>channel strips</dfn> for each track and bus in your session.
- It has a general "vertical" sense to it: signals flow from the top of each
- channel strip through the processing elements in the strip to reach the
- output listed at the bottom.
-</p>
-<p>
- It is possible to show a single channel strip in the editor window, and
- some people find this enough to work on mixing without actually opening
- the mixer window. Most of the time though, you will want both of these
- windows at various stages of a session's lifetime — sometimes
- you'll be focused on editing, sometimes on mixing and possibly some of
- the time on both.
-</p>
projects / ardour-manual / commitdiff
