1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59
|
-*- text -*-
Beginning in version 0.7.1, normalize has an option --frontend that
makes the output very terse, but easy to parse. The general format of
frontend output is "<message-type> <arg> [<arg>...]".
These message types are experimental and subject to change. If you're
interested in writing a frontend, and there's something you'd like
added, removed, or changed, email me at chrisvaill@gmail.com.
The current message types are listed below:
NUMFILES <number_of_files>
This message comes first, and tells how many FILE messages will
follow.
FILE <index> <filename>
One of these messages will be printed for each input file. The
index is a number that subsequent messages will use to indicate this
particular file.
PROGRESS <file> <batch>
*Not implemented*
I'd like to provide an indicator of how far in the current operation
normalize has progressed. This is not in place in the code as of
v0.7.1, but this is how I expect it to look. The arguments are
numbers indicating percent complete for the current file, and for
the whole batch of files.
ANALYZING <index>
Normalize is about to begin analyzing the file referred to by index.
LEVEL <index> <level>
Analysis of the file is finished, and level is the file's volume, in
dBFS.
AVERAGE_EXCLUDES <index> <difference>
The file referred to by index is not being considered in the average
level. Its level is different from the average by difference, and
is being considered an aberration.
AVERAGE_LEVEL <level>
The average level of all the input files, in dBFS.
ADJUSTING <index> <gain>
Normalize is about to begin adjusting the file referred to by index,
using gain, given in dB.
ADJUSTED <index> <0|1>
If the file was actually adjusted, the second argument will be 1.
If the adjustment was not applied for a non-error reason (e.g. the
gain was too small to be worth applying), it will be 0.
ADJUST_NEEDED <0|1>
"ADJUST_NEEDED 1" is printed if a file was adjusted, or if the -n
option was given and a file would need adjustment.
"ADJUST_NEEDED 0" is printed if the -n option was not given and no
file was adjusted, or if -n was given and no file would need
adjustment.
|