]>
<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" />
projects / ardour.git / blobdiff