auxana_rec.3

speech signal process tools

.\" Copyright (c) 1987 Entropic Speech, Inc.; All rights reserved
.\" @(#)auxana_rec.3	1.2	10/6/87 ESI
.TH AUXANA_REC 3\-ESPS 10/6/87
.ds ]W "\fI\s+4\ze\h'0.05'e\s-4\v'-0.4m'\fP\(*p\v'0.4m'\ Entropic Speech, Inc.
.ds ]Y "\fBESI INTERNAL\fP
.SH NAME
allo_auxana_rec \- allocate memory for auxiliary portion of an expanded
ESPS FEA_ANA file record.
.br
init_auxana_hd \- initialize an expanded FEA file header for subtype FEA_ANA.
.SH SYNOPSIS
.ft B
.nf
#include <esps/esps.h>
#include <esps/fea.h>
#include <esps/anafea.h>
#include <esps/feaquant.h>

struct auxana *
allo_auxana_rec( hd, p )
struct header *hd;
struct anafea *p;

int
init_auxana_hd( hd, order_vcd, order_unvcd, maxpulses, maxraw )
struct header *hd;
long order_vcd;
long order_unvcd;
long maxpulses;
long maxraw;
.fi
.ft
.SH DESCRIPTION
\fIAllo_auxana_rec\fR allocates memory for the auxiliary portion of an
expanded FEA_ANA file record and returns a pointer to it. The memory
allocations assume that the header was initialized by a call to
\fIinit_auxana_hd\fR. Because the size of the allocated record
depends on values in the data file header, it is important to ensure that
an expanded FEA_ANA record is consistent with the header of the file it
is being used with [see \fIinit_auxana_hd\fR]. Internally,
\fIallo_auxana_rec\fR hooks the FEA record up to an \fIauxana\fR struct.
.PP
\fIInit_auxana_hd\fR accepts a pointer \fIhd\fR to an ESPS FEA file header. It
initializes the record-field definitions to describe the auxiliary fields that
make up an expanded file of subtype FEA_ANA. It does this by means of calls to
\fIadd_fea_fld\fR (3\-ESPS). For a description of the expanded FEA_ANA record
fields, see \fIaux_ana\fR (5\-ESPS). \fIInit_auxana_hd\fR returns 1 if any of
the internal calls to \fIadd_fea_fld\fR (3\-ESPS) return an error code; otherwise,
it returns 0. \fIInit_auxana_hd\fR should be called only when creating a new
expanded FEA_ANA file, after the call to \fInew_header\fR (3\-ESPS), or
\fIcopy_header\fR (3\-ESPS). For a description of the parameters \fIorder_vcd\fR,
\fIorder_unvcd\fR, \fImaxpulses,\fR and \fImaxraw\fR, see \fIfea_ana\fR (5\-ESPS).
.SH EXAMPLES
.if n .ta 33
.if t .ta 3i
.nf
\fB\s-1Reading an existing file:\s+1\fR

FILE *ifp;
struct auxana *auxana_rec;
struct anafea *anafea_rec;
struct header *ih;

ih = read_header( ifp );
anafea_rec = allo_anafea_rec( ih );
auxana_rec = allo_auxana_rec( ih, anafea_rec );
if ( get_anafea_rec( anafea_rec, ih, ifp ) == EOF ) . . .

for ( i = 0; i < order; i++ )
    c[i] = auxana_rec\->spec_param_idx[i];

\fB\s-1Creating a new file:\s+1\fR

FILE *ifp;
FILE *ofp;
struct auxana *auxana_rec;
struct anafea *anafea_rec;
struct header *ih;
struct header *oh;

ih = read_header( ifp );
oh = copy_header( ih );
if ( init_auxana_hd( oh, order_vcd, order_unvcd, maxpulses, maxraw ) )
    ERROR_EXIT( "error filling expanded FEA_ANA header" );
 . . .
write_header( oh, ofp );
anafea_rec = allo_anafea_rec( oh );
auxana_rec = allo_auxana_rec( oh, anafea_rec );
 . . .
for ( i = 0; i < order; i++ )
    auxana_rec\->spec_param_idx[i] = c[i];
 . . .
put_anafea_rec( anafea_rec, oh, ofp );
.fi
.PP
In both of these examples, notice that the FEA_ANA read and write
routines, \fIget_anafea_rec\fR (3\-ESPS) and \fIput_anafea_rec\fR
(3\-ESPS), implicitly perform the I/O for the auxiliary data \- no
separate routines are needed.
.SH DIAGNOSTICS
If \fIhd\fR does not point to a FEA header of subtype FEA_ANA, the
program terminates with an assertion failure.  
.SH BUGS
None known.
.SH SEE ALSO
allo_anafea_rec (3\-ESPS), init_anafea_hd (3\-ESPS), aux_ana (5\-ESPS),
fea_ana (5\-ESPS).
.SH AUTHOR
Programs and manual page by Jim Elliott.