.TH "SNDHIST" 1csound CARL
.SH NAME
sndhist  
- produce histogram of sound file
.SH SYNOPSIS
.B sndhist 
[flags] [file]
.SH DESCRIPTION
.B sndhist
is the rather un-UNIX like 
implementation within one program of the exact same functionality obtained
by the combination of sndin(1csound) and hist(1CARL).  To wit, saying
.RS .5i
sndin -b1 -e2 | hist
.RE
is exactly the equivalent of saying
.RS .5i
sndhist -b1 -e2
.RE
.SH APOLOGIA
The purpose of this heresy
is also rather un-UNIX-like in nature: speed.  For recording
sessions, fast estimation of gain levels is essential.  By eliminating the
pipe, 
.B sndhist
runs better than three times faster than 
.B sndin
and
.B hist
piped.  
.PP
The author of the program hopes the gods of UNIX will not frown
too darkly upon this sin.  
.SH BUGS
The devil made me do it!
.SH AUTHOR
Gareth Loy
