Copy local state in AudioRegionView copy constructor. Fixes #4047.
[ardour2.git] / manual / xml / basic_recording.xml
blobe8deb17a1712796007175d01bbda6e87adf34f2b
1 <?xml version="1.0" standalone="no"?>
3 <!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
5 ]>
7 <!-- XXX This needs a fair amount of work-->
9 <section id="sn-basic-recording">
10   <title>Basic Recording</title>
11   <para>
12     Recording audio is theoretically a very simple process. You have to make
13     essentially 2 decisions: what are you going to record, and how many
14     channels will you be recording, then press a couple of buttons and
15     you're recording.
16   </para>
18   <para>
19     Unfortunately, most recording also requires monitoring&mdash;providing
20     some way to hear what you are recording as you record it, possibly with
21     existing recorded material as well. Monitoring in Ardour is very
22     flexible, but with flexibility comes complexity. If you want to try to
23     skip ahead and record without reading about monitoring, you are welcome
24     to do so. Ardour attempts to use reasonable defaults for monitoring, but
25     the variety of hardware setups make it impossible to pick one default
26     that will work for everyone.
27   </para>
29   <para>
30     For this reason, you are strongly recommended to spend a few minutes
31     understanding <xref linkend="sn-monitoring"/>, because otherwise you're
32     going to get very confused and possibly irritated.
33   </para>
35   <section id="recording-a-single-track">
36     <title>Recording a single audio track</title>
37     <para>
38       These steps can all be taken directly within the Editor window,
39       although most of them can also be done via Mixer window if you prefer.
40     </para>
41   </section>
43   <section id="setting-up-a-new-track-for-recording">
44     <title>Setting up a new track for recording</title>
45     <orderedlist>
46       <listitem>
47         <para>
48           Choose <menuchoice> <guimenu>Session</guimenu> <guisubmenu>Add
49           Track/Bus</guisubmenu> </menuchoice>. This will popup a dialog
50           allowing you to choose how many tracks to add, and what basic I/O
51           configuration the track will have (mono, stereo, etc.). You can
52           change I/O configurations for tracks at any time.
53         </para>
54       </listitem>
55       <listitem>
56         <para>
57           Make the editor's dedicated mixer strip visible by clicking on the
58           <guibutton>Editor Mixer</guibutton> button located at the left end
59           of the transport bar.
60           <note>
61             <para>
62               In Ardour3, there is no <guibutton>Editor Mixer</guibutton>
63               button, but you can make the mixer strip visible by selecting
64               <menuchoice> <guimenu>View</guimenu> <guisubmenu>Show Editor
65               Mixer</guisubmenu> </menuchoice>, or by pressing
66               <keycombo><keycap>Shift</keycap><keycap>E</keycap></keycombo>
67               on the keyboard.
68             </para>
69           </note>
70         </para>
71       </listitem>
72     </orderedlist>
73     <section id="selecting-record-source">
74       <title>Selecting the source to record</title>
75       <orderedlist>
76         <listitem>
77           <para>
78             Check the input configuration for the new track. Click on its
79             control area. A mixer strip appears in the editor for this
80             track. Click on the <guibutton>Input</guibutton> button near the
81             top of the strip, and select <guimenuitem>Edit</guimenuitem>
82             from the menu. The standard I/O dialog pops up to let you
83             connect the track to whichever JACK port you want to record
84             from.
85           </para>
86         </listitem>
87         <listitem>
88           <para>
89             Rename the track. This is an important step in helping you make
90             sense of your session, because track names are used when naming
91             newly created regions.
92           </para>
93         </listitem>
94         <listitem>
95           <para>
96             Click on the track's record-enable button to record enable the
97             track. You can use the <guibutton>r</guibutton> button in the
98             track control area or the <guibutton>record</guibutton> button
99             of the mixer strip. The button will turn pink.
100           </para>
101         </listitem>
102         <listitem>
103           <para>
104             Adjust the output level of the sound source to the a level where
105             the loudest input drives the meter in the mixer strip close to,
106             but not over, 0dB. The mixer strip will show the incoming signal
107             level, along with peak indicators
108           </para>
109         </listitem>
110         <listitem>
111           <para>
112             If you are using software monitoring, adjust the output volume
113             and possibly panning if desired. These settings do not affect
114             the recorded material.
115           </para>
116         </listitem>
117       </orderedlist>
118       <para>
119         Check the output configuration for the new track. Click on the
120         <guibutton>Output</guibutton> button near the bottom of the strip,
121         and select <guimenuitem>Edit</guimenuitem> from the menu. Make sure
122         the track's output is connected as you intend.
123       </para>
125       <note>
126         <para>
127           by default (and when not using a session template that works
128           otherwise) mono tracks have mono outputs, meaning that you cannot
129           pan them.
130         </para>
131       </note>
132     </section>
133   </section>
135   <section id="to-record-to-the-new-audio-track">
136     <title>To record to the new audio track</title>
137     <orderedlist>
138       <listitem>
139         <para>
140           If necessary, setup the session's default meter and tempo by on
141           the initial meter and tempo markers.
142         </para>
143       </listitem>
144       <listitem>
145         <para>
146           If desired, enable the click track in the transport bar.
147         </para>
148       </listitem>
149       <listitem>
150         <para>
151           Click on the <guimenuitem>Record</guimenuitem> button of the
152           transport window, which will start to flash.
153         </para>
154       </listitem>
155       <listitem>
156         <para>
157           When you are ready to record, click the
158           <guibutton>Play</guibutton> button in the transport window.
159         </para>
160       </listitem>
161       <listitem>
162         <para>
163           When you have finished recording, click the
164           <guibutton>Stop</guibutton> button in the transport window.
165         </para>
166       </listitem>
167       <listitem>
168         <para>
169           If desired, click the track's record-enable button to disengage
170           record-enable for this track.
171         </para>
172       </listitem>
173     </orderedlist>
174     <para>
175       The audio you recorded will be written to a new audio file stored on
176       one of your disks. In the editor, a new region will appear in the
177       track display area and also in the region list display.
178     </para>
179   </section>
181   <section id="to-playback-the-new-audio-track">
182     <title>To play back the new audio track</title>
183     <orderedlist>
184       <listitem>
185         <para>
186           Press the <keycap>Home</keycap> key (or
187           <keycombo><keycap>Ctrl</keycap><keycap>A</keycap></keycombo>) to
188           return the playhead to the start of the track
189         </para>
190       </listitem>
191       <listitem>
192         <para>
193           In the transport bar click on the <guibutton>Play</guibutton>
194           button, or press the <keycap>spacebar</keycap>.
195         </para>
196       </listitem>
197       <listitem>
198         <para>
199           Adjust the track's volume as necessary, using either the mixer
200           strip in the editor, or the corresponding strip in the mixer
201           window.
202         </para>
203       </listitem>
204     </orderedlist>
205   </section>
207   <section id="cancelling-a-take">
208     <title>Cancelling a take</title>
209     <para></para>
210   </section>
212   <section id="recording-multiple-tracks">
213     <title>Recording multiple tracks</title>
214     <para>
215       Multiple tracks can easily be recorded simultaneously by
216       record-enabling each track you would like to record.
217     </para>
218   </section>
220   <section id="recording-additional-takes">
221     <title>Recording additional takes</title>
222     <para></para>
223   </section>
225   <section id="appending-new-material">
226     <title>Appending new material</title>
227     <para></para>
228   </section>
230   <section id="recording-into-a-new-playlist">
231     <title>Recording into a new playlist</title>
232     <para>
233       There is a <guibutton>p</guibutton> button in the track controls. If
234       you press it and select <guimenuitem>new playlist</guimenuitem>, the
235       contents will be cleared, allowing you to construct a new arrangement
236       of recordings. You can recall your playlist later by using the same
237       button and selecting <guimenuitem>select...</guimenuitem>. This will
238       open a window displaying all the playlists you have recorded on that
239       track. Select the one you want and proceed. Playlists from other
240       tracks can also be selected.. in fact you can have the same playlist
241       on two different tracks if you feel it necessary.
242     </para>
243   </section>
245   <section id="punch-recording">
246     <title>Punch Recording</title>
247     <para>
248       You can automate the portion of a track to be recorded using the punch
249       functions. This is most often implemented when a portion of a
250       particular take is problematic but an adjacent portion is good. In
251       order to punch record, the punch range must be set.
252     </para>
253   </section>
255   <section id="loop-recording">
256     <title>Loop Recording</title>
257     <para></para>
258   </section>
260   <section id="setting-punch-loop-points">
261     <title>Setting Punch/Loop Points</title>
262     <para></para>
263   </section>
265   <section id="using-pre-and-post-roll">
266     <title>Using Pre- and Post-Roll</title>
267     <para></para>
268   </section>
269 <!--
270         <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
271                 href="Some_Subsection.xml" />
272         -->
273 </section>