Renamed Insert to Processor and Redirect to IOProcessor.
[ardour.git] / manual / xml / exporting_to_cd.xml
1 <?xml version="1.0" standalone="no"?>
2
3 <!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
4
5 ]>
6
7 <section id="sn-exporting-to-cd">
8   <sectioninfo>
9     <authorgroup>
10       <author>
11         <personname>
12           <firstname>Nick</firstname>
13           <surname>Mainsbridge</surname>
14         </personname>
15       </author>
16     </authorgroup>
17   </sectioninfo>
18   <title>Exporting to CD</title>
19   <section id="table-of-contents">
20     <title>Table of Contents </title>
21     <para>
22       A Table of Contents is a description of the data stored on a medium.
23       In the case of audio Cds, the TOC comes in the form of PQ data which
24       is intermingled with the audio data whaen the CD is burnt. Because PQ
25       data isn't part of 'normal' audio file formats such as wav or aiff,
26       this information must be stored in a separate file on your computer (a
27       CUE or TOC file) ready for use by your CD burning software which will
28       combine the two.
29     </para>
30
31     <para>
32       At the moment, Ardour can export TOC and CUE files containing the
33       red-book related fields Track, Index, ISRC, SCMS and Preemphasis. The
34       CD-TEXT fields TITLE, COMPOSER, PERFORMER and disc title are also
35       supported.
36     </para>
37
38     <para>
39       Range markers in Ardour can be 'promoted' to become CD tracks in the
40       locations window. Marks (point markers) can be promoted to be CD
41       Indexes in the same window. All TOC/CUE export operations hinge on
42       this.
43     </para>
44
45     <para>
46       Assuming you have several songs on your timeline laid out so that
47       their spacing and level is 'correct' as you hear it, you should then
48       set ranges that represent the start and end points of each track,
49       These will become the start and end points on your CD. The start times
50       are all rounded down to the previous CD frame (Of which there are
51       75/second) on export, so if you want to hear the exact point that your
52       CD player will start from, select 'CD frames' as your snap setting
53       while you do this. If you want track indexes (nobody does, but they're
54       there), set a location marker for each desired index.
55     </para>
56
57     <para>
58       The locations dialog is useful here, as you can just 'go' to a point
59       to audition the exact position of a marker/range.
60     </para>
61   </section>
62
63   <section id="pregap">
64     <title> Pregap </title>
65     <para>
66       A word about pregap:
67     </para>
68
69     <para>
70       A 'normal' redbook CD should have a blank (digital black) space of 2
71       seconds before the first modulation called the pregap. Ideally, your
72       first song will have been placed at 2 seconds when you began, but you
73       can always drag the whole collection of songs to the right position
74       fairly easily at this point.
75     </para>
76
77     <para>
78       Also, note that this 2 second rule can be fun to break. You can make
79       the pregap as long as you like.. even hide whole songs in there. The
80       player will still play track one when the disc is inserted. Only those
81       listeners with the urge to rewind beyond the beginning will find your
82       hidden song/dog bark. Also keep in mind that there is a pregap for
83       each song. It starts where the previous song ends. In other words, if
84       you leave a gap in the ranges between songs 2 &amp; 3, that gap will
85       only play for those listening through the entire CD. Anyone skipping
86       directly to 3 will miss your secret 'long' intro.
87     </para>
88
89     <para>
90       After setting a non-overlapping range for each track (overlapping CD
91       tracks are removed on export, from left to right, as are indexes that
92       aren't inside a track), open the locations window and make your ranges
93       into track markers by clicking the CD button. Fill in whatever
94       information you feel is necessary in the boxes below. Unused fields
95       will be ignored as far as the exported TOC/CUE file is concerned.
96     </para>
97
98     <para>
99       CD-TEXT track titles are taken from the range's name. The CD-TEXT
100       title of the CD is taken from the session name (i should have told you
101       that first, right?).
102     </para>
103
104     <note>
105       <para>
106         Pre-emphasis is there for those strange types that use it (they also
107         use track indexes). You almost certainly don't want pre-emphasis. A
108         valid ISRC is all capitals, 12 characters.
109       </para>
110     </note>
111   </section>
112
113   <section id="cue-files">
114     <title> Cue Files </title>
115     <para>
116       Cue files have no notion of 'the end'. Its a drag. They think the end
117       of the file is the end of the last track. If you want to use CUE
118       files, you have to make sure that the session end marker is snapped to
119       CD frames (before you export, of course), or else use the -pad option
120       when you burn.
121     </para>
122   </section>
123
124   <section id="export-the-session">
125     <title> Export The Session </title>
126     <para>
127       Now export the session to a file (16bit 44.1kHz for CD), selecting
128       your preferred cuefile type (TOC or CUE). The TOC/CUE file is written
129       to the same directory as your audio file, and has the same name, only
130       with '.toc' or '.cue' appended. Usually you will only be selecting the
131       two master outputs to export, with output 1 always being 'left'. The
132       export is post fader and panner. Don't assume that the sound will be
133       identical after you have truncated/dithered to 16 bits. It can be
134       worthwhile to experiment with different dither settings when making
135       your export.
136     </para>
137
138     <para>
139       To check out the details without burning
140     </para>
141 <screen>
142 cdrdao show-toc blah.wav.toc
143 </screen>
144     <para>
145       to correct a problem, make your changes, then use the 'export toc file
146       only' option. If you have to change the session end marker, you'll
147       have to re-export your audio file.
148     </para>
149
150     <para>
151       To burn
152     </para>
153 <screen>
154 cdrdao write /home/britney/globalsmash.wav.toc
155 </screen>
156     <para>
157       One last thing:
158     </para>
159
160     <para>
161       If you don't make any CD Track ranges and export a TOC/CUE file, the
162       entire session is treated as one track with no pregap. Indexes, if
163       present, will be honoured.
164     </para>
165   </section>
166
167   <section id="ddp-support">
168     <title>FAQ </title>
169     <para>
170       Why no DDP? ( http://www.dcainc.com/products/ddp/ )
171     </para>
172
173     <para>
174       A: DCA have been kind enough to get in touch. Hopefully they will
175       allow a GPL implementaton soon.
176     </para>
177   </section>
178
179   <section id="catalog-numbers">
180     <title>What about catalog numbers for the CD?</title>
181     <para>
182       A: coming eventually.. we need a tab for session-wide variables like
183       these. where to put it? in the export dialog or the options menu?
184     </para>
185   </section>
186 <!--
187         <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
188                 href="Some_Subsection.xml" />
189         -->
190 </section>