/* ** music_timidity_mididevice.cpp ** Provides access to TiMidity as a generic MIDI device. ** **--------------------------------------------------------------------------- ** Copyright 2008 Randy Heit ** All rights reserved. ** ** Redistribution and use in source and binary forms, with or without ** modification, are permitted provided that the following conditions ** are met: ** ** 1. Redistributions of source code must retain the above copyright ** notice, this list of conditions and the following disclaimer. ** 2. Redistributions in binary form must reproduce the above copyright ** notice, this list of conditions and the following disclaimer in the ** documentation and/or other materials provided with the distribution. ** 3. The name of the author may not be used to endorse or promote products ** derived from this software without specific prior written permission. ** ** THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR ** IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES ** OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. ** IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT, ** INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT ** NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, ** DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY ** THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT ** (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF ** THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. **--------------------------------------------------------------------------- ** */ // HEADER FILES ------------------------------------------------------------ #include #include "zmusic/zmusic_internal.h" #include "mididevice.h" #ifdef HAVE_ADL #include "adlmidi.h" ADLConfig adlConfig; class ADLMIDIDevice : public SoftSynthMIDIDevice { struct ADL_MIDIPlayer *Renderer; float OutputGainFactor; public: ADLMIDIDevice(const ADLConfig *config); ~ADLMIDIDevice(); int OpenRenderer() override; int GetDeviceType() const override { return MDEV_ADL; } protected: void HandleEvent(int status, int parm1, int parm2) override; void HandleLongEvent(const uint8_t *data, int len) override; void ComputeOutput(float *buffer, int len) override; private: int LoadCustomBank(const ADLConfig *config); }; enum { ME_NOTEOFF = 0x80, ME_NOTEON = 0x90, ME_KEYPRESSURE = 0xA0, ME_CONTROLCHANGE = 0xB0, ME_PROGRAM = 0xC0, ME_CHANNELPRESSURE = 0xD0, ME_PITCHWHEEL = 0xE0 }; //========================================================================== // // ADLMIDIDevice Constructor // //========================================================================== ADLMIDIDevice::ADLMIDIDevice(const ADLConfig *config) :SoftSynthMIDIDevice(44100) { Renderer = adl_init(44100); // todo: make it configurable OutputGainFactor = 3.5f; if (Renderer != nullptr) { adl_switchEmulator(Renderer, config->adl_emulator_id); adl_setRunAtPcmRate(Renderer, config->adl_run_at_pcm_rate); if (!LoadCustomBank(config)) adl_setBank(Renderer, config->adl_bank); adl_setNumChips(Renderer, config->adl_chips_count); adl_setVolumeRangeModel(Renderer, config->adl_volume_model); adl_setSoftPanEnabled(Renderer, config->adl_fullpan); // TODO: Please tune the factor for each volume model to avoid too loud or too silent sounding switch (adl_getVolumeRangeModel(Renderer)) { // Louder models case ADLMIDI_VolumeModel_Generic: case ADLMIDI_VolumeModel_9X: case ADLMIDI_VolumeModel_9X_GENERIC_FM: OutputGainFactor = 2.0f; break; // Middle volume models case ADLMIDI_VolumeModel_HMI: case ADLMIDI_VolumeModel_HMI_OLD: OutputGainFactor = 2.5f; break; default: // Quite models case ADLMIDI_VolumeModel_DMX: case ADLMIDI_VolumeModel_DMX_Fixed: case ADLMIDI_VolumeModel_APOGEE: case ADLMIDI_VolumeModel_APOGEE_Fixed: case ADLMIDI_VolumeModel_AIL: OutputGainFactor = 3.5f; break; // Quiter models case ADLMIDI_VolumeModel_NativeOPL3: OutputGainFactor = 3.8f; break; } } else throw std::runtime_error("Failed to create ADL MIDI renderer."); } //========================================================================== // // ADLMIDIDevice Destructor // //========================================================================== ADLMIDIDevice::~ADLMIDIDevice() { Close(); if (Renderer != nullptr) { adl_close(Renderer); } } //========================================================================== // // ADLMIDIDevice :: LoadCustomBank // // Loads a custom WOPL bank for libADLMIDI. Returns 1 when bank has been // loaded, otherwise, returns 0 when custom banks are disabled or failed // //========================================================================== int ADLMIDIDevice::LoadCustomBank(const ADLConfig *config) { const char *bankfile = config->adl_custom_bank.c_str(); if(!config->adl_use_custom_bank) return 0; if(!*bankfile) return 0; return (adl_openBankFile(Renderer, bankfile) == 0); } //========================================================================== // // ADLMIDIDevice :: Open // // Returns 0 on success. // //========================================================================== int ADLMIDIDevice::OpenRenderer() { adl_rt_resetState(Renderer); return 0; } //========================================================================== // // ADLMIDIDevice :: HandleEvent // //========================================================================== void ADLMIDIDevice::HandleEvent(int status, int parm1, int parm2) { int command = status & 0xF0; int chan = status & 0x0F; switch (command) { case ME_NOTEON: adl_rt_noteOn(Renderer, chan, parm1, parm2); break; case ME_NOTEOFF: adl_rt_noteOff(Renderer, chan, parm1); break; case ME_KEYPRESSURE: adl_rt_noteAfterTouch(Renderer, chan, parm1, parm2); break; case ME_CONTROLCHANGE: adl_rt_controllerChange(Renderer, chan, parm1, parm2); break; case ME_PROGRAM: adl_rt_patchChange(Renderer, chan, parm1); break; case ME_CHANNELPRESSURE: adl_rt_channelAfterTouch(Renderer, chan, parm1); break; case ME_PITCHWHEEL: adl_rt_pitchBendML(Renderer, chan, parm2, parm1); break; } } //========================================================================== // // ADLMIDIDevice :: HandleLongEvent // //========================================================================== void ADLMIDIDevice::HandleLongEvent(const uint8_t *data, int len) { adl_rt_systemExclusive(Renderer, data, len); } static const ADLMIDI_AudioFormat audio_output_format = { ADLMIDI_SampleType_F32, sizeof(float), 2 * sizeof(float) }; //========================================================================== // // ADLMIDIDevice :: ComputeOutput // //========================================================================== void ADLMIDIDevice::ComputeOutput(float *buffer, int len) { ADL_UInt8* left = reinterpret_cast(buffer); ADL_UInt8* right = reinterpret_cast(buffer + 1); auto result = adl_generateFormat(Renderer, len * 2, left, right, &audio_output_format); for(int i=0; i < result; i++) { buffer[i] *= OutputGainFactor; } } //========================================================================== // // // //========================================================================== extern ADLConfig adlConfig; MIDIDevice *CreateADLMIDIDevice(const char *Args) { ADLConfig config = adlConfig; const char* bank = Args && *Args ? Args : adlConfig.adl_use_custom_bank ? adlConfig.adl_custom_bank.c_str() : nullptr; if (bank && *bank) { if (*bank >= '0' && *bank <= '9') { // Args specify a bank by index. config.adl_bank = (int)strtoll(bank, nullptr, 10); config.adl_use_custom_bank = false; } else { const char* info; if (musicCallbacks.PathForSoundfont) { info = musicCallbacks.PathForSoundfont(bank, SF_WOPL); } else { info = bank; } if (info == nullptr) { config.adl_custom_bank = ""; config.adl_use_custom_bank = false; } else { config.adl_custom_bank = info; config.adl_use_custom_bank = true; } } } return new ADLMIDIDevice(&config); } DLL_EXPORT int ZMusic_GetADLBanks(const char* const** pNames) { if (pNames) *pNames = adl_getBankNames(); return adl_getBanksCount(); } #else MIDIDevice* CreateADLMIDIDevice(const char* Args) { throw std::runtime_error("ADL device not supported in this configuration"); } DLL_EXPORT int ZMusic_GetADLBanks(const char* const** pNames) { // The export needs to be there even if non-functional. return 0; } #endif