22 #ifndef AUDIO_MIDIDRV_H 23 #define AUDIO_MIDIDRV_H 25 #include "common/scummsys.h" 26 #include "common/str.h" 27 #include "common/stream.h" 28 #include "common/timer.h" 29 #include "common/array.h" 88 MDT_APPLEIIGS = 1 << 6,
93 MDT_PREFER_MT32 = 1 << 11,
94 MDT_PREFER_GM = 1 << 12,
95 MDT_PREFER_FLUID= 1 << 13,
96 MDT_MACINTOSH = 1 << 14
104 static const uint8 MIDI_CHANNEL_COUNT = 16;
105 static const uint8 MIDI_RHYTHM_CHANNEL = 9;
107 static const byte MIDI_COMMAND_NOTE_OFF = 0x80;
108 static const byte MIDI_COMMAND_NOTE_ON = 0x90;
109 static const byte MIDI_COMMAND_POLYPHONIC_AFTERTOUCH = 0xA0;
110 static const byte MIDI_COMMAND_CONTROL_CHANGE = 0xB0;
111 static const byte MIDI_COMMAND_PROGRAM_CHANGE = 0xC0;
112 static const byte MIDI_COMMAND_CHANNEL_AFTERTOUCH = 0xD0;
113 static const byte MIDI_COMMAND_PITCH_BEND = 0xE0;
114 static const byte MIDI_COMMAND_SYSTEM = 0xF0;
116 static const byte MIDI_CONTROLLER_BANK_SELECT_MSB = 0x00;
117 static const byte MIDI_CONTROLLER_MODULATION = 0x01;
118 static const byte MIDI_CONTROLLER_DATA_ENTRY_MSB = 0x06;
119 static const byte MIDI_CONTROLLER_VOLUME = 0x07;
120 static const byte MIDI_CONTROLLER_BALANCE = 0x08;
121 static const byte MIDI_CONTROLLER_PANNING = 0x0A;
122 static const byte MIDI_CONTROLLER_EXPRESSION = 0x0B;
123 static const byte MIDI_CONTROLLER_BANK_SELECT_LSB = 0x20;
124 static const byte MIDI_CONTROLLER_DATA_ENTRY_LSB = 0x26;
125 static const byte MIDI_CONTROLLER_SUSTAIN = 0x40;
126 static const byte MIDI_CONTROLLER_PORTAMENTO = 0x41;
127 static const byte MIDI_CONTROLLER_SOSTENUTO = 0x42;
128 static const byte MIDI_CONTROLLER_SOFT = 0x43;
129 static const byte MIDI_CONTROLLER_REVERB = 0x5B;
130 static const byte MIDI_CONTROLLER_CHORUS = 0x5D;
131 static const byte MIDI_CONTROLLER_RPN_LSB = 0x64;
132 static const byte MIDI_CONTROLLER_RPN_MSB = 0x65;
133 static const byte MIDI_CONTROLLER_ALL_SOUND_OFF = 0x78;
134 static const byte MIDI_CONTROLLER_RESET_ALL_CONTROLLERS = 0x79;
135 static const byte MIDI_CONTROLLER_ALL_NOTES_OFF = 0x7B;
136 static const byte MIDI_CONTROLLER_OMNI_ON = 0x7C;
137 static const byte MIDI_CONTROLLER_OMNI_OFF = 0x7D;
138 static const byte MIDI_CONTROLLER_MONO_ON = 0x7E;
139 static const byte MIDI_CONTROLLER_POLY_ON = 0x7F;
141 static const uint16 MIDI_RPN_PITCH_BEND_SENSITIVITY = 0x0000;
142 static const uint16 MIDI_RPN_MASTER_TUNING_FINE = 0x0001;
143 static const uint16 MIDI_RPN_MASTER_TUNING_COARSE = 0x0002;
144 static const uint16 MIDI_RPN_NULL = 0x7F7F;
146 static const uint8 MIDI_META_END_OF_TRACK = 0x2F;
147 static const uint8 MIDI_META_SEQUENCER = 0x7F;
149 static const uint16 MIDI_PITCH_BEND_DEFAULT = 0x2000;
150 static const uint8 MIDI_PANNING_DEFAULT = 0x40;
151 static const uint8 MIDI_EXPRESSION_DEFAULT = 0x7F;
152 static const uint16 MIDI_MASTER_TUNING_FINE_DEFAULT = 0x2000;
153 static const uint8 MIDI_MASTER_TUNING_COARSE_DEFAULT = 0x40;
155 static const uint8 MT32_PITCH_BEND_SENSITIVITY_DEFAULT = 0x0C;
156 static const uint8 GM_PITCH_BEND_SENSITIVITY_DEFAULT = 0x02;
158 static const uint8 GS_RHYTHM_FIRST_NOTE = 0x1B;
159 static const uint8 GS_RHYTHM_LAST_NOTE = 0x58;
171 virtual void send(uint32 b) = 0;
178 virtual void send(int8 source, uint32 b) {
send(b); }
187 void send(byte status, byte firstOp, byte secondOp);
194 void send(int8 source, byte status, byte firstOp, byte secondOp);
206 virtual void sysEx(
const byte *msg, uint16 length) { }
223 virtual void metaEvent(byte type, byte *data, uint16 length) { }
230 virtual void metaEvent(int8 source, byte type, byte *data, uint16 length) {
metaEvent(type, data, length); }
248 virtual void stopAllNotes(
bool stopSustainedNotes =
false);
258 virtual bool isReady(int8 source = -1) {
return true; }
310 enum DeviceStringType {
320 static MidiDriver *createMidi(DeviceHandle handle);
323 static DeviceHandle detectDevice(
int flags);
326 static DeviceHandle getDeviceHandle(
const Common::String &identifier);
329 static bool checkDevice(DeviceHandle handle);
332 static MusicType getMusicType(DeviceHandle handle);
335 static Common::String getDeviceString(DeviceHandle handle, DeviceStringType type);
338 void midiDriverCommonSend(uint32 b);
341 void midiDriverCommonSysEx(
const byte *msg, uint16 length);
349 static bool _forceTypeMT32;
354 static const byte _mt32ToGm[128];
355 static const byte _gmToMt32[128];
362 MERR_CANNOT_CONNECT = 1,
364 MERR_DEVICE_NOT_AVAILABLE = 3,
365 MERR_ALREADY_OPEN = 4
371 PROP_CHANNEL_MASK = 3,
383 PROP_USER_VOLUME_SCALING = 5,
402 PROP_MIDI_DATA_REVERSE_PANNING = 6,
414 PROP_OPL_ACCURACY_MODE = 7,
434 PROP_OPL_CHANNEL_ALLOCATION_MODE = 8,
445 PROP_MILES_VERSION = 9,
459 PROP_OPL_RHYTHM_MODE_IGNORE_NOTE_OFF = 10
466 virtual int open() = 0;
471 virtual bool isOpen()
const = 0;
474 virtual void close() = 0;
477 virtual uint32
property(
int prop, uint32 param) {
return 0; }
480 static const char *getErrorName(
int error_code);
483 virtual void setPitchBendRange(byte channel, uint range) {
484 send(MIDI_COMMAND_CONTROL_CHANGE | channel, MIDI_CONTROLLER_RPN_MSB, MIDI_RPN_PITCH_BEND_SENSITIVITY >> 8);
485 send(MIDI_COMMAND_CONTROL_CHANGE | channel, MIDI_CONTROLLER_RPN_LSB, MIDI_RPN_PITCH_BEND_SENSITIVITY & 0xFF);
486 send(MIDI_COMMAND_CONTROL_CHANGE | channel, MIDI_CONTROLLER_DATA_ENTRY_MSB, range);
487 send(MIDI_COMMAND_CONTROL_CHANGE | channel, MIDI_CONTROLLER_DATA_ENTRY_LSB, 0);
488 send(MIDI_COMMAND_CONTROL_CHANGE | channel, MIDI_CONTROLLER_RPN_MSB, MIDI_RPN_NULL >> 8);
489 send(MIDI_COMMAND_CONTROL_CHANGE | channel, MIDI_CONTROLLER_RPN_LSB, MIDI_RPN_NULL & 0xFF);
495 void sendMT32Reset();
506 virtual uint32 getBaseTempo() = 0;
516 virtual bool acceptsSoundFontData() {
return false; }
524 virtual byte getNumber() = 0;
525 virtual void release() = 0;
527 virtual void send(uint32 b) = 0;
530 virtual void noteOff(byte note) = 0;
531 virtual void noteOn(byte note, byte velocity) = 0;
532 virtual void programChange(byte program) = 0;
533 virtual void pitchBend(int16 bend) = 0;
536 virtual void controlChange(byte control, byte value) = 0;
537 virtual void modulationWheel(byte value) { controlChange(MidiDriver::MIDI_CONTROLLER_MODULATION, value); }
538 virtual void volume(byte value) { controlChange(MidiDriver::MIDI_CONTROLLER_VOLUME, value); }
539 virtual void panPosition(byte value) { controlChange(MidiDriver::MIDI_CONTROLLER_PANNING, value); }
540 virtual void pitchBendFactor(byte value) = 0;
541 virtual void transpose(int8 value) {}
542 virtual void detune(int16 value) { controlChange(17, value & 0xff); }
543 virtual void priority(byte value) { }
544 virtual void sustain(
bool value) { controlChange(MidiDriver::MIDI_CONTROLLER_SUSTAIN, value ? 1 : 0); }
545 virtual void effectLevel(byte value) { controlChange(MidiDriver::MIDI_CONTROLLER_REVERB, value); }
546 virtual void chorusLevel(byte value) { controlChange(MidiDriver::MIDI_CONTROLLER_CHORUS, value); }
547 virtual void allNotesOff() { controlChange(MidiDriver::MIDI_CONTROLLER_ALL_NOTES_OFF, 0); }
550 virtual void sysEx_customInstrument(uint32 type,
const byte *instr, uint32 dataSize) = 0;
virtual uint32 property(int prop, uint32 param)
Definition: mididrv.h:477
void midiDumpDo(uint32 b)
int midiDumpVarLength(const uint32 &delta)
virtual void metaEvent(int8 source, byte type, byte *data, uint16 length)
Definition: mididrv.h:230
bool _midiDumpEnable
Definition: mididrv.h:266
uint32 DeviceHandle
Definition: mididrv.h:308
MusicType
Definition: mididrv.h:44
void(* TimerProc)(void *refCon)
Definition: timer.h:42
MidiDriverFlags
Definition: mididrv.h:80
virtual void stopAllNotes(bool stopSustainedNotes=false)
Definition: mididrv.h:299
virtual bool isReady(int8 source=-1)
Definition: mididrv.h:258
virtual void send(int8 source, uint32 b)
Definition: mididrv.h:178
Common::Array< byte > _midiDumpCache
Definition: mididrv.h:272
Definition: mididrv.h:102
void midiDumpSysEx(const byte *msg, uint16 length)
Definition: mididrv.h:519
uint32 _prevMillis
Definition: mididrv.h:269
virtual void sysEx(const byte *msg, uint16 length)
Definition: mididrv.h:206
virtual void send(uint32 b)=0
virtual uint16 sysExNoDelay(const byte *msg, uint16 length)
Definition: mididrv.h:220