mirror of
https://github.com/ElvishArtisan/rivendell.git
synced 2025-11-26 15:20:29 +01:00
2014-10-25 Fred Gleason <fredg@paravelsystems.com>
* Implemented '--set-marker-end-*=' and '--set-marker-start-*=' options for rdimport(1) in 'utils/rdimport/markerset.cpp',, 'utils/rdimport/markerset.h', 'utils/rdimport/rdimport.cpp' and 'utils/rdimport/rdimport.h'.
This commit is contained in:
Fred Gleason
@@ -16,71 +16,58 @@ list of filespecs to be read from standard input.
|
||||
|
||||
.SH OPTIONS
|
||||
.TP
|
||||
.B --verbose
|
||||
Print progress messages during processing.
|
||||
.TP
|
||||
.B --help
|
||||
Print a short usage message and exit.
|
||||
.TP
|
||||
.B --version
|
||||
Output version information and exit.
|
||||
.TP
|
||||
.B --log-mode
|
||||
Prepend date/time information to each line of printed status (implies
|
||||
the '--verbose' option).
|
||||
.TP
|
||||
.B --normalization-level=<\fIlevel\fP>
|
||||
Specify the level to use for peak normalizing the audio, in dBFS.
|
||||
Specifying '0' will turn off normalization.
|
||||
.B --add-scheduler-code=<\fIstr\fP>
|
||||
Add Scheduler Code <\fIstr\fP> to the target cart. The specified
|
||||
code must exist in RDAdmin->SchedulerCodes. This option may be
|
||||
specified multiple times.
|
||||
.TP
|
||||
.B --autotrim-level=<level>
|
||||
Specify the threshold level to use for autotrimming the audio, in dBFS.
|
||||
Specifying '0' will turn off autotrimming.
|
||||
.TP
|
||||
.B --single-cart
|
||||
If more than one file is imported, place them within multiple cuts within a
|
||||
single cart, rather than creating separate carts for each file.
|
||||
.TP
|
||||
.B --segue-level=<\fIlevel\fP>
|
||||
Specify the threshold level to use for setting the segue markers, in dBFS.
|
||||
Default action is not to create segue markers.
|
||||
.TP
|
||||
.B --segue-length=<\fIlength\fP>
|
||||
Length of the added segue in msecs. See \fB--segue-level\fP above.
|
||||
.TP
|
||||
.B --to-cart=<\fIcartnum\fP>
|
||||
Specify the cart to import the audio into, rather than using the next
|
||||
available cart number for the group. If the cart does not exist, it will
|
||||
be created. Each file will be imported into a separate new cut within the
|
||||
cart. Use of this option implies the \fB--single-cart\fP option as well,
|
||||
and is mutually exclusive with the \fB--use-cartchunk-cutid\fP option.
|
||||
.TP
|
||||
.B --use-cartchunk-cutid
|
||||
Import the audio into the cart specified by the CartChunk CutID parameter
|
||||
associated with the file. If the cart does not exist, it will be
|
||||
created. Use of this option is mutually exclusive with the \fB--to-cart\fP
|
||||
option.
|
||||
.TP
|
||||
.B --title-from-cartchunk-cutid
|
||||
Set the cart title from CartChunk CutID.
|
||||
.TP
|
||||
.B --cart-number-offset=<\fIoffset\fP>
|
||||
Add <\fIoffset\fP> to the cart number as determined from metadata pattern
|
||||
or --use-cartchunk-cutid.
|
||||
.TP
|
||||
.B --delete-source
|
||||
Delete each source file after successful import. Use with caution!
|
||||
.B --create-enddate-offset=<\fIdays\fP>
|
||||
If the imported file does not reference an end date, create with
|
||||
end date offset by <\fIdays\fP> days relative to the current date.
|
||||
Cannot be less than the value the value for \fB--create-startdate-offset\fP
|
||||
(default = 0).
|
||||
.TP
|
||||
.B --create-startdate-offset=<\fIdays\fP>
|
||||
If the imported file does not reference a start date, create with
|
||||
startdate offset by <\fIdays\fP> days relative to the current date.
|
||||
Cannot be greater than the value for \fB--create-enddate-offset\fP
|
||||
(default = 0).
|
||||
.TP
|
||||
.B --delete-cuts
|
||||
Delete all cuts within the destination cart before importing. Use
|
||||
with caution!
|
||||
.TP
|
||||
.B --delete-source
|
||||
Delete each source file after successful import. Use with caution!
|
||||
.TP
|
||||
.B --drop-box
|
||||
Operate in DropBox mode, causing \fIrdimport(1)\fP to run continuously,
|
||||
periodically scanning for files matching the specified <\fIfilespec\fP>,
|
||||
importing and then deleting them when found. WARNING: use of this option
|
||||
also implies the \fB--delete-source\fP option!
|
||||
.TP
|
||||
.B --enddate-offset=<days>
|
||||
If the imported file references an end date, offset the value by <\fIdays\fP>
|
||||
days.
|
||||
.TP
|
||||
.B --fix-broken-formats
|
||||
Attempt to work around malformed audio input data.
|
||||
.TP
|
||||
.B --help
|
||||
Print a short usage message and exit.
|
||||
.TP
|
||||
.B --log-mode
|
||||
Prepend date/time information to each line of printed status (implies
|
||||
the '--verbose' option).
|
||||
.TP
|
||||
.B --metadata-pattern=<\fIpattern\fP>
|
||||
Attempt to read metadata parameters from the source filename, using
|
||||
the pattern <\fIpattern\fP>. Patterns consist of a sequence of wildcards and
|
||||
@@ -154,41 +141,84 @@ when processing a filename of 'My Song_My Artist_TEMP_123456.mp3',
|
||||
would extract 'My Song' as the title and 'My Artist' as the artist,
|
||||
while importing it into cart 123456 in the TEMP group.
|
||||
.TP
|
||||
.B --startdate-offset=<\fIdays\fP>
|
||||
If the imported file references a start date, offset the value by <\fIdays\fP>
|
||||
days.
|
||||
.B --normalization-level=<\fIlevel\fP>
|
||||
Specify the level to use for peak normalizing the audio, in dBFS.
|
||||
Specifying '0' will turn off normalization.
|
||||
.TP
|
||||
.B --enddate-offset=<days>
|
||||
If the imported file references an end date, offset the value by <\fIdays\fP>
|
||||
days.
|
||||
.B --segue-length=<\fIlength\fP>
|
||||
Length of the added segue in msecs. See \fB--segue-level\fP below.
|
||||
.TP
|
||||
.B --create-startdate-offset=<\fIdays\fP>
|
||||
If the imported file does not reference a start date, create with
|
||||
startdate offset by <\fIdays\fP> days relative to the current date.
|
||||
Cannot be greater than the value for \fB--create-enddate-offset\fP
|
||||
(default = 0).
|
||||
.TP
|
||||
.B --create-enddate-offset=<\fIdays\fP>
|
||||
If the imported file does not reference an end date, create with
|
||||
end date offset by <\fIdays\fP> days relative to the current date.
|
||||
Cannot be less than the value the value for \fB--create-startdate-offset\fP
|
||||
(default = 0).
|
||||
.B --segue-level=<\fIlevel\fP>
|
||||
Specify the threshold level to use for setting the segue markers, in dBFS.
|
||||
Default action is not to create segue markers.
|
||||
.TP
|
||||
.B --set-daypart-times=<\fIstart-time\fP>,<\fIend-time\fP>
|
||||
Set the start and end daypart times, in the format HHMMSS.
|
||||
.TP
|
||||
.B --fix-broken-formats
|
||||
Attempt to work around malformed audio input data.
|
||||
.B --set-marker-end-<\fImarker\fP>=<\fIoffset\fP>
|
||||
Set an end marker to a given offset value. The <\fIoffset\fP> parameter is
|
||||
specified in milliseconds. If positive, it is taken to indicate a marker
|
||||
position relative to the absolute beginning of the audio cut, while if
|
||||
negative, it is taken to indicate a marker position relative to the absolute
|
||||
end of the audio cut.
|
||||
|
||||
The following <\fImarker\fP> types are recognized:
|
||||
.RS
|
||||
.TP
|
||||
.B --add-scheduler-code=<\fIstr\fP>
|
||||
Add Scheduler Code <\fIstr\fP> to the target cart. The specified
|
||||
code must exist in RDAdmin->SchedulerCodes. This option may be
|
||||
specified multiple times.
|
||||
.B cut
|
||||
The Cut markers.
|
||||
.TP
|
||||
.B hook
|
||||
The Hook markers.
|
||||
.TP
|
||||
.B segue
|
||||
The Segue markers
|
||||
.TP
|
||||
.B talk
|
||||
The Talk markers.
|
||||
.RE
|
||||
.RE
|
||||
|
||||
.TP
|
||||
.B --set-marker-start-<\fImarker\fP>=<\fIoffset\fP>
|
||||
Set a start marker to a given offset value. See the discussion of the
|
||||
\fB--set-marker-end-<marker>\fP option above for a description of the
|
||||
<\fImarker\fP> and <\fIoffset\fP> parameters.
|
||||
.TP
|
||||
.B --set-user-defined=<\fIstr\fP>
|
||||
Set the User Defined field for the target cart to <\fIstr\fP>. This will
|
||||
override any value that might otherwise be set --e.g. by using the
|
||||
\fB--metadata-pattern\fP option.
|
||||
.TP
|
||||
.B --single-cart
|
||||
If more than one file is imported, place them within multiple cuts within a
|
||||
single cart, rather than creating separate carts for each file.
|
||||
.TP
|
||||
.B --startdate-offset=<\fIdays\fP>
|
||||
If the imported file references a start date, offset the value by <\fIdays\fP>
|
||||
days.
|
||||
.TP
|
||||
.B --title-from-cartchunk-cutid
|
||||
Set the cart title from CartChunk CutID.
|
||||
.TP
|
||||
.B --to-cart=<\fIcartnum\fP>
|
||||
Specify the cart to import the audio into, rather than using the next
|
||||
available cart number for the group. If the cart does not exist, it will
|
||||
be created. Each file will be imported into a separate new cut within the
|
||||
cart. Use of this option implies the \fB--single-cart\fP option as well,
|
||||
and is mutually exclusive with the \fB--use-cartchunk-cutid\fP option.
|
||||
.TP
|
||||
.B --use-cartchunk-cutid
|
||||
Import the audio into the cart specified by the CartChunk CutID parameter
|
||||
associated with the file. If the cart does not exist, it will be
|
||||
created. Use of this option is mutually exclusive with the \fB--to-cart\fP
|
||||
option.
|
||||
.TP
|
||||
.B --verbose
|
||||
Print progress messages during processing.
|
||||
.TP
|
||||
.B --version
|
||||
Output version information and exit.
|
||||
|
||||
.SH NOTES
|
||||
It may be necessary to enclose individual <\fIfilespec\fP> clauses in quotes
|
||||
@@ -197,8 +227,8 @@ indicator that this is necessary is the failure of \fBrdimport(1)\fP to process
|
||||
newly added files when running in DropBox mode.
|
||||
|
||||
.SH BUGS
|
||||
It could be argued that RMS rather peak normalization would be more appropriate
|
||||
for use with the \fB--normalization-level\fP option.
|
||||
It could be argued that RMS rather than peak normalization would be more
|
||||
appropriate for use with the \fB--normalization-level\fP option.
|
||||
|
||||
.SH AUTHOR
|
||||
Fred Gleason <fredg@paravelsystems.com>
|
||||
|
||||
Reference in New Issue
Block a user