make OSS detect blocking, adjust audio API
[picodrive.git] / pico / pico.h
index fb067b8..ca7577f 100644 (file)
@@ -4,7 +4,7 @@
 // Pico Library - Header File\r
 \r
 // (c) Copyright 2004 Dave, All rights reserved.\r
-// (c) Copyright 2006-2008 notaz, All rights reserved.\r
+// (c) Copyright 2006-2009 notaz, All rights reserved.\r
 // Free for non-commercial use.\r
 \r
 // For commercial use, separate licencing terms must be obtained.\r
@@ -12,7 +12,7 @@
 #ifndef PICO_H\r
 #define PICO_H\r
 \r
-#include <stdio.h>\r
+//#include <stdio.h>\r
 \r
 // port-specific compile-time settings\r
 #include <port_config.h>\r
@@ -22,15 +22,31 @@ extern "C" {
 #endif\r
 \r
 // external funcs for Sega/Mega CD\r
-extern int  mp3_get_bitrate(FILE *f, int size);\r
-extern void mp3_start_play(FILE *f, int pos);\r
+extern int  mp3_get_bitrate(void *f, int size);\r
+extern void mp3_start_play(void *f, int pos);\r
 extern void mp3_update(int *buffer, int length, int stereo);\r
 \r
 // this function should write-back d-cache and invalidate i-cache\r
 // on a mem region [start_addr, end_addr)\r
-// used by SVP dynarec\r
+// used by dynarecs\r
 extern void cache_flush_d_inval_i(const void *start_addr, const void *end_addr);\r
 \r
+// attempt to alloc mem at specified address.\r
+// alloc anywhere else if that fails (callers should handle that)\r
+extern void *plat_mmap(unsigned long addr, size_t size);\r
+extern void *plat_mremap(void *ptr, size_t oldsize, size_t newsize);\r
+extern void  plat_munmap(void *ptr, size_t size);\r
+\r
+// this one should handle display mode changes\r
+extern void emu_video_mode_change(int start_line, int line_count, int is_32cols);\r
+\r
+// this must switch to 16bpp mode\r
+extern void emu_32x_startup(void);\r
+\r
+// optional 32X BIOS, should be left NULL if not used\r
+// must be 256, 2048, 1024 bytes\r
+extern void *p32x_bios_g, *p32x_bios_m, *p32x_bios_s;\r
+\r
 // Pico.c\r
 #define POPT_EN_FM          (1<< 0) // 00 000x\r
 #define POPT_EN_PSG         (1<< 1)\r
@@ -52,13 +68,16 @@ extern void cache_flush_d_inval_i(const void *start_addr, const void *end_addr);
 #define POPT_EN_SVP_DRC     (1<<17)\r
 #define POPT_DIS_SPRITE_LIM (1<<18)\r
 #define POPT_DIS_IDLE_DET   (1<<19)\r
+#define POPT_EN_32X         (1<<20)\r
+#define POPT_EN_PWM         (1<<21)\r
 extern int PicoOpt; // bitfield\r
+\r
 #define PAHW_MCD  (1<<0)\r
 #define PAHW_32X  (1<<1)\r
 #define PAHW_SVP  (1<<2)\r
 #define PAHW_PICO (1<<3)\r
+#define PAHW_SMS  (1<<4)\r
 extern int PicoAHW;            // Pico active hw\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
@@ -67,10 +86,11 @@ void PicoInit(void);
 void PicoExit(void);\r
 void PicoPower(void);\r
 int  PicoReset(void);\r
+void PicoLoopPrepare(void);\r
 void 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 (*PicoWriteSound)(int bytes); // 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 { PI_ROM, PI_ISPAL, PI_IS40_CELL, PI_IS240_LINES } pint_t;\r
 typedef union { int vint; void *vptr; } pint_ret_t;\r
@@ -78,10 +98,10 @@ void PicoGetInternal(pint_t which, pint_ret_t *ret);
 \r
 // cd/Pico.c\r
 extern void (*PicoMCDopenTray)(void);\r
-extern int  (*PicoMCDcloseTray)(void);\r
+extern void (*PicoMCDcloseTray)(void);\r
 extern int PicoCDBuffers;\r
 \r
-// Pico/Pico.c\r
+// pico.c\r
 #define XPCM_BUFFER_SIZE (320+160)\r
 typedef struct\r
 {\r
@@ -98,30 +118,20 @@ typedef struct
 } picohw_state;\r
 extern picohw_state PicoPicohw;\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
+// area.c\r
+int PicoState(const char *fname, int is_save);\r
+int PicoStateLoadGfx(const char *fname);\r
+void *PicoTmpStateSave(void);\r
+void  PicoTmpStateRestore(void *data);\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
 void PicoCDBufferFlush(void);\r
 \r
 // cd/cd_sys.c\r
-int Insert_CD(char *cdimg_name, int type);\r
+int Insert_CD(const char *cdimg_name, int type);\r
 void Stop_CD(void); // releases all resources taken when CD game was started.\r
 \r
 // Cart.c\r
@@ -137,28 +147,32 @@ typedef struct
        void *param;            /* additional file related field */\r
        unsigned int size;      /* size */\r
        pm_type type;\r
+       char ext[4];\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 PicoCartLoad(pm_file *f,unsigned char **prom,unsigned int *psize,int is_sms);\r
+int PicoCartInsert(unsigned char *rom, unsigned int romsize, const char *carthw_cfg);\r
 void PicoCartUnload(void);\r
 extern void (*PicoCartLoadProgressCB)(int percent);\r
-extern void (*PicoCDLoadProgressCB)(int percent);\r
+extern void (*PicoCDLoadProgressCB)(const char *fname, int percent);\r
 \r
 // Draw.c\r
-void PicoDrawSetColorFormat(int which); // 0=BGR444, 1=RGB555, 2=8bit(HighPal pal)\r
+// for line-based renderer, set conversion\r
+// from internal 8 bit representation in 'HighCol' to:\r
+typedef enum\r
+{\r
+       PDF_NONE = 0,    // no conversion\r
+       PDF_RGB555,      // RGB/BGR output, depends on compile options\r
+       PDF_8BIT,        // 8-bit out (handles shadow/hilight mode, sonic water)\r
+} pdso_t;\r
+void PicoDrawSetOutFormat(pdso_t which, int allow_32x);\r
+void PicoDrawSetOutBuf(void *dest, int increment);\r
+void PicoDrawSetCallbacks(int (*begin)(unsigned int num), int (*end)(unsigned int num));\r
 extern void *DrawLineDest;\r
-#if OVERRIDE_HIGHCOL\r
 extern unsigned char *HighCol;\r
-#else\r
-extern unsigned char  HighCol[8+320+8];\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
@@ -169,6 +183,7 @@ extern int PicoDrawMask;
 #define PDRAW_LAYERA_ON      (1<<3)\r
 #define PDRAW_SPRITES_LOW_ON (1<<4)\r
 #define PDRAW_SPRITES_HI_ON  (1<<7)\r
+#define PDRAW_32X_ON         (1<<8)\r
 // internals\r
 #define PDRAW_SPRITES_MOVED (1<<0) // (asm)\r
 #define PDRAW_WND_DIFF_PRIO (1<<1) // not all window tiles use same priority\r
@@ -178,15 +193,32 @@ extern int PicoDrawMask;
 #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
-extern int rendstatus;\r
+#define PDRAW_32_COLS       (1<<8) // 32 column mode\r
+extern int rendstatus, rendstatus_old;\r
+extern int rendlines;\r
 extern unsigned short HighPal[0x100];\r
 \r
-// Draw2.c\r
+// draw.c\r
+void PicoDrawUpdateHighPal(void);\r
+void PicoDrawSetInternalBuf(void *dest, int line_increment);\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
+// pico.c (32x)\r
+// multipliers against 68k clock\r
+extern int p32x_msh2_multiplier;\r
+extern int p32x_ssh2_multiplier;\r
+#define SH2_MULTI_SHIFT 10\r
+#define MSH2_MULTI_DEFAULT ((1 << SH2_MULTI_SHIFT) * 3 / 2)\r
+#define SSH2_MULTI_DEFAULT ((1 << SH2_MULTI_SHIFT) * 3 / 2)\r
+\r
+// 32x/draw.c\r
+void PicoDraw32xSetFrameMode(int is_on, int only_32x);\r
+\r
 // sound.c\r
 extern int PsndRate,PsndLen;\r
 extern short *PsndOut;\r