alBnkfNew.3p
1.11 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
.TH alBnkfNew 3P local "Silicon Graphics, Inc."
.SH NAME
.upperok
alBnkfNew \- initializes a Bank File for use on the Ultra 64
.SH SYNOPSIS
.nf
\f3
.Op c
#include <libaudio.h>
.sp .8v
void alBnkfNew(ALBankFile *ctl, u8 *tbl);
.Op
\f1
.fi
.SH PARAMETERS
.TP 10
.I bnk
pointer to the control (.ctl) data.
.TP
.I tbl
pointer to the wavetable (.tbl) data.
.SH DESCRIPTION
The instrument compiler
.I ic (3p)
creates two files, the control (.ctl) file and the wavetable (.tbl)
file. The controlfile contains instrument performance information and
the wavetable file contains the actual wavetable data.
.PP
The control file format specifies that references to bank data be
stored as offsets from the beginning of the control file. To improve
runtime performance, the offsets are converted to virtual addresses by
alBnkfNew.
.PP
Typically, the control (.ctl) file is loaded into DRAM while the table
file (.tbl) is left in the Cart ROM because of its size. If your table
file is small, you can optionally load that into DRAM to minimize DMA
requests while the sequence is playing.
.SH SEE ALSO
.IR ic (3P),
.IR alSeqpSetBank (3P)