1<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2<html>
3
4<head>
5<LINK rel="stylesheet" type="text/css" href="../../CSS/revolution.css">
6<title>AXSetVoiceRmtIIRCoefs</title>
7<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
8<META name="GENERATOR" content="IBM WebSphere Studio Homepage Builder Version 6.5.0.0 for Windows">
9<META http-equiv="Content-Style-Type" content="text/css">
10</head>
11
12<body>
13
14<h1 align="left">AXSetVoiceRmtIIRCoefs</h1>
15
16<h2>C Specification</h2>
17
18<BLOCKQUOTE>
19<pre><code>#include &lt;revolution.h&gt;
20#define AX_PB_LPF_ON            0x0001
21#define AX_PB_BIQUAD_ON         0x0002
22
23void AXSetVoiceRmtIIRCoefs(AXVPB *pvpb, u16 type, ...);</CODE></pre>
24</BLOCKQUOTE>
25
26<h2>Arguments</h2>
27
28<TABLE border="1" cellpadding="3" cellspacing="0.1">
29  <tr>
30<TD width="120" valign="top" bgcolor="#ffffe8"><em><strong><font face="Courier New">AXVPB *pvpb</font></strong></em></TD>
31<TD width="520">Pointer to the specified voice.</TD>
32    </tr>
33  <tr>
34      <TD width="120" valign="top" bgcolor="#ffffe8"><em><strong><font face="Courier New">u16             type;</font></strong></em></TD>
35      <TD width="520"> Specifies the IIR filter type.</TD>
36    </tr>
37  <tr>
38      <TD width="120" valign="top" bgcolor="#ffffe8"><em><strong><font face="Courier New">...</font></strong></em>
39      </TD>
40      <TD width="520">Specifies the filter coefficients corresponding to the filter type.
41      </TD>
42    </tr>
43</TABLE>
44
45<h2>Return Values</h2>
46
47<p>None.</p>
48
49<h2>Description</h2>
50
51<p>The <code>AXSetVoiceRmtIIRCoefs</code> function sets new filter coefficients when IIR filters for the Controller speaker are enabled. This function also asserts the synchronization flag corresponding to <code>axvpb.sync</code>.</p>
52
53<p>The <code>type</code> argument specifies the filter type. If LPF is used as the IIR filter type for the Controller speaker, specify <code>AX_PB_LPF_ON</code> for <code>type</code>. If Biquad filters are used, specify <code>AX_PB_BIQUAD_ON</code>.</p>
54
55<p><strong>Note: The <code>AXSetVoiceRmtIIRCoefs</code> function cannot change the filter type.</strong></p>
56
57<p>The method of specifying filter coefficients depends on the <code>type</code>. If <code>AX_PB_LPF_ON</code> is specified for <code>type</code>:</p>
58
59<BLOCKQUOTE><pre><code>
60AXSetVoiceRmtIIRCoefs(pvpb, AX_PB_LPF_ON, a0, b0);
61</CODE></pre></BLOCKQUOTE>
62
63<p>If, on the other hand, <code>AX_PB_BIQUAD_ON</code> is specified for <code>type</code>::</p>
64
65<BLOCKQUOTE><pre><code>
66AXSetVoiceRmtIIRCoefs(pvpb, AX_PB_BIQUAD_ON, b0, b1, b2, a1, a2);
67</CODE></pre></BLOCKQUOTE>
68
69<p> To learn about filter coefficients, see the <code>axvpb.pb.lpf</code> and <code>axvpb.pb.biquad</code> pages.</p>
70
71<P>To enable/disable IIR filters, use the <code>AXSetVoiceRmtIIR</code> function.</P>
72
73<h2>See Also</h2>
74
75<p>
76<font face="Courier New"><a href="../Parameter_Blocks/AXPBLPF_lpf.html">axvpb.pb.lpf</a><br> <a href="../Parameter_Blocks/AXPBBIQUAD_biquad.html">axvpb.pb.biquad</a><br> <a href="../Parameter_Blocks/AXPBRMTIIR_rmtIIR.html">axvpb.pb.rmtIIR</a><br> <a href="AXSetVoiceRmtIIR.html">AXSetVoiceRmtIIR</a><br></font>
77</p>
78
79<h2>Revision History</h2>
80
81<P>
822006/11/14 Initial version.
83</P>
84<hr>
85<P>CONFIDENTIAL</p>
86</BODY>
87</HTML>
88
89