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>C Specification</h2>
16<BLOCKQUOTE>
17<pre><CODE>#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                 );</CODE></pre>
29</BLOCKQUOTE>
30
31<h2>Arguments</h2>
32
33<table border="1" cellpadding="3" cellspacing="0.1">
34  <tr>
35<td width="120" bgcolor="#ffffe8"><em><strong><code>synth</code></strong></em></td>
36<td width="520">pointer to user-allocated <code>SYNSYNTH</code> data structure</td>
37  </tr>
38  <tr>
39<td width="120" bgcolor="#ffffe8"><em><strong><code>wavetable</code></strong></em></td>
40<td width="520">pointer to contents of WT file in memory</td>
41  </tr>
42  <tr>
43<td width="120" bgcolor="#ffffe8"><em><strong><code>samples</code></strong></em></td>
44    <td width="520">pointer to contents of PCM file in memory</td>
45  </tr>
46  <tr>
47    <td width="120" bgcolor="#ffffe8"><em><strong><code>zerobuffer</code></strong></em></td>
48    <td width="520">pointer to  zero buffer in memory</td>
49  </tr>
50  <tr>
51<td width="120" bgcolor="#ffffe8"><em><strong><code>priorityVoiceAlloc</code></strong></em></td>
52<td width="520">priority for allocating AX voices to handle MIDI notes with events<br>maximum: 31<br>minimum: 1</td>
53  </tr>
54  <tr>
55<td width="120" bgcolor="#ffffe8"><em><strong><code>priorityNoteOn</code></strong></em></td>
56<td width="520">priority at which to set voices after successful allocation<br>maximum: 31<br>minimum: 1</td>
57  </tr>
58  <tr>
59<td width="120" bgcolor="#ffffe8"><em><strong><code>priorityNoteRelease</code></strong></em></td>
60<td width="520">priority at which to set voices after MIDI keyoff event<br>maximum: 31<br>minimum: 1</td>
61  </tr>
62</table>
63
64<h2>Return Values</h2>
65
66<p>None.</p>
67
68<h2>Description</h2>
69
70<p>This function 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. This function must be called prior to any other API calls for the specific instance of the synthesizer.</p>
71
72<h2>See Also</h2>
73
74<p>
75<code><a href="SYNInit.html">SYNInit</a></code>
76</p>
77
78<h2>Revision History</h2>
79<P>03/01/2006 Initial version.</P>
80
81</body>
82</html>
83