📄 infones.h
字号:
/*===================================================================*/
/* */
/* InfoNES.h : NES Emulator for Win32, Linux(x86), Linux(PS2) */
/* */
/* 2000/05/14 InfoNES Project ( based on pNesX ) */
/* */
/*===================================================================*/
#ifndef InfoNES_H_INCLUDED
#define InfoNES_H_INCLUDED
/*-------------------------------------------------------------------*/
/* Include files */
/*-------------------------------------------------------------------*/
#include "InfoNES_Types.h"
/*-------------------------------------------------------------------*/
/* NES resources : cpu resources */
/*-------------------------------------------------------------------*/
#define RAM_SIZE 0x2000 //2k字节RAM,从0x0000到0x07ff可用，做四次镜像到0x1fff
#define SRAM_SIZE 0x2000 //8k字节的SRAM,电池RAM，卡带上用来保存游戏记录的EPROM－电擦写ROM
//从0x6000到0x7fff
#define PPURAM_SIZE 0x4000 //16k的PPURAM
#define SPRRAM_SIZE 256 //精灵RAM，RAM中的256字节，专用于储存精灵，它不属于VRAM或ROM
/* RAM */
extern BYTE RAM[];
/* SRAM */
extern BYTE SRAM[];
/* ROM */
extern BYTE *ROM;
/* SRAM BANK ( 8Kb ) */
extern BYTE *SRAMBANK;
/* ROM BANK ( 8Kb * 4 ) */ //卡带ROM
extern BYTE *ROMBANK0;
extern BYTE *ROMBANK1;
extern BYTE *ROMBANK2;
extern BYTE *ROMBANK3;
/*-------------------------------------------------------------------*/
/* PPU resources */
/*-------------------------------------------------------------------*/
/* PPU RAM */
extern BYTE PPURAM[];
/* VROM */
extern BYTE *VROM; //图像ROM，储存图像数据的地方，可以由MMC切换到VRAM里
/* PPU BANK ( 1Kb * 16 ) */
extern BYTE *PPUBANK[];
#define NAME_TABLE0 8 //四个命名表
#define NAME_TABLE1 9
#define NAME_TABLE2 10
#define NAME_TABLE3 11
#define NAME_TABLE_V_MASK 2 //NES卡带有垂直镜像和水平镜像
#define NAME_TABLE_H_MASK 1
/* Sprite RAM */
extern BYTE SPRRAM[]; //精灵RAM
#define SPR_Y 0
#define SPR_CHR 1
#define SPR_ATTR 2
#define SPR_X 3
#define SPR_ATTR_COLOR 0x3
#define SPR_ATTR_V_FLIP 0x80
#define SPR_ATTR_H_FLIP 0x40
#define SPR_ATTR_PRI 0x20
/* PPU Register */
extern BYTE PPU_R0;
extern BYTE PPU_R1;
extern BYTE PPU_R2;
extern BYTE PPU_R3;
extern BYTE PPU_R7;
extern BYTE PPU_Scr_V;
extern BYTE PPU_Scr_V_Next;
extern BYTE PPU_Scr_V_Byte;
extern BYTE PPU_Scr_V_Byte_Next;
extern BYTE PPU_Scr_V_Bit;
extern BYTE PPU_Scr_V_Bit_Next;
extern BYTE PPU_Scr_H;
extern BYTE PPU_Scr_H_Next;
extern BYTE PPU_Scr_H_Byte;
extern BYTE PPU_Scr_H_Byte_Next;
extern BYTE PPU_Scr_H_Bit;
extern BYTE PPU_Scr_H_Bit_Next;
extern BYTE PPU_Latch_Flag;
extern WORD PPU_Addr;
extern WORD PPU_Temp;
extern WORD PPU_Increment;
extern BYTE PPU_Latch_Flag;
extern BYTE PPU_UpDown_Clip;
#define R0_NMI_VB 0x80
#define R0_NMI_SP 0x40
#define R0_SP_SIZE 0x20
#define R0_BG_ADDR 0x10
#define R0_SP_ADDR 0x08
#define R0_INC_ADDR 0x04
#define R0_NAME_ADDR 0x03
#define R1_BACKCOLOR 0xe0
#define R1_SHOW_SP 0x10
#define R1_SHOW_SCR 0x08
#define R1_CLIP_SP 0x04
#define R1_CLIP_BG 0x02
#define R1_MONOCHROME 0x01
#define R2_IN_VBLANK 0x80
#define R2_HIT_SP 0x40
#define R2_MAX_SP 0x20
#define R2_WRITE_FLAG 0x10
#define SCAN_TOP_OFF_SCREEN 0
#define SCAN_ON_SCREEN 1
#define SCAN_BOTTOM_OFF_SCREEN 2
#define SCAN_UNKNOWN 3
#define SCAN_VBLANK 4
#define SCAN_TOP_OFF_SCREEN_START 0
#define SCAN_ON_SCREEN_START 8
#define SCAN_BOTTOM_OFF_SCREEN_START 232
#define SCAN_UNKNOWN_START 240
#define SCAN_VBLANK_START 243
#define SCAN_VBLANK_END 262
#define STEP_PER_SCANLINE 113
#define STEP_PER_FRAME 29828
/* Develop Scroll Registers */
#define InfoNES_SetupScr() \
{ \
/* V-Scroll Register */ \
PPU_Scr_V_Next = ( BYTE )( PPU_Addr & 0x001f ); \
PPU_Scr_V_Byte_Next = PPU_Scr_V_Next >> 3; \
PPU_Scr_V_Bit_Next = PPU_Scr_V_Next & 0x07; \
\
/* H-Scroll Register */ \
PPU_Scr_H_Next = ( BYTE )( ( PPU_Addr & 0x03e0 ) >> 5 ); \
PPU_Scr_H_Byte_Next = PPU_Scr_H_Next >> 3; \
PPU_Scr_H_Bit_Next = PPU_Scr_H_Next & 0x07; \
}
/* Current Scanline */
extern WORD PPU_Scanline;
/* Scanline Table */
extern BYTE PPU_ScanTable[];
/* Name Table Bank */
extern BYTE PPU_NameTableBank;
/* BG Base Address */
extern BYTE *PPU_BG_Base;
/* Sprite Base Address */
extern BYTE *PPU_SP_Base;
/* Sprite Height */
extern WORD PPU_SP_Height;
/* NES display size */
#define NES_DISP_WIDTH 256
#define NES_DISP_HEIGHT 240
/* VRAM Write Enable ( 0: Disable, 1: Enable ) */
extern BYTE byVramWriteEnable;
/* Frame IRQ ( 0: Disabled, 1: Enabled )*/
extern BYTE FrameIRQ_Enable;
extern WORD FrameStep;
/*-------------------------------------------------------------------*/
/* Display and Others resouces */
/*-------------------------------------------------------------------*/
/* Frame Skip */
extern WORD FrameSkip;
extern WORD FrameCnt;
extern WORD FrameWait;
extern WORD DoubleFrame[ 2 ][ NES_DISP_WIDTH * NES_DISP_HEIGHT ];
extern WORD *WorkFrame;
extern WORD WorkFrameIdx;
extern BYTE ChrBuf[];
extern BYTE ChrBufUpdate;
extern WORD PalTable[];
/*-------------------------------------------------------------------*/
/* APU and Pad resources */
/*-------------------------------------------------------------------*/
extern BYTE APU_Reg[];
extern int APU_Mute;
extern DWORD PAD1_Latch;
extern DWORD PAD2_Latch;
extern DWORD PAD_System;
extern DWORD PAD1_Bit;
extern DWORD PAD2_Bit;
#define PAD_SYS_QUIT 1
#define PAD_SYS_OK 2
#define PAD_SYS_CANCEL 4
#define PAD_SYS_UP 8
#define PAD_SYS_DOWN 0x10
#define PAD_SYS_LEFT 0x20
#define PAD_SYS_RIGHT 0x40
#define PAD_PUSH(a,b) ( ( (a) & (b) ) != 0 )
/*-------------------------------------------------------------------*/
/* Mapper Function */
/*-------------------------------------------------------------------*/
/* Initialize Mapper */
extern void (*MapperInit)();
/* Write to Mapper */
extern void (*MapperWrite)( WORD wAddr, BYTE byData );
/* Write to SRAM */
extern void (*MapperSram)( WORD wAddr, BYTE byData );
/* Write to APU */
extern void (*MapperApu)( WORD wAddr, BYTE byData );
/* Read from Apu */
extern BYTE (*MapperReadApu)( WORD wAddr );
/* Callback at VSync */
extern void (*MapperVSync)();
/* Callback at HSync */
extern void (*MapperHSync)();
/* Callback at PPU read/write */
extern void (*MapperPPU)( WORD wAddr );
/* Callback at Rendering Screen 1:BG, 0:Sprite */
extern void (*MapperRenderScreen)( BYTE byMode );
/*-------------------------------------------------------------------*/
/* ROM information */
/*-------------------------------------------------------------------*/
/* .nes File Header */
struct NesHeader_tag
{
BYTE byID[ 4 ];
BYTE byRomSize;
BYTE byVRomSize;
BYTE byInfo1;
BYTE byInfo2;
BYTE byReserve[ 8 ];
};
/* .nes File Header */
extern struct NesHeader_tag NesHeader;
/* Mapper No. */
extern BYTE MapperNo;
/* Other */
extern BYTE ROM_Mirroring;
extern BYTE ROM_SRAM;
extern BYTE ROM_Trainer;
extern BYTE ROM_FourScr;
/*-------------------------------------------------------------------*/
/* Function prototypes */
/*-------------------------------------------------------------------*/
/* Initialize InfoNES */
void InfoNES_Init();
/* Completion treatment */
void InfoNES_Fin();
/* Load a cassette */
int InfoNES_Load( const char *pszFileName );
/* Reset InfoNES */
int InfoNES_Reset();
/* Initialize PPU */
void InfoNES_SetupPPU();
/* Set up a Mirroring of Name Table */
void InfoNES_Mirroring( int nType );
/* The main loop of InfoNES */
void InfoNES_Main();
/* The loop of emulation */
void InfoNES_Cycle();
/* A function in H-Sync */
int InfoNES_HSync();
/* Render a scanline */
void InfoNES_DrawLine();
/* Get a position of scanline hits sprite #0 */
void InfoNES_GetSprHitY();
/* Develop character data */
void InfoNES_SetupChr();
#endif /* !InfoNES_H_INCLUDED */
⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -