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
17<h2>C Specification</h2>
18<BLOCKQUOTE>
19<pre><CODE>typedef struct _AXPBVE
20{
21
22    u16 currentVolume;  // volume at start of frame, 0x8000 = 1.0
23    s16 currentDelta;   // signed per sample delta (96 samples per frame)
24
25} AXPBVE;</CODE></pre>
26</BLOCKQUOTE>
27<h2>Description</h2>
28
29<p>The <CODE>VE</CODE> values are used to store context for the volume envelope.</p>
30
31<p>The <code>currentDelta</code> parameter dictates how the volume will change for the current frame (or until it has been modified by an update directive). The <code>currentDelta</code> value will be added to the <code>currentVolume</code> value on a per-sample basis. <BR><BR><B>Note:</B> 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>
32
33<p><strong><B>Note:</B></strong> <code>currentDelta</code> can only modify <code>currentVolume</code> 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>
34
35<p>To synchronize the <code>AXPBVE</code> structure, assert the <code>AX_SYNC_USER_VE</code> bit in the <code>axvpb.sync</code> word.</p>
36
37<p>Assert the <code>AX_SYNC_USER_VEDELTA</code> bit when only the delta value has changed.</p>
38
39<h2>See Also</h2>
40
41<p>
42<code><a href="../Voice_Parameter_Blocks/sync.html">axvpb.sync</a><br> <a href="../Voice_Parameters/AXSetVoiceVe.html">AXSetVoiceVe</a><br> <a href="../Voice_Parameters/AXSetVoiceVeDelta.html">AXSetVoiceVeDelta</a></code>
43</p>
44
45<h2>Revision History</h2>
46
47<P>
482006/03/01 Initial version. <BR>2006/10/25 Made revisions in line with the change in the audio frame length.
49</P>
50
51<hr>
52<P>CONFIDENTIAL</p>
53</BODY>
54</HTML>
55