.\" DO NOT MODIFY THIS FILE!  It was generated by help2man 1.47.4.
.TH AMBIX-INTERLEAVE "1" "October 2016" "ambix-interleave 0.1.1" "User Commands"
.SH NAME
ambix-interleave \- AMBIsonics eXchange utility
.SH SYNOPSIS
.B ambix-interleave
\fI\,-o outfile \/\fR[\fI\,options\/\fR] \fI\,infile1\/\fR...
.SH DESCRIPTION
Merges several audio files into an ambix file
.SH OPTIONS
.TP
\fB\-h\fR, \fB\-\-help\fR
print this help
.TP
\fB\-o\fR, \fB\-\-output\fR
output filename
.TP
\fB\-O\fR, \fB\-\-order\fR
force ambisonics order (default: autodetect)
.TP
\fB\-X\fR, \fB\-\-matrix\fR
specify adaptor matrix file or a predefined matrix
('FuMa', 'n3d|sid', 'n3d' or 'sid')
.TP
\fB\-b\fR, \fB\-\-blocksize\fR
blocksize for copying (default: 1024)
.PP
In it's simplest form, you pass it a number of input files,
the accumulated channels of which form a full 3d ambisonics set
(channel #0 becomes the W\-channel,...).
The ambisonics order is calculated from the number of channels using N=(O+1)^2.
.PP
If you specify the 'order', then all extranous channels will be stored as 'extra' channels.
.PP
You can also write extended ambix files, by specifying an adaptor matrix
(either a soundfile, where the channels are read as rows and the frames as columns,
or by specifying one of the standard matrices), in which case the columns of the
matrix define the number of (reduced) ambisonics channels read from the input
and the rows of the matrix must form a full 3d ambisonics set.
Input channels exceeding the number of matrix columns are stored as 'extra' channels.
.TP
\fB\-h\fR, \fB\-\-help\fR
print this help
.TP
\fB\-o\fR, \fB\-\-output\fR
output filename
.TP
\fB\-O\fR, \fB\-\-order\fR
force ambisonics order (default: autodetect)
.TP
\fB\-X\fR, \fB\-\-matrix\fR
specify adaptor matrix file or a predefined matrix
('FuMa', 'n3d|sid', 'n3d' or 'sid')
.TP
\fB\-b\fR, \fB\-\-blocksize\fR
blocksize for copying (default: 1024)
.PP
In it's simplest form, you pass it a number of input files,
the accumulated channels of which form a full 3d ambisonics set
(channel #0 becomes the W\-channel,...).
The ambisonics order is calculated from the number of channels using N=(O+1)^2.
.PP
If you specify the 'order', then all extranous channels will be stored as 'extra' channels.
.PP
You can also write extended ambix files, by specifying an adaptor matrix
(either a soundfile, where the channels are read as rows and the frames as columns,
or by specifying one of the standard matrices), in which case the columns of the
matrix define the number of (reduced) ambisonics channels read from the input
and the rows of the matrix must form a full 3d ambisonics set.
Input channels exceeding the number of matrix columns are stored as 'extra' channels.
.TP
\fB\-h\fR, \fB\-\-help\fR
print this help
.TP
\fB\-o\fR, \fB\-\-output\fR
output filename
.TP
\fB\-O\fR, \fB\-\-order\fR
force ambisonics order (default: autodetect)
.TP
\fB\-X\fR, \fB\-\-matrix\fR
specify adaptor matrix file or a predefined matrix
('FuMa', 'n3d|sid', 'n3d' or 'sid')
.TP
\fB\-b\fR, \fB\-\-blocksize\fR
blocksize for copying (default: 1024)
.PP
In it's simplest form, you pass it a number of input files,
the accumulated channels of which form a full 3d ambisonics set
(channel #0 becomes the W\-channel,...).
The ambisonics order is calculated from the number of channels using N=(O+1)^2.
.PP
If you specify the 'order', then all extranous channels will be stored as 'extra' channels.
.PP
You can also write extended ambix files, by specifying an adaptor matrix
(either a soundfile, where the channels are read as rows and the frames as columns,
or by specifying one of the standard matrices), in which case the columns of the
matrix define the number of (reduced) ambisonics channels read from the input
and the rows of the matrix must form a full 3d ambisonics set.
Input channels exceeding the number of matrix columns are stored as 'extra' channels.
.SH AUTHOR
Written by IOhannes m zmoelnig <zmoelnig@iem.at>
.PP
Usage: \fI\,/build/libambix\-7u1iOH/libambix\-0.1\/\fP.1/utils/.libs/ambix\-interleave \fB\-o\fR outfile [options] infile1...
Merges several audio files into an ambix file
.SH "REPORTING BUGS"
Report bugs to: zmoelnig@iem.at
.PP
.br
Home page: http://ambisonics.iem.at/xchange/format
.PP
.br
Usage: \fI\,/build/libambix\-7u1iOH/libambix\-0.1\/\fP.1/utils/.libs/ambix\-interleave \fB\-o\fR outfile [options] infile1...
.br
Merges several audio files into an ambix file
.PP
.br
Report bugs to: zmoelnig@iem.at
.PP
.br
Home page: http://ambisonics.iem.at/xchange/format
.PP
.br
Report bugs to: zmoelnig@iem.at
.PP
.br
Home page: http://ambisonics.iem.at/xchange/format
.SH COPYRIGHT
Copyright \(co 2012 Institute of Electronic Music and Acoustics (IEM), University of Music and Dramatic Arts (KUG), Graz, Austria.
.PP
License LGPLv2.1: GNU Lesser GPL version 2.1 or later <http://gnu.org/licenses/lgpl.html>
.br
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.
.SH "SEE ALSO"
The full documentation for
.B ambix-interleave
is maintained as a Texinfo manual.  If the
.B info
and
.B ambix-interleave
programs are properly installed at your site, the command
.IP
.B info ambix-interleave
.PP
should give you access to the complete manual.