annotate Plugins/Input/console/Gbs_Emu.h @ 352:f13ab2d8e9cf trunk

[svn] various fixes :(

// Game Boy GBS-format game music file emulator

// Game_Music_Emu 0.2.4. Copyright (C) 2003-2005 Shay Green. GNU LGPL license.

#ifndef GBS_EMU_H
#define GBS_EMU_H

#include "Classic_Emu.h"
#include "Gb_Apu.h"
#include "Gb_Cpu.h"

class Gbs_Emu : public Classic_Emu {
public:
	// Sets internal gain, where 1.0 results in almost no clamping. Default gain
	// roughly matches volume of other emulators.
	Gbs_Emu( double gain = 1.3 );
	~Gbs_Emu();
	
	struct header_t {
		char tag [3];
		byte vers;
		byte track_count;
		byte first_track;
		byte load_addr [2];
		byte init_addr [2];
		byte play_addr [2];
		byte stack_ptr [2];
		byte timer_modulo;
		byte timer_mode;
		char game [32];
		char author [32];
		char copyright [32];
		
		enum { song = 0 }; // no song titles
	};
	BOOST_STATIC_ASSERT( sizeof (header_t) == 112 );
	
	// Load GBS, given its header and reader for remaining data
	blargg_err_t load( const header_t&, Emu_Reader& );
	
	const char** voice_names() const;
	blargg_err_t start_track( int );
	

// End of public interface
protected:
	void set_voice( int, Blip_Buffer*, Blip_Buffer*, Blip_Buffer* );
	void update_eq( blip_eq_t const& );
	blip_time_t run( int, bool* );
private:
	// rom
	const byte* rom_bank;
	byte* rom;
	void unload();
	int bank_count;
	void set_bank( int );
	static void write_rom( Gbs_Emu*, gb_addr_t, int );
	static int read_rom( Gbs_Emu*, gb_addr_t );
	static int read_bank( Gbs_Emu*, gb_addr_t );
	
	// state
	gb_addr_t load_addr;
	gb_addr_t init_addr;
	gb_addr_t play_addr;
	gb_addr_t stack_ptr;
	int timer_modulo_init;
	int timer_mode;
	
	// timer
	gb_time_t cpu_time;
	gb_time_t play_period;
	gb_time_t next_play;
	int double_speed;
	
	// hardware
	Gb_Apu apu;
	byte hi_page [0x100];
	void set_timer( int tma, int tmc );
	static int read_io( Gbs_Emu*, gb_addr_t );
	static void write_io( Gbs_Emu*, gb_addr_t, int );
	static int read_unmapped( Gbs_Emu*, gb_addr_t );
	static void write_unmapped( Gbs_Emu*, gb_addr_t, int );
	
	// cpu and ram
	Gb_Cpu cpu;
	void cpu_jsr( gb_addr_t );
	gb_time_t clock() const;
	byte ram [0x4000];
	static int read_ram( Gbs_Emu*, gb_addr_t );
	static void write_ram( Gbs_Emu*, gb_addr_t, int );
};

#endif