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>AXFXReverbHiInitDpl2</TITLE>
7<META http-equiv="Content-Type" content="text/html; charset=windows-1252">
8<META http-equiv="Content-Style-Type" content="text/css">
9</head>
10
11<BODY>
12
13<H1 align="left">AXFXReverbHiInitDpl2</H1>
14
15<H2>C Specification</H2>
16<BLOCKQUOTE>
17<PRE><CODE>#include &lt;revolution.h&gt;
18#include &lt;revolution/axfx.h&gt;
19
20BOOL AXFXReverbHiInitDpl2(AXFX_REVERBHI_DPL2 *rev);</CODE></PRE>
21</BLOCKQUOTE>
22
23<H2>Arguments</H2>
24<TABLE border="1" cellpadding="3" cellspacing="0.1">
25  <TBODY>
26    <TR>
27<TD width="120" bgcolor="#ffffe8"><EM><STRONG><code>rev&nbsp;&nbsp; </code></STRONG></EM></TD>
28<TD width="520">Pointer to an initialized instance of <font face="Courier New"><code>AXFX_REVERBHI_DPL2.</code></font></TD>
29    </TR>
30  </TBODY>
31</TABLE>
32
33<H2>Return Values</H2>
34<P><code>TRUE</code> if successful, <code>FALSE</code> if a parameter is out of bounds or memory allocation fails.</P>
35
36<H2>Description</H2>
37<P><font face="Courier New"><code>AXFXReverbHiInitDpl2()</code></font> creates an instance of the DPL2-enhanced high-quality reverb, using the specified <code>AXFX_REVERBHI_DPL2</code> structure. Your application must initialize the reverb settings, within the <code>AXFX_REVERBHI_DPL2</code> structure, prior to calling <code>AXFXReverbHiInitDpl2().</code>This function will allocate memory for the reverb, and start the effect quietly.</P>
38
39<p><B>Note:</B> This reverb supports panning to the discrete surround channels, as afforded by the DPL2 encoder. <BR><BR><B>Note:</B> The crosstalk cancellation parameter, present in the other reverb effects, is <i>not</i> supported.</p>
40
41<p>The three-channel standard and high-quality reverb effects will still work in DPL2 output mode. However, the effects will produce a mono surround signal only.</p>
42
43<H2>See Also</H2>
44<P>
45<code><A href="AXFXReverbHiShutdownDpl2.html">AXFXReverbHiShutdownDpl2</A><br> <A href="AXFXReverbHiSettingsDpl2.html">AXFXReverbHiSettingsDpl2</A><br> <A href="AXFXReverbHiCallbackDpl2.html">AXFXReverbHiCallbackDpl2</A></code>
46</P>
47
48<H2>Revision History</H2>
49<P>03/01/2006 Initial version.</P>
50
51</BODY>
52</HTML>
53