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>axvpb.pb.ve</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">axvpb.pb.ve</h1>
15
16<h2>Syntax</h2>
17<dl><dd><pre class="construction">
18typedef struct _AXPBVE
19{
20
21    u16 currentVolume;  // volume at start of frame, 0x8000 = 1.0
22    s16 currentDelta;   // signed per sample delta (96 samples per frame)
23
24} AXPBVE;
25</pre></dd></dl>
26
27<h2>Description</h2>
28<p>The <SPAN class="argument">ve</SPAN> values are used to store context for the volume envelope.</p>
29
30<p>The <SPAN class="argument">currentDelta</SPAN> parameter dictates how the volume will change for the current frame (or until it has been modified by an update directive). The <SPAN class="argument">currentDelta</SPAN> value will be added to the <SPAN class="argument">currentVolume</SPAN> value on a per-sample basis. Be aware that the DSP does not clamp this computation. Your audio application is responsible for ensuring that the computation remains within bounds. Please see the <code>MIX</code> application library for an example of this computation.</p>
31
32<p><strong><B>Note:</B></strong> <SPAN class="argument">currentDelta</SPAN> can only modify <SPAN class="argument">currentVolume</SPAN> in multiples of 96 per audio frame. Please see the <code>MIX</code> library source code for an example of <code>AXPBVE</code> usage.</p>
33
34<p>To synchronize the <code>AXPBVE</code> structure, assert the <code>AX_SYNC_USER_VE</code> bit in the <code>axvpb.sync</code> member.</p>
35
36<p>Assert the <code>AX_SYNC_USER_VEDELTA</code> bit when only the delta value has changed.</p>
37
38<h2>See Also</h2>
39<p class="reference">
40<a href="../Voice_Parameter_Blocks/sync.html">axvpb.sync</a>, <a href="../Voice_Parameters/AXSetVoiceVe.html">AXSetVoiceVe</a>, <a href="../Voice_Parameters/AXSetVoiceVeDelta.html">AXSetVoiceVeDelta</a>
41</p>
42
43<h2>Revision History</h2>
44<P>
452006/10/25 Made revisions in line with the change in the audio frame length.<br>2006/03/01 Initial version.<br>
46</P>
47
48<hr><p>CONFIDENTIAL</p></body>
49</html>
50