NAME
qwavcut - extract and/or delete parts of a wav file
SYNOPSIS
qwavcut [option]... file
DESCRIPTION
qwavcut allows to extract and/or delete a fragment of a wav file. some
parameters must be supplied in order to define the start/size/end cut
points and what to do then: either the fragment must be copied to
another file or erased from the file (or both)
GENERAL OPTIONS
-d, --delete
deletes the fragment from the file. if option --output is used,
deletion action is always done after fragment extraction.
-h, --help
show a brief help and exit.
-o <outfile>, --output=<outfile>
outfile is the file where the samples contained in the specified
cut will be copied.
-V, --version
show version and exit.
CUT OPTIONS
cut options are used to specify at which sample the fragment begins
(options -b or -B), ends (options -e and -E), or which size it has
(option -s). at least, one cut option must be specified. neither the
options -b and -B, and the options -e and -E can be used together;
also, a begin, end and size option can be used at the same time.
by default, the fragment begins at the first sample and ends at the
last sample; there’s no default value for size.
all the values are treated as a sample number unless a format specifier
is used. see the FORMATS section below for information. all values must
be positive integer.
-b <begin>[<format>], --set-begin-from-eof=<begin>[<format>]
begin specifies the first sample of the file that belongs to the
cut counting from the end of the file.
-B <begin>[<format>], --set-begin=<begin>[<format>]
begin specifies the first sample of the file that belongs to the
cut counting from the beginning of the file.
-e <end>[<format>], --set-end-from-eof=<end>[<format>]
end specifies the last sample of the file that belongs to the
cut counting from the end of the file.
-E <end>[<format>], --set-end=<end>[<format>]
end specifies the last sample of the file that belongs to the
cut counting from the beginning of the file.
-s <size>[<format>], --set-size=<size>[<format>]
size specifies the number of samples contained in the cut.
-S <begin>-<end>, --slice <begin>-<end>
slice specifies the starting and ending points of the cut as a
timeslice, which is to say, two time specifications
([[h:]m:]s[.ms]) joined by a hyphen.
FORMATS
cut options can have also an optional modifier. if this modifier is not
used, then the value provided with the corresponding cut option will be
interpreted as a number of samples. since most of the times will be
difficult to specify a cut in terms of samples, the following modifiers
are provided:
j value is interpreted as milliseconds.
m value is interpreted as minutes.
s value is interpreted as seconds.
b value is interpreted as bytes.
k value is interpreted as kbytes (1024 bytes).
M value is interpreted as megabytes (1024 kbytes).
in either case, the values specified will be rounded to get an integer
number of samples.
EXAMPLES
here are some examples:
to get the last ten seconds of a file:
qwavcut -b 10s -o outfile.wav infile.wav
four ways of getting the first minute of a file:
qwavcut -S -1:0 -o outfile.wav infile.wav
qwavcut -S -60 -o outfile.wav infile.wav
qwavcut -E 1m -o outfile.wav infile.wav
qwavcut -s 1m -o outfile.wav infile.wav
four ways of getting the second quarter of a file:
qwavcut -S 15:0-30:0 -o outfile.wav infile.wav
qwavcut -B 15m -E 30m -o outfile.wav infile.wav
qwavcut -s 15m -E 30m -o outfile.wav infile.wav
qwavcut -B 15m -s 15m -o outfile.wav infile.wav
NOTES
if neither the options --output nor --delete are specified, the program
will do nothing.
when cutting at the end, a simple truncate call is needed. but when
cutting in the middle or in the beginning, all the data behind the cut
must be moved ahead and, depending on the amount of the data to be
moved, this can be a time consuming operation.
BUGS
tests has been done only with 44100 Hz 16 bit stereo files, though it
may work with mono/stereo 8/16 bits files.
AUTHOR
dmanye@etse.urv.es
http://www.etse.urv.es/~dmanye/quelcom/quelcom.html
SEE ALSO
qwavinfo(1), qwavjoin(1), qwavsilence(1), qwavfade(1),
qwavheaderdump(1)
qmp3info(1), qmp3join(1), qmp3cut(1), qmp3check(1), qmp3report(1)