summaryrefslogtreecommitdiff
path: root/manual/xml/editing_concepts.xml
diff options
context:
space:
mode:
Diffstat (limited to 'manual/xml/editing_concepts.xml')
-rw-r--r--manual/xml/editing_concepts.xml341
1 files changed, 341 insertions, 0 deletions
diff --git a/manual/xml/editing_concepts.xml b/manual/xml/editing_concepts.xml
new file mode 100644
index 0000000000..c73bb00c2a
--- /dev/null
+++ b/manual/xml/editing_concepts.xml
@@ -0,0 +1,341 @@
+<?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="sn-editing-concepts">
+ <title>Editing Concepts</title>
+ <para>
+ In Ardour, "editing" describes the process of
+ </para>
+
+ <itemizedlist>
+ <listitem>
+ <para>
+ making modifications to playlists. Recall that
+ <glossterm linkend="gt-playlist">playlists</glossterm> are nothing
+ more than lists of
+ <glossterm linkend="gt-region">regions</glossterm> arranged over
+ time.
+ </para>
+ </listitem>
+
+ <listitem>
+ <para>
+ recording/modifying automation data
+ </para>
+ </listitem>
+ </itemizedlist>
+
+ <section id="editing-cut-copy-paste">
+ <title> Cut/Copy/Paste </title>
+ <para></para>
+ </section>
+
+ <section id="sn-snap-settings">
+ <title>Snap Settings</title>
+ <para>
+ By default, when you move objects around, they move freely. There
+ <emphasis>is</emphasis> a "granularity" to the motion, but it is a
+ single audio frame (so typically on the order of 1/48000'th or
+ 1/96000'th of a second), and at most zoom levels it will not be
+ apparent in any way.
+ </para>
+
+ <para>
+ However, this is not always the way you want to move some kinds of
+ objects. If you are working with structured compositions that utilize
+ traditional concepts of bars, beats, rythmn and so forth, you will
+ often want to move regions so that that they always align to specific
+ periodic time points that correspond to the start of a bar, or a beat
+ etc. If you are working on a movie soundtrack, you may prefer to have
+ regions always align to SMPTE frames, or perhaps even to whole
+ seconds.
+ </para>
+
+ <para>
+ Ardour provides a wide variety of "snap" settings. If any but "None"
+ is selected, they define a grid of timepoints which will be used to
+ "snap" object positions as they are dragged. The grid can be regular
+ (as is the case if you choose "Beats", for example), or it can be
+ completely irregular (if you choose "Marks", for example). It can even
+ consist of a <emphasis>single</emphasis> timepoint (if you choose
+ "Edit cursor", for example).
+ </para>
+
+ <variablelist>
+ <title> Possible Snap Settings </title>
+ <varlistentry>
+ <term><guilabel>None</guilabel></term>
+ <listitem>
+ <para>
+ no alignment used at all
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel> CD Frames</guilabel></term>
+ <listitem>
+ <para>
+ align to 1/75th of a second intervals, as defined by the
+ "Redbook" Audio CD standards
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel> SMPTE Frames</guilabel></term>
+ <listitem>
+ <para>
+ align to whatever the current SMPTE frame interval is (defined
+ in the options editor)
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel> SMPTE Seconds</guilabel></term>
+ <listitem>
+ <para>
+ align to whole seconds, adjusted to account for any SMPTE start
+ offset
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel> SMPTE Minutes</guilabel></term>
+ <listitem>
+ <para>
+ align to whole minutes, adjust to account for any SMPTE start
+ offset
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel> Seconds</guilabel></term>
+ <listitem>
+ <para>
+ align to whole seconds
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel> Minutes</guilabel></term>
+ <listitem>
+ <para>
+ align to whole minutes
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel> Beats/32</guilabel></term>
+ <listitem>
+ <para>
+ align to 1/32 divisions of the beat
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel> Beats/16</guilabel></term>
+ <listitem>
+ <para>
+ align to 1/16 divisions of the beat
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel> Beats/8</guilabel></term>
+ <listitem>
+ <para>
+ align to 1/8 divisions of the beat
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel> Beats/4</guilabel></term>
+ <listitem>
+ <para>
+ align to 1/4 divisions of the beat
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel> Beats/3</guilabel></term>
+ <listitem>
+ <para>
+ align to 1/3 divisions of the beat
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel> Beats</guilabel></term>
+ <listitem>
+ <para>
+ align to beats
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel> Bars</guilabel></term>
+ <listitem>
+ <para>
+ align to the start of bars
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel> Marks</guilabel></term>
+ <listitem>
+ <para>
+ align to the nearest mark of some kind
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel> Edit Cursor</guilabel></term>
+ <listitem>
+ <para>
+ align to the current position of the edit cursor
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel> Region starts</guilabel></term>
+ <listitem>
+ <para>
+ align to the nearest start of a region in the (first) selected
+ track
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel> Region ends</guilabel></term>
+ <listitem>
+ <para>
+ align to the nearest end of a region in the (first) selected
+ track
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel> Region syncs</guilabel></term>
+ <listitem>
+ <para>
+ align to the nearest region sync point in the (first) selected
+ track
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><guilabel> Region bounds </guilabel></term>
+ <listitem>
+ <para>
+ align to the nearest region start or end in the (first) selected
+ track
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+
+ <section id="changing-snap-settings">
+ <title> To change snap settings </title>
+ <para>
+ Move the mouse pointer to the toolbar panel of the editor window.
+ Click on the "expansion arrow" of the "Snap setting" chooser. This
+ will popup a list of available snap settings. If necessary, scroll
+ down to see your desired choice. Click on your choice in the list to
+ dismiss it and make Ardour switch to the new setting.
+ </para>
+
+ <note>
+ <para>
+ Changing snap settings has <emphasis>no</emphasis> effect on the
+ position of any existing region. Its effect is only on objects
+ being moved.
+ </para>
+ </note>
+ <tip>
+ <para>
+ The snap setting also affects moving the playhead, the edit
+ cursor, loop/punch and location markers, and dragging/moving range
+ selections.
+ </para>
+ </tip>
+ </section>
+
+ <section id="snap-mode">
+ <title> Snap Mode </title>
+ <para>
+ There are two subtly different ways in which the snap setting can
+ affect region motion:
+ </para>
+
+ <variablelist>
+ <title></title>
+ <varlistentry>
+ <term>normal snap mode</term>
+ <listitem>
+ <para>
+ regions can only be moved to positions defined by the snap
+ setting. It is not possible to move them to intermediate
+ positions.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>magnetic snap mode</term>
+ <listitem>
+ <para>
+ regions can still be moved to positions not defined by the
+ setting, but they "stick" to the timepoints that are when
+ dragged across them. Imagine that the timepoints and the
+ regions are magnetic - or just try it and see.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+
+ <para>
+ However, you can press the <emphasis>snap modifier</emphasis> key
+ while dragging, and the snap setting will be ignored. By default,
+ this is the key on your keyboard that generates
+ <emphasis>Mod3</emphasis> , but you can modify this from the
+ <emphasis>Options Editor</emphasis> keyboard tab.
+ </para>
+ </section>
+
+ <section id="changing-snap-mode">
+ <title> To change snap mode </title>
+ <para>
+ Move the mouse pointer to the toolbar panel of the editor window.
+ Click on the "expansion arrow" of the "Snap mode" chooser. This will
+ popup a list of available snap settings. If necessary, scroll down
+ to see your desired choice. Click on your choice in the list to
+ dismiss it and make Ardour switch to the new setting.
+ </para>
+ </section>
+ </section>
+<!--
+ <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
+ href="Some_Subsection.xml" />
+ -->
+</section>