diff options
Diffstat (limited to 'manual/xml/working_with_regions.xml')
-rw-r--r-- | manual/xml/working_with_regions.xml | 1244 |
1 files changed, 633 insertions, 611 deletions
diff --git a/manual/xml/working_with_regions.xml b/manual/xml/working_with_regions.xml index 7e3f687bcc..1c8cea8209 100644 --- a/manual/xml/working_with_regions.xml +++ b/manual/xml/working_with_regions.xml @@ -5,617 +5,639 @@ ]> <section id="sn-working-with-regions"> - <title>Working with Regions</title> - <para> - Regions are the basic elements of editing and composing in Ardour. Each - region represents a single, contiguous section of one or more audio files. - Regions are defined by a fixed set of attributes: - </para> - - <itemizedlist> - <listitem> - <para> - the source audio file(s) they represent - </para> - </listitem> - <listitem> - <para> - a starting point in the audio file(s) - </para> - </listitem> - <listitem> - <para> - a length - </para> - </listitem> - </itemizedlist> - - <para> - When placed into a <glossterm linkend="gt-playlist">playlist</glossterm>, - they gain additional attributes: - </para> - - <itemizedlist> - <listitem> - <para> - a position along the timeline - </para> - </listitem> - <listitem> - <para> - a layer - </para> - </listitem> - </itemizedlist> - - <para> - There are <emphasis>other attributes</emphasis> as well, but they do not - define the region. Things you should know about regions: - </para> - - <variablelist> - <title></title> - <varlistentry> - <term>Regions are Cheap</term> - <listitem> - <para> - By themselves, regions do not consume hardly any of your computer's - resources. Each region requires a small amount of memory, and represents - a rather small amount of CPU work if placed into an active track. So, - don't worry about creating regions whenever you need to. - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term>Regions are not audio files</term> - <listitem> - <para> - Although a region can represent an entire audio file, they are never - equivalent to an audio file. Most regions represent just parts of an - audio file(s) on disk, and removing a region from a track has nothing to - do with removing the audio file(s) from the disk ((the - <emphasis>Destroy</emphasis> operation, one of Ardour's few destructive - operations, can affect this)). Changing the length of a region has no - effect on the audio file(s) on disk. Splitting and copying regions does - not alter the audio file in anyway, nor does it create new audio files - ((the <emphasis>Export</emphasis> , <emphasis>Bounce</emphasis> and - <emphasis>Reverse</emphasis> operations do create new audio files)). - </para> - </listitem> - </varlistentry> - </variablelist> - - <section id="region-naming"> - <title>Region Naming</title> - <para> - Regions are initially named using either: - </para> - - <itemizedlist> - <listitem> - <para> - the name of the playlist for which they were recorded - </para> - </listitem> - <listitem> - <para> - the name of the embedded/imported audio file they represent - </para> - </listitem> - </itemizedlist> - - <section id="whole-file-region-names"> - <title>Whole File Region Names</title> - <para> - These are not audio files, but regions that represent the full extent of - an audio file. Every time a new recording is done, or a new file is - embedded/imported, a new region is created that represents the entire - audio file(s) This region will have the name of the playlist/original - file, followed by a "-" and then a number. - </para> - - <para> - For recorded regions, the number will increase each time a new recording - is made. So, for example, if there is a playlist called "Didgeridoo", the - first recorded whole file region for that playlist will be called - "Digderidoo-1". The next one will be "Digeridoo-2" and so on. - </para> - - <para> - For imported/embedded files, the region name will be based on the file - name, but with any final suffix (e.g. ".wav" or ".aiff") removed. - </para> - - <para> - Normally, whole file regions are not inserted into tracks/playlists, but - regions derived from them are. The whole-file versions live in the editor - region list where they act as an organizing mechanism for regions that are - derived from them. - </para> - </section> - - <section id="normal-region-names"> - <title>Normal Region Names</title> - <para> - When a region is inserted into a track/playlist, its initial name will end - in a version number, such as ".1" or ".103". For a recorded region, if the - whole file region was "Hang drum-1", then the region in the track will - appear with the name "Hang drum-1.1". For an imported/embedded region, if - the whole file region was "Bach:Invention3", then the region in the track - will appear with the name "Bach:Invention3.1". - </para> - </section> - - <section id="copied-region-names"> - <title>Copied Region Names</title> - <para> - If the region is a copy of another region, it will begin life with the - same name as the original. When an operation is carried out that modifies - one of the copies, that particular copy will be renamed by incrementing - the version number. - </para> - </section> - - <section id="renaming-regions"> - <title>Renaming Regions</title> - <para> - You can rename a region at any time. Use the <emphasis>region context - menu</emphasis> to popup the rename dialog. The new name does not need to - have a version number in it (in fact, it probably should not). The region - will retain its name until it is modified after being copied. - </para> - </section> - </section> - - <section id="selecting-regions"> - <title>Selecting Regions</title> - <para> - In general, operations on regions apply to whichever regions are currently - <emphasis>selected</emphasis> . - </para> - - <para> - To select a single region, click on it using - <mousebutton>Button1</mousebutton>. - </para> - - <para> - To add an unselected region to the currently selected regions, click on it - using - <keycombo><keycap>Shift</keycap><mousebutton>Button1</mousebutton></keycombo>. - </para> - - <para> - To remove a selected region from the currently selected regions, click on - it using - <keycombo><keycap>Shift</keycap><mousebutton>Button1</mousebutton></keycombo>. - </para> - </section> - - <section id="removing-regions"> - <title>Removing Regions</title> - <para> - Select the region(s) to be removed. Then press the "Delete" key or use the - standard key binding for "Cut" ( - <keycombo><keycap>Ctrl</keycap><keycap>X</keycap></keycombo> by default). - </para> - - <para> - Note that "removing" a region is a non-destructive operation. It has no - effect on the audio file(s) stored on disk. If you really want to - destructively remove the region, use the context menu for the region which - has a "Destroy" item. This is not guaranteed to remove the audio file from - your disk storage, but it generally will. - </para> - </section> - - <section id="moving-regions"> - <title>Moving Regions</title> - <para> - To move a region, make sure you are in <emphasis>object</emphasis> mouse - mode. Move the mouse pointer into the waveform display part of the region, - press <mousebutton>Button1</mousebutton> and drag. The region will follow the - mouse pointer as you move it around. By default, the region can move freely - along the timeline - see <xref linkend="sn-snap-settings"/> for information on how to - force the region to align to certain kinds of points along the timeline. - </para> - - <para> - To move a region from one track to another, simply start a move as - described above, but move the mouse pointer into the desired track. The - region will follow the mouse pointer. Note that if you have other kinds of - "tracks" visible, the region will remain where it is as the mouse pointer - moves across them, and will then jump to the new track. This serves as a - visual reminder that you cannot drag an audio region into an automation - track or a bus, for example. - </para> - - <section id="moving-more-than-one-region"> - <title>Moving more than one region</title> - <para> - To move multiple regions, select them before moving. Then click+drag on - one of the selected regions. All the regions will move, keeping their - positions relative to each other. - </para> - </section> - - <section id="region-fixed-time-motion"> - <title>Fixed-time motion</title> - <para> - Sometimes, you want to move a region to another track, but keeping its - position along the timeline exactly the same. To do this, use - <mousebutton>Button2</mousebutton> rather than <mousebutton>Button1</mousebutton>. - </para> - </section> - </section> - - <section id="copying-regions"> - <title>Copying Regions</title> - <para> - To copy a region, make sure you are in <emphasis>object</emphasis> mouse - mode. Move the mouse pointer into the waveform press the - <keycap>Ctrl</keycap> key, keep it down while pressing - <mousebutton>Button1</mousebutton> and drag. A new region is created and will - follow the mouse pointer as it moves. See <xref linkend="moving-regions"/> for - more details on moving the copied region around. - </para> - - <section id="copying-more-than-one-region"> - <title>Copying more than one region</title> - <para> - To copy multiple regions, select them before copying. Then click+drag on - one of the selected regions. All the regions will be copied and as they - move, the will keep their positions relative to each other. - </para> - </section> - - <section id="region-fixed-time-copying"> - <title>Fixed-time copying</title> - <para> - If you want to copy region(s) to other track(s) but keep the copies at the - exact position on the timeline as the originals, simply use - <keycombo><keycap>Ctrl</keycap><mousebutton>Button2</mousebutton></keycombo> instead of - <keycombo><keycap>Ctrl</keycap><mousebutton>Button1</mousebutton></keycombo>. - </para> - </section> - </section> - - <section id="trimming-regions"> - <title>Trimming Regions</title> - <para></para> - </section> - - <section id="auditioning-regions"> - <title>Auditioning Regions</title> - <para></para> - </section> - - <section id="region-gain-envelopes"> - <title>Region Gain Envelopes</title> - <para></para> - </section> - - <section id="region-context-menu"> - <!-- needs work --> - <title>Region Context Menu</title> - <para> - If you context-click on a region, a popup menu will appear. At or near the - top of that menu is a list of all regions that exist in the clicked-upon - track under the mouse pointer. Each region entry (shown by name) points to - a submenu that contains region-specific operations: - </para> - - <variablelist> - <title></title> - <varlistentry> - <term><guilabel>Popup region editor</guilabel></term> - <listitem> - <para> - creates and displays the editor for this region, allowing even more - specific control over the region than this menu - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Raise to top layer</guilabel></term> - <listitem> - <para> - moves the region to the top layer of this track (works only in "Most - recently added/moved/trimmed regions are higher" <emphasis>layer - mode</emphasis> - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Lower to bottom layer</guilabel></term> - <listitem> - <para> - moves the region to the bottom layer of this track (works only in "Most - recently added/moved/trimmed regions are higher" <emphasis>layer - mode</emphasis> - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Define sync point</guilabel></term> - <listitem> - <para> - if the edit cursor is within this region, defines the region sync point - at the edit cursor location. - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Remove sync point</guilabel></term> - <listitem> - <para></para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Audition</guilabel></term> - <listitem> - <para> - plays this region via the <glossterm linkend="gt-auditioner">auditioner</glossterm> - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Export</guilabel></term> - <listitem> - <para> - exports this region to a new audio file, via the export dialog (thus - allowing resampling, dithering, format specification etc.) - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Bounce</guilabel></term> - <listitem> - <para> - re-records this region (with any plugins/inserts applied) to a new audio - file, and replaces the region with one referring to the new file. - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Lock</guilabel></term> - <listitem> - <para> - prevents the region from being moved, trimmed, or modified in almost any - way. - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Unlock</guilabel></term> - <listitem> - <para> - removes the lock on region modification - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Mute</guilabel></term> - <listitem> - <para> - makes the region silent during playback - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Unmute</guilabel></term> - <listitem> - <para></para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Toggle envelope visibility</guilabel></term> - <listitem> - <para> - shows/hides the region gain envelope - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Toggle envelope active</guilabel></term> - <listitem> - <para> - turns the region gain envelope on/off (the line is gray when the - envelope is off, green when it is on) - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Original position</guilabel></term> - <listitem> - <para> - if the region was recorded (and Broadcast WAVE was the native file - format) moves the region to its original capture position - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Normalize</guilabel></term> - <listitem> - <para> - alters the gain processing of the region so that the loudest sample is - at 0dBFS - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>DeNormalize</guilabel></term> - <listitem> - <para> - undoes the effect of a normalize - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Reverse</guilabel></term> - <listitem> - <para> - writes the region to a new audio file with the contents reversed, and - replaces the region with one referring to the new file - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Nudge</guilabel></term> - <listitem> - <para> - moves the region in various ways - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Nudge fwd</guilabel></term> - <listitem> - <para> - moves the region forward by the amount shown in the nudge clock - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Nudge bwd</guilabel></term> - <listitem> - <para> - moves the region backward by the amount shown in the nudge clock - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Nudge fwd by capture offset</guilabel></term> - <listitem> - <para> - moves the region forward by the same offset that it might have been - (incorrectly) adjusted by when captured - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Nudge bwd by capture offset</guilabel></term> - <listitem> - <para> - moves the region backwards by the same offset that it might have been - (incorrectly) adjusted by when captured - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Trim</guilabel></term> - <listitem> - <para></para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Start to edit cursor</guilabel></term> - <listitem> - <para> - adjusts the start of the region to the current position of the edit - cursor (if possible) - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Edit cursor to end</guilabel></term> - <listitem> - <para> - adjusts the end of the region to the current position of the edit cursor - (if possible) - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Split</guilabel></term> - <listitem> - <para> - if the edit cursor is within the region, splits the region at the editor - cursor location - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Make mono regions</guilabel></term> - <listitem> - <para> - if the region is a multi-channel one, creates new regions corresponding - to each channel. The new regions are added to the editor's region list, - not the track. - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Duplicate</guilabel></term> - <listitem> - <para> - pops up a dialog allowing the region to be copied 1 or more times. Each - copy is placed directly after the original or previous copy. - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Fill Track</guilabel></term> - <listitem> - <para> - copies the region as many times as necessary to fill the track to the - current session end mark. Each copy is placed directly after the - original or previous copy. - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Remove</guilabel></term> - <listitem> - <para> - remove the region from the track (non-destructive) - </para> - </listitem> - </varlistentry> - - <varlistentry> - <term><guilabel>Destroy</guilabel></term> - <listitem> - <para> - remove the region from the track and the editor region list, and if no - other regions are referencing it, remove the audio file that the region - is derived from. ( <emphasis>DESTRUCTIVE</emphasis> ) - </para> - </listitem> - </varlistentry> - </variablelist> - </section> + <title>Working with Regions</title> + <para> + Regions are the basic elements of editing and composing in Ardour. Each + region represents a single, contiguous section of one or more audio + files. Regions are defined by a fixed set of attributes: + </para> + + <itemizedlist> + <listitem> + <para> + the source audio file(s) they represent + </para> + </listitem> + + <listitem> + <para> + a starting point in the audio file(s) + </para> + </listitem> + + <listitem> + <para> + a length + </para> + </listitem> + </itemizedlist> + + <para> + When placed into a + <glossterm linkend="gt-playlist">playlist</glossterm>, they gain + additional attributes: + </para> + + <itemizedlist> + <listitem> + <para> + a position along the timeline + </para> + </listitem> + + <listitem> + <para> + a layer + </para> + </listitem> + </itemizedlist> + + <para> + There are <emphasis>other attributes</emphasis> as well, but they do not + define the region. Things you should know about regions: + </para> + + <variablelist> + <title></title> + <varlistentry> + <term>Regions are Cheap</term> + <listitem> + <para> + By themselves, regions do not consume hardly any of your + computer's resources. Each region requires a small amount of + memory, and represents a rather small amount of CPU work if placed + into an active track. So, don't worry about creating regions + whenever you need to. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term>Regions are not audio files</term> + <listitem> + <para> + Although a region can represent an entire audio file, they are + never equivalent to an audio file. Most regions represent just + parts of an audio file(s) on disk, and removing a region from a + track has nothing to do with removing the audio file(s) from the + disk ((the <emphasis>Destroy</emphasis> operation, one of Ardour's + few destructive operations, can affect this)). Changing the length + of a region has no effect on the audio file(s) on disk. Splitting + and copying regions does not alter the audio file in anyway, nor + does it create new audio files ((the <emphasis>Export</emphasis> , + <emphasis>Bounce</emphasis> and <emphasis>Reverse</emphasis> + operations do create new audio files)). + </para> + </listitem> + </varlistentry> + </variablelist> + + <section id="region-naming"> + <title>Region Naming</title> + <para> + Regions are initially named using either: + </para> + + <itemizedlist> + <listitem> + <para> + the name of the playlist for which they were recorded + </para> + </listitem> + + <listitem> + <para> + the name of the embedded/imported audio file they represent + </para> + </listitem> + </itemizedlist> + + <section id="whole-file-region-names"> + <title>Whole File Region Names</title> + <para> + These are not audio files, but regions that represent the full + extent of an audio file. Every time a new recording is done, or a + new file is embedded/imported, a new region is created that + represents the entire audio file(s) This region will have the name + of the playlist/original file, followed by a "-" and then a number. + </para> + + <para> + For recorded regions, the number will increase each time a new + recording is made. So, for example, if there is a playlist called + "Didgeridoo", the first recorded whole file region for that playlist + will be called "Digderidoo-1". The next one will be "Digeridoo-2" + and so on. + </para> + + <para> + For imported/embedded files, the region name will be based on the + file name, but with any final suffix (e.g. ".wav" or ".aiff") + removed. + </para> + + <para> + Normally, whole file regions are not inserted into tracks/playlists, + but regions derived from them are. The whole-file versions live in + the editor region list where they act as an organizing mechanism for + regions that are derived from them. + </para> + </section> + + <section id="normal-region-names"> + <title>Normal Region Names</title> + <para> + When a region is inserted into a track/playlist, its initial name + will end in a version number, such as ".1" or ".103". For a recorded + region, if the whole file region was "Hang drum-1", then the region + in the track will appear with the name "Hang drum-1.1". For an + imported/embedded region, if the whole file region was + "Bach:Invention3", then the region in the track will appear with the + name "Bach:Invention3.1". + </para> + </section> + + <section id="copied-region-names"> + <title>Copied Region Names</title> + <para> + If the region is a copy of another region, it will begin life with + the same name as the original. When an operation is carried out that + modifies one of the copies, that particular copy will be renamed by + incrementing the version number. + </para> + </section> + + <section id="renaming-regions"> + <title>Renaming Regions</title> + <para> + You can rename a region at any time. Use the <emphasis>region + context menu</emphasis> to popup the rename dialog. The new name + does not need to have a version number in it (in fact, it probably + should not). The region will retain its name until it is modified + after being copied. + </para> + </section> + </section> + + <section id="selecting-regions"> + <title>Selecting Regions</title> + <para> + In general, operations on regions apply to whichever regions are + currently <emphasis>selected</emphasis> . + </para> + + <para> + To select a single region, click on it using + <mousebutton>Button1</mousebutton>. + </para> + + <para> + To add an unselected region to the currently selected regions, click + on it using + <keycombo><keycap>Shift</keycap><mousebutton>Button1</mousebutton></keycombo>. + </para> + + <para> + To remove a selected region from the currently selected regions, click + on it using + <keycombo><keycap>Shift</keycap><mousebutton>Button1</mousebutton></keycombo>. + </para> + </section> + + <section id="removing-regions"> + <title>Removing Regions</title> + <para> + Select the region(s) to be removed. Then press the "Delete" key or use + the standard key binding for "Cut" ( + <keycombo><keycap>Ctrl</keycap><keycap>X</keycap></keycombo> by + default). + </para> + + <para> + Note that "removing" a region is a non-destructive operation. It has + no effect on the audio file(s) stored on disk. If you really want to + destructively remove the region, use the context menu for the region + which has a "Destroy" item. This is not guaranteed to remove the audio + file from your disk storage, but it generally will. + </para> + </section> + + <section id="moving-regions"> + <title>Moving Regions</title> + <para> + To move a region, make sure you are in <emphasis>object</emphasis> + mouse mode. Move the mouse pointer into the waveform display part of + the region, press <mousebutton>Button1</mousebutton> and drag. The + region will follow the mouse pointer as you move it around. By + default, the region can move freely along the timeline - see + <xref linkend="sn-snap-settings"/> for information on how to force the + region to align to certain kinds of points along the timeline. + </para> + + <para> + To move a region from one track to another, simply start a move as + described above, but move the mouse pointer into the desired track. + The region will follow the mouse pointer. Note that if you have other + kinds of "tracks" visible, the region will remain where it is as the + mouse pointer moves across them, and will then jump to the new track. + This serves as a visual reminder that you cannot drag an audio region + into an automation track or a bus, for example. + </para> + + <section id="moving-more-than-one-region"> + <title>Moving more than one region</title> + <para> + To move multiple regions, select them before moving. Then click+drag + on one of the selected regions. All the regions will move, keeping + their positions relative to each other. + </para> + </section> + + <section id="region-fixed-time-motion"> + <title>Fixed-time motion</title> + <para> + Sometimes, you want to move a region to another track, but keeping + its position along the timeline exactly the same. To do this, use + <mousebutton>Button2</mousebutton> rather than + <mousebutton>Button1</mousebutton>. + </para> + </section> + </section> + + <section id="copying-regions"> + <title>Copying Regions</title> + <para> + To copy a region, make sure you are in <emphasis>object</emphasis> + mouse mode. Move the mouse pointer into the waveform press the + <keycap>Ctrl</keycap> key, keep it down while pressing + <mousebutton>Button1</mousebutton> and drag. A new region is created + and will follow the mouse pointer as it moves. See + <xref linkend="moving-regions"/> for more details on moving the copied + region around. + </para> + + <section id="copying-more-than-one-region"> + <title>Copying more than one region</title> + <para> + To copy multiple regions, select them before copying. Then + click+drag on one of the selected regions. All the regions will be + copied and as they move, the will keep their positions relative to + each other. + </para> + </section> + + <section id="region-fixed-time-copying"> + <title>Fixed-time copying</title> + <para> + If you want to copy region(s) to other track(s) but keep the copies + at the exact position on the timeline as the originals, simply use + <keycombo><keycap>Ctrl</keycap><mousebutton>Button2</mousebutton></keycombo> + instead of + <keycombo><keycap>Ctrl</keycap><mousebutton>Button1</mousebutton></keycombo>. + </para> + </section> + </section> + + <section id="trimming-regions"> + <title>Trimming Regions</title> + <para></para> + </section> + + <section id="auditioning-regions"> + <title>Auditioning Regions</title> + <para></para> + </section> + + <section id="region-gain-envelopes"> + <title>Region Gain Envelopes</title> + <para></para> + </section> + + <section id="region-context-menu"> +<!-- needs work --> + <title>Region Context Menu</title> + <para> + If you context-click on a region, a popup menu will appear. At or near + the top of that menu is a list of all regions that exist in the + clicked-upon track under the mouse pointer. Each region entry (shown + by name) points to a submenu that contains region-specific operations: + </para> + + <variablelist> + <title></title> + <varlistentry> + <term><guilabel>Popup region editor</guilabel></term> + <listitem> + <para> + creates and displays the editor for this region, allowing even + more specific control over the region than this menu + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Raise to top layer</guilabel></term> + <listitem> + <para> + moves the region to the top layer of this track (works only in + "Most recently added/moved/trimmed regions are higher" + <emphasis>layer mode</emphasis> + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Lower to bottom layer</guilabel></term> + <listitem> + <para> + moves the region to the bottom layer of this track (works only + in "Most recently added/moved/trimmed regions are higher" + <emphasis>layer mode</emphasis> + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Define sync point</guilabel></term> + <listitem> + <para> + if the edit cursor is within this region, defines the region + sync point at the edit cursor location. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Remove sync point</guilabel></term> + <listitem> + <para></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Audition</guilabel></term> + <listitem> + <para> + plays this region via the + <glossterm linkend="gt-auditioner">auditioner</glossterm> + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Export</guilabel></term> + <listitem> + <para> + exports this region to a new audio file, via the export dialog + (thus allowing resampling, dithering, format specification etc.) + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Bounce</guilabel></term> + <listitem> + <para> + re-records this region (with any plugins/inserts applied) to a + new audio file, and replaces the region with one referring to + the new file. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Lock</guilabel></term> + <listitem> + <para> + prevents the region from being moved, trimmed, or modified in + almost any way. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Unlock</guilabel></term> + <listitem> + <para> + removes the lock on region modification + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Mute</guilabel></term> + <listitem> + <para> + makes the region silent during playback + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Unmute</guilabel></term> + <listitem> + <para></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Toggle envelope visibility</guilabel></term> + <listitem> + <para> + shows/hides the region gain envelope + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Toggle envelope active</guilabel></term> + <listitem> + <para> + turns the region gain envelope on/off (the line is gray when the + envelope is off, green when it is on) + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Original position</guilabel></term> + <listitem> + <para> + if the region was recorded (and Broadcast WAVE was the native + file format) moves the region to its original capture position + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Normalize</guilabel></term> + <listitem> + <para> + alters the gain processing of the region so that the loudest + sample is at 0dBFS + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>DeNormalize</guilabel></term> + <listitem> + <para> + undoes the effect of a normalize + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Reverse</guilabel></term> + <listitem> + <para> + writes the region to a new audio file with the contents + reversed, and replaces the region with one referring to the new + file + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Nudge</guilabel></term> + <listitem> + <para> + moves the region in various ways + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Nudge fwd</guilabel></term> + <listitem> + <para> + moves the region forward by the amount shown in the nudge clock + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Nudge bwd</guilabel></term> + <listitem> + <para> + moves the region backward by the amount shown in the nudge clock + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Nudge fwd by capture offset</guilabel></term> + <listitem> + <para> + moves the region forward by the same offset that it might have + been (incorrectly) adjusted by when captured + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Nudge bwd by capture offset</guilabel></term> + <listitem> + <para> + moves the region backwards by the same offset that it might have + been (incorrectly) adjusted by when captured + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Trim</guilabel></term> + <listitem> + <para></para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Start to edit cursor</guilabel></term> + <listitem> + <para> + adjusts the start of the region to the current position of the + edit cursor (if possible) + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Edit cursor to end</guilabel></term> + <listitem> + <para> + adjusts the end of the region to the current position of the + edit cursor (if possible) + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Split</guilabel></term> + <listitem> + <para> + if the edit cursor is within the region, splits the region at + the editor cursor location + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Make mono regions</guilabel></term> + <listitem> + <para> + if the region is a multi-channel one, creates new regions + corresponding to each channel. The new regions are added to the + editor's region list, not the track. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Duplicate</guilabel></term> + <listitem> + <para> + pops up a dialog allowing the region to be copied 1 or more + times. Each copy is placed directly after the original or + previous copy. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Fill Track</guilabel></term> + <listitem> + <para> + copies the region as many times as necessary to fill the track + to the current session end mark. Each copy is placed directly + after the original or previous copy. + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Remove</guilabel></term> + <listitem> + <para> + remove the region from the track (non-destructive) + </para> + </listitem> + </varlistentry> + + <varlistentry> + <term><guilabel>Destroy</guilabel></term> + <listitem> + <para> + remove the region from the track and the editor region list, and + if no other regions are referencing it, remove the audio file + that the region is derived from. ( + <emphasis>DESTRUCTIVE</emphasis> ) + </para> + </listitem> + </varlistentry> + </variablelist> + </section> <!-- <xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="Some_Subsection.xml" /> |