From 4c1590e505f3c47ef0f2783f64dc074338a82f17 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=B6rn=20Nettingsmeier?= Date: Wed, 5 Feb 2014 11:19:59 +0100 Subject: [PATCH] copy-editing chapter 8. --- STYLE_GUIDE | 8 ++ _manual/08_working-with-regions.html | 54 +++++--- .../01_region-naming.html | 81 ++++++++--- .../02_region-selection-equivalence.html | 46 +++++-- .../03_region-context-menu.html | 128 ++++++++++-------- source/css/app.css | 22 ++- 6 files changed, 229 insertions(+), 110 deletions(-) diff --git a/STYLE_GUIDE b/STYLE_GUIDE index 278c65a..7d2dad4 100644 --- a/STYLE_GUIDE +++ b/STYLE_GUIDE @@ -270,3 +270,11 @@ https://developer.gnome.org/hig-book/3.6/design-text-labels.html.en#layout-capit * Do not capitalize concepts in the text body, with the possible exceptions of _the_ Editor and _the_ Mixer. + +5.4 Janitorial tasks/review +--------------------------- + +If you encounter something that is unclear or patent nonsense, but you are +not bold or knowledgeable to fix it, express your doubts with an

editorial note

, so that readers will be warned and fellow +editors know where there's work to do. diff --git a/_manual/08_working-with-regions.html b/_manual/08_working-with-regions.html index 03c391b..49ea835 100644 --- a/_manual/08_working-with-regions.html +++ b/_manual/08_working-with-regions.html @@ -3,29 +3,51 @@ layout: default title: Working With Regions --- - - -

Working With Regions

-

Regions are the basic elements of editing and composing in Ardour. In most cases, a region represents a single contiguous section of one or more media files. Regions are defined by a fixed set of attributes:

+

Working With Regions

+

+ Regions are the basic elements of editing and composing in + Ardour. In most cases, a region represents a single contiguous section + of one or more media files. Regions are defined by a fixed set of attributes: +

-

When placed into a playlist, they gain additional attributes:

+

+ When placed into a playlist, they gain additional attributes: +

-

There are other attributes as well, but they do not define the region. Things you should know about regions:

+

+ There are other attributes as well, but they do not define the + region. Things you should know about regions: +

Regions Are Cheap

-

By themselves, regions consume very little 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.

+

+ By themselves, regions consume very little 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. +

Regions Are Not Files

-

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 Destroy 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 (only recording, and the Export, Bounce and Reverse operations create new audio files).

+

+ 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 Destroy 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 (only + recording, + and the Export, Bounce and + Reverse operations create new audio files).

{% children %} diff --git a/_manual/08_working-with-regions/01_region-naming.html b/_manual/08_working-with-regions/01_region-naming.html index 9b20267..1ebbdd9 100644 --- a/_manual/08_working-with-regions/01_region-naming.html +++ b/_manual/08_working-with-regions/01_region-naming.html @@ -2,28 +2,67 @@ layout: default title: Region Naming --- - - - -

Regions are initially named using either:

+

Region names are initially derived from either

-

Whole File Region Names

-

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 track/playlist/original file, followed by a "-" and then a number plus a dot and then a number.

-

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.

-

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.

-

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.

-

Normal Region Names

-

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".

-

Copied Region Names

-

If you copy a region, it initially shares the same name as the original. When you perform an operation modifies one of the copies, Ardour will increment the version number on the particular copy that changed.

-

Renaming Regions

-

You can rename a region at any time. Use the region context menu to popup the Rename dialog. The new name does not need to have a version number in it (in fact, it probably should not). Ardour will add a version number in the future if needed (e.g. if you copy or split the region).

+

+ It appears that recorded regions are always named after the track, not the + active playlist in that track. +

+ +

Whole File Region Names

+

+ 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 imported + to the session, a new region is created that represents the entire audio + file. This region will have the name of the track/playlist/original file, + followed by a "-", then a number plus a dot and then a number. +

+

+ 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. +

+

