.TH BTOA 1carl CARL
.SH NAME
btoa - binary to arabic converter for floatsams
.SH SYNOPSIS
.B btoa 
[
flags
] 
< 
floatsams 
> 
arabic numbers
.nf
.RS .5i
-RN set sampling rate to N (DEFSR Hz)
-bN set begin time to N
-eN set end time to N
-f print samples as floating point numbers
-d print samples as decimal numbers
-o print samples as octal numbers
-x print samples as hexadecimal numbers
-t index samples with time in seconds
-s index samples with sample numbers
-h usage statement
.RE
.fi
.SH DESCRIPTION
.B btoa 
reads floatsams (32-bit binary floating point samples) on its
standard input and 
prints their arabic equivalents on its standard output.  Arabic
is printed even if the standard output is a file or pipe.
.PP
.B btoa
defaults to writing its output on the standard output, formatting
the sample value as a floating point number in the signed unit interval.
The 
.B -t 
flag causes samples to be indexed by time in seconds at the prevailing
sampling rate.  The sampling rate defaults to
DEFSR Hz and is changed by the
.B -RN
flag where N is the desired sampling rate.
.PP
The sample formats are as described in the synopsis.  They are cumulative,
that is, selecting octal and floating point will print both formats
on the same line.
.SH AUTHOR
Gareth Loy
.SH SEE ALSO
atob(1carl),
xform(1carl),
getfloat(3carl).
