X-Git-Url: http://shamusworld.gotdns.org/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=include%2Fgrid-controls.html;h=fee3dd0704af99d6afcf0c2d69333d8aefc3a0b0;hb=8784c09ee467dad5cc148876bfb2e780d40132c0;hp=5b60ae208cd82cb9a244d63612f88fbd44ae2c14;hpb=7349ebd9e930453ecbba8167ecc18104bc778be9;p=ardour-manual diff --git a/include/grid-controls.html b/include/grid-controls.html index 5b60ae2..fee3dd0 100644 --- a/include/grid-controls.html +++ b/include/grid-controls.html @@ -1,27 +1,62 @@ -Editor toolbar's grid +

What is “Snap” and “Grid”?

+
+ Editor toolbar's grid +
+ Editor toolbar's grid. +
+
+ +

+“Snap” will cause drags and other mouse-driven operations to jump to +positions determined by the nearest snap setting. Snap can be set to +multiple options: markers, region start/ends, and the grid (those +are all enabled by default. change them in prefs). +

+

+Grid can be enabled, and it will draw lines at selected intervals; +which can be musical, like 16th notes, or can be timecode based +(minutes and seconds). You can leave the Grid enabled, but snap +disabled, if you just want to see the lines but not snap to them. +

+

+For example: if the Grid is set to “beats” and Snap-to-grid is +enabled, then any operations such as split, paste, or range-select +will happen exactly on a beat, according to the musical timeline and +tempo. +

- Ardour's editor utilizes a grid to assist in the placement of regions - on the timeline, or with editing functions that need to happen at a specific - point in time. This snapping of the cursor and various objects to the - grid can be toggled on or off, as does its behaviour, and grid units. +Alternatively, you can leave “Snap” enabled (so your mouse actions +can snap to Markers, or region edges) but disable the Grid. +

+ +

A Warning, of sorts

+ +

+The grid consist of lines running vertically in the edit canvas. If +you zoom too far out, you might see a coarser grid than you +expect. Ardour tries not to show “too many” or “too few” grid lines +depending on the zoom level. You might find that items snap in-between +the grid lines sometimes. That’s expected behavior. If you can’t see +or snap to the grid you’d like to use, you may have to zoom in or out.

About Snapping

- There are two ways to think about aligning material to a grid. The first and - most obvious one is where an object's position is clamped to grid lines. In - Ardour, this is called absolute snap and is commonly used when - working with sampled material where audio begins exactly at the beginning of a - file, note or region. + There are two ways to think about aligning material. The first and + most obvious one is where an object's position is clamped to the + snap positions. In Ardour, this is called absolute snap + and is commonly used when working with sampled material where audio + begins exactly at the beginning of a file, note or region.

- The second, relative snap, is used when an object's position relative - to the grid lines is important. In music, this allows to move objects around - without changing the "feel" (or timing) of a performance. + The second, relative snap, is used when an object's + position relative to the snap positions is important. In music, this + allows to move objects around without changing the "feel" (or + timing) of a performance.

@@ -48,7 +83,7 @@

- The realtive snap and snap modifiers (along with other modifier keys) may be set + The relative snap and snap modifiers (along with other modifier keys) may be set in Edit > Preferences > User Interaction

@@ -58,7 +93,7 @@ otherwise unused key. For example, the snap modifier may be chosen to be the key and the relative snap modifier to be the and keys. -

. +

Snap Modes

@@ -67,14 +102,14 @@ to the grid:

-
-
No Grid
-
disables the grid. All objects move freely in this mode.
+ + + + + + + +
No Griddisables the grid. All objects move freely in this mode.
In No Grid mode, the grid may be temporarily activated by pressing the snap modifier (for absolute snap) or switch to relative snap - by pressing the relative snap modifier. -
Grid
-
activates normal snapping. All positions of objects snap to the grid. (See + by pressing the relative snap modifier.
Gridactivates normal snapping. All positions of objects snap to the grid. (See Grid Units below to change the grid). Moving an object in "Grid"-mode, does not change its position until the mouse is far enough for the object to reach the next grid line.
@@ -85,16 +120,16 @@ New objects will always be created at grid points.
Holding down the snap modifier will disable the current grid - setting and allow you to move the object freely. -
Magnetic
-
is a less strict type of snapping. Objects can still be moved to any + setting and allow moving the object freely.
Magneticis a less strict type of snapping. Objects can still be moved to any position, but positions close to the relative or absolute grid points will snap. In order to move an object very close to a snap point, it may be necessary to zoom in to prevent snapping to that point, or to use the snap modifier to disable snap completely.
As with Grid mode, the snap modifier will disable snap completely while the absolute snap modifier will move the "notch" of - Magnetic snap to the grid lines. - + Magnetic snap to the grid lines.

Syncing Regions to the Grid

@@ -112,30 +147,30 @@ elements. The grid can be set to several different units:

-
-
CD Frames
-
A CD Frame is 1/75th of a second. Snapping to CD Frames (using absolute snap) can be used to avoid issues with CD track lengths.
-
Timecode Frames/Seconds/Minutes
-
The duration of a frame depends on the timecode settings for the session.
-
Seconds/Minutes
-
These are absolute time units, unaffected by sample rate or timecode settings
-
Beats/N
-
Set the grid to units of 1/N beats, where N can be 128, 64, 32, 16, 8, 7, 6, 5, 4, 3, 2. The duration of a grid unit will depend on the tempo and meter in effect at that point in the timeline.
-
Beats
-
Set the grid to whole beats. The duration of a grid unit will depend on the tempo and meter in effect at that point in the timeline.
-
Bars
-
Set the grid to whole bars. The duration of a grid unit will depend on the tempo and meter in effect at that point in the timeline.
-
Markers
-
The grid lines are the markers.
-
Region Starts
-
The grid lines are constructed from region start points (see below).
-
Region Ends
-
The grid lines are constructed from region end points (see below).
-
Region Syncs
-
The grid lines are constructed from region sync points.
-
Region Bounds
-
The grid lines are constructed from region start or end points.
-
+ + + + + + + + + + + + + + + + + + + + + + + +
CD FramesA CD Frame is 1/75th of a second. Snapping to CD Frames (using absolute snap) can be used to avoid issues with CD track lengths.
Timecode Frames/Seconds/MinutesThe duration of a frame depends on the timecode settings for the session.
Seconds/MinutesThese are absolute time units, unaffected by sample rate or timecode settings
Beats/NSet the grid to units of 1/N beats, where N can be 128, 64, 32, 16, 8, 7, 6, 5, 4, 3, 2. The duration of a grid unit will depend on the tempo and meter in effect at that point in the timeline.
BeatsSet the grid to whole beats. The duration of a grid unit will depend on the tempo and meter in effect at that point in the timeline.
BarsSet the grid to whole bars. The duration of a grid unit will depend on the tempo and meter in effect at that point in the timeline.
MarkersThe grid lines are the markers.
Region StartsThe grid lines are constructed from region start points (see below).
Region EndsThe grid lines are constructed from region end points (see below).
Region SyncsThe grid lines are constructed from region sync points.
Region BoundsThe grid lines are constructed from region start or end points.

To use Region starts/ends/syncs/bounds as snap choices, it is necessary to have either: @@ -156,3 +191,4 @@ unusable. This option should not be used in conjunction with the use any of the Region grid units.

+