+ For imported regions, the region name will be based on the original file + name, but with any final suffix (e.g. ".wav" or ".aiff") removed. +

+

+ Normally, whole file regions are not inserted into tracks or 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. +

+ +

Normal Region Names

+

+ When a region is inserted into a track and playlist, its initial name will + end in a version number, such as .1. 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 region, if the whole file region was Bach:Invention3, + then the region in the track will appear with the name + Bach:Invention3.1. +

+ +

Copied Region Names

+

+ If you copy a region, it initially shares the same name as the original. + When you perform an operation modifies one of the copies, Ardour will + increment the version number on the particular copy that changed. +

+ +

Renaming Regions

+

+ You can rename a region at any time. Use the region context menu to + pop up the Rename dialog. The new name does not need to + have a version number in it (in fact, it probably should not). Ardour will add a + version number in the future if needed (e.g. if you copy or split the region). +

diff --git a/_manual/08_working-with-regions/02_region-selection-equivalence.html b/_manual/08_working-with-regions/02_region-selection-equivalence.html index eea654b..13f3f9c 100644 --- a/_manual/08_working-with-regions/02_region-selection-equivalence.html +++ b/_manual/08_working-with-regions/02_region-selection-equivalence.html @@ -1,22 +1,46 @@ --- layout: default -title: Region Selection Equivalence +title: Equivalent Region Selection --- - - -

Track Groups have a property titled "Select" which, if enabled, Ardour to tries to propagate a region selection in one of a group's member tracks to the other members of the group..

-

For example, let's assume you have used multiple microphones to record a drum kit to multiple tracks. You have created a track group, added all the drum tracks, enabled the group and enabled the "Select" property for the group. When you select a region in one of the drum tracks, Ardour will select the corresponding track in every other drum track, which in turn means that a subsequent edit operation will affect all the selected regions (and thus all the drum tracks) together.

+

+ Track Groups have + a property titled Select which, if enabled, cause + Ardour to propagate a region selection in one track of a group to the + equivalent regions of the other tracks in that group. +

+

+ For example, let's assume you have used multiple microphones to record a + drum kit to multiple tracks. You have created a track group, added all the + drum tracks, enabled the group and enabled the Select property for the group. + When you select a region in one of the drum tracks, Ardour will select the + corresponding region in every other drum track, which in turn means that a + subsequent edit operation will affect all the drum tracks together. +

How Ardour Decides Which Regions are "Equivalent"

-

Regions in different tracks are considered to be equivalent for the purposes of sharing "selection" if they satisfy all the following criteria:

+

+ Regions in different tracks are considered to be equivalent for the purposes + of sharing selection if they satisfy all the following criteria: +

    -
  1. Each region starts at the same offset within its source file
    2. -
  2. Each region is located at the same position on the timeline
    3. -
  3. Each region has the same length
    4. +
  4. Each region starts at the same offset within its source file,
    5. +
  5. each region is located at the same position on the timeline, and
    6. +
  6. each region has the same length.

Overlap Equivalence

-

Sometimes, the rules outlined above are too strict to get Ardour to do what you want. Regions may be slightly different lengths, or positioned slightly differently, and this will cause Ardour to not select regions in other grouped tracks.

-

In this case, enable Edit > Preferences > Editor > Use overlap equivalency for regions. With this option enabled, regions in different tracks will be considered equivalent for the purposes of selection if they overlap. This is much more flexible and will cover almost all of the cases that the fixed rules above might make cumbersome.

+

+ Sometimes, the rules outlined above are too strict to get Ardour to do what you + want. Regions may have been trimmed to slightly different lengths, or positioned + slightly differently, and this will cause Ardour to not select regions in other + grouped tracks.

+

+ In this case, enable + Edit > Preferences > Editor > Use overlap equivalency for + regions. With this option enabled, regions in different tracks will be + considered equivalent for the purposes of selection if they + overlap. This is much more flexible and will cover almost all of the + cases that the fixed rules above might make cumbersome. +

diff --git a/_manual/08_working-with-regions/03_region-context-menu.html b/_manual/08_working-with-regions/03_region-context-menu.html index ff9cf95..2b8a473 100644 --- a/_manual/08_working-with-regions/03_region-context-menu.html +++ b/_manual/08_working-with-regions/03_region-context-menu.html @@ -3,64 +3,78 @@ layout: default title: Region Context Menu --- - - -

In the editor window, right clicking (context clicking) on a region displays a menu with many region operations. The menu begins with the name of the region, or "Selected Regions" if multiple regions are selected.

-

If there is more than one region layered at the point where you clicked, the menu will also contain an item "Choose Top." The "Choose Top" dialog lets you select which layer you want on top. See Adjusting Region Layering for more details.

-

Below these items is the rest of the Track Context Menu, which provides access to track-level operations. To see the region context menu's contents, select the region name or "Selected Regions", and the following submenu structure appears:

+

+ In the editor window, right clicking (context clicking) on a region + displays a menu with track and region operations. The menu begins with the + name of the region, or Selected Regions if multiple + regions are selected. +

+

+ If there is more than one region layered at the point where you clicked, the + menu will also contain an item Choose Top. This + dialog lets you select which region you want on the top layer. See + Adjusting Region Layering for more details. +

+

+ Below these items is the rest of the + Track Context Menu, which + provides access to track-level operations. To see the contents + of the region context menu, select the region name or "Selected Regions", and + the following submenu structure appears: +

-
Play
-
-
Loop
-
-
Properties
-
-
Rename
-
-
Edit
-
-
-
Combine
-
-
Uncombine
-
-
Split
-
-
Make Mono Regions
-
-
Opaque
-
-
Mute
-
-
Pitch Shift
-
-
Reverse
-
-
Close Gaps
-
-
Place Transients
-
-
Rhythm Ferret
-
-
Strip Silence
-
-
-
-
Position
-
-
-
Move To Original Position
-
-
Lock
-
-
Glue to Bars and Beats
-
-
Snap Position to Grid
-
-
Set Sync Position
-
-
Remove Sync
-
+
Play
+
+
Loop
+
+
Properties
+
+
Rename
+
+
Edit
+
+
+
Combine
+
+
Uncombine
+
+
Split
+
+
Make Mono Regions
+
+
Opaque
+
+
Mute
+
+
Pitch Shift
+
+
Reverse
+
+
Close Gaps
+
+
Place Transients
+
+
Rhythm Ferret
+
+
Strip Silence
+
+
+
+
Position
+
+
+
Move To Original Position
+
+
Lock
+
+
Glue to Bars and Beats
+
+
Snap Position to Grid
+
+
Set Sync Position
+
+
Remove Sync
+
Nudge Later
Nudge Earlier
diff --git a/source/css/app.css b/source/css/app.css index 3fb82b5..5506111 100644 --- a/source/css/app.css +++ b/source/css/app.css @@ -328,8 +328,6 @@ kbd.option:after,kbd.optoff:after { font-weight:lighter; text-align:center; border:solid 1px black; - -moz-border-radius:10px; - border-radius:10px; margin-left:0.3em; } kbd.option:after { @@ -408,17 +406,19 @@ samp:after { float:left; } -#content .note,.warning { +#content .note,.warning,.fixme { min-height: 20px; padding: 19px; margin-bottom: 20px; - border: 1px solid + border-style: solid; + border-width: 1px 1px 1px 8px; -webkit-border-radius: 4px; -moz-border-radius: 4px; border-radius: 4px; -webkit-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.05); -moz-box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.05); box-shadow: inset 0 1px 1px rgba(0, 0, 0, 0.05); + } #content .note { @@ -427,10 +427,22 @@ samp:after { } #content .warning { - border-color: #990000; + border-color: #995555; background-color: #ffeeee; } +#content .fixme { + border-color: #999944; + background-color: #f0f0e0; +} + +.fixme:before { + content:'FIXME: '; + font-weight: bold; + font-style: italic; +} + + .mod1:before {