diff options
Diffstat (limited to 'manual/xml/editor_window_region_list.xml')
-rw-r--r-- | manual/xml/editor_window_region_list.xml | 266 |
1 files changed, 140 insertions, 126 deletions
diff --git a/manual/xml/editor_window_region_list.xml b/manual/xml/editor_window_region_list.xml index 551c9acee9..7c7990e1da 100644 --- a/manual/xml/editor_window_region_list.xml +++ b/manual/xml/editor_window_region_list.xml @@ -5,132 +5,146 @@ ]> <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, “Captured” and “External”. - “Captured” contains all regions that were either recorded by - Ardour or imported as native audio files. “External”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 “[N]” where N is a - number indicating the number of channels. Any region that ends in - “-N”, where N is a number, is a region that describes an entire - audio file. Any region that ends in “.N” 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> + <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, “Captured” and “External”. + “Captured” contains all regions that were either recorded by + Ardour or imported as native audio files. “External”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 “[N]” where N is a + number indicating the number of channels. Any region that ends in + “-N”, where N is a number, is a region that describes an + entire audio file. Any region that ends in “.N” 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" /> |