mididriver.h

/* 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.
 *
 * 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 3 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, see <http://www.gnu.org/licenses/>.
 *
 */

#ifndef DGDS_SOUND_DRIVERS_MIDIDRIVER_H
#define DGDS_SOUND_DRIVERS_MIDIDRIVER_H

#include "audio/mididrv.h"
#include "common/platform.h"

namespace Dgds {

// Music patches in SCI games:
// ===========================
// 1.pat - MT-32 driver music patch
// 2.pat - Yamaha FB01 driver music patch
// 3.pat - Adlib driver music patch
// 4.pat - Casio MT-540 (in earlier SCI0 games)
// 4.pat - GM driver music patch (in later games that support GM)
// 7.pat (newer) / patch.200 (older) - Mac driver music patch / Casio CSM-1
// 9.pat (newer) / patch.005 (older) - Amiga driver music patch
// 98.pat - Unknown, found in later SCI1.1 games. A MIDI format patch
// 101.pat - CMS/PCjr driver music patch.
//           Only later PCjr drivers use this patch, earlier ones don't use a patch
// bank.001 - older SCI0 Amiga instruments

class ResourceManager;

enum {
    MIDI_CHANNELS = 16,
    MIDI_PROP_MASTER_VOLUME = 0
};

#define MIDI_RHYTHM_CHANNEL 9

/* Special SCI sound stuff */

#define SCI_MIDI_TIME_EXPANSION_PREFIX 0xF8
#define SCI_MIDI_TIME_EXPANSION_LENGTH 240

#define SCI_MIDI_EOT 0xFC
#define SCI_MIDI_SET_SIGNAL 0xCF
#define SCI_MIDI_SET_POLYPHONY 0x4B
#define SCI_MIDI_RESET_ON_SUSPEND 0x4C
#define SCI_MIDI_CHANNEL_MUTE 0x4E
#define SCI_MIDI_SET_REVERB 0x50
#define SCI_MIDI_HOLD 0x52
#define SCI_MIDI_CUMULATIVE_CUE 0x60
#define SCI_MIDI_CHANNEL_SOUND_OFF 0x78 /* all-sound-off for Bn */
#define SCI_MIDI_CHANNEL_NOTES_OFF 0x7B /* all-notes-off for Bn */

#define SCI_MIDI_SET_SIGNAL_LOOP 0x7F
/* If this is the parameter of 0xCF, the loop point is set here */

#define SCI_MIDI_CONTROLLER(status) ((status & 0xF0) == 0xB0)

class MidiPlayer : public MidiDriver_BASE {
protected:
    MidiDriver *_driver;
    int8 _reverb;

public:
    MidiPlayer() : _driver(nullptr), _reverb(-1) {}

    virtual int open() { return _driver->open(); }
    virtual void close() { _driver->close(); }
    void send(uint32 b) override { _driver->send(b); }
    virtual uint32 getBaseTempo() { return _driver->getBaseTempo(); }
    virtual bool hasRhythmChannel() const = 0;
    virtual void setTimerCallback(void *timer_param, Common::TimerManager::TimerProc timer_proc) { _driver->setTimerCallback(timer_param, timer_proc); }

    virtual byte getPlayId() const = 0;
    virtual int getPolyphony() const = 0;
    virtual int getFirstChannel() const { return 0; }
    virtual int getLastChannel() const { return 15; }

    virtual void setVolume(byte volume) {
        if(_driver)
            _driver->property(MIDI_PROP_MASTER_VOLUME, volume);
    }

    virtual int getVolume() {
        return _driver ? _driver->property(MIDI_PROP_MASTER_VOLUME, 0xffff) : 0;
    }

    // Returns the current reverb, or -1 when no reverb is active
    int8 getReverb() const { return _reverb; }
    // Sets the current reverb, used mainly in MT-32
    virtual void setReverb(int8 reverb) { _reverb = reverb; }

    virtual void playSwitch(bool play) {
        if (!play) {
            // Send "All Sound Off" on all channels
            for (int i = 0; i < MIDI_CHANNELS; ++i)
                _driver->send(0xb0 + i, SCI_MIDI_CHANNEL_NOTES_OFF, 0);
        }
    }
};

class SciResource;

extern SciResource *getMidiPatchData(int num);

extern MidiPlayer *MidiPlayer_AdLib_create();
extern MidiPlayer *MidiPlayer_AmigaMac1_create(Common::Platform platform);
extern MidiPlayer *MidiPlayer_CMS_create();
extern MidiPlayer *MidiPlayer_PCJr_create();
extern MidiPlayer *MidiPlayer_PCSpeaker_create();
extern MidiPlayer *MidiPlayer_Midi_create();

} // End of namespace Dgds

#endif // DGDS_SOUND_DRIVERS_MIDIDRIVER_H