'\" t
.\"     Title: sdif2ad
.\"    Author: 
.\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
.\"      Date: 08/01/2011
.\"    Manual: The Canonical Csound Reference Manual
.\"    Source: 5.10
.\"  Language: English
.\"
.TH "SDIF2AD" "1" "08/01/2011" "5.10" "The Canonical Csound Reference"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
sdif2ad \- Converts SDIF files to files usable by adsyn\&. .\" sdif2ad
.SH "DESCRIPTION"
.PP
Convert files Sound Description Interchange Format (SDIF) to the format usable by Csound\*(Aqs
\fIadsyn\fR
opcode\&. As of Csound version 4\&.10,
\fIsdif2ad\fR
was available only as a standalone program for Windows console and DOS\&.
.SH "SYNTAX"
.sp
.if n \{\
.RS 4
.\}
.nf
\fBsdif2ad\fR [flags] infilename outfilename
.fi
.if n \{\
.RE
.\}
.SH "INITIALIZATION"
.PP
Flags:
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fI\-s\fRN \-\- apply amplitude scale factor N
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fI\-p\fRN \-\- keep only the first N partials\&. Limited to 1024 partials\&. The source partial track indices are used directly to select internal storage\&. As these can be arbitrary values, the maximum of 1024 partials may not be realized in all cases\&.
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.sp -1
.IP \(bu 2.3
.\}
\fI\-r\fR
\-\- byte\-reverse output file data\&. The byte\-reverse option is there to facilitate transfer across platforms, as Csound\*(Aqs
adsyn
file format is not portable\&.
.RE
.PP
If the filename passed to
hetro
has the extension
\(lq\&.sdif\(rq, data will be written in SDIF format as 1TRC frames of additive synthesis data\&. The utility program
\fIsdif2ad\fR
can be used to convert any SDIF file containing a stream of 1TRC data to the Csound
adsyn
format\&.
\fIsdif2ad\fR
allows the user to limit the number of partials retained, and to apply an amplitude scaling factor\&. This is often necessary, as the SDIF specification does not, as of the release of
\fIsdif2ad\fR, require amplitudes to be within a particular range\&.
\fIsdif2ad\fR
reports information about the file to the console, including the frequency range\&.
.PP
The main advantages of SDIF over the
\fIadsyn\fR
format, for Csound users, is that SDIF files are fully portable across platforms (data is
\(lqbig\-endian\(rq), and do not have the duration limit of 32\&.76 seconds imposed by the 16 bit
\fIadsyn\fR
format\&. This limit is necessarily imposed by
\fIsdif2ad\fR\&. Eventually, SDIF reading will be incorporated directly into
\fIadsyn\fR, thus enabling files of any length (subject to system memory limits) to be analysed and processed\&.
.PP
Users should remember that the SDIF formats are still under development\&. While the 1TRC format is now fairly well established, it can still change\&.
.PP
For detailed information on the Sound Description Interchange Format, refer to the CNMAT website:
\m[blue]\fBhttp://cnmat\&.CNMAT\&.Berkeley\&.EDU/SDIF\fR\m[]
.PP
Some other SDIF resources (including a viewer) are available via the NC_DREAM website:
\m[blue]\fBhttp://www\&.bath\&.ac\&.uk/~masjpf/NCD/dreamhome\&.html\fR\m[]
.SH "CREDITS"
.PP
Author: Richard Dobson
.PP
Somerset, England
.PP
August, 2000
.PP
New in Csound version 4\&.08
.SH "AUTHORS"
.PP
\fBBarry Vercoe\fR
.br
MIT Media Lab
          
.RS 4
Author.
.RE
.PP
\fBDan Ellis\fR
.br
MIT Media Lab, 
          Cambridge
          Massachussetts
        
.RS 4
Author.
.RE
.SH "COPYRIGHT"
.br