sintonia/library/ecasound-2.7.2/Documentation/ecalength.1

77 lines
1.9 KiB
Groff

.TH "ecalength" "1" "18\&.04\&.2004" "" "Multimedia software"
.PP
.SH "NAME"
ecalength \- prints audio file lenght and other information
.PP
.SH "SYNOPSIS"
\fBecalength\fP [-ahtsfmbcr] FILE1 [FILE2] [FILEn]
.PP
.SH "DESCRIPTION"
.PP
This is ecalength, a few lines of code pompously named so because they
let one retrieve the length of an audio file from the command line
using ecasound\&'s engine\&.
.PP
Limitations:
.IP ""
- With files without header information (raw files), ecalength will only work
correctly if the audio file is at a sampling rate of 44100 hz\&.
(Addressed with the -a switch\&.)
.IP ""
- It is not foolproof, feeding it with something other than an audio
file WILL result in ugly things being spewed back\&.
(A bit better)
.IP ""
- A thousand more that I haven\&'t thought of\&.
.PP
.SH "OPTIONS"
.PP
.IP "-h"
Prints this usage message\&. (help)
.IP
.IP "-a[:]bits,channels,rate"
Changes the format assumed by default for headerless data\&. (adjust)
.IP
.IP "-t"
Prints the summed length of all the files processed\&. (total)
(Ignored if with -s)
.IP
.IP "-s"
Enables script mode: One info type per file per line\&. (script)
(Defaults to length in secs\&.)
.IP
.IP "-f"
With -s will return the format string as info, alone it will
add it to the main display\&. (format)
.IP
.IP "-b"
If -s and -f are enabled with this the info printed will be
the sample\&'s bitwidth\&. (bits)
.IP
.IP "-c"
If -s and -f are enabled with this the info printed will be
the channel count\&. (channel count)
.IP
.IP "-r"
If -s and -f are enabled with this the info printed will be
the sampling rate\&. (rate)
.IP
.IP "-m"
Will print human computable time as in main display but in
batch fashion\&. (minutes) (Only with -s)
.PP
.SH "SEE ALSO"
.PP
ecasound(1), ecatools(1)
.PP
.SH "AUTHOR"
.PP
S\&.Massy, <observer |at| colba\&.net <observer |at| colba\&.net>>