summaryrefslogtreecommitdiff
path: root/manual/xml/editor_window_region_list.xml
blob: 7c7990e1da9fdf7c8c48cbb852286d403002407a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
<?xml version="1.0" standalone="no"?>

<!DOCTYPE section PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN" "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [

]>

<section id="editor-window-region-list">
  <title>Region List</title>
  <para>
    To the right of the track display is the region list, which uses a tree
    display to show all regions in the session. There are sections in the
    region list, &#8220;Captured&#8221; and &#8220;External&#8221;.
    &#8220;Captured&#8221; contains all regions that were either recorded by
    Ardour or imported as native audio files. &#8220;External&#8221;contains
    regions created using audio files external to Ardour (from a sample
    library, for example).
  </para>

  <section id="region-list-organization">
    <title>Organization of the region list</title>
    <para>
      In both sections of the region list, any regions containing multiple
      channels will have its name followed by &#8220;[N]&#8221; where N is a
      number indicating the number of channels. Any region that ends in
      &#8220;-N&#8221;, where N is a number, is a region that describes an
      entire audio file. Any region that ends in &#8220;.N&#8221; is a
      region that describes part of an audio file. Any subtree within the
      region list can be hidden or displayed by clicking on the box left of
      its name.
    </para>

    <para>
      Within the Captured part of the tree, each track is represented by its
      own subtree (strictly speaking, its not each track but each playlist
      that is represented). Within that subtree is an entry for each take
      recorded for that track. Remember that each take is stored as one and
      audio files (strictly, one per channel). Within the take tree is an
      entry for each region created from that take.
    </para>

    <para>
      Within the External part of the tree, there is a subtree for each
      audio file embedded into the session. Within that subtree are entries
      for each region created from that audio file.
    </para>
  </section>

  <section id="region-list-operations">
    <title>Region list operations</title>
    <para>
      Click on the box to the left of the name of part of the tree to
      hide/show that part of the subtree.
    </para>

    <para>
      Click the name of a region and then drag it to the track display area
      to insert a region into a track.
    </para>

    <para>
      Click on the title bar of the region list to display a menu allowing
      you to
    </para>

    <table id="tbl-region-list-operations-menu">
      <title>Region List Context Menu</title>
      <tgroup cols = "2">
        <colspec colnum="1" colname="Snap Option" colwidth="1"/>
        <colspec colnum="2" colname="Action" colwidth= "2"/>
        <thead>
          <row>
            <entry>
              Menu Item
            </entry>

            <entry>
              Description
            </entry>
          </row>
        </thead>
        <tbody>
          <row>
            <entry>
              Find
            </entry>
          </row>

          <row>
            <entry>
              Show/Hide All
            </entry>

            <entry>
              <para>
                fully expand or collapse the region list
              </para>
            </entry>
          </row>

          <row>
            <entry>
              Sort
            </entry>
          </row>

          <row>
            <entry>
              Display Automatic Regions normally,
            </entry>

            <entry>
              Ardour does not display regions created as a result of a side
              effect of user actions. If this option is selected, all
              regions will be included in the region list.
            </entry>
          </row>

          <row>
            <entry>
              Import audio files
            </entry>

            <entry>
              <para>
                copy (and if necessary convert) audio files into the
                session. See Importing for more details.
              </para>
            </entry>
          </row>

          <row>
            <entry>
              Embed audio file
            </entry>

            <entry>
              <para>
                embed external audio files into the session. No new files
                are created, and no format conversion is done. See
                [[editing:Embedding]] for more details.
              </para>
            </entry>
          </row>
        </tbody>
      </tgroup>
    </table>
  </section>
<!--
							<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" 
								href="Some_Subsection.xml" />
							-->
</section>