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>SEQAddSequence</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">SEQAddSequence</h1>
14
15<h2>C Specification</h2>
16
17<dl>
18  <dd>
19<pre><CODE>#include &lt;revolution.h&gt;
20  #include &lt;revolution/seq.h&gt;
21
22  void SEQAddSequence(
23                     SEQSEQUENCE     *sequence,
24                     u8              *midiStream,
25                     u8              *wavetable,
26                     u8              *samples,
27                     u8              *zerobuffer,
28                     u32             priorityVoiceAlloc,
29                     u32             priorityNoteOn,
30                     u32             priorityNoteRelease
31);</CODE></pre>
32  </dd>
33</dl>
34
35<h2>Arguments</h2>
36
37<table border="1" cellpadding="3" cellspacing="0.1">
38  <tr>
39<td width="120" bgcolor="#ffffe8"><em><strong><code>sequence</code></strong></em></td>
40<td width="520">pointer to user-allocated <code>SEQSEQUENCE</code> structure</td>
41  </tr>
42  <tr>
43<TD width="120" bgcolor="#ffffe8"><em><strong><code>midiStream</code></strong></em></TD>
44<td width="520">pointer to MIDI data</td>
45  </tr>
46  <tr>
47<TD width="120" bgcolor="#ffffe8"><em><strong><code>wavetable</code></strong></em></TD>
48<td width="520">pointer to wave table</td>
49  </tr>
50  <tr>
51<TD width="120" bgcolor="#ffffe8"><em><strong><code>samples</code></strong></em></TD>
52<td width="520">pointer to sample set corresponding to wave table</td>
53  </tr>
54  <tr>
55<TD width="120" bgcolor="#ffffe8"><em><strong><code>zerobuffer</code></strong></em></TD>
56<td width="520">Pointer to zero buffer. <strong>(Not used. Specify <code>NULL </code>.)</strong></td>
57  </tr>
58  <tr>
59<TD width="120" bgcolor="#ffffe8"><em><strong><code>priorityVoiceAlloc</code></strong></em></TD>
60<td width="520">priority used to allocate AX voice for note on<br>maximum: 31<br>minimum: 1</td>
61  </tr>
62  <tr>
63<TD width="120" bgcolor="#ffffe8"><em><strong><code>priorityNoteOn</code></strong></em></TD>
64<td width="520">priority at which to set voices after successful allocation<br>maximum: 31<br>minimum: 1</td>
65  </tr>
66  <tr>
67<TD width="120" bgcolor="#ffffe8"><em><strong><code>priorityNoteRelease</code></strong></em></TD>
68<td width="520">priority at which to set voices for note off <br>maximum: 31<br>minimum: 1</td>
69  </tr>
70</table>
71
72<h2>Return Values</h2>
73
74<p>None.</p>
75
76<h2>Description</h2>
77
78<p>This function initializes a user-allocated <code>SEQUENCE</code> structure and adds it to the sequence list.</p>
79
80<p>The <code>SEQSEQUENCE</code> structure contains the <code>SYNSYNTH</code> structure that is used for sequence play. Internally, the <CODE>SEQAddSequence</CODE> function also initializes the <code>SYNSYNTH</code> structure.</p>
81
82<h2>See Also</h2>
83<p>
84<code><a href="SEQRemoveSequence.html">SEQRemoveSequence</a></code>
85</p>
86
87<h2>Revision History</h2>
88<P>
892006/11/21 Added an explanation to the arguments about the zero buffer no longer being necessary.<br>2006/03/01 Initial version.
90</P>
91<hr>
92<P>CONFIDENTIAL</p>
93</BODY>
94</HTML>
95