diff options
Diffstat (limited to 'manual/xml/editing_concepts.xml')
-rw-r--r-- | manual/xml/editing_concepts.xml | 327 |
1 files changed, 327 insertions, 0 deletions
diff --git a/manual/xml/editing_concepts.xml b/manual/xml/editing_concepts.xml new file mode 100644 index 0000000000..354ef8db95 --- /dev/null +++ b/manual/xml/editing_concepts.xml @@ -0,0 +1,327 @@ +<?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> |