mirror of
https://github.com/ZDoom/ZMusic.git
synced 2024-12-03 09:02:17 +00:00
72c23d98a3
## 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!) * Added support for OPNA chip with Neko Project II Kai YM2602 emulator usage (Thanks to [Jean Pierre Cimalando](https://github.com/jpcima) for a work!) * Added VGM file dumper which allows to output OPN2 commands into VGM file. (A new MIDI to VGM tool is now created with basing on libOPNMIDI) * Fixed an incorrect work of CC-121 (See https://github.com/Wohlstand/libADLMIDI/issues/227 for details) * Internality has been refactored and improved
193 lines
6.1 KiB
C++
193 lines
6.1 KiB
C++
// license:GPL-2.0+
|
|
// copyright-holders:Jarek Burczynski,Tatsuyuki Satoh
|
|
/*
|
|
File: fm.h -- header file for software emulation for FM sound generator
|
|
|
|
*/
|
|
|
|
#ifndef MAME_SOUND_FM_H
|
|
#define MAME_SOUND_FM_H
|
|
|
|
#pragma once
|
|
#include "emu.h"
|
|
|
|
struct device_t;
|
|
typedef int32_t stream_sample_t;
|
|
|
|
/* --- select emulation chips --- */
|
|
#define BUILD_YM2203 (0) /* build YM2203(OPN) emulator */
|
|
#define BUILD_YM2608 (1) /* build YM2608(OPNA) emulator */
|
|
#define BUILD_YM2610 (0) /* build YM2610(OPNB) emulator */
|
|
#define BUILD_YM2610B (0) /* build YM2610B(OPNB?)emulator */
|
|
#define BUILD_YM2612 (0) /* build YM2612(OPN2) emulator */
|
|
#define BUILD_YM3438 (0) /* build YM3438(OPN) emulator */
|
|
|
|
/* select bit size of output : 8 or 16 */
|
|
#define FM_SAMPLE_BITS 16
|
|
|
|
/* select timer system internal or external */
|
|
#define FM_INTERNAL_TIMER 0
|
|
|
|
/* --- speedup optimize --- */
|
|
/* busy flag emulation , The definition of FM_GET_TIME_NOW() is necessary. */
|
|
#define FM_BUSY_FLAG_SUPPORT 0
|
|
|
|
/* --- external SSG(YM2149/AY-3-8910)emulator interface port */
|
|
/* used by YM2203,YM2608,and YM2610 */
|
|
struct ssg_callbacks
|
|
{
|
|
void (*set_clock)(device_t *device, int clock);
|
|
void (*write)(device_t *device, int address, int data);
|
|
int (*read)(device_t *device);
|
|
void (*reset)(device_t *device);
|
|
};
|
|
|
|
/* --- external callback functions for realtime update --- */
|
|
|
|
#if FM_BUSY_FLAG_SUPPORT
|
|
using TIME_TYPE = attotime;
|
|
#define UNDEFINED_TIME attotime::zero
|
|
#define FM_GET_TIME_NOW(machine) (machine)->time()
|
|
inline TIME_TYPE ADD_TIMES(TIME_TYPE const &t1, TIME_TYPE const &t2) { return t1 + t2; }
|
|
constexpr int COMPARE_TIMES(TIME_TYPE const &t1, TIME_TYPE const &t2) { return (t1 == t2) ? 0 : (t1 < t2) ? -1 : 1; }
|
|
template <typename X> constexpr TIME_TYPE MULTIPLY_TIME_BY_INT(TIME_TYPE const &t, X &&i) { return t * i; }
|
|
#endif
|
|
|
|
|
|
typedef stream_sample_t FMSAMPLE;
|
|
/*
|
|
#if (FM_SAMPLE_BITS==16)
|
|
typedef int16_t FMSAMPLE;
|
|
#endif
|
|
#if (FM_SAMPLE_BITS==8)
|
|
typedef unsigned char FMSAMPLE;
|
|
#endif
|
|
*/
|
|
|
|
typedef uint8_t (*FM_READBYTE)(device_t *device, offs_t offset);
|
|
typedef void(*FM_WRITEBYTE)(device_t *device, offs_t offset, uint8_t data);
|
|
typedef void (*FM_TIMERHANDLER)(device_t *device,int c,int cnt,int clock);
|
|
typedef void (*FM_IRQHANDLER)(device_t *device,int irq);
|
|
/* FM_TIMERHANDLER : Stop or Start timer */
|
|
/* int n = chip number */
|
|
/* int c = Channel 0=TimerA,1=TimerB */
|
|
/* int count = timer count (0=stop) */
|
|
/* doube stepTime = step time of one count (sec.)*/
|
|
|
|
/* FM_IRQHHANDLER : IRQ level changing sense */
|
|
/* int n = chip number */
|
|
/* int irq = IRQ level 0=OFF,1=ON */
|
|
|
|
#if BUILD_YM2203
|
|
/* -------------------- YM2203(OPN) Interface -------------------- */
|
|
|
|
/*
|
|
** Initialize YM2203 emulator(s).
|
|
**
|
|
** 'num' is the number of virtual YM2203's to allocate
|
|
** 'baseclock'
|
|
** 'rate' is sampling rate
|
|
** 'TimerHandler' timer callback handler when timer start and clear
|
|
** 'IRQHandler' IRQ callback handler when changed IRQ level
|
|
** return 0 = success
|
|
*/
|
|
void * ym2203_init(device_t *device, int baseclock, int rate,
|
|
FM_TIMERHANDLER TimerHandler,FM_IRQHANDLER IRQHandler, const ssg_callbacks *ssg);
|
|
|
|
/*
|
|
** YM2203 clock changed notifier
|
|
*/
|
|
void ym2203_clock_changed(void *chip, int clock, int rate);
|
|
|
|
/*
|
|
** shutdown the YM2203 emulators
|
|
*/
|
|
void ym2203_shutdown(void *chip);
|
|
|
|
/*
|
|
** reset all chip registers for YM2203 number 'num'
|
|
*/
|
|
void ym2203_reset_chip(void *chip);
|
|
|
|
/*
|
|
** update one of chip
|
|
*/
|
|
void ym2203_update_one(void *chip, FMSAMPLE *buffer, int length);
|
|
|
|
/*
|
|
** Write
|
|
** return : InterruptLevel
|
|
*/
|
|
int ym2203_write(void *chip,int a,unsigned char v);
|
|
|
|
/*
|
|
** Read
|
|
** return : InterruptLevel
|
|
*/
|
|
unsigned char ym2203_read(void *chip,int a);
|
|
|
|
/*
|
|
** Timer OverFlow
|
|
*/
|
|
int ym2203_timer_over(void *chip, int c);
|
|
|
|
/*
|
|
** State Save
|
|
*/
|
|
void ym2203_postload(void *chip);
|
|
#endif /* BUILD_YM2203 */
|
|
|
|
#if BUILD_YM2608
|
|
/* -------------------- YM2608(OPNA) Interface -------------------- */
|
|
void * ym2608_init(device_t *device, int baseclock, int rate,
|
|
FM_READBYTE InternalReadByte,
|
|
FM_READBYTE ExternalReadByte, FM_WRITEBYTE ExternalWriteByte,
|
|
FM_TIMERHANDLER TimerHandler, FM_IRQHANDLER IRQHandler, const ssg_callbacks *ssg);
|
|
void ym2608_clock_changed(void *chip, int clock, int rate);
|
|
void ym2608_shutdown(void *chip);
|
|
void ym2608_reset_chip(void *chip);
|
|
void ym2608_update_one(void *chip, FMSAMPLE **buffer, int length);
|
|
|
|
int ym2608_write(void *chip, int a,unsigned char v);
|
|
void ym2608_write_pan(void *chip, int c,unsigned char v); // libOPNMIDI: soft panning
|
|
unsigned char ym2608_read(void *chip,int a);
|
|
int ym2608_timer_over(void *chip, int c );
|
|
void ym2608_postload(void *chip);
|
|
#endif /* BUILD_YM2608 */
|
|
|
|
#if (BUILD_YM2610||BUILD_YM2610B)
|
|
/* -------------------- YM2610(OPNB) Interface -------------------- */
|
|
void * ym2610_init(device_t *device, int baseclock, int rate,
|
|
FM_READBYTE adpcm_a_read_byte, FM_READBYTE adpcm_b_read_byte,
|
|
FM_TIMERHANDLER TimerHandler,FM_IRQHANDLER IRQHandler, const ssg_callbacks *ssg);
|
|
void ym2610_clock_changed(void *chip, int clock, int rate);
|
|
void ym2610_shutdown(void *chip);
|
|
void ym2610_reset_chip(void *chip);
|
|
void ym2610_update_one(void *chip, FMSAMPLE **buffer, int length);
|
|
|
|
#if BUILD_YM2610B
|
|
void ym2610b_update_one(void *chip, FMSAMPLE **buffer, int length);
|
|
#endif /* BUILD_YM2610B */
|
|
|
|
int ym2610_write(void *chip, int a,unsigned char v);
|
|
unsigned char ym2610_read(void *chip,int a);
|
|
int ym2610_timer_over(void *chip, int c );
|
|
void ym2610_postload(void *chip);
|
|
#endif /* (BUILD_YM2610||BUILD_YM2610B) */
|
|
|
|
#if (BUILD_YM2612||BUILD_YM3438)
|
|
void * ym2612_init(device_t *device, int baseclock, int rate,
|
|
FM_TIMERHANDLER TimerHandler,FM_IRQHANDLER IRQHandler);
|
|
void ym2612_clock_changed(void *chip, int clock, int rate);
|
|
void ym2612_shutdown(void *chip);
|
|
void ym2612_reset_chip(void *chip);
|
|
void ym2612_update_one(void *chip, FMSAMPLE **buffer, int length);
|
|
|
|
int ym2612_write(void *chip, int a,unsigned char v);
|
|
unsigned char ym2612_read(void *chip,int a);
|
|
int ym2612_timer_over(void *chip, int c );
|
|
void ym2612_postload(void *chip);
|
|
#endif /* (BUILD_YM2612||BUILD_YM3438) */
|
|
|
|
|
|
#endif // MAME_SOUND_FM_H
|