Copy local state in AudioRegionView copy constructor. Fixes #4047.
[ardour2.git] / manual / xml / editor_window.xml
blobf87d9e93fc6fdcf1b153f571430ba930cbcc2562
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-editor-window">
8   <title>The Editor</title>
9   <para>
10     Ardour provides two ways of viewing a session: the Editor and the Mixer.
11     The Editor shows the session by representing tracks as horizontal
12     timeline displays, with material within the tracks (audio, MIDI, video,
13     automation data, etc.) arranged along the horizontal (time) axis. The
14     Mixer shows the session by representing tracks as mixer strips, with
15     controls for gain, record enable, soloing and so forth. More abstractly,
16     the Editor represents the time based aspects of a session, whereas the
17     Mixer represents the signal flow.
18   </para>
20   <para>
21     However, it is quite possible to control the signal flow aspects from
22     within the Editor as well, without the comprehensive overview that the
23     Mixer provides. For some sessions, especially during the early stages of
24     a session, the Editor may be the only window you need to use.
25   </para>
27   <section id="editor-window-layout">
28     <title>Editor Window Layout</title>
29     <para>
30       Lets survey the basic layout of the editor window:
31     </para>
33     <para>
34       The transport controls are in a tearoff window at the top of the
35       editor, and are described in transport_window.
36     </para>
37   </section>
38   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
39                 href="editor_window_controls.xml" />
40   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
41                 href="track_list.xml" />
42   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
43                 href="editor_window_group_list.xml" />
44   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
45                 href="editor_window_region_list.xml" />
46   <section id="editor-window-chunk-list">
47     <title>Chunk List</title>
48     <para>
49       Below the region list is the Chunk List, which provides a visual list
50       of all "chunks". Chunks are collections (possibly discontiguous) of
51       sections.
52     </para>
53   </section>
54   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
55                 href="track_display.xml" />
56   <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
57                 href="editor_window_timeline.xml" />
58   <section id="editor-window-track-controls">
59     <title>Track Controls</title>
60     <para>
61       Each track has a set of controls on its left side. Which controls are
62       present varies depending on the type of track (audio, bus, automation,
63       MIDI, etc.). Every track type has a "hide" button marked with a cross.
64       Click on this to hide the track.
65     </para>
66   </section>
68   <section id="editor-window-track-views">
69     <title>Track Views</title>
70     <para>
71       This is where all editing takes place. The track views contain region
72       objects, curve control points, lines and other items that can be
73       added, removed, copied, cut and pasted. See editing_basics for more
74       information on editing.
75     </para>
76   </section>
77 <!--
78         <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
79                 href="Some_Subsection.xml" />
80         -->
81 </section>