AXSetVoiceBiquadCoefs

Syntax

#include <cafe/ax.h>

void AXSetVoiceBiquadCoefs(AXVPB *p, u16 b0, u16 b1, u16 b2, u16 a1, u16 a2);

Parameters

p Pointer to the voice.
b0, b1, b2, a1, a2 Filter coefficients (fixed-point values; 2-bit integer part and 14-bit fraction part).

Return Values

None.

Description

Applies the given filter coefficients to voice p. Use after biquad filters are enabled by AXSetVoiceBiquad.

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
AXSetVoiceBiquad
AXSetVoiceLpf
AXSetVoiceLpfCoefs

Revision History

2013/05/08 Automated cleanup pass.
2012/08/01 Cleanup Pass.
2006/11/14 Initial version.


CONFIDENTIAL