Add the ardour manual converted to docbook format with only a few minor
[ardour.git] / manual / xml / editor_window_timeline.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="editor-window-timeline">
8         <title>Timeline</title>
9         <para>
10                 At the top of the track display area is the timeline display. This consists
11                 of a number of rulers, a meter track, a tempo track and the marker display.
12         </para>
13
14         <para>
15                 The available rulers include:
16         </para>
17
18         <table id="tbl-rulers">
19                 <title>Ruler Types</title>
20                 <tgroup cols = "2">
21                         <colspec colnum="1" colname="Ruler Type" colwidth="1"/>
22                         <colspec colnum="2" colname="Description" colwidth= "2"/>
23                         <thead>
24                                 <row>
25                                         <entry>
26                                                 Ruler Type
27                                         </entry>
28                                         <entry>
29                                                 Description
30                                         </entry>
31                                 </row>
32                         </thead>
33                         <tbody>
34                                 <row>
35                                         <entry>
36                                                 Frames
37                                         </entry>
38                                         <entry>
39                                                 this ruler measures audio frames. The number of audio frames per second
40                                                 depends on the sample rate in use.
41                                         </entry>
42                                 </row>
43                                 <row>
44                                         <entry>
45                                                 SMPTE
46                                         </entry>
47                                         <entry>
48                                                 this ruler displays SMPTE timecode. The SMPTE format (25fps, 30fps, drop
49                                                 frame etc) is selected in the Options Editor option_editor.
50                                         </entry>
51                                 </row>
52                                 <row>
53                                         <entry>
54                                                 Min:Sec
55                                         </entry>
56                                         <entry>
57                                                 this ruler displays time in minutes+seconds, measured since the start of
58                                                 the session.
59                                         </entry>
60                                 </row>
61                                 <row>
62                                         <entry>
63                                                 BBT
64                                         </entry>
65                                         <entry>
66                                                 <para>
67                                                         (Bars,Beats,Ticks) this ruler displays positions based on the tempo
68                                                         map.
69                                                 </para>
70                                         </entry>
71                                 </row>
72                         </tbody>
73                 </tgroup>
74         </table>
75
76         <para>
77                 To show or hide one or more of the rulers, click on the area to the left of
78                 their names. A menu will popup that has a check item for each available
79                 ruler. Click on the name of the ruler to toggle its visibility.
80         </para>
81
82         <para>
83                 The tempo and meter tracks display the tempo map for the session. The tempo
84                 track contains 1 or more tempo change points, with a default tempo of 120
85                 beats per minute. The meter track contains 1 or more meter change points,
86                 with an initial default meter of 4/4.
87         </para>
88
89         <para>
90                 on a tempo/meter change point to edit it. Click in the tempo/meter track to
91                 add a new change point. Click and drag on a change point to move it. on a
92                 tempo/meter change point to remove it.
93         </para>
94
95         <para>
96                 There is more information on using the timeline in editing_basics.
97         </para>
98 <!--
99                                                                 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
100                                                                         href="Some_Subsection.xml" />
101                                                                 -->
102 </section>