mirror of
https://github.com/Pecusx/libretro-atari800.git
synced 2026-05-21 14:49:36 +02:00
initial commit
This commit is contained in:
R-type
@@ -0,0 +1,190 @@
|
||||
#ifndef ATARI_H_
|
||||
#define ATARI_H_
|
||||
|
||||
#include "config.h"
|
||||
#include <stdio.h> /* FILENAME_MAX */
|
||||
#ifdef HAVE_WINDOWS_H
|
||||
#include <windows.h>
|
||||
#endif
|
||||
|
||||
/* Fundamental declarations ---------------------------------------------- */
|
||||
|
||||
#define Atari800_TITLE "Atari 800 Emulator, Version 3.1.0"
|
||||
|
||||
#ifndef FALSE
|
||||
#define FALSE 0
|
||||
#endif
|
||||
#ifndef TRUE
|
||||
#define TRUE 1
|
||||
#endif
|
||||
|
||||
/* SBYTE and UBYTE must be exactly 1 byte long. */
|
||||
/* SWORD and UWORD must be exactly 2 bytes long. */
|
||||
/* SLONG and ULONG must be exactly 4 bytes long. */
|
||||
#define SBYTE signed char
|
||||
#define SWORD signed short
|
||||
#define SLONG signed int
|
||||
#define UBYTE unsigned char
|
||||
#define UWORD unsigned short
|
||||
#ifndef HAVE_WINDOWS_H
|
||||
/* Windows headers typedef ULONG */
|
||||
#define ULONG unsigned int
|
||||
#endif
|
||||
/* Note: in various parts of the emulator we assume that char is 1 byte
|
||||
and int is 4 bytes. */
|
||||
|
||||
|
||||
/* Public interface ------------------------------------------------------ */
|
||||
|
||||
/* Machine type. */
|
||||
enum {
|
||||
Atari800_MACHINE_800,
|
||||
Atari800_MACHINE_XLXE,
|
||||
Atari800_MACHINE_5200,
|
||||
/* Number of values in the emumerator */
|
||||
Atari800_MACHINE_SIZE
|
||||
};
|
||||
/* Don't change this variable directly; use Atari800_SetMachineType() instead. */
|
||||
extern int Atari800_machine_type;
|
||||
void Atari800_SetMachineType(int type);
|
||||
|
||||
/* Always call Atari800_InitialiseMachine() after changing Atari800_machine_type
|
||||
or MEMORY_ram_size! */
|
||||
|
||||
/* Indicates if machine has BASIC built in. */
|
||||
extern int Atari800_builtin_basic;
|
||||
|
||||
/* Indicates existence of 1200XL's two keyboard LEDs.
|
||||
Used only for Atari800_MACHINE_XLXE. */
|
||||
extern int Atari800_keyboard_leds;
|
||||
|
||||
/* Indicates existence of F1-F4 keys.
|
||||
Used only for Atari800_MACHINE_XLXE. */
|
||||
extern int Atari800_f_keys;
|
||||
|
||||
/* State of the J1 jumper on the 1200XL board.
|
||||
Used only for Atari800_MACHINE_XLXE. Always call
|
||||
Atari800_UpdateJumper() after changing this variable. */
|
||||
extern int Atari800_jumper;
|
||||
void Atari800_UpdateJumper(void);
|
||||
|
||||
/* Indicates existence of XEGS' built-in game.
|
||||
Used only for Atari800_MACHINE_XLXE. */
|
||||
extern int Atari800_builtin_game;
|
||||
|
||||
/* TRUE if the XEGS keyboard is detached.
|
||||
Used only for Atari800_MACHINE_XLXE. Always call
|
||||
Atari800_UpdateKeyboardDetached() after changing this variable. */
|
||||
extern int Atari800_keyboard_detached;
|
||||
void Atari800_UpdateKeyboardDetached(void);
|
||||
|
||||
/* Video system. */
|
||||
#define Atari800_TV_UNSET 0
|
||||
#define Atari800_TV_PAL 312
|
||||
#define Atari800_TV_NTSC 262
|
||||
#define Atari800_FPS_PAL 49.8607597
|
||||
/*49.8607597 = (4.43361875*(4/5)*1000000)/(312*228)*/
|
||||
#define Atari800_FPS_NTSC 59.9227434
|
||||
/*59.9227434 = (3.579545*1000000)/(262*228)*/
|
||||
|
||||
/* Video system / Number of scanlines per frame. Do not set this variable
|
||||
directly; instead use Atari800_SetTVMode(). */
|
||||
extern int Atari800_tv_mode;
|
||||
|
||||
/* TRUE to disable Atari BASIC when booting Atari (hold Option in XL/XE). */
|
||||
extern int Atari800_disable_basic;
|
||||
|
||||
/* OS ROM version currently used by the emulator. Can be -1 for emuos/missing
|
||||
ROM, or a value from the SYSROM enumerator. */
|
||||
extern int Atari800_os_version;
|
||||
|
||||
/* If Atari800_Frame() sets it to TRUE, then the current contents
|
||||
of Screen_atari should be displayed. */
|
||||
extern int Atari800_display_screen;
|
||||
|
||||
/* Simply incremented by Atari800_Frame(). */
|
||||
extern int Atari800_nframes;
|
||||
|
||||
/* How often the screen is updated (1 = every Atari frame). */
|
||||
extern int Atari800_refresh_rate;
|
||||
|
||||
/* If TRUE, will try to maintain the emulation speed to 100% */
|
||||
extern int Atari800_auto_frameskip;
|
||||
|
||||
/* Set to TRUE for faster emulation with Atari800_refresh_rate > 1.
|
||||
Set to FALSE for accurate emulation with Atari800_refresh_rate > 1. */
|
||||
extern int Atari800_collisions_in_skipped_frames;
|
||||
|
||||
/* Set to TRUE to run emulated Atari as fast as possible */
|
||||
extern int Atari800_turbo;
|
||||
|
||||
/* Initializes Atari800 emulation core. */
|
||||
int Atari800_Initialise(int *argc, char *argv[]);
|
||||
|
||||
/* Emulates one frame (1/50sec for PAL, 1/60sec for NTSC). */
|
||||
void Atari800_Frame(void);
|
||||
|
||||
/* Reboots the emulated Atari. */
|
||||
void Atari800_Coldstart(void);
|
||||
|
||||
/* Presses the Reset key in the emulated Atari. */
|
||||
void Atari800_Warmstart(void);
|
||||
|
||||
/* Reinitializes after Atari800_machine_type or ram_size change.
|
||||
You should call Atari800_Coldstart() after it. */
|
||||
int Atari800_InitialiseMachine(void);
|
||||
|
||||
/* Shuts down Atari800 emulation core and saves the config file if needed.
|
||||
* Use it when a user requested exiting/entering a monitor. */
|
||||
int Atari800_Exit(int run_monitor);
|
||||
|
||||
/* Shuts down Atari800 emulation core. Use it for emergency-exiting
|
||||
such as on failure. */
|
||||
void Atari800_ErrExit(void);
|
||||
|
||||
|
||||
/* Private interface ----------------------------------------------------- */
|
||||
/* Don't use outside the emulation core! */
|
||||
|
||||
/* STAT_UNALIGNED_WORDS is solely for benchmarking purposes.
|
||||
8-element arrays (stat_arr) represent number of accesses with the given
|
||||
value of 3 least significant bits of address. This gives us information
|
||||
about the ratio of aligned vs unaligned accesses. */
|
||||
#ifdef STAT_UNALIGNED_WORDS
|
||||
#define UNALIGNED_STAT_DEF(stat_arr) unsigned int stat_arr[8];
|
||||
#define UNALIGNED_STAT_DECL(stat_arr) extern unsigned int stat_arr[8];
|
||||
#define UNALIGNED_GET_WORD(ptr, stat_arr) (stat_arr[(unsigned int) (ptr) & 7]++, *(const UWORD *) (ptr))
|
||||
#define UNALIGNED_PUT_WORD(ptr, value, stat_arr) (stat_arr[(unsigned int) (ptr) & 7]++, *(UWORD *) (ptr) = (value))
|
||||
#define UNALIGNED_GET_LONG(ptr, stat_arr) (stat_arr[(unsigned int) (ptr) & 7]++, *(const ULONG *) (ptr))
|
||||
#define UNALIGNED_PUT_LONG(ptr, value, stat_arr) (stat_arr[(unsigned int) (ptr) & 7]++, *(ULONG *) (ptr) = (value))
|
||||
UNALIGNED_STAT_DECL(Screen_atari_write_long_stat)
|
||||
UNALIGNED_STAT_DECL(pm_scanline_read_long_stat)
|
||||
UNALIGNED_STAT_DECL(memory_read_word_stat)
|
||||
UNALIGNED_STAT_DECL(memory_write_word_stat)
|
||||
UNALIGNED_STAT_DECL(memory_read_aligned_word_stat)
|
||||
UNALIGNED_STAT_DECL(memory_write_aligned_word_stat)
|
||||
#else
|
||||
#define UNALIGNED_STAT_DEF(stat_arr)
|
||||
#define UNALIGNED_STAT_DECL(stat_arr)
|
||||
#define UNALIGNED_GET_WORD(ptr, stat_arr) (*(const UWORD *) (ptr))
|
||||
#define UNALIGNED_PUT_WORD(ptr, value, stat_arr) (*(UWORD *) (ptr) = (value))
|
||||
#define UNALIGNED_GET_LONG(ptr, stat_arr) (*(const ULONG *) (ptr))
|
||||
#define UNALIGNED_PUT_LONG(ptr, value, stat_arr) (*(ULONG *) (ptr) = (value))
|
||||
#endif
|
||||
|
||||
/* Sleeps until it's time to emulate next Atari frame. */
|
||||
void Atari800_Sync(void);
|
||||
|
||||
/* Load a ROM image filename of size nbytes into buffer */
|
||||
int Atari800_LoadImage(const char *filename, UBYTE *buffer, int nbytes);
|
||||
|
||||
/* Save State */
|
||||
void Atari800_StateSave(void);
|
||||
|
||||
/* Read State */
|
||||
void Atari800_StateRead(UBYTE version);
|
||||
|
||||
/* Change TV mode. */
|
||||
void Atari800_SetTVMode(int mode);
|
||||
|
||||
#endif /* ATARI_H_ */
|
||||
Reference in New Issue
Block a user