[picodrive.git] / Pico / Pico.h

\r
// -------------------- Pico Library --------------------\r
\r
// Pico Library - Header File\r
\r
// (c) Copyright 2004 Dave, All rights reserved.\r
// (c) Copyright 2006-2008 notaz, All rights reserved.\r
// Free for non-commercial use.\r
\r
// For commercial use, separate licencing terms must be obtained.\r
\r
#ifndef PICO_H\r
#define PICO_H\r
\r
#include <stdio.h>\r
\r
// port-specific compile-time settings\r
#include <port_config.h>\r
\r
#ifdef __cplusplus\r
extern "C" {\r
#endif\r
\r
// external funcs for Sega/Mega CD\r
int  mp3_get_bitrate(FILE *f, int size);\r
void mp3_start_play(FILE *f, int pos);\r
int  mp3_get_offset(void); // 0-1023\r
void mp3_update(int *buffer, int length, int stereo);\r
\r
\r
// Pico.c\r
#define POPT_EN_FM          (1<< 0) // 00 000x\r
#define POPT_EN_PSG         (1<< 1)\r
#define POPT_EN_Z80         (1<< 2)\r
#define POPT_EN_STEREO      (1<< 3)\r
#define POPT_ALT_RENDERER   (1<< 4) // 00 00x0\r
#define POPT_6BTN_PAD       (1<< 5)\r
#define POPT_ACC_TIMING     (1<< 6)\r
#define POPT_ACC_SPRITES    (1<< 7)\r
#define POPT_DIS_32C_BORDER (1<< 8) // 00 0x00\r
#define POPT_EXT_FM         (1<< 9)\r
#define POPT_EN_MCD_PCM     (1<<10)\r
#define POPT_EN_MCD_CDDA    (1<<11)\r
#define POPT_EN_MCD_GFX     (1<<12) // 00 x000\r
#define POPT_EN_MCD_PSYNC   (1<<13)\r
#define POPT_EN_SOFTSCALE   (1<<14)\r
#define POPT_EN_MCD_RAMCART (1<<15)\r
#define POPT_DIS_VDP_FIFO   (1<<16) // 0x 0000\r
#define POPT_EN_SVP_DRC     (1<<17)\r
extern int PicoOpt; // bitfield\r
extern int PicoVer;\r
extern int PicoSkipFrame; // skip rendering frame, but still do sound (if enabled) and emulation stuff\r
extern int PicoRegionOverride; // override the region detection 0: auto, 1: Japan NTSC, 2: Japan PAL, 4: US, 8: Europe\r
extern int PicoAutoRgnOrder; // packed priority list of regions, for example 0x148 means this detection order: EUR, USA, JAP\r
extern int PicoSVPCycles;\r
int  PicoInit(void);\r
void PicoExit(void);\r
void PicoPower(void);\r
int  PicoReset(void);\r
int  PicoFrame(void);\r
void PicoFrameDrawOnly(void);\r
extern int PicoPad[2]; // Joypads, format is MXYZ SACB RLDU\r
extern void (*PicoWriteSound)(int len); // called once per frame at the best time to send sound buffer (PsndOut) to hardware\r
extern void (*PicoMessage)(const char *msg); // callback to output text message from emu\r
typedef enum { PS_PAL, PS_40_CELL, PS_240_LINES } pstat_t;\r
int  PicoGetStat(pstat_t which);\r
\r
// cd/Pico.c\r
extern void (*PicoMCDopenTray)(void);\r
extern int  (*PicoMCDcloseTray)(void);\r
extern int PicoCDBuffers;\r
\r
// Area.c\r
typedef size_t (arearw)(void *p, size_t _size, size_t _n, void *file);\r
typedef size_t (areaeof)(void *file);\r
typedef int    (areaseek)(void *file, long offset, int whence);\r
typedef int    (areaclose)(void *file);\r
// Save or load the state from PmovFile:\r
int PmovState(int PmovAction, void *PmovFile); // &1=for reading &2=for writing &4=volatile &8=non-volatile\r
extern arearw  *areaRead;  // external read and write function pointers for\r
extern arearw  *areaWrite; // gzip save state ability\r
extern areaeof *areaEof;\r
extern areaseek *areaSeek;\r
extern areaclose *areaClose;\r
extern void (*PicoStateProgressCB)(const char *str);\r
\r
// cd/Area.c\r
int PicoCdLoadStateGfx(void *file);\r
\r
// cd/buffering.c\r
void PicoCDBufferInit(void);\r
void PicoCDBufferFree(void);\r
\r
// cd/cd_sys.c\r
int Insert_CD(char *iso_name, int is_bin);\r
void Stop_CD(void); // releases all resources taken when CD game was started.\r
\r
// Cart.c\r
typedef enum\r
{\r
	PMT_UNCOMPRESSED = 0,\r
	PMT_ZIP,\r
	PMT_CSO\r
} pm_type;\r
typedef struct\r
{\r
	void *file;		/* file handle */\r
	void *param;		/* additional file related field */\r
	unsigned int size;	/* size */\r
	pm_type type;\r
} pm_file;\r
pm_file *pm_open(const char *path);\r
size_t   pm_read(void *ptr, size_t bytes, pm_file *stream);\r
int      pm_seek(pm_file *stream, long offset, int whence);\r
int      pm_close(pm_file *fp);\r
int PicoCartLoad(pm_file *f,unsigned char **prom,unsigned int *psize);\r
int PicoCartInsert(unsigned char *rom,unsigned int romsize);\r
void Byteswap(unsigned char *data,int len);\r
int PicoCartUnload(void);\r
extern void (*PicoCartLoadProgressCB)(int percent);\r
extern void (*PicoCDLoadProgressCB)(int percent);\r
\r
// Draw.c\r
void PicoDrawSetColorFormat(int which); // 0=BGR444, 1=RGB555, 2=8bit(HighPal pal)\r
extern void *DrawLineDest;\r
#if OVERRIDE_HIGHCOL\r
extern unsigned char *HighCol;\r
#endif\r
extern int (*PicoScanBegin)(unsigned int num);\r
extern int (*PicoScanEnd)(unsigned int num);\r
// utility\r
#ifdef _ASM_DRAW_C\r
void vidConvCpyRGB565(void *to, void *from, int pixels);\r
#endif\r
// internals\r
#define PDRAW_SPRITES_MOVED (1<<0)\r
#define PDRAW_WND_DIFF_PRIO (1<<1) // not all window tiles use same priority\r
#define PDRAW_ACC_SPRITES   (1<<2) // accurate sprites (copied from PicoOpt)\r
#define PDRAW_INTERLACE     (1<<3) // \r
#define PDRAW_DIRTY_SPRITES (1<<4)\r
#define PDRAW_SONIC_MODE    (1<<5) // mid-frame palette changes for 8bit renderer\r
#define PDRAW_PLANE_HI_PRIO (1<<6) // have layer with all hi prio tiles (mk3)\r
#define PDRAW_SHHI_DONE     (1<<7) // layer sh/hi already processed\r
#define PDRAW_EARLY_BLANK   (1<<8) // blanking enabled at the start of prev line\r
extern int rendstatus;\r
extern unsigned short HighPal[0x100];\r
\r
// Draw2.c\r
// stuff below is optional\r
extern unsigned char  *PicoDraw2FB;  // buffer for fast renderer in format (8+320)x(8+224+8) (eights for borders)\r
extern unsigned short *PicoCramHigh; // pointer to CRAM buff (0x40 shorts), converted to native device color (works only with 16bit for now)\r
extern void (*PicoPrepareCram)();    // prepares PicoCramHigh for renderer to use\r
\r
// sound.c\r
extern int PsndRate,PsndLen;\r
extern short *PsndOut;\r
extern void (*PsndMix_32_to_16l)(short *dest, int *src, int count);\r
void PsndRerate(int preserve_state);\r
\r
// Utils.c\r
extern int PicuAnd;\r
int PicuQuick(unsigned short *dest,unsigned short *src);\r
int PicuShrink(unsigned short *dest,int destLen,unsigned short *src,int srcLen);\r
int PicuShrinkReverse(unsigned short *dest,int destLen,unsigned short *src,int srcLen);\r
int PicuMerge(unsigned short *dest,int destLen,unsigned short *src,int srcLen);\r
\r
#ifdef __cplusplus\r
} // End of extern "C"\r
#endif\r
\r
#endif // PICO_H\r
Commit	Line	Data
cc68a136	1	\r
	2	// -------------------- Pico Library --------------------\r
	3	\r
	4	// Pico Library - Header File\r
	5	\r
	6	// (c) Copyright 2004 Dave, All rights reserved.\r
602133e1	7	// (c) Copyright 2006-2008 notaz, All rights reserved.\r
cc68a136	8	// Free for non-commercial use.\r
	9	\r
	10	// For commercial use, separate licencing terms must be obtained.\r
	11	\r
	12	#ifndef PICO_H\r
	13	#define PICO_H\r
	14	\r
eff55556	15	#include <stdio.h>\r
eff55556	16	\r
cc68a136	17	// port-specific compile-time settings\r
	18	#include <port_config.h>\r
	19	\r
	20	#ifdef __cplusplus\r
	21	extern "C" {\r
	22	#endif\r
	23	\r
75736070	24	// external funcs for Sega/Mega CD\r
75736070	25	int mp3_get_bitrate(FILE *f, int size);\r
cb0316e4	26	void mp3_start_play(FILE *f, int pos);\r
75736070	27	int mp3_get_offset(void); // 0-1023\r
4f265db7	28	void mp3_update(int *buffer, int length, int stereo);\r
cb0316e4	29	\r
cb0316e4	30	\r
cc68a136	31	// Pico.c\r
602133e1	32	#define POPT_EN_FM (1<< 0) // 00 000x\r
	33	#define POPT_EN_PSG (1<< 1)\r
	34	#define POPT_EN_Z80 (1<< 2)\r
	35	#define POPT_EN_STEREO (1<< 3)\r
	36	#define POPT_ALT_RENDERER (1<< 4) // 00 00x0\r
	37	#define POPT_6BTN_PAD (1<< 5)\r
	38	#define POPT_ACC_TIMING (1<< 6)\r
	39	#define POPT_ACC_SPRITES (1<< 7)\r
	40	#define POPT_DIS_32C_BORDER (1<< 8) // 00 0x00\r
	41	#define POPT_EXT_FM (1<< 9)\r
	42	#define POPT_EN_MCD_PCM (1<<10)\r
	43	#define POPT_EN_MCD_CDDA (1<<11)\r
	44	#define POPT_EN_MCD_GFX (1<<12) // 00 x000\r
	45	#define POPT_EN_MCD_PSYNC (1<<13)\r
	46	#define POPT_EN_SOFTSCALE (1<<14)\r
	47	#define POPT_EN_MCD_RAMCART (1<<15)\r
	48	#define POPT_DIS_VDP_FIFO (1<<16) // 0x 0000\r
	49	#define POPT_EN_SVP_DRC (1<<17)\r
	50	extern int PicoOpt; // bitfield\r
cc68a136	51	extern int PicoVer;\r
	52	extern int PicoSkipFrame; // skip rendering frame, but still do sound (if enabled) and emulation stuff\r
	53	extern int PicoRegionOverride; // override the region detection 0: auto, 1: Japan NTSC, 2: Japan PAL, 4: US, 8: Europe\r
51a902ae	54	extern int PicoAutoRgnOrder; // packed priority list of regions, for example 0x148 means this detection order: EUR, USA, JAP\r
0ffefdb8	55	extern int PicoSVPCycles;\r
0ffefdb8	56	int PicoInit(void);\r
cc68a136	57	void PicoExit(void);\r
1cb1584b	58	void PicoPower(void);\r
1cb1584b	59	int PicoReset(void);\r
0ffefdb8	60	int PicoFrame(void);\r
a12e0116	61	void PicoFrameDrawOnly(void);\r
cc68a136	62	extern int PicoPad[2]; // Joypads, format is MXYZ SACB RLDU\r
7a93adeb	63	extern void (*PicoWriteSound)(int len); // called once per frame at the best time to send sound buffer (PsndOut) to hardware\r
66fdc0f0	64	extern void (PicoMessage)(const char msg); // callback to output text message from emu\r
8e5427a0	65	typedef enum { PS_PAL, PS_40_CELL, PS_240_LINES } pstat_t;\r
8e5427a0	66	int PicoGetStat(pstat_t which);\r
cc68a136	67	\r
721cd396	68	// cd/Pico.c\r
721cd396	69	extern void (*PicoMCDopenTray)(void);\r
721cd396	70	extern int (*PicoMCDcloseTray)(void);\r
0a051f55	71	extern int PicoCDBuffers;\r
0a051f55	72	\r
cc68a136	73	// Area.c\r
cc68a136	74	typedef size_t (arearw)(void p, size_t _size, size_t _n, void file);\r
51a902ae	75	typedef size_t (areaeof)(void *file);\r
75736070	76	typedef int (areaseek)(void *file, long offset, int whence);\r
860c6322	77	typedef int (areaclose)(void *file);\r
cc68a136	78	// Save or load the state from PmovFile:\r
cc68a136	79	int PmovState(int PmovAction, void *PmovFile); // &1=for reading &2=for writing &4=volatile &8=non-volatile\r
51a902ae	80	extern arearw *areaRead; // external read and write function pointers for\r
	81	extern arearw *areaWrite; // gzip save state ability\r
	82	extern areaeof *areaEof;\r
75736070	83	extern areaseek *areaSeek;\r
860c6322	84	extern areaclose *areaClose;\r
76276b0b	85	extern void (PicoStateProgressCB)(const char str);\r
cc68a136	86	\r
eff55556	87	// cd/Area.c\r
	88	int PicoCdLoadStateGfx(void *file);\r
	89	\r
0a051f55	90	// cd/buffering.c\r
	91	void PicoCDBufferInit(void);\r
	92	void PicoCDBufferFree(void);\r
	93	\r
eff55556	94	// cd/cd_sys.c\r
	95	int Insert_CD(char *iso_name, int is_bin);\r
	96	void Stop_CD(void); // releases all resources taken when CD game was started.\r
	97	\r
cc68a136	98	// Cart.c\r
83bd0b76	99	typedef enum\r
	100	{\r
	101	PMT_UNCOMPRESSED = 0,\r
71de3cd9	102	PMT_ZIP,\r
71de3cd9	103	PMT_CSO\r
83bd0b76	104	} pm_type;\r
	105	typedef struct\r
	106	{\r
	107	void file; / file handle */\r
	108	void param; / additional file related field */\r
	109	unsigned int size; /* size */\r
	110	pm_type type;\r
	111	} pm_file;\r
	112	pm_file pm_open(const char path);\r
	113	size_t pm_read(void ptr, size_t bytes, pm_file stream);\r
	114	int pm_seek(pm_file *stream, long offset, int whence);\r
	115	int pm_close(pm_file *fp);\r
	116	int PicoCartLoad(pm_file f,unsigned char prom,unsigned int psize);\r
cc68a136	117	int PicoCartInsert(unsigned char *rom,unsigned int romsize);\r
cc68a136	118	void Byteswap(unsigned char *data,int len);\r
a12b1b29	119	int PicoCartUnload(void);\r
a9b3ffd3	120	extern void (*PicoCartLoadProgressCB)(int percent);\r
4b167c12	121	extern void (*PicoCDLoadProgressCB)(int percent);\r
cc68a136	122	\r
	123	// Draw.c\r
	124	void PicoDrawSetColorFormat(int which); // 0=BGR444, 1=RGB555, 2=8bit(HighPal pal)\r
	125	extern void *DrawLineDest;\r
ea8c405f	126	#if OVERRIDE_HIGHCOL\r
	127	extern unsigned char *HighCol;\r
	128	#endif\r
602133e1	129	extern int (*PicoScanBegin)(unsigned int num);\r
602133e1	130	extern int (*PicoScanEnd)(unsigned int num);\r
cc68a136	131	// utility\r
cc68a136	132	#ifdef _ASM_DRAW_C\r
ea8c405f	133	void vidConvCpyRGB565(void to, void from, int pixels);\r
cc68a136	134	#endif\r
602133e1	135	// internals\r
	136	#define PDRAW_SPRITES_MOVED (1<<0)\r
	137	#define PDRAW_WND_DIFF_PRIO (1<<1) // not all window tiles use same priority\r
	138	#define PDRAW_ACC_SPRITES (1<<2) // accurate sprites (copied from PicoOpt)\r
	139	#define PDRAW_INTERLACE (1<<3) // \r
	140	#define PDRAW_DIRTY_SPRITES (1<<4)\r
	141	#define PDRAW_SONIC_MODE (1<<5) // mid-frame palette changes for 8bit renderer\r
	142	#define PDRAW_PLANE_HI_PRIO (1<<6) // have layer with all hi prio tiles (mk3)\r
	143	#define PDRAW_SHHI_DONE (1<<7) // layer sh/hi already processed\r
	144	#define PDRAW_EARLY_BLANK (1<<8) // blanking enabled at the start of prev line\r
	145	extern int rendstatus;\r
	146	extern unsigned short HighPal[0x100];\r
cc68a136	147	\r
	148	// Draw2.c\r
	149	// stuff below is optional\r
8e5427a0	150	extern unsigned char *PicoDraw2FB; // buffer for fast renderer in format (8+320)x(8+224+8) (eights for borders)\r
cc68a136	151	extern unsigned short *PicoCramHigh; // pointer to CRAM buff (0x40 shorts), converted to native device color (works only with 16bit for now)\r
	152	extern void (*PicoPrepareCram)(); // prepares PicoCramHigh for renderer to use\r
	153	\r
	154	// sound.c\r
	155	extern int PsndRate,PsndLen;\r
	156	extern short *PsndOut;\r
4a32f01f	157	extern void (PsndMix_32_to_16l)(short dest, int *src, int count);\r
9d917eea	158	void PsndRerate(int preserve_state);\r
cc68a136	159	\r
	160	// Utils.c\r
	161	extern int PicuAnd;\r
	162	int PicuQuick(unsigned short dest,unsigned short src);\r
	163	int PicuShrink(unsigned short dest,int destLen,unsigned short src,int srcLen);\r
	164	int PicuShrinkReverse(unsigned short dest,int destLen,unsigned short src,int srcLen);\r
	165	int PicuMerge(unsigned short dest,int destLen,unsigned short src,int srcLen);\r
	166	\r
	167	#ifdef __cplusplus\r
	168	} // End of extern "C"\r
	169	#endif\r
	170	\r
	171	#endif // PICO_H\r