'\" te
.\" Copyright (c) 2007, Sun Microsystems, Inc.  All Rights Reserved 
.TH mlib_SignalMelCepstralInit_S16 3MLIB "2 Mar 2007" "SunOS 5.11" "mediaLib Library Functions"
.SH NAME
mlib_SignalMelCepstralInit_S16, mlib_SignalMelCepstralInit_F32 \- initialization for cepstral analysis in mel frequency scale
.SH SYNOPSIS
.LP
.nf
cc [ \fIflag\fR... ] \fIfile\fR... \fB-lmlib\fR [ \fIlibrary\fR... ]
#include <mlib.h>

\fBmlib_status\fR \fBmlib_SignalMelCepstralInit_S16\fR(\fBvoid *\fR\fIstate\fR, \fBmlib_s32\fR \fInlinear\fR,
     \fBmlib_s32\fR \fInmel\fR, \fBmlib_f32\fR \fImelbgn\fR, \fBmlib_f32\fR \fImelend\fR, \fBmlib_f32\fR \fImeldiv\fR,
     \fBmlib_s32\fR \fIorder\fR);
.fi

.LP
.nf
\fBmlib_status\fR \fBmlib_SignalMelCepstralInit_F32\fR(\fBvoid *\fR\fIstate\fR, \fBmlib_s32\fR \fInlinear\fR,
     \fBmlib_s32\fR \fInmel\fR, \fBmlib_f32\fR \fImelbgn\fR, \fBmlib_f32\fR \fImelend\fR, \fBmlib_f32\fR \fImeldiv\fR,
     \fBmlib_s32\fR \fIorder\fR);
.fi

.SH DESCRIPTION
.sp
.LP
Each of these functions initializes the internal state structure for cepstral analysis in mel frequency scale.
.sp
.LP
The init function performs internal state structure allocation and global initialization. Per function call initialization is done in each function, so the same internal state structure can be reused for multiplefunction calls.
.SH PARAMETERS
.sp
.LP
Each of the functions takes the following arguments:
.sp
.ne 2
.mk
.na
\fB\fIstate\fR\fR
.ad
.RS 11n
.rt  
Pointer to the internal state structure.
.RE

.sp
.ne 2
.mk
.na
\fB\fInlinear\fR\fR
.ad
.RS 11n
.rt  
The number of band pass filters in linear frequency scale.
.RE

.sp
.ne 2
.mk
.na
\fB\fInmel\fR\fR
.ad
.RS 11n
.rt  
The number of band pass filters in mel frequency scale.
.RE

.sp
.ne 2
.mk
.na
\fB\fImelbgn\fR\fR
.ad
.RS 11n
.rt  
The begin radian frequency of the mel scale filter bank defined in linear frequency scale, where \fB0 \(<= melbgn < melend \(<= PI\fR, \fBmelbgn\fR is ignored if \fBnlinear = 0\fR.
.RE

.sp
.ne 2
.mk
.na
\fB\fImelend\fR\fR
.ad
.RS 11n
.rt  
The end radian frequency of the mel scale filter bank defined in linear frequency scale, where \fB0 \(<= melbgn < melend \(<= PI\fR.
.RE

.sp
.ne 2
.mk
.na
\fB\fImeldiv\fR\fR
.ad
.RS 11n
.rt  
The dividing factor in linear to mel scale conversion, linear scale is measured in radians, with \fBPI\fR corresponding to half the sampling rate.
.RE

.sp
.ne 2
.mk
.na
\fB\fIorder\fR\fR
.ad
.RS 11n
.rt  
The order of the input signal vector and the cepstral coefficients, where \fBlength = 2**order\fR.
.RE

.SH RETURN VALUES
.sp
.LP
Each of the functions returns \fBMLIB_SUCCESS\fR if successful. Otherwise it returns \fBMLIB_FAILURE\fR.
.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(5) for descriptions of the following attributes:
.sp

.sp
.TS
tab() box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPEATTRIBUTE VALUE
_
Interface StabilityCommitted
_
MT-LevelMT-Safe
.TE

.SH SEE ALSO
.sp
.LP
\fBmlib_SignalMelCepstral_S16\fR(3MLIB), \fBmlib_SignalMelCepstral_F32\fR(3MLIB), \fBmlib_SignalMelCepstral_S16_Adp\fR(3MLIB), \fBmlib_SignalMelCepstralFree_S16\fR(3MLIB), \fBmlib_SignalMelCepstralFree_F32\fR(3MLIB), \fBattributes\fR(5)