AXSetVoiceBiquad

Syntax

#include <cafe/ax.h>

void AXSetVoiceBiquad(AXVPB *p, const AXPBBIQUAD *biquad);

Parameters

p Pointer to the voice.
biquad Pointer to the application-initialized AXPBBIQUAD structure.

Return Values

None.

Description

Applies the biquad filter parameters to the specified voice. To update the coefficients after the biquad filter has been enabled, use AXSetVoiceBiquadCoefs.

For more information on the biquad filter, see the Filtering Overview.

CAUTION:
Due to the difference in PPC and DSP architectures, PPC being a floating-point processor and DSP a fixed point processor, the output of a voice processed on PPC might sound different than the same voice processed on DSP. This is especially true when using biquad and LPF filters. DSP has a 16-bit width to represent coefficients. This limitation imposes restrictions on the realization of stable filters for extreme cut-off filters. For example, realizing a low pass filter using biquad less than 160Hz, might be difficult for all inputs. It is up to the developers to make sure that the filters they submit to the DSP are stable for all the inputs that are processed through such a filter.

Availability

Library Version Availability
Sound 2.0 Yes
Sound 1.0 Yes

Do Not Call From

None.

See Also

AXPBBIQUAD
Filtering Overview
AXSetVoiceBiquadCoefs
AXSetVoiceLpf
AXSetVoiceLpfCoefs

Revision History

2013/05/08 Automated cleanup pass.
2012/08/01 Cleanup Pass.
2012/01/26 Update to Audio API v2.0.
2011/02/21 Initial Version


CONFIDENTIAL