musix 0.3.3

Music player library for esoteric audio formats (music from C64,Amiga etc)
Documentation 
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
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175

/*
 * Adplug - Replayer for many OPL2/OPL3 audio file formats.
 * Copyright (C) 1999 - 2005 Simon Peter <dn.tlp@gmx.net>, et al.
 * 
 * This library is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public
 * License as published by the Free Software Foundation; either
 * version 2.1 of the License, or (at your option) any later version.
 * 
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * Lesser General Public License for more details.
 * 
 * You should have received a copy of the GNU Lesser General Public
 * License along with this library; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
 *
 * adlib.h - AdLib Sound Driver by Stas'M <binarymaster@mail.ru> and Jepael
 *
 * Based on ADLIB.H by Marc Savary and Dale Glowinski, Ad Lib Inc.
 */

#ifndef H_ADPLUG_ADLIBDRV
#define H_ADPLUG_ADLIBDRV

#include "stdint.h"
#include "player.h"

/* Parameters of each voice: */
#define nbLocParam		14

#define prmKsl			0
#define prmMulti		1
#define prmFeedBack		2		/* use for opr. 0 only */
#define prmAttack		3
#define prmSustain		4
#define prmStaining		5		/* Sustaining ... */
#define prmDecay		6
#define prmRelease		7
#define prmLevel		8
#define prmAm			9
#define prmVib			10
#define prmKsr			11
#define prmFm			12			/* use for opr. 0 only */
#define prmWaveSel		13			/* wave select */

 /* globals parameters: */
#define prmAmDepth		14
#define prmVibDepth		15
#define prmNoteSel		16
#define prmPercussion	17

 /* melodic voice numbers: */
#define vMelo0			0
#define vMelo1			1
#define vMelo2			2
#define vMelo3			3
#define vMelo4			4
#define vMelo5			5
#define vMelo6			6
#define vMelo7			7
#define vMelo8			8

 /* percussive voice numbers: */
#define BD				6
#define SD				7
#define TOM				8
#define CYMB			9
#define HIHAT			10

#define MAX_VOICES		11
#define MAX_VOLUME		0x7f
#define MAX_PITCH		0x3fff
#define MID_PITCH		0x2000

#define MID_C			60			/* MIDI standard mid C */
#define CHIP_MID_C		48			/* sound chip mid C */
#define NR_NOTES		96			/* # of notes we can play on chip */

#define TOM_PITCH	24				/* best frequency, in range of 0 to 95 */
#define TOM_TO_SD	7				/* 7 half-tones between voice 7 & 8 */
#define SD_PITCH	(TOM_PITCH + TOM_TO_SD)

#define NR_STEP_PITCH	25			/* 25 steps within a half-tone for pitch bend */
#define ADLIB_OPER_LEN	13			/* operator length */
#define ADLIB_INST_LEN	(ADLIB_OPER_LEN * 2 + 2)	/* modulator, carrier, mod/car wave select */

#define GetLocPrm(slot, prm) ( (uint8_t)paramSlot[slot][prm] )

class CadlibDriver
{
public:
	CadlibDriver(Copl *newopl)
		: opl(newopl)
	{};
	~CadlibDriver()
	{};

	void SoundWarmInit();
	void SetMode(int mode);
	void SetWaveSel(int state);
	void SetPitchRange(uint8_t pR);
	void SetGParam(int amD, int vibD, int nSel);
	void SetVoiceTimbre(uint8_t voice, int16_t * paramArray);
	void SetVoiceVolume(uint8_t voice, uint8_t volume);
	void SetVoicePitch(uint8_t voice, uint16_t pitchBend);
	void NoteOn(uint8_t voice, int pitch);
	void NoteOff(uint8_t voice);

private:
	Copl *opl;

	void InitSlotVolume();
	void InitFNums();
	void SoundChut(int voice);
	void SetFreq(uint8_t voice, int pitch, uint8_t keyOn);
	void SndSAmVibRhythm();
	void SndSNoteSel();
	void SndSKslLevel(uint8_t slot);
	void SndSFeedFm(uint8_t slot);
	void SndSAttDecay(uint8_t slot);
	void SndSSusRelease(uint8_t slot);
	void SndSAVEK(uint8_t slot);
	void SndWaveSelect(uint8_t slot);
	void SndSetAllPrm(uint8_t slot);
	void SetSlotParam(uint8_t slot, int16_t * param, uint8_t waveSel);
	void SetCharSlotParam(uint8_t slot, uint8_t * cParam, uint8_t waveSel);
	void InitSlotParams();
	void SetFNum(uint16_t * fNumVec, int num, int den);
	void ChangePitch(int voice, int pitchBend);
	long CalcPremFNum(int numDeltaDemiTon, int denDeltaDemiTon);

	uint16_t fNumNotes[NR_STEP_PITCH][12];
	int		halfToneOffset[MAX_VOICES];
	uint16_t * fNumFreqPtr[MAX_VOICES];
	int	 	pitchRange;			/* pitch variation, half-tone [+1,+12] */
	int 	pitchRangeStep;		/* == pitchRange * NR_STEP_PITCH */
	int		modeWaveSel;		/* != 0 if used with the 'wave-select' parameters */

	uint8_t percBits;				/* control bits of percussive voices */
	uint8_t notePitch[MAX_VOICES];	/* pitch of last note-on of each voice */
	uint8_t voiceKeyOn[MAX_VOICES];	/* state of keyOn bit of each voice */

	uint8_t noteDIV12[96];			/* table of (0..95) DIV 12 */
	uint8_t noteMOD12[96];			/* table of (0..95) MOD 12 */

	uint8_t slotRelVolume[18];		/* relative volume of slots */

	typedef uint8_t SLOT_PARAM;
	SLOT_PARAM paramSlot[18][nbLocParam];	/* all the parameters of slots...  */

	uint8_t amDepth;			/* chip global parameters .. */
	uint8_t vibDepth;			/* ... */
	uint8_t noteSel;			/* ... */
	uint8_t percussion;		/* percussion mode parameter */

protected:
	static const uint8_t percMasks[5];
	static uint8_t pianoParamsOp0[nbLocParam];
	static uint8_t pianoParamsOp1[nbLocParam];
	static uint8_t bdOpr0[nbLocParam];
	static uint8_t bdOpr1[nbLocParam];
	static uint8_t sdOpr[nbLocParam];
	static uint8_t tomOpr[nbLocParam];
	static uint8_t cymbOpr[nbLocParam];
	static uint8_t hhOpr[nbLocParam];
	static uint8_t slotVoice[9][2];
	static uint8_t slotPerc[5][2];
	static uint8_t offsetSlot[18];
	static uint8_t operSlot[18];
	static uint8_t voiceSlot[18];
};

#endif