2007-05-30 21:56:52 +00:00
|
|
|
/* ScummVM - Graphic Adventure Engine
|
|
|
|
*
|
|
|
|
* ScummVM is the legal property of its developers, whose names
|
|
|
|
* are too numerous to list here. Please refer to the COPYRIGHT
|
|
|
|
* file distributed with this source distribution.
|
2002-04-21 17:46:42 +00:00
|
|
|
*
|
|
|
|
* This program is free software; you can redistribute it and/or
|
|
|
|
* modify it under the terms of the GNU General Public License
|
|
|
|
* as published by the Free Software Foundation; either version 2
|
|
|
|
* of the License, or (at your option) any later version.
|
|
|
|
|
|
|
|
* This program 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 General Public License for more details.
|
|
|
|
|
|
|
|
* You should have received a copy of the GNU General Public License
|
|
|
|
* along with this program; if not, write to the Free Software
|
2005-10-18 01:30:26 +00:00
|
|
|
* Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
|
2002-04-21 17:46:42 +00:00
|
|
|
*
|
2006-02-11 10:05:31 +00:00
|
|
|
* $URL$
|
|
|
|
* $Id$
|
2002-04-21 17:46:42 +00:00
|
|
|
*
|
|
|
|
*/
|
|
|
|
|
2002-09-08 01:08:12 +00:00
|
|
|
#ifndef SOUND_MIDIDRV_H
|
|
|
|
#define SOUND_MIDIDRV_H
|
|
|
|
|
2003-08-01 12:21:04 +00:00
|
|
|
#include "common/scummsys.h"
|
2011-04-24 08:34:27 +00:00
|
|
|
#include "common/str.h"
|
2003-10-18 13:04:59 +00:00
|
|
|
#include "common/timer.h"
|
2002-09-08 01:08:12 +00:00
|
|
|
|
2002-11-26 16:54:58 +00:00
|
|
|
class MidiChannel;
|
2003-10-02 22:52:57 +00:00
|
|
|
|
2010-06-21 21:36:36 +00:00
|
|
|
/**
|
|
|
|
* Music types that music drivers can implement and engines can rely on.
|
|
|
|
*/
|
|
|
|
enum MusicType {
|
2010-08-11 19:32:07 +00:00
|
|
|
MT_INVALID = -1, // Invalid output
|
|
|
|
MT_AUTO = 0, // Auto
|
|
|
|
MT_NULL, // Null
|
|
|
|
MT_PCSPK, // PC Speaker
|
|
|
|
MT_PCJR, // PCjr
|
|
|
|
MT_CMS, // CMS
|
|
|
|
MT_ADLIB, // AdLib
|
|
|
|
MT_C64, // C64
|
|
|
|
MT_AMIGA, // Amiga
|
|
|
|
MT_APPLEIIGS, // Apple IIGS
|
|
|
|
MT_TOWNS, // FM-TOWNS
|
|
|
|
MT_PC98, // PC98
|
|
|
|
MT_GM, // General MIDI
|
|
|
|
MT_MT32, // MT-32
|
|
|
|
MT_GS // Roland GS
|
2003-10-02 22:52:57 +00:00
|
|
|
};
|
|
|
|
|
2005-12-26 11:18:25 +00:00
|
|
|
/**
|
2010-06-21 21:36:36 +00:00
|
|
|
* A set of flags to be passed to detectDevice() which can be used to
|
2005-12-29 16:55:21 +00:00
|
|
|
* specify what kind of music driver is preferred / accepted.
|
|
|
|
*
|
2011-03-01 08:32:17 +00:00
|
|
|
* The flags (except for MDT_PREFER_MT32 and MDT_PREFER_GM) indicate whether a
|
|
|
|
* given driver type is acceptable. E.g. the TOWNS music driver could be
|
|
|
|
* returned by detectDevice if and only if MDT_TOWNS is specified.
|
|
|
|
*
|
|
|
|
* MDT_PREFER_MT32 and MDT_PREFER_GM indicate the MIDI device type to use when
|
|
|
|
* no device is selected in the music options, or when the MIDI device selected
|
|
|
|
* does not match the requirements of a game engine. With these flags, more
|
|
|
|
* priority is given to an MT-32 device, or a GM device respectively.
|
|
|
|
*
|
2005-12-29 16:55:21 +00:00
|
|
|
* @todo Rename MidiDriverFlags to MusicDriverFlags
|
2005-12-26 11:18:25 +00:00
|
|
|
*/
|
|
|
|
enum MidiDriverFlags {
|
2010-08-11 18:54:56 +00:00
|
|
|
MDT_NONE = 0,
|
2011-03-23 11:58:01 +00:00
|
|
|
MDT_PCSPK = 1 << 0, // PC Speaker: Maps to MT_PCSPK and MT_PCJR
|
|
|
|
MDT_CMS = 1 << 1, // Creative Music System / Gameblaster: Maps to MT_CMS
|
2010-08-11 19:32:07 +00:00
|
|
|
MDT_PCJR = 1 << 2, // Tandy/PC Junior driver
|
|
|
|
MDT_ADLIB = 1 << 3, // AdLib: Maps to MT_ADLIB
|
|
|
|
MDT_C64 = 1 << 4,
|
|
|
|
MDT_AMIGA = 1 << 5,
|
|
|
|
MDT_APPLEIIGS = 1 << 6,
|
|
|
|
MDT_TOWNS = 1 << 7, // FM-TOWNS: Maps to MT_TOWNS
|
|
|
|
MDT_PC98 = 1 << 8, // FM-TOWNS: Maps to MT_PC98
|
|
|
|
MDT_MIDI = 1 << 9, // Real MIDI
|
|
|
|
MDT_PREFER_MT32 = 1 << 10, // MT-32 output is preferred
|
|
|
|
MDT_PREFER_GM = 1 << 11 // GM output is preferred
|
2004-12-02 00:33:42 +00:00
|
|
|
};
|
2003-10-18 00:22:46 +00:00
|
|
|
|
2011-03-23 12:04:46 +00:00
|
|
|
/**
|
|
|
|
* TODO: Document this, give it a better name.
|
|
|
|
*/
|
|
|
|
class MidiDriver_BASE {
|
|
|
|
public:
|
|
|
|
virtual ~MidiDriver_BASE() { }
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Output a packed midi command to the midi stream.
|
|
|
|
* The 'lowest' byte (i.e. b & 0xFF) is the status
|
|
|
|
* code, then come (if used) the first and second
|
|
|
|
* opcode.
|
|
|
|
*/
|
|
|
|
virtual void send(uint32 b) = 0;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Output a midi command to the midi stream. Convenience wrapper
|
|
|
|
* around the usual 'packed' send method.
|
|
|
|
*
|
|
|
|
* Do NOT use this for sysEx transmission; instead, use the sysEx()
|
|
|
|
* method below.
|
|
|
|
*/
|
|
|
|
void send(byte status, byte firstOp, byte secondOp) {
|
|
|
|
send(status | ((uint32)firstOp << 8) | ((uint32)secondOp << 16));
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Transmit a sysEx to the midi device.
|
|
|
|
*
|
|
|
|
* The given msg MUST NOT contain the usual SysEx frame, i.e.
|
|
|
|
* do NOT include the leading 0xF0 and the trailing 0xF7.
|
|
|
|
*
|
|
|
|
* Furthermore, the maximal supported length of a SysEx
|
|
|
|
* is 264 bytes. Passing longer buffers can lead to
|
|
|
|
* undefined behavior (most likely, a crash).
|
|
|
|
*/
|
|
|
|
virtual void sysEx(const byte *msg, uint16 length) { }
|
|
|
|
|
|
|
|
// TODO: Document this.
|
|
|
|
virtual void metaEvent(byte type, byte *data, uint16 length) { }
|
|
|
|
};
|
|
|
|
|
2005-12-29 16:55:21 +00:00
|
|
|
/**
|
|
|
|
* Abstract MIDI Driver Class
|
|
|
|
*
|
|
|
|
* @todo Rename MidiDriver to MusicDriver
|
|
|
|
*/
|
2011-03-23 12:04:46 +00:00
|
|
|
class MidiDriver : public MidiDriver_BASE {
|
2004-12-02 00:33:42 +00:00
|
|
|
public:
|
2010-06-29 00:29:35 +00:00
|
|
|
/**
|
|
|
|
* The device handle.
|
|
|
|
*
|
|
|
|
* The value 0 is reserved for an invalid device for now.
|
|
|
|
* TODO: Maybe we should use -1 (i.e. 0xFFFFFFFF) as
|
|
|
|
* invalid device?
|
|
|
|
*/
|
2010-06-21 21:36:36 +00:00
|
|
|
typedef uint32 DeviceHandle;
|
2005-12-30 14:18:21 +00:00
|
|
|
|
2010-06-21 21:36:36 +00:00
|
|
|
enum DeviceStringType {
|
|
|
|
kDriverName,
|
|
|
|
kDriverId,
|
|
|
|
kDeviceId
|
|
|
|
};
|
2004-12-02 00:33:42 +00:00
|
|
|
|
2010-06-21 21:36:36 +00:00
|
|
|
static uint32 musicType2GUIO(uint32 musicType);
|
2010-06-15 10:56:12 +00:00
|
|
|
|
2010-06-25 22:37:19 +00:00
|
|
|
/** Create music driver matching the given device handle, or NULL if there is no match. */
|
2010-06-21 21:36:36 +00:00
|
|
|
static MidiDriver *createMidi(DeviceHandle handle);
|
|
|
|
|
2010-06-25 22:37:19 +00:00
|
|
|
/** Returns device handle based on the present devices and the flags parameter. */
|
2010-06-21 21:36:36 +00:00
|
|
|
static DeviceHandle detectDevice(int flags);
|
2010-07-21 18:17:51 +00:00
|
|
|
|
2010-06-25 22:37:19 +00:00
|
|
|
/** Find the music driver matching the given driver name/description. */
|
2010-06-21 21:36:36 +00:00
|
|
|
static DeviceHandle getDeviceHandle(const Common::String &identifier);
|
2004-12-02 00:33:42 +00:00
|
|
|
|
2010-06-21 21:36:36 +00:00
|
|
|
/** Get the music type matching the given device handle, or MT_AUTO if there is no match. */
|
|
|
|
static MusicType getMusicType(DeviceHandle handle);
|
2004-12-02 00:33:42 +00:00
|
|
|
|
2010-06-25 22:37:19 +00:00
|
|
|
/** Get the device description string matching the given device handle and the given type. */
|
2010-06-21 21:36:36 +00:00
|
|
|
static Common::String getDeviceString(DeviceHandle handle, DeviceStringType type);
|
2004-12-02 00:33:42 +00:00
|
|
|
|
2010-06-21 21:36:36 +00:00
|
|
|
private:
|
|
|
|
// If detectDevice() detects MT32 and we have a preferred MT32 device
|
|
|
|
// we use this to force getMusicType() to return MT_MT32 so that we don't
|
|
|
|
// have to rely on the 'True Roland MT-32' config manager setting (since nobody
|
|
|
|
// would possibly think about activating 'True Roland MT-32' when he has set
|
2010-06-25 22:37:19 +00:00
|
|
|
// 'Music Driver' to '<default>')
|
2010-06-21 21:36:36 +00:00
|
|
|
static bool _forceTypeMT32;
|
2004-12-02 00:33:42 +00:00
|
|
|
|
2002-04-13 18:34:11 +00:00
|
|
|
public:
|
2003-05-23 04:19:47 +00:00
|
|
|
virtual ~MidiDriver() { }
|
|
|
|
|
2005-04-03 22:01:38 +00:00
|
|
|
static const byte _mt32ToGm[128];
|
|
|
|
static const byte _gmToMt32[128];
|
|
|
|
|
2003-10-02 22:52:57 +00:00
|
|
|
/**
|
|
|
|
* Error codes returned by open.
|
|
|
|
* Can be converted to a string with getErrorName().
|
|
|
|
*/
|
2002-04-13 18:34:11 +00:00
|
|
|
enum {
|
|
|
|
MERR_CANNOT_CONNECT = 1,
|
2002-12-11 16:09:58 +00:00
|
|
|
// MERR_STREAMING_NOT_AVAILABLE = 2,
|
2002-04-13 18:34:11 +00:00
|
|
|
MERR_DEVICE_NOT_AVAILABLE = 3,
|
2002-12-25 00:36:04 +00:00
|
|
|
MERR_ALREADY_OPEN = 4
|
2002-04-13 18:34:11 +00:00
|
|
|
};
|
|
|
|
|
|
|
|
enum {
|
2003-05-23 04:19:47 +00:00
|
|
|
// PROP_TIMEDIV = 1,
|
2003-09-25 22:32:05 +00:00
|
|
|
PROP_OLD_ADLIB = 2,
|
|
|
|
PROP_CHANNEL_MASK = 3
|
2002-04-13 18:34:11 +00:00
|
|
|
};
|
|
|
|
|
2003-10-02 22:52:57 +00:00
|
|
|
/**
|
|
|
|
* Open the midi driver.
|
|
|
|
* @return 0 if successful, otherwise an error code.
|
|
|
|
*/
|
2002-12-11 16:09:58 +00:00
|
|
|
virtual int open() = 0;
|
2002-04-13 18:34:11 +00:00
|
|
|
|
2011-03-21 14:42:17 +00:00
|
|
|
/**
|
|
|
|
* Check whether the midi driver has already been opened.
|
|
|
|
*/
|
|
|
|
virtual bool isOpen() const = 0;
|
|
|
|
|
2003-10-02 22:52:57 +00:00
|
|
|
/** Close the midi driver. */
|
2002-04-13 18:34:11 +00:00
|
|
|
virtual void close() = 0;
|
|
|
|
|
2003-10-02 22:52:57 +00:00
|
|
|
/** Get or set a property. */
|
2003-05-17 14:27:58 +00:00
|
|
|
virtual uint32 property(int prop, uint32 param) { return 0; }
|
2002-04-13 18:34:11 +00:00
|
|
|
|
2003-10-02 22:52:57 +00:00
|
|
|
/** Retrieve a string representation of an error code. */
|
2002-12-11 16:09:58 +00:00
|
|
|
static const char *getErrorName(int error_code);
|
2002-10-21 09:32:38 +00:00
|
|
|
|
|
|
|
// HIGH-LEVEL SEMANTIC METHODS
|
2007-02-16 13:30:41 +00:00
|
|
|
virtual void setPitchBendRange(byte channel, uint range) {
|
|
|
|
send(0xB0 | channel, 101, 0);
|
|
|
|
send(0xB0 | channel, 100, 0);
|
|
|
|
send(0xB0 | channel, 6, range);
|
|
|
|
send(0xB0 | channel, 38, 0);
|
|
|
|
send(0xB0 | channel, 101, 127);
|
|
|
|
send(0xB0 | channel, 100, 127);
|
2002-11-04 18:29:26 +00:00
|
|
|
}
|
2002-11-21 19:06:42 +00:00
|
|
|
|
MIDI: Send a reset MIDI device signal on startup.
This is currently done in the engine code. I adapted AGI, AGOS, DRACI,
GROOVIE, LURE, MADE, QUEEN, SAGA, SKY, TINSEL and TOUCHE to send a reset
device on startup. The sound output still works fine (started up a game
from every engine), so this should hopefully not introduce any regressions.
As far as I can tell it seems that SCUMM does send a proper device reset, so
I did not touch it. KYRA only sends a proper reset for MT-32 currently. I am
not sure about SCI though.
This fixes bug #3066826 "SIMON: MIDI notes off when using RTL after SCI".
svn-id: r52736
2010-09-15 22:00:20 +00:00
|
|
|
/**
|
|
|
|
* Send a Roland MT-32 reset sysEx to the midi device.
|
|
|
|
*/
|
|
|
|
void sendMT32Reset();
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Send a General MIDI reset sysEx to the midi device.
|
|
|
|
*/
|
|
|
|
void sendGMReset();
|
|
|
|
|
2006-02-27 01:59:07 +00:00
|
|
|
virtual void sysEx_customInstrument(byte channel, uint32 type, const byte *instr) { }
|
2007-02-16 13:30:41 +00:00
|
|
|
|
2002-11-21 19:06:42 +00:00
|
|
|
// Timing functions - MidiDriver now operates timers
|
2006-06-24 09:34:49 +00:00
|
|
|
virtual void setTimerCallback(void *timer_param, Common::TimerManager::TimerProc timer_proc) = 0;
|
2005-07-30 21:11:48 +00:00
|
|
|
|
2004-10-17 19:39:54 +00:00
|
|
|
/** The time in microseconds between invocations of the timer callback. */
|
2009-11-02 21:54:57 +00:00
|
|
|
virtual uint32 getBaseTempo() = 0;
|
2002-11-26 16:54:58 +00:00
|
|
|
|
|
|
|
// Channel allocation functions
|
|
|
|
virtual MidiChannel *allocateChannel() = 0;
|
|
|
|
virtual MidiChannel *getPercussionChannel() = 0;
|
|
|
|
};
|
|
|
|
|
|
|
|
class MidiChannel {
|
|
|
|
public:
|
2005-06-20 18:27:33 +00:00
|
|
|
virtual ~MidiChannel() {}
|
|
|
|
|
2002-12-18 07:13:42 +00:00
|
|
|
virtual MidiDriver *device() = 0;
|
2002-12-18 07:48:35 +00:00
|
|
|
virtual byte getNumber() = 0;
|
2002-11-26 16:54:58 +00:00
|
|
|
virtual void release() = 0;
|
|
|
|
|
2005-05-27 12:43:19 +00:00
|
|
|
virtual void send(uint32 b) = 0; // 4-bit channel portion is ignored
|
2003-08-08 11:54:24 +00:00
|
|
|
|
2002-11-26 16:54:58 +00:00
|
|
|
// Regular messages
|
2005-05-27 12:43:19 +00:00
|
|
|
virtual void noteOff(byte note) = 0;
|
|
|
|
virtual void noteOn(byte note, byte velocity) = 0;
|
|
|
|
virtual void programChange(byte program) = 0;
|
|
|
|
virtual void pitchBend(int16 bend) = 0; // -0x2000 to +0x1FFF
|
2002-11-26 16:54:58 +00:00
|
|
|
|
|
|
|
// Control Change messages
|
2005-05-27 12:43:19 +00:00
|
|
|
virtual void controlChange(byte control, byte value) = 0;
|
2006-05-12 12:03:36 +00:00
|
|
|
virtual void modulationWheel(byte value) { controlChange(1, value); }
|
|
|
|
virtual void volume(byte value) { controlChange(7, value); }
|
|
|
|
virtual void panPosition(byte value) { controlChange(10, value); }
|
2005-05-27 12:43:19 +00:00
|
|
|
virtual void pitchBendFactor(byte value) = 0;
|
2006-05-12 12:03:36 +00:00
|
|
|
virtual void detune(byte value) { controlChange(17, value); }
|
2005-05-27 12:43:19 +00:00
|
|
|
virtual void priority(byte value) { }
|
2006-05-12 12:03:36 +00:00
|
|
|
virtual void sustain(bool value) { controlChange(64, value ? 1 : 0); }
|
|
|
|
virtual void effectLevel(byte value) { controlChange(91, value); }
|
|
|
|
virtual void chorusLevel(byte value) { controlChange(93, value); }
|
|
|
|
virtual void allNotesOff() { controlChange(123, 0); }
|
2002-11-26 16:54:58 +00:00
|
|
|
|
|
|
|
// SysEx messages
|
2006-02-27 01:59:07 +00:00
|
|
|
virtual void sysEx_customInstrument(uint32 type, const byte *instr) = 0;
|
2002-04-13 18:34:11 +00:00
|
|
|
};
|
|
|
|
|
2004-02-06 08:35:24 +00:00
|
|
|
#endif
|