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>AXFX_REVERBHI_EXP/AXFX_REVERBHI_EXP_DPL2</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">AXFX_REVERBHI_EXP/AXFX_REVERBHI_EXP_DPL2</H1> 14 15<H2>Syntax</H2> 16<dl><dd><pre class="construction"> 17#include <revolution.h> 18#include <revolution/axfx.h> 19 20/*----------------------------------------------* 21 For mono, stereo, surround 22 *----------------------------------------------*/ 23 24typedef struct AXFX_BUS 25{ 26 s32 *left; 27 s32 *right; 28 s32 *surround; 29 30} AXFX_BUS; 31 32typedef struct AXFX_REVERBHI_EXP 33{ 34 // do not touch these! 35 f32 *earlyLine[3]; 36 37 (omitted) 38 39 u32 active; 40 41 // user parameters 42 u32 earlyMode; // early reflection mode 43 f32 preDelayTimeMax; // max of pre delay time of fused reverb (sec) 44 f32 preDelayTime; // pre delay time of fused reverb (sec) 45 u32 fusedMode; // fused reverb mode 46 f32 fusedTime; // fused reverb time (sec) 47 f32 coloration; // coloration of all-pass filter (0.f - 1.f) 48 f32 damping; // damping of timbre (0.f - 1.f) 49 f32 crosstalk; // crosstalk of each channels 50 f32 earlyGain; // output gain of early reflection (0.f - 1.f) 51 f32 fusedGain; // output gain of fused reverb (0.f - 1.f) 52 53 AXFX_BUS *busIn; 54 AXFX_BUS *busOut; 55 f32 outGain; 56 f32 sendGain; 57 58} AXFX_REVERBHI_EXP; 59 60/*----------------------------------------------* 61 For Dolby Pro Logic II 62 *----------------------------------------------*/ 63 64typedef struct AXFX_BUS_DPL2 65{ 66 s32 *L; 67 s32 *R; 68 s32 *Ls; 69 s32 *Rs; 70 71} AXFX_BUS_DPL2; 72 73typedef struct AXFX_REVERBHI_EXP_DPL2 74{ 75 // do not touch these! 76 f32 *earlyLine[4]; 77 78 (omitted) 79 80 u32 active; 81 82 // user parameters 83 u32 earlyMode; // early reflection mode 84 f32 preDelayTimeMax;// pre-delay max time of fused reverb (sec) 85 f32 preDelayTime; // pre-delay time of fused reverb (sec) 86 u32 fusedMode; // fused reverb mode 87 f32 fusedTime; // fused reverb time (sec) 88 f32 coloration; // coloration of all-pass filter (0.f-1.f) 89 f32 damping; // damping of timbre (0.f-1.f) 90 f32 crosstalk; // crosstalk of each channels 91 f32 earlyGain; // output gain of early reflection(0.f-1.f) 92 f32 fusedGain; // output gain of fused reverb (0.f-1.f) 93 94 AXFX_BUS_DPL2 *busIn; 95 AXFX_BUS_DPL2 *busOut; 96 f32 outGain; 97 f32 sendGain; 98 99} AXFX_REVERBHI_EXP_DPL2; 100</pre></dd></dl> 101 102<h2>Elements</h2> 103<TABLE class="arguments" border="1" > 104 <tr> 105<TH><CODE><STRONG><EM>earlyMode</EM></STRONG></CODE></TH> 106<TD>Mode of the initial reflected sound (Early Reflection). The modes that can be specified are listed below. 107 <TABLE class="arguments" border="1" > 108 <TR> 109<TH>AXFX_REVERBHI_EXP_EARLY_MODE_5MS</TH> 110<TD>The initial reflection arrives after an approximately 5-millisecond delay. Subsequently, the sound arrives at intervals of approximately 5 milliseconds.</TD> 111 </TR> 112 <TR> 113<TH>AXFX_REVERBHI_EXP_EARLY_MODE_10MS</TH> 114<TD>The initial reflection arrives after an approximately 10-millisecond delay. Subsequently, the sound arrives at intervals of approximately 10 milliseconds.</TD> 115 </TR> 116 <TR> 117<TH>AXFX_REVERBHI_EXP_EARLY_MODE_15MS</TH> 118<TD>The initial reflection arrives after an approximately 15-millisecond delay. Subsequently, the sound arrives at intervals of approximately 15 milliseconds.</TD> 119 </TR> 120 <TR> 121<TH>AXFX_REVERBHI_EXP_EARLY_MODE_20MS</TH> 122<TD>The initial reflection arrives after an approximately 20-millisecond delay. Subsequently, the sound arrives at intervals of approximately 20 milliseconds.</TD> 123 </TR> 124 <TR> 125<TH>AXFX_REVERBHI_EXP_EARLY_MODE_25MS</TH> 126<TD>The initial reflection arrives after an approximately 25-millisecond delay. Subsequently, the sound arrives at intervals of approximately 25 milliseconds.</TD> 127 </TR> 128 <TR> 129<TH>AXFX_REVERBHI_EXP_EARLY_MODE_30MS</TH> 130<TD>The initial reflection arrives after an approximately 30-millisecond delay. Subsequently, the sound arrives at intervals of approximately 30 milliseconds.</TD> 131 </TR> 132 <TR> 133<TH>AXFX_REVERBHI_EXP_EARLY_MODE_35MS</TH> 134<TD>The initial reflection arrives after an approximately 35-millisecond delay. Subsequently, the sound arrives at intervals of approximately 35 milliseconds.</TD> 135 </TR> 136 <TR> 137<TH>AXFX_REVERBHI_EXP_EARLY_MODE_40MS</TH> 138<TD>The initial reflection arrives after an approximately 40-millisecond delay. Subsequently, the sound arrives at intervals of approximately 40 milliseconds.</TD> 139 </TR> 140 </TABLE> 141 </TD> 142 </tr> 143 <tr> 144<TH><CODE><STRONG><EM>preDelayTimeMax</EM></STRONG></CODE></TH> 145<TD>Maximum value of pre-delay for the end of reverberation (= maximum delay time until reflection begins). Specify a value of 0.0 or greater (units of sec). The memory to be used for pre-delay is allocated according to this value.</TD> 146 </tr> 147 <tr> 148<TH><CODE><STRONG><EM>preDelayTime</EM></STRONG></CODE></TH> 149<TD>Pre-delay for the end of reverberation (= delay time until reverberation begins). Specify a value as 0.0 <= <EM>value</EM> <= <CODE><STRONG><EM>preDelayTimeMax</EM></STRONG></CODE> (in sec).</TD> 150 </tr> 151 <tr> 152<TH><CODE><STRONG><EM>fusedMode</EM></STRONG></CODE></TH> 153<TD>Mode for the end of reverberation. The modes that can be specified are listed below. 154 <TABLE class="arguments" border="1" > 155 <TR> 156<TH>AXFX_REVERBHI_EXP_FUSED_MODE_OLD_AXFX</TH> 157<TD>The old AXFX Reverb mode.</TD> 158 </TR> 159 <TR> 160<TH>AXFX_REVERBHI_EXP_FUSED_MODE_METAL_TANK</TH> 161<TD>Gives the feel of a small, metal-walled space. The reverberating echoes interfere with each other, and the flange effect generates some high frequencies.</TD> 162 </TR> 163 <TR> 164<TH>AXFX_REVERBHI_EXP_FUSED_MODE_SMALL_ROOM</TH> 165<TD>A suitable mode for simulating a small room (about 10x10m).</TD> 166 </TR> 167 <TR> 168<TH>AXFX_REVERBHI_EXP_FUSED_MODE_LARGE_ROOM</TH> 169<TD>A suitable mode for simulating a large room (on the scale of a large conference room).</TD> 170 </TR> 171 <TR> 172<TH>AXFX_REVERBHI_EXP_FUSED_MODE_HALL</TH> 173<TD>A suitable mode for simulating concert halls.</TD> 174 </TR> 175 <TR> 176<TH>AXFX_REVERBHI_EXP_FUSED_MODE_CAVERNOUS</TH> 177<TD>A suitable mode for simulating caves.</TD> 178 </TR> 179 </TABLE> 180 </TD> 181 </tr> 182 <tr> 183<TH><CODE><STRONG><EM>fusedTime</EM></STRONG></CODE></TH> 184<TD>The reverberation time for the end of reverberation. Specify a value of 0.0 or greater (units of sec).</TD> 185 </tr> 186 <tr> 187<TH><CODE><STRONG><EM>coloration</EM></STRONG></CODE></TH> 188<TD>Tunes the coefficients of the all-pass filter. Specify a value as 0.0 <= <EM>value</EM> <= 1.0. This number is used to simulate the acoustic properties of sound-reflective walls. In general, the smaller this value becomes, the coarser the reverberation density. In the opposite way, as this value increases the reverberation becomes more dense, but waveform interference may cause the high frequencies to stand out.</TD> 189 </tr> 190 <tr> 191<TH><CODE><STRONG><EM>damping</EM></STRONG></CODE></TH> 192<TD>Tunes the filter coefficient of the low-pass filter (LPF). Specify a value as 0.0 <= <EM>value</EM> <= 1.0. As this value approaches 0.0, the signal's low-frequency portion becomes its main content, and reverb begins to stand out. In the opposite way, as this value approaches 1.0, the high-frequency portion of the signal is passed with less attenuation, and reverb becomes less noticeable.</TD> 193 </tr> 194 <tr> 195<TH><CODE><STRONG><EM>crosstalk</EM></STRONG></CODE></TH> 196<TD>Sets the amount of interaction between channels. Specify a value as 0.0 <= <EM>value</EM> <= 1.0. If <CODE><STRONG><EM>crosstalk</EM></STRONG></CODE> is set to 0.0, the reverberation does not seep into other channels at all, and any interaction among the channels is eliminated. Specifying a value larger than 0.0 will cause the reverberation to affect other channels.</TD> 197 </tr> 198 <tr> 199<TH><CODE><STRONG><EM>earlyGain</EM></STRONG></CODE></TH> 200<TD>Mix gain of the initial reflected sound. Specify a value as 0.0 <= <EM>value</EM> <= 1.0.</TD> 201 </tr> 202 <tr> 203<TH><CODE><STRONG><EM>fusedGain</EM></STRONG></CODE></TH> 204<TD>Mix gain for the end of reverberation. Specify a value as 0.0 <= <EM>value</EM> <= 1.0.</TD> 205 </tr> 206 <tr> 207<TH><STRONG><CODE><EM>busIn</EM></CODE></STRONG></TH> 208<TD>Specifies the input buffer for effect bus sends.</TD> 209 </tr> 210 <tr> 211<TH><STRONG><CODE><EM>busOut</EM></CODE></STRONG></TH> 212<TD>Specifies the output buffer for effect bus sends.</TD> 213 </tr> 214 <tr> 215<TH><CODE><STRONG><EM>outGain</EM></STRONG></CODE></TH> 216<TD>Output gain. Specify a value as 0.0 <= <EM>value</EM> <= 1.0.</TD> 217 </tr> 218 <tr> 219<TH><STRONG><CODE><EM>sendGain</EM></CODE></STRONG></TH> 220<TD>Send gain to the next-level effect bus. Specify a value as 0.0 <= <EM>value</EM> <= 1.0.</TD> 221 </tr> 222</TABLE> 223 224<H2>Description</H2> 225<P>When using the High-Quality Reverb Expansion, you must assign appropriate values to the various parameters of the <code>AXFX_REVERBHI_EXP</CODE> or <CODE>AXFX_REVERBHI_EXP_DPL2</code> structure. The <code>AXFX_REVERBHI_EXP</code> structure is used normally, and the <code>AXFX_REVERBHI_EXP_DPL2</code> structure is used with Dolby Pro Logic II.</P> 226 227<H2>See Also</H2> 228<P class="reference"> 229</P> 230 231<H2>Revision History</H2> 232<P> 2332007/08/07 Initial version.<br> 234</P> 235 236<hr><p>CONFIDENTIAL</p></body> 237</HTML> 238