Copy local state in AudioRegionView copy constructor. Fixes #4047.
[ardour2.git] / manual / xml / working_with_crossfades.xml
blob412da4b84496c38e6d606f984b534db04b0138af
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 <section id="sn-working-with-crossfades">
8   <title>Working with Crossfades</title>
9   <para>
10     Whenever you arrange any two audio regions so that they overlap in any
11     way, you create the potential for a
12     <link linkend="gt-crossfade">crossfade</link> between them: a smooth
13     transition from one region to the other. Crossfades in Ardour are
14     generated in realtime, and are not stored on disk. They are objects
15     within a playlist just like regions, except that the only way to create
16     a crossfade is by overlapping two regions, and the only way to remove a
17     crossfade is to move one or both of the regions so that they no longer
18     overlap. Note that crossfades are not always audible (they can be muted
19     and unmuted at will), and can be edited in a variety of ways. We think
20     of a crossfade as consisting of an overlap between two regions, plus two
21     gain control curves that control the volume of the incoming and outgoing
22     regions during the crossfade.
23   </para>
25   <section id="crossfade-types">
26     <title>Types of crossfades</title>
27     <para>
28       Ardour comes with two basic kinds of crossfades, termed
29       <emphasis>short crossfades</emphasis> and <emphasis>full
30       crossfades</emphasis> . A full crossfade is a transition between two
31       regions that spans the entire overlap between them. If the overlap is
32       2 seconds long, then the crossfade is 2 seconds long. A short
33       crossfade is a transition between two regions that lasts a fixed
34       amount of time and serves simply to avoid audio glitches at the
35       boundary of the two regions. The length of a short crossfade is a
36       session-wide parameter than can be set via the <emphasis>option
37       editor</emphasis> . The default is 15ms, and the length can vary from
38       1 milliseconds to 0.5 seconds. In the current version of Ardour, it is
39       not possible to change the length of a short becrossfade after it has
40       been created, but it is possible to change most short crossfades to a
41       full crossfade and vice versa. Full crossfades can have their length
42       altered by changing the extent of the overlap between the two regions.
43     </para>
45     <para>
46       Note that even though the absolute length of the crossfade is fixed,
47       crossfades can be <emphasis>edited</emphasis> with complete freedom,
48       allowing you change the effective length of a crossfade by altering
49       the shapes of the fade in and fade out curves.
50     </para>
51   </section>
53   <section id="crossfade-overlaps">
54     <title>Overlaps</title>
55     <para>
56       There are several different ways to overlap two regions, and they
57       result in different kinds of crossfades being placed at the boundaries
58       of the two regions:
59     </para>
61     <section id="external-overlaps">
62       <title>External overlaps</title>
63       <para>
64         An "external" overlap occurs when a region starts within another
65         region, but extends beyond the other's end.
66       </para>
67       <mediaobject>
68         <imageobject>
69           <imagedata fileref="images/overlaplaterhigher.png"/>
70         </imageobject>
71       </mediaobject>
72       <para>
73         Overlaps like this will cause an xfade to be placed at the start of
74         the later region. Whether it is a full or short crossfade is
75         controlled by the current crossfade type preference. If short
76         crossfades have been chosen, the crossfade will last for the current
77         short crossfade duration; otherwise the full crossfade will last for
78         the entire overlap. The mute status of the crossfade will depend on
79         the current state of the "New crossfades are muted" setting.
80       </para>
82       <para>
83         In the example above, the later region is above the earlier one. It
84         is also possible to create an overlap where the earlier region is in
85         a higher layer:
86       </para>
87       <mediaobject>
88         <imageobject>
89           <imagedata fileref="images/overlapearlyhigher.png"/>
90         </imageobject>
91       </mediaobject>
92       <para>
93         For an overlap of this type, the current crossfade type preference
94         affects the placement of the crossfade. If full crossfades have been
95         chosen, the crossfade will be placed at the start of the later
96         region and will last for the entire overlap. If short crossfades
97         have been chosen, the crossfade will start just before the end of
98         the earlier region and will last for the chosen short crossfade
99         duration. The mute status of the crossfade will depend on the
100         current state of the "New crossfades are muted" setting.
101       </para>
102     </section>
104     <section id="internal-overlaps">
105       <title>Internal overlaps</title>
106       <para>
107         An "internal" overlap occurs when the start and end of one region
108         both occur within the duration of another.
109       </para>
110       <mediaobject>
111         <imageobject>
112           <imagedata fileref="images/internalhigheroverlap.png"/>
113         </imageobject>
114       </mediaobject>
115       <para>
116         Overlaps of this type will cause two short crossfades to be place at
117         the start of the later region and close to its end. Both crossfades
118         will last for the current short crossfade duration, and are created
119         in an un-muted state. These crossfades <emphasis>cannot</emphasis>
120         be converted to full crossfades. It is important to realize that the
121         purpose of these two crossfades is a little different than those
122         created for the single-ended overlap cases above. They are created
123         solely to avoid audio glitches at the transitions between the two
124         regions, and are not intended to facilitate interesting crossfades
125         between the upper and lower region.
126       </para>
128       <para>
129         Notice that in the example above, the shorter region is above the
130         longer one. It is also possible to create the following type of
131         overlap, where the shorter region is below the longer one:
132       </para>
133       <mediaobject>
134         <imageobject>
135           <imagedata fileref="images/internalloweroverlap.png"/>
136         </imageobject>
137       </mediaobject>
138       <para>
139         Overlaps of this type will not cause any crossfades to be created.
140         The uppermost region will be audible throughout its duration; the
141         lowermost region will not be audible at all.
142       </para>
143     </section>
144   </section>
146   <section id="creating-crossfades">
147     <title>Creating Crossfades</title>
148     <para>
149       To create a crossfade between two regions, move them so that they
150       overlap. A crossfade is automatically created within the overlap
151       (possibly two, dependening on the type of overlap, as explained
152       above). Whether the crossfade is muted or not depends on two things:
153     </para>
155     <itemizedlist>
156       <listitem>
157         <para>
158           if the current crossfade type is set to "Short", the new crossfade
159           will be created in an un-muted state
160         </para>
161       </listitem>
163       <listitem>
164         <para>
165           if the current crossfade type is set to "Full", the mute status of
166           the new crossfade is controlled from the <emphasis>option
167           editor</emphasis> on the "Layers&amp;Fades" control panel. If "New
168           crossfades are unmuted", the new crossfade will be unmuted.
169         </para>
170       </listitem>
171     </itemizedlist>
173     <para>
174       A muted crossfade is not directly visible in the editor window, but
175       can be accessed by context clicking within the overlap that it relates
176       to. An unmuted crossfade has a yellow background that covers the
177       entire overlap (to make its presence obvious at all times), and a pair
178       of visible curves that show the gain control curves for the fade.
179       These curves may not be visible at a particular zoom level, especially
180       for short crossfades.
181     </para>
182   </section>
184   <section id="editing-crossfades">
185     <title>Editing Crossfades</title>
186     <para>
187       To carry out operations on a crossfade, context click anywhere in the
188       overlap. For the short crossfades in the "internal" overlap case, you
189       will need to zoom in until the crossfade becomes visible, and then
190       context click on it. Each crossfade under the mouse pointer (there is
191       normally only one) will appear in the context menu, and will lead to a
192       submenu offering the following options:
193     </para>
195     <itemizedlist>
196       <listitem>
197         <para>
198           Mute/Unmute the crossfade
199         </para>
200       </listitem>
202       <listitem>
203         <para>
204           Edit the crossfade
205         </para>
206       </listitem>
208       <listitem>
209         <para>
210           change the crossfade from short to full or vice versa
211         </para>
212       </listitem>
213     </itemizedlist>
215     <para>
216       The last option is not available for the short crossfades in the
217       "internal" overlap case.
218     </para>
219   </section>
220 <!--
221         <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
222                 href="Some_Subsection.xml" />
223         -->
224 </section>