#pragma once #include #include #include // These constants must match the corresponding values of the Windows headers // to avoid readjustment in the native Windows device's playback functions // and should not be changed. enum EMidiDeviceClass { MIDIDEV_MIDIPORT = 1, MIDIDEV_SYNTH, MIDIDEV_SQSYNTH, MIDIDEV_FMSYNTH, MIDIDEV_MAPPER, MIDIDEV_WAVETABLE, MIDIDEV_SWSYNTH }; enum EMIDIType { MIDI_NOTMIDI, MIDI_MIDI, MIDI_HMI, MIDI_XMI, MIDI_MUS }; enum EMidiDevice { MDEV_DEFAULT = -1, MDEV_STANDARD = 0, MDEV_OPL = 1, MDEV_SNDSYS = 2, MDEV_TIMIDITY = 3, MDEV_FLUIDSYNTH = 4, MDEV_GUS = 5, MDEV_WILDMIDI = 6, MDEV_ADL = 7, MDEV_OPN = 8, MDEV_COUNT }; enum ESoundFontTypes { SF_SF2 = 1, SF_GUS = 2, SF_WOPL = 4, SF_WOPN = 8 }; struct SoundStreamInfo { int mBufferSize; // If mBufferSize is 0, the song doesn't use streaming but plays through a different interface. int mSampleRate; int mNumChannels; // If mNumChannels is negative, 16 bit integer format is used instead of floating point. }; enum SampleType { SampleType_UInt8, SampleType_Int16 }; enum ChannelConfig { ChannelConfig_Mono, ChannelConfig_Stereo }; enum EIntConfigKey { zmusic_adl_chips_count, zmusic_adl_emulator_id, zmusic_adl_run_at_pcm_rate, zmusic_adl_fullpan, zmusic_adl_bank, zmusic_adl_use_custom_bank, zmusic_adl_volume_model, zmusic_fluid_reverb, zmusic_fluid_chorus, zmusic_fluid_voices, zmusic_fluid_interp, zmusic_fluid_samplerate, zmusic_fluid_threads, zmusic_fluid_chorus_voices, zmusic_fluid_chorus_type, zmusic_opl_numchips, zmusic_opl_core, zmusic_opl_fullpan, zmusic_opn_chips_count, zmusic_opn_emulator_id, zmusic_opn_run_at_pcm_rate, zmusic_opn_fullpan, zmusic_opn_use_custom_bank, zmusic_gus_dmxgus, zmusic_gus_midi_voices, zmusic_gus_memsize, zmusic_timidity_modulation_wheel, zmusic_timidity_portamento, zmusic_timidity_reverb, zmusic_timidity_reverb_level, zmusic_timidity_chorus, zmusic_timidity_surround_chorus, zmusic_timidity_channel_pressure, zmusic_timidity_lpf_def, zmusic_timidity_temper_control, zmusic_timidity_modulation_envelope, zmusic_timidity_overlap_voice_allow, zmusic_timidity_drum_effect, zmusic_timidity_pan_delay, zmusic_timidity_key_adjust, zmusic_wildmidi_reverb, zmusic_wildmidi_enhanced_resampling, zmusic_snd_midiprecache, zmusic_mod_samplerate, zmusic_mod_volramp, zmusic_mod_interp, zmusic_mod_autochip, zmusic_mod_autochip_size_force, zmusic_mod_autochip_size_scan, zmusic_mod_autochip_scan_threshold, zmusic_snd_streambuffersize, zmusic_snd_mididevice, zmusic_snd_outputrate, NUM_ZMUSIC_INT_CONFIGS }; enum EFloatConfigKey { zmusic_fluid_gain = 1000, zmusic_fluid_reverb_roomsize, zmusic_fluid_reverb_damping, zmusic_fluid_reverb_width, zmusic_fluid_reverb_level, zmusic_fluid_chorus_level, zmusic_fluid_chorus_speed, zmusic_fluid_chorus_depth, zmusic_timidity_drum_power, zmusic_timidity_tempo_adjust, zmusic_timidity_min_sustain_time, zmusic_gme_stereodepth, zmusic_mod_dumb_mastervolume, zmusic_snd_musicvolume, zmusic_relative_volume, zmusic_snd_mastervolume, NUM_FLOAT_CONFIGS }; enum EStringConfigKey { zmusic_adl_custom_bank = 2000, zmusic_fluid_lib, zmusic_fluid_patchset, zmusic_opn_custom_bank, zmusic_gus_config, zmusic_gus_patchdir, zmusic_timidity_config, zmusic_wildmidi_config, NUM_STRING_CONFIGS }; struct ZMusicCustomReader { void* handle; char* (*gets)(struct ZMusicCustomReader* handle, char* buff, int n); long (*read)(struct ZMusicCustomReader* handle, void* buff, int32_t size); long (*seek)(struct ZMusicCustomReader* handle, long offset, int whence); long (*tell)(struct ZMusicCustomReader* handle); void (*close)(struct ZMusicCustomReader* handle); }; struct ZMusicMidiOutDevice { char *Name; int ID; int Technology; }; struct ZMusicCallbacks { // Callbacks the client can install to capture messages from the backends // or to provide sound font data. // The message callbacks are optional, without them the output goes to stdout. void (*WildMidi_MessageFunc)(const char* wmfmt, va_list args); void (*GUS_MessageFunc)(int type, int verbosity_level, const char* fmt, ...); void (*Timidity_Messagefunc)(int type, int verbosity_level, const char* fmt, ...); int (*Fluid_MessageFunc)(const char *fmt, ...); // Retrieves the path to a soundfont identified by an identifier. Only needed if the client virtualizes the sound font names const char *(*PathForSoundfont)(const char *name, int type); // The sound font callbacks are for allowing the client to customize sound font management and they are optional. // They only need to be defined if the client virtualizes the sound font management and doesn't pass real paths to the music code. // Without them only paths to real files can be used. If one of these gets set, all must be set. // This opens a sound font. Must return a handle with which the sound font's content can be read. void *(*OpenSoundFont)(const char* name, int type); // Opens a file in the sound font. For GUS patch sets this will try to open each patch with this function. // For other formats only the sound font's actual name can be requested. // When passed NULL this must open the Timidity config file, if this is requested for an SF2 sound font it should be synthesized. struct ZMusicCustomReader* (*SF_OpenFile)(void* handle, const char* fn); //Adds a path to the list of directories in which files must be looked for. void (*SF_AddToSearchPath)(void* handle, const char* path); // Closes the sound font reader. void (*SF_Close)(void* handle); // Used to handle client-specific path macros. If not set, the path may not contain any special tokens that may need expansion. const char *(*NicePath)(const char* path); }; enum ZMusicVariableType { ZMUSIC_VAR_INT, ZMUSIC_VAR_BOOL, ZMUSIC_VAR_FLOAT, ZMUSIC_VAR_STRING, }; struct ZMusicConfigurationSetting { const char* name; int identifier; ZMusicVariableType type; float defaultVal; const char* defaultString; }; #ifndef ZMUSIC_INTERNAL #ifdef _MSC_VER #define DLL_IMPORT _declspec(dllimport) #else // !_MSC_VER #define DLL_IMPORT #endif // _MSC_VER // Note that the internal 'class' definitions are not C compatible! typedef struct { int zm1; } *ZMusic_MidiSource; typedef struct { int zm2; } *ZMusic_MusicStream; struct SoundDecoder; #endif #ifdef __cplusplus extern "C" { #endif DLL_IMPORT const char* ZMusic_GetLastError(); // Sets callbacks for functionality that the client needs to provide. DLL_IMPORT void ZMusic_SetCallbacks(const ZMusicCallbacks* callbacks); // Sets GenMidi data for OPL playback. If this isn't provided the OPL synth will not work. DLL_IMPORT void ZMusic_SetGenMidi(const uint8_t* data); // Set default bank for OPN. Without this OPN only works with custom banks. DLL_IMPORT void ZMusic_SetWgOpn(const void* data, unsigned len); // Set DMXGUS data for running the GUS synth in actual GUS mode. DLL_IMPORT void ZMusic_SetDmxGus(const void* data, unsigned len); // Returns an array with all available configuration options - terminated with an empty entry where all elements are 0. DLL_IMPORT const ZMusicConfigurationSetting* ZMusic_GetConfiguration(); // These exports are needed by the MIDI dumpers which need to remain on the client side because the need access to the client's file system. DLL_IMPORT EMIDIType ZMusic_IdentifyMIDIType(uint32_t* id, int size); DLL_IMPORT ZMusic_MidiSource ZMusic_CreateMIDISource(const uint8_t* data, size_t length, EMIDIType miditype); DLL_IMPORT bool ZMusic_MIDIDumpWave(ZMusic_MidiSource source, EMidiDevice devtype, const char* devarg, const char* outname, int subsong, int samplerate); DLL_IMPORT ZMusic_MusicStream ZMusic_OpenSong(struct ZMusicCustomReader* reader, EMidiDevice device, const char* Args); DLL_IMPORT ZMusic_MusicStream ZMusic_OpenSongFile(const char *filename, EMidiDevice device, const char* Args); DLL_IMPORT ZMusic_MusicStream ZMusic_OpenSongMem(const void *mem, size_t size, EMidiDevice device, const char* Args); DLL_IMPORT ZMusic_MusicStream ZMusic_OpenCDSong(int track, int cdid = 0); DLL_IMPORT bool ZMusic_FillStream(ZMusic_MusicStream stream, void* buff, int len); DLL_IMPORT bool ZMusic_Start(ZMusic_MusicStream song, int subsong, bool loop); DLL_IMPORT void ZMusic_Pause(ZMusic_MusicStream song); DLL_IMPORT void ZMusic_Resume(ZMusic_MusicStream song); DLL_IMPORT void ZMusic_Update(ZMusic_MusicStream song); DLL_IMPORT bool ZMusic_IsPlaying(ZMusic_MusicStream song); DLL_IMPORT void ZMusic_Stop(ZMusic_MusicStream song); DLL_IMPORT void ZMusic_Close(ZMusic_MusicStream song); DLL_IMPORT bool ZMusic_SetSubsong(ZMusic_MusicStream song, int subsong); DLL_IMPORT bool ZMusic_IsLooping(ZMusic_MusicStream song); DLL_IMPORT bool ZMusic_IsMIDI(ZMusic_MusicStream song); DLL_IMPORT void ZMusic_VolumeChanged(ZMusic_MusicStream song); DLL_IMPORT bool ZMusic_WriteSMF(ZMusic_MidiSource source, const char* fn, int looplimit); DLL_IMPORT void ZMusic_GetStreamInfo(ZMusic_MusicStream song, SoundStreamInfo *info); // Configuration interface. The return value specifies if a music restart is needed. // RealValue should be written back to the CVAR or whatever other method the client uses to store configuration state. DLL_IMPORT bool ChangeMusicSettingInt(EIntConfigKey key, ZMusic_MusicStream song, int value, int* pRealValue); DLL_IMPORT bool ChangeMusicSettingFloat(EFloatConfigKey key, ZMusic_MusicStream song, float value, float* pRealValue); DLL_IMPORT bool ChangeMusicSettingString(EStringConfigKey key, ZMusic_MusicStream song, const char* value); DLL_IMPORT const char *ZMusic_GetStats(ZMusic_MusicStream song); DLL_IMPORT struct SoundDecoder* CreateDecoder(const uint8_t* data, size_t size, bool isstatic); DLL_IMPORT void SoundDecoder_GetInfo(struct SoundDecoder* decoder, int* samplerate, ChannelConfig* chans, SampleType* type); DLL_IMPORT size_t SoundDecoder_Read(struct SoundDecoder* decoder, void* buffer, size_t length); DLL_IMPORT void SoundDecoder_Close(struct SoundDecoder* decoder); DLL_IMPORT void FindLoopTags(const uint8_t* data, size_t size, uint32_t* start, bool* startass, uint32_t* end, bool* endass); // The rest of the decoder interface is only useful for streaming music. DLL_IMPORT const ZMusicMidiOutDevice *ZMusic_GetMidiDevices(int *pAmount); #ifdef __cplusplus } inline bool ChangeMusicSetting(EIntConfigKey key, ZMusic_MusicStream song, int value, int* pRealValue = NULL) { return ChangeMusicSettingInt(key, song, value, pRealValue); } inline bool ChangeMusicSetting(EFloatConfigKey key, ZMusic_MusicStream song, float value, float* pRealValue = NULL) { return ChangeMusicSettingFloat(key, song, value, pRealValue); } inline bool ChangeMusicSetting(EStringConfigKey key, ZMusic_MusicStream song, const char* value) { return ChangeMusicSettingString(key, song, value); } #endif