From: Shamus Hammons Date: Thu, 12 Jan 2017 19:12:18 +0000 (-0600) Subject: Merge branch 'master' of http://shamusworld.gotdns.org/git/ardour-manual X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=9d9e4988fe140a7798906887d04cd7b7ca5a690a;hp=-c;p=ardour-manual-diverged Merge branch 'master' of shamusworld.gotdns.org/git/ardour-manual --- 9d9e4988fe140a7798906887d04cd7b7ca5a690a diff --combined master-doc.txt index de2cb81,d3aed91..8b349f6 --- a/master-doc.txt +++ b/master-doc.txt @@@ -7009,16 -7009,35 +7009,35 @@@ title: Status Ba part: chapter --- -

Add content

The status bar is an informative bar at the top of the window, showing:

File: the file format used in the session, including when recording
TC: is the timecode, i.e. the number of frames per second used by the session (for videos)
Audio: gives the sample rate used in the session, and the latency computed from the buffer size
Buffers: decribe how much data is buffered, see below
DSP: for Digital Sound Processing, shows how much of the CPU is used by Ardour and its plugins
X: shows the number of xruns since Ardour's launch, see below
Disk: reports the remaining hard disk space as the time that can be recorded with the current session setting
a Clock showing the system time
a Log button that indicates if Ardour has encountered any warning or error.

The buffers are labelled as p for playback and c for capture. If the + system is fast enough, these buffers should be 100% full at all times, showing the system has time to precompute + all the data before delivering it to the audio system. A buffer constantly under 20% is a sign of an underpowered + computer system or of too much processing.

+ +

An Xrun (short for buffer over- or under-run) happens when the system has been forced to skip audio frames, e.g. if the latency + asked is too short for the computing power of the machine. It usually results in clicks, pops and crackles if it happens while recording.

+ +

The log button turns yellow when a warning is shows, and red when an error occurs. Clicking the log button gives acces to the log.

--- title: Transport bar and times part: chapter --- -

There is no discussion of starting playback anywhere in here. Starting/stopping needs to be explained

Ardour offers many ways to control playback of your session, including the transport bar, key bindings and remote controls. You can also use markers to define locations or ranges within the session and rapidly move around between them.

@@@ -7055,7 -7074,7 +7074,7 @@@ part: subchapte The Transport Bar groups all the actions regarding the control of playback and recording.

The transport controls

This bar is made of (from left to right): @@@ -7063,7 -7082,7 +7082,7 @@@

- Midi Panic: allows to immediately stop all midi output. + Midi Panic: Immediately stops all midi output.
Enable/disable Audio Click: Toggles (on/off) a click track (metronome) along the tempo. @@@ -7075,23 -7094,23 +7094,23 @@@ Go to End of the Session: Jumps forward to the end of the session, as defined by the end marker.
- Play Loop Range: Repeats the defined loop as defined by the Loop range, 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. + Play Loop Range: Repeats the defined loop as defined by the Loop range, until the "Stop playback" button is pressed. Clicking the "Play loop Range" button while already active switches to normal Play mode, which exits the loop without stopping and restarting playback.
Play Range/Selection: 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.
- Play from playhead: Starts the playback and optionally record (more bellow). + Play from playhead: Starts the playback and optionally record (more below).
Stop: 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.
- Toggle Record: Global switch button to activate/deactivate 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 Recording. + Toggle Record: Global switch button to activate/deactivate recording. While active, the button blinks red. The button doesn't start recording by itself: if one or more tracks are marked as record-enabled, pressing the "Play from Playhead" starts recording on those tracks. See Recording.

Language in the above paragraphs is awkward

Add default keyboard shortcuts to the above.

All these actions are bound to keyboard shortcuts, which allows for speedier use and more focused work. @@@ -7126,7 -7145,7 +7145,7 @@@ Follow Edits 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.

- Auto Return 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. + Auto Return 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 hearing the same piece of audio before and after tweaking it, without having to set a loop range on it.