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 <strong>(Not used. Specify <code>NULL</code>.)</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. <CODE>SYNInitSynth</CODE> 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>
802006/11/21 Added an explanation to the arguments about the zero buffer no longer being necessary.<br>2006/03/01 Initial version.
81</P>
82<hr>
83<P>CONFIDENTIAL</p>
84</BODY>
85</HTML>
86