zmusic/thirdparty/adlmidi/oplinst.h
Wohlstand 1d4a016c41 Update libADLMIDI up to 1.5.0
## 1.5.0   2020-09-28
 * Drum note length expanding is now supported in real-time mode (Thanks to [Jean Pierre Cimalando](https://github.com/jpcima) for a work!)
 * Channels manager has been improved (Thanks to [Jean Pierre Cimalando](https://github.com/jpcima) for a work!)
 * Nuked OPL3 1.8 emulator got some optimizations ported from 1.7 where they are was applied previously (Thanks to [Jean Pierre Cimalando](https://github.com/jpcima) for a work!)
 * Reworked rhythm-mode percussions system, WOPL banks with rhythm-mode percussions
 * Added Public Domain Opal OPL3 emulator made by Reality (a team who originally made the Reality Adlib Tracker) (Thanks to [Jean Pierre Cimalando](https://github.com/jpcima) for a work!)
 * Added LGPL licensed JavaOPL3 emulator made by Robson Cozendey in Java and later rewritten into C++ for GZDoom (Thanks to [Jean Pierre Cimalando](https://github.com/jpcima) for a work!)
 * Fully rewritten an embedded bank database format, embedded banks now supports a wider set (more than 127:127 instruments in one bank)
 * Improved accuracy of the DMX volume model, include the buggy AM interpretation
 * Improved accuracy of Apogee volume model, include the bug of AM instruments
 * Improved accuracy of the Win9X volume model
 * Removed C++ extras. C++-bounded instruments tester is useless since a real-time MIDI API can completely replace it
 * Added AIL volume model
 * Added Generic FM variant of Win9X volume model
 * Fixed an incorrect work of CC-121 (See https://github.com/Wohlstand/libADLMIDI/issues/227 for details)
 * Added HMI volume model (Thanks to [Alexey Khokholov](https://github.com/nukeykt) for help with research!)
 * Added frequency models, assigned to every volume model: AIL, HMI, DMX, Apogee, 9X, and the Generic formula
2020-10-04 08:03:44 +02:00

121 lines
3.3 KiB
C

/*
* libADLMIDI is a free Software MIDI synthesizer library with OPL3 emulation
*
* Original ADLMIDI code: Copyright (c) 2010-2014 Joel Yliluoma <bisqwit@iki.fi>
* ADLMIDI Library API: Copyright (c) 2015-2020 Vitaly Novichkov <admin@wohlnet.ru>
*
* Library is based on the ADLMIDI, a MIDI player for Linux and Windows with OPL3 emulation:
* http://iki.fi/bisqwit/source/adlmidi.html
*
* 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
* 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 OPLINST_H
#define OPLINST_H
#include <string.h>
#include <stdint.h>
#include <cstring>
#pragma pack(push, 1)
#define OPLINST_BYTE_COMPARABLE(T) \
inline bool operator==(const T &a, const T &b) \
{ return !memcmp(&a, &b, sizeof(T)); } \
inline bool operator!=(const T &a, const T &b) \
{ return !operator==(a, b); }
/**
* @brief OPL3 Operator data for single tumbre
*/
struct OplTimbre
{
//! WaveForm, Sustain/Release, AttackDecay, and AM/VIB/EG/KSR/F-Mult settings
uint32_t modulator_E862, carrier_E862;
//! KSL/attenuation settings
uint8_t modulator_40, carrier_40;
//! Feedback/connection bits for the channel
uint8_t feedconn;
//! Semi-tone offset
int8_t noteOffset;
};
OPLINST_BYTE_COMPARABLE(struct OplTimbre)
enum { OPLNoteOnMaxTime = 40000 };
/**
* @brief Instrument data with operators included
*/
struct OplInstMeta
{
enum
{
Flag_Pseudo4op = 0x01,
Flag_NoSound = 0x02,
Flag_Real4op = 0x04
};
enum
{
Flag_RM_BassDrum = 0x08,
Flag_RM_Snare = 0x10,
Flag_RM_TomTom = 0x18,
Flag_RM_Cymbal = 0x20,
Flag_RM_HiHat = 0x28,
Mask_RhythmMode = 0x38
};
//! Operator data
OplTimbre op[2];
//! Fixed note for drum instruments
uint8_t drumTone;
//! Instrument flags
uint8_t flags;
//! Number of milliseconds it produces sound while key on
uint16_t soundKeyOnMs;
//! Number of milliseconds it produces sound while releasing after key off
uint16_t soundKeyOffMs;
//! MIDI velocity offset
int8_t midiVelocityOffset;
//! Second voice detune
double voice2_fine_tune;
};
OPLINST_BYTE_COMPARABLE(struct OplInstMeta)
#undef OPLINST_BYTE_COMPARABLE
#pragma pack(pop)
/**
* @brief Bank global setup
*/
struct OplBankSetup
{
int volumeModel;
bool deepTremolo;
bool deepVibrato;
bool scaleModulators;
};
/**
* @brief Convert external instrument to internal instrument
*/
void cvt_ADLI_to_FMIns(OplInstMeta &dst, const struct ADL_Instrument &src);
/**
* @brief Convert internal instrument to external instrument
*/
void cvt_FMIns_to_ADLI(struct ADL_Instrument &dst, const OplInstMeta &src);
#endif // OPLINST_H