dmFS1016DecoderSetParams(3dm)			 dmFS1016DecoderSetParams(3dm)

NAME    [Toc]    [Back]

     dmFS1016DecoderSetParams -	set FS1016 decoder parameter values.

SYNOPSIS    [Toc]    [Back]

     #include <dmedia/dm_audioutil.h>
     #include <dmedia/dm_audio.h>
     #include <dmedia/dm_params.h>

     DMstatus dmFS1016DecoderSetParams(DMFS1016decoder handle,
				   DMparams *params)

PARAMETER    [Toc]    [Back]

     handle   DMFS1016decoder structure, created by
	      dmFS1016DecoderCreate(3dm).


     params   List of parameters for specification.  Null (0) value is
	      acceptable.

RETURNED VALUE    [Toc]    [Back]

     Returns DM_SUCCESS	or DM_FAILURE.

DESCRIPTION    [Toc]    [Back]

     dmFS1016DecoderSetParams(3dm) sets	state of FS1016	decoder	with params.
     Unrecognized parameters are ignored.


     The parameters of params for FS1016 decoder specification are, defined in
     dmedia/dm_audio.h and dmedia/dm_audioutil.h:

     DM_AUDIO_BITRATE    [Toc]    [Back]
     DM_FS1016_POSTFILTERING_FLAG
     DM_FS1016_HIGHPASS_FLAG


     The value for DM_AUDIO_BITRATE can	be

     DM_FS1016_4800_BITS    [Toc]    [Back]
     DM_FS1016_7200_BITS
     DM_FS1016_9600_BITS


     The value for DM_FS1016_POSTFILTERING_FLAG	can be

     DM_FS1016_POSTFILTERING_YES    [Toc]    [Back]
     DM_FS1016_POSTFILTERING_NO

     The value for DM_FS1016_HIGHPASS_FLAG can be



									Page 1






dmFS1016DecoderSetParams(3dm)			 dmFS1016DecoderSetParams(3dm)



     DM_FS1016_HIGHPASS_YES    [Toc]    [Back]
     DM_FS1016_HIGHPASS_NO



     The above values select a decoder with desired bitrate and	with or
     without postfiltering and highpass	filtering.  Cautious application of
     postfiltering at the decoder's output is recommended.  The	human ear's
     masking properties	are exploited to trade off speech distortion vs.
     quantizing	noise.	In tandem coding scenarios, only one stage of
     postfiltering is recommended and multiple stages should be	avoided.  The
     bitrate and decode	mode are set by	a call to
     dmFS1016DecoderSetParams(3dm). Without calling
     dmFS1016DecoderSetParams(3dm), decoder sets defaults to
     DM_FS1016_4800_BITS, DM_FS1016_POSTFILTERING_YES, and
     DM_FS1016_HIGHPASS_NO.

NOTE    [Toc]    [Back]

SEE ALSO
     dmFS1016DecoderCreate(3dm), dmFS1016Decode(3dm),
     dmFS1016DecoderGetParams(3dm).


									PPPPaaaaggggeeee 2222