'\" te
.\" Copyright (c) 2007, Sun Microsystems, Inc.  All Rights Reserved 
.TH mlib_SignalEmphasizeInit_S16_S16 3MLIB "2 Mar 2007" "SunOS 5.11" "mediaLib Library Functions"
.SH NAME
mlib_SignalEmphasizeInit_S16_S16, mlib_SignalEmphasizeInit_S16S_S16S, mlib_SignalEmphasizeInit_F32_F32, mlib_SignalEmphasizeInit_F32S_F32S \- initialization for signal pre-emphasizing
.SH SYNOPSIS
.LP
.nf
cc [ \fIflag\fR... ] \fIfile\fR... \fB-lmlib\fR [ \fIlibrary\fR... ]
#include <mlib.h>

\fBmlib_status\fR \fBmlib_SignalEmphasizeInit_S16_S16\fR(\fBvoid **\fR\fIfilter\fR, 
     \fBmlib_f32\fR \fIalpha\fR);
.fi

.LP
.nf
\fBmlib_status\fR \fBmlib_SignalEmphasizeInit_S16S_S16S\fR(\fBvoid **\fR\fIfilter\fR, 
     \fBmlib_f32\fR \fIalpha\fR);
.fi

.LP
.nf
\fBmlib_status\fR \fBmlib_SignalEmphasizeInit_F32_F32\fR(\fBvoid **\fR\fIfilter\fR, 
     \fBmlib_f32\fR \fIalpha\fR);
.fi

.LP
.nf
\fBmlib_status\fR \fBmlib_SignalEmphasizeInit_F32S_F32S\fR(\fBvoid **\fR\fIfilter\fR, 
     \fBmlib_f32\fR \fIalpha\fR);
.fi

.SH DESCRIPTION
.sp
.LP
Each of these functions allocates memory for an internal filter structure and converts the filter coefficients into the internal representation.
.SH PARAMETERS
.sp
.LP
Each of the functions takes the following arguments:
.sp
.ne 2
.mk
.na
\fB\fIfilter\fR\fR
.ad
.RS 10n
.rt  
Internal filter structure.
.RE

.sp
.ne 2
.mk
.na
\fB\fIalpha\fR\fR
.ad
.RS 10n
.rt  
Emphasizing coefficient. \fB0 < alpha < 1.0\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_SignalEmphasize_S16_S16_Sat\fR(3MLIB), \fBmlib_SignalEmphasizeFree_S16_S16\fR(3MLIB), \fBattributes\fR(5)