From c9ea791d60010cc2ffb48ae39c19122e9ebca6e9 Mon Sep 17 00:00:00 2001 From: Ed Ward Date: Tue, 22 Jan 2019 15:09:25 +0100 Subject: [PATCH] Documenting the Region Properties dialog --- include/region-properties.html | 119 ++++++++++++++++++++++++++++ master-doc.txt | 7 ++ source/images/region-properties.png | Bin 0 -> 7858 bytes 3 files changed, 126 insertions(+) create mode 100644 include/region-properties.html create mode 100644 source/images/region-properties.png diff --git a/include/region-properties.html b/include/region-properties.html new file mode 100644 index 00000000..ca5dfe0d --- /dev/null +++ b/include/region-properties.html @@ -0,0 +1,119 @@ + +

Region properties

+ +
+ The Region Propeties window +
+ The Region Propeties window +
+
+ +

+ The Region properties window brings information about the selected + regions, and allows to fine tune its sequencing. It is accessed through the + Region > Properties… menu, or by + right clicking the region, + Name_of_the_Region > Properties…. +

+

+ This window also allows to manually set the different values. +

+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
FieldMeaningEditable
Name:The name of the region in the editorX
AuditionThis button allows to listen to the region and only the region, dry (with + no effects, regardless of the processors applied to the track). For MIDI, + the default MIDI synth, set in the Preferences, + is used to audition the region.
Position:Position in time of the left-hand side of the regionX
End:Position in time of the right-hand side of the regionX
Length:Duration of the region (=End−Position)X
Sync point (relative to region):Position in time of the Sync Point, relative + to the beginning of the region. No manual sync point means the sync point is + the beginning of the region (=Position), so will show as "0" in time + and 001|01|0000 in Bars:Beats notation.X
Sync point (absolute):Position in time of the Sync Point, relative + to the beginning of the session. No manual sync point means the sync point + is the beginning of the region, and will be equal to the Position.X
File start:Position in time of the beginning of the region relative to the source + file start. If the region has not been trimmed on the left, then the regions + start is the file start and this value is 0.
Source:Name of the source audio/MIDI file the region is exctracted from. + A region can be a part of or a whole audio/MIDI file, and multiple regions can + be based on the same source file. + X
Region gain:(Audio files only) Manual gain, in dB, applied constantly to the whole region, + regardless of the global track's gain, automation, etc…X
Peak amplitude:(Audio files only) Maximum level the signal reaches inside the region. + Expressed in dBFS (Full Scale), where 0 is the numeric maximum a signal can + reach.
+ +

+ All the fields maked as "editable" in the table above allow the user to manually + enter a value in the field, to manually set this value. +

+ +

+ Right-clicking on a field allow to switch between the + different clock modes. +

+ +

+ The context menu that pops up also allows the relevant fields (Position, End, + and both Sync points) to be set from the playhead location, which can be used to + e.g. trim a region to the playhead or place a sync point exactly on a beat. +

diff --git a/master-doc.txt b/master-doc.txt index 28aa8c49..e3310e73 100644 --- a/master-doc.txt +++ b/master-doc.txt @@ -1304,6 +1304,13 @@ link: insert-remove-time part: subchapter --- +--- +title: Region Properties +include: region-properties.html +link: region-properties +part: subchapter +--- + --- title: Fades and Crossfades include: create-region-fades-and-crossfades.html diff --git a/source/images/region-properties.png b/source/images/region-properties.png new file mode 100644 index 0000000000000000000000000000000000000000..985501fd91aacbe920ee0688eac2b127fb05d043 GIT binary patch literal 7858 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