AXSetVoiceRmtIIRCoefs

Syntax

#include <revolution/ax.h>

#define AX_PB_LPF_ON            0x0001
#define AX_PB_BIQUAD_ON         0x0002

void AXSetVoiceRmtIIRCoefs(AXVPB *pvpb, u16 type, ...);

Arguments

pvpb	Pointer to the specified voice.
type	Specifies the IIR filter type.
...	Specifies the filter coefficients corresponding to the filter type.

Return Values

None.

Description

The AXSetVoiceRmtIIRCoefs function sets new filter coefficients when IIR filters for the controller speaker are enabled. This function also asserts the synchronization flag corresponding to axvpb.sync.

The type argument specifies the filter type. If LPF is used as the IIR filter type for the controller speaker, specify AX_PB_LPF_ON for type. If Biquad filters are used, specify AX_PB_BIQUAD_ON.

Note: The AXSetVoiceRmtIIRCoefs function cannot change the filter type.

The method of specifying filter coefficients depends on the type. If AX_PB_LPF_ON is specified for type:


AXSetVoiceRmtIIRCoefs(pvpb, AX_PB_LPF_ON, a0, b0);

If, on the other hand, AX_PB_BIQUAD_ON is specified for type:


AXSetVoiceRmtIIRCoefs(pvpb, AX_PB_BIQUAD_ON, b0, b1, b2, a1, a2);

To learn about filter coefficients, see the axvpb.pb.lpf and axvpb.pb.biquad pages.

To enable/disable IIR filters, use the AXSetVoiceRmtIIR function.

Revision History

2006/11/14 Initial version.