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>SPPrepareSound</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">SPPrepareSound</h1>
14
15<h2>C Specification</h2>
16
17<dl>
18  <dd>
19<pre><CODE>#include &lt;revolution.h&gt;
20#include &lt;revolution/sp.h&gt;
21
22void SPPrepareSound(SPSoundEntry *sound, AXVPB *axvpb, u32 sampleRate);</CODE></pre>
23  </dd>
24</dl>
25
26<h2>Arguments</h2>
27
28<table border="1" cellpadding="3" cellspacing="0.1">
29  <tr>
30<td width="120" bgcolor="#ffffe8"><em><strong><code>sound</code></strong></em></td>
31    <td width="520">pointer to an <code>SPSoundEntry</code> structure</td>
32  </tr>
33  <tr>
34    <td width="120" bgcolor="#ffffe8"><em><strong><code>axvpb</code></strong></em></td>
35    <td width="520">pointer to the <code>AXVPB</code> structure associated with an allocated AX voice</td>
36  </tr>
37  <tr>
38<td width="120" bgcolor="#ffffe8"><em><strong><code>sampleRate</code></strong></em></td>
39    <td width="520">the SE playback frequency</td>
40  </tr>
41</table>
42
43<h2>Return Values</h2>
44
45<p>None.</p>
46
47<h2>Description</h2>
48
49<p>This function initializes the AX voice specified by <code>axvpb</code>, based on the SE information (<code>sound</code>) and the playback frequency (<code>sampleRate</code>). If there is no need to convert the SE playback frequency, set the SE default playback frequency (<code>sound-&gt;sampleRate</code>) to <code>sampleRate</code>.</p>
50
51<p><STRONG>NB</STRONG>: This function sets only the <code>AXPBADDR</code> and <code>AXPBSRC</code> parameters for the specified AX voice. Calling this function does not start SE playback.</p>
52
53<h2>See Also</h2>
54
55<p><code><a href="SPSoundEntry.html">SPSoundEntry</a></code></p>
56
57<h2>Revision History</h2>
58<P>03/01/2006 Initial version.</P>
59
60</body>
61</html>
62