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>SYNInitSynth</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">SYNInitSynth</h1>
14
15<h2>Syntax</h2>
16<dl><dd><pre class="construction">
17#include &lt;revolution.h&gt;
18#include &lt;revolution/syn.h&gt;
19
20void SYNInitSynth(
21                 SYNSYNTH *synth,
22                 u8       *wavetable,
23                 u8       *samples,
24                 u8       *zerobuffer,
25                 u32      priorityVoiceAlloc,
26                 u32      priorityNoteOn,
27                 u32      priorityNoteRelease
28                 );
29</pre></dd></dl>
30
31<h2>Arguments</h2>
32<TABLE class="arguments" border="1" >
33  <tr>
34<th>synth</th>
35<td>Pointer to the user-allocated <code>SYNSYNTH</code> data structure.</td>
36  </tr>
37  <tr>
38<th>wavetable</th>
39<td>Pointer to contents of the WT file in memory.</td>
40  </tr>
41  <tr>
42<th>samples</th>
43<td>Pointer to contents of the PCM file in memory.</td>
44  </tr>
45  <tr>
46<th>zerobuffer</th>
47<td>Pointer to the zero buffer in memory.<strong> (Not used. Specify <code>NULL</code>.)</strong></td>
48  </tr>
49  <tr>
50<th>priorityVoiceAlloc</th>
51<td>Priority for allocating AX voices to handle MIDI notes with events.<br>maximum: 31<br>minimum: 1</td>
52  </tr>
53  <tr>
54<th>priorityNoteOn</th>
55<td>Priority at which to set voices after successful allocation.<br>maximum: 31<br>minimum: 1</td>
56  </tr>
57  <tr>
58<th>priorityNoteRelease</th>
59<td>Priority at which to set voices after a MIDI key-off event.<br>maximum: 31<br>minimum: 1</td>
60  </tr>
61</table>
62
63<h2>Return Values</h2>
64<p>None.</p>
65
66<h2>Description</h2>
67<p><code>SYNInitSynth</code> initializes a user-allocated instance of the synthesizer. Any number of synthesizer instances may be used. All running synthesizers will contend for the same pool of AX voices at runtime. <code>SYNInitSynth</code> must be called prior to any other function calls for the specific instance of the synthesizer.</p>
68
69<h2>See Also</h2>
70<p class="reference">
71<a href="SYNInit.html"><CODE>SYNInit</CODE></a>
72</p>
73
74<h2>Revision History</h2>
75<P>
762006/11/21 Added an explanation to the arguments about the zero buffer no longer being necessary.<br>2006/03/01 Initial version.<br>
77</P>
78
79<hr><p>CONFIDENTIAL</p></body>
80</html>
81