/*--------------------------------------------------------------------- Copyright (C) 1997, Nintendo. File gs2dex.h Coded by Yoshitaka Yasumoto. Jul 31, 1997. Modified by Comments Header file for S2DEX ucode. $Id: gs2dex.h,v 1.21 1998/05/28 00:14:49 has Exp $ ---------------------------------------------------------------------*/ #ifndef _GS2DEX_H_ #define _GS2DEX_H_ #ifdef _LANGUAGE_C_PLUS_PLUS extern "C" { #endif #include <PR/ultratypes.h> /*===========================================================================* * Macro *===========================================================================*/ #define GS_CALC_DXT(line) (((1<< G_TX_DXT_FRAC)-1)/(line)+1) #define GS_PIX2TMEM(pix, siz) ((pix)>>(4-(siz))) #define GS_PIX2DXT(pix, siz) GS_CALC_DXT(GS_PIX2TMEM((pix), (siz))) /*===========================================================================* * Data structures for S2DEX microcode *===========================================================================*/ /*---------------------------------------------------------------------------* * Background *---------------------------------------------------------------------------*/ #define G_BGLT_LOADBLOCK 0x0033 #define G_BGLT_LOADTILE 0xfff4 #define G_BG_FLAG_FLIPS 0x01 #define G_BG_FLAG_FLIPT 0x10 /* Non scalable background plane */ typedef struct { u16 imageX; /* テクスチャの左上位置 X 座標 (u10.5) */ u16 imageW; /* テクスチャの幅 (u10.2) */ s16 frameX; /* 転送されるフレームの左上位置(s10.2) */ u16 frameW; /* 転送されるフレームの幅 (u10.2) */ u16 imageY; /* テクスチャの左上位置 Y 座標 (u10.5) */ u16 imageH; /* テクスチャの高さ (u10.2) */ s16 frameY; /* 転送されるフレームの左上位置(s10.2) */ u16 frameH; /* 転送されるフレームの高さ (u10.2) */ u64 *imagePtr; /* DRAM 上のテクスチャソースアドレス */ u16 imageLoad; /* LoadBlock, LoadTile のどちらを使用するか */ u8 imageFmt; /* テクセルのフォーマット G_IM_FMT_* */ u8 imageSiz; /* テクセルのサイズ G_IM_SIZ_* */ u16 imagePal; /* パレット番号 */ u16 imageFlip; /* イメージの左右反転 G_BG_FLAG_FLIPS で反転 */ /* 以下は初期化ルーチン guS2DInitBg() 内で設定されるのでユーザが設 定する必要はない */ u16 tmemW; /* frame 1 ラインの TMEM 幅 Word サイズ LoadBlock の時 GS_PIX2TMEM(imageW/4,imageSiz) LoadTile の時 GS_PIX2TMEM(frameW/4,imageSiz)+1 */ u16 tmemH; /* 一度にロードできる TMEM 高さ (s13.2) 4倍値 通常テクスチャの時 512/tmemW*4 CI テクスチャの時 256/tmemW*4 */ u16 tmemLoadSH; /* SH 値 LoadBlock の時 tmemSize/2-1 LoadTile の時 tmemW*16-1 */ u16 tmemLoadTH; /* TH 値 or Stride 値 LoadBlock の時 GS_CALC_DXT(tmemW) LoadTile の時 tmemH-1 */ u16 tmemSizeW; /* image 1 ライン分の imagePtr のスキップ値 LoadBlock の時 tmemW*2 LoadTile の時 GS_PIX2TMEM(imageW/4,imageSiz)*2 */ u16 tmemSize; /* ロード一回分の imagePtr のスキップ値 = tmemSizeW*tmemH */ } uObjBg_t; /* 40 bytes */ /* Scalable background plane */ typedef struct { u16 imageX; /* テクスチャの左上位置 X 座標 (u10.5) */ u16 imageW; /* テクスチャの幅 (u10.2) */ s16 frameX; /* 転送されるフレームの左上位置(s10.2) */ u16 frameW; /* 転送されるフレームの幅 (u10.2) */ u16 imageY; /* テクスチャの左上位置 Y 座標 (u10.5) */ u16 imageH; /* テクスチャの高さ (u10.2) */ s16 frameY; /* 転送されるフレームの左上位置(s10.2) */ u16 frameH; /* 転送されるフレームの高さ (u10.2) */ u64 *imagePtr; /* DRAM 上のテクスチャソースアドレス */ u16 imageLoad; /* LoadBlock, LoadTile のどちらを使用するか */ u8 imageFmt; /* テクセルのフォーマット G_IM_FMT_* */ u8 imageSiz; /* テクセルのサイズ G_IM_SIZ_* */ u16 imagePal; /* パレット番号 */ u16 imageFlip; /* イメージの左右反転 G_BG_FLAG_FLIPS で反転 */ u16 scaleW; /* X 方向スケール値 (u5.10) */ u16 scaleH; /* Y 方向スケール値 (u5.10) */ s32 imageYorig; /* image における描画始点 (s20.5) */ u8 padding[4]; } uObjScaleBg_t; /* 40 bytes */ typedef union { uObjBg_t b; uObjScaleBg_t s; long long int force_structure_alignment; } uObjBg; /*---------------------------------------------------------------------------* * 2D Objects *---------------------------------------------------------------------------*/ #define G_OBJ_FLAG_FLIPS 1<<0 /* S 方向反転 */ #define G_OBJ_FLAG_FLIPT 1<<4 /* T 方向反転 */ typedef struct { s16 objX; /* s10.2 OBJ 左上端 X 座標 */ u16 scaleW; /* u5.10 幅方向スケーリング */ u16 imageW; /* u10.5 テクスチャの幅 (S 方向の長さ) */ u16 paddingX; /* 未使用 常に 0 */ s16 objY; /* s10.2 OBJ 左上端 Y 座標 */ u16 scaleH; /* u5.10 高さ方向スケーリング */ u16 imageH; /* u10.5 テクスチャの高さ (T 方向の長さ) */ u16 paddingY; /* 未使用 常に 0 */ u16 imageStride; /* テクセルの折り返し幅 (64bit word 単位) */ u16 imageAdrs; /* TMEM 内のテクスチャ先頭位置 (64bit word 単位) */ u8 imageFmt; /* テクセルのフォーマット G_IM_FMT_* */ u8 imageSiz; /* テクセルのサイズ G_IM_SIZ_* */ u8 imagePal; /* パレット番号 0-7 */ u8 imageFlags; /* 表示フラグ G_OBJ_FLAG_FLIP* */ } uObjSprite_t; /* 24 bytes */ typedef union { uObjSprite_t s; long long int force_structure_alignment; } uObjSprite; /*---------------------------------------------------------------------------* * 2D Matrix *---------------------------------------------------------------------------*/ typedef struct { s32 A, B, C, D; /* s15.16 */ s16 X, Y; /* s10.2 */ u16 BaseScaleX; /* u5.10 */ u16 BaseScaleY; /* u5.10 */ } uObjMtx_t; /* 24 bytes */ typedef union { uObjMtx_t m; long long int force_structure_alignment; } uObjMtx; typedef struct { s16 X, Y; /* s10.2 */ u16 BaseScaleX; /* u5.10 */ u16 BaseScaleY; /* u5.10 */ } uObjSubMtx_t; /* 8 bytes */ typedef union { uObjSubMtx_t m; long long int force_structure_alignment; } uObjSubMtx; /*---------------------------------------------------------------------------* * Loading into TMEM *---------------------------------------------------------------------------*/ #define G_OBJLT_TXTRBLOCK 0x00001033 #define G_OBJLT_TXTRTILE 0x00fc1034 #define G_OBJLT_TLUT 0x00000030 #define GS_TB_TSIZE(pix,siz) (GS_PIX2TMEM((pix),(siz))-1) #define GS_TB_TLINE(pix,siz) (GS_CALC_DXT(GS_PIX2TMEM((pix),(siz)))) typedef struct { u32 type; /* Type 種別 G_OBJLT_TXTRBLOCK */ u64 *image; /* DRAM 上のテクスチャソースアドレス */ u16 tmem; /* ロード先の TMEM ワードアドレス (8byteWORD) */ u16 tsize; /* Texture サイズ マクロ GS_TB_TSIZE() で指定 */ u16 tline; /* Texture 1 ライン幅 マクロ GS_TB_TLINE() で指定 */ u16 sid; /* STATE ID 4 の倍数で 0,4,8,12 のどれか */ u32 flag; /* STATE flag */ u32 mask; /* STATE mask */ } uObjTxtrBlock_t; /* 24 bytes */ #define GS_TT_TWIDTH(pix,siz) ((GS_PIX2TMEM((pix), (siz))<<2)-1) #define GS_TT_THEIGHT(pix,siz) (((pix)<<2)-1) typedef struct { u32 type; /* Type 種別 G_OBJLT_TXTRTILE */ u64 *image; /* DRAM 上のテクスチャソースアドレス */ u16 tmem; /* ロード先の TMEM ワードアドレス (8byteWORD) */ u16 twidth; /* Texture 幅 マクロ GS_TT_TWIDTH() で指定 */ u16 theight; /* Texture 高さ マクロ GS_TT_THEIGHT() で指定 */ u16 sid; /* STATE ID 4 の倍数で 0,4,8,12 のどれか */ u32 flag; /* STATE flag */ u32 mask; /* STATE mask */ } uObjTxtrTile_t; /* 24 bytes */ #define GS_PAL_HEAD(head) ((head)+256) #define GS_PAL_NUM(num) ((num)-1) typedef struct { u32 type; /* Type 種別 G_OBJLT_TLUT */ u64 *image; /* DRAM 上のテクスチャソースアドレス */ u16 phead; /* ロード先頭のパレット番号 256 以上 511 以下 */ u16 pnum; /* ロードするパレット数 - 1 */ u16 zero; /* 常に 0 を代入する */ u16 sid; /* STATE ID 4 の倍数で 0,4,8,12 のどれか */ u32 flag; /* STATE flag */ u32 mask; /* STATE mask */ } uObjTxtrTLUT_t; /* 24 bytes */ typedef union { uObjTxtrBlock_t block; uObjTxtrTile_t tile; uObjTxtrTLUT_t tlut; long long int force_structure_alignment; } uObjTxtr; /*---------------------------------------------------------------------------* * Loading into TMEM & 2D Objects *---------------------------------------------------------------------------*/ typedef struct { uObjTxtr txtr; uObjSprite sprite; } uObjTxSprite; /* 48 bytes */ /*===========================================================================* * GBI Commands for S2DEX microcode *===========================================================================*/ /* GBI Header */ #ifdef F3DEX_GBI_2 #define G_OBJ_RECTANGLE_R 0xda #define G_OBJ_MOVEMEM 0xdc #define G_RDPHALF_0 0xe4 #define G_OBJ_RECTANGLE 0x01 #define G_OBJ_SPRITE 0x02 #define G_SELECT_DL 0x04 #define G_OBJ_LOADTXTR 0x05 #define G_OBJ_LDTX_SPRITE 0x06 #define G_OBJ_LDTX_RECT 0x07 #define G_OBJ_LDTX_RECT_R 0x08 #define G_BG_1CYC 0x09 #define G_BG_COPY 0x0a #define G_OBJ_RENDERMODE 0x0b #else #define G_BG_1CYC 0x01 #define G_BG_COPY 0x02 #define G_OBJ_RECTANGLE 0x03 #define G_OBJ_SPRITE 0x04 #define G_OBJ_MOVEMEM 0x05 #define G_SELECT_DL 0xb0 #define G_OBJ_RENDERMODE 0xb1 #define G_OBJ_RECTANGLE_R 0xb2 #define G_OBJ_LOADTXTR 0xc1 #define G_OBJ_LDTX_SPRITE 0xc2 #define G_OBJ_LDTX_RECT 0xc3 #define G_OBJ_LDTX_RECT_R 0xc4 #define G_RDPHALF_0 0xe4 #endif /*---------------------------------------------------------------------------* * Background wrapped screen *---------------------------------------------------------------------------*/ #define gSPBgRectangle(pkt, m, mptr) gDma0p((pkt),(m),(mptr),0) #define gsSPBgRectangle(m, mptr) gsDma0p( (m),(mptr),0) #define gSPBgRectCopy(pkt, mptr) gSPBgRectangle((pkt), G_BG_COPY, (mptr)) #define gsSPBgRectCopy(mptr) gsSPBgRectangle( G_BG_COPY, (mptr)) #define gSPBgRect1Cyc(pkt, mptr) gSPBgRectangle((pkt), G_BG_1CYC, (mptr)) #define gsSPBgRect1Cyc(mptr) gsSPBgRectangle( G_BG_1CYC, (mptr)) /*---------------------------------------------------------------------------* * 2D Objects *---------------------------------------------------------------------------*/ #define gSPObjSprite(pkt, mptr) gDma0p((pkt),G_OBJ_SPRITE, (mptr),0) #define gsSPObjSprite(mptr) gsDma0p( G_OBJ_SPRITE, (mptr),0) #define gSPObjRectangle(pkt, mptr) gDma0p((pkt),G_OBJ_RECTANGLE, (mptr),0) #define gsSPObjRectangle(mptr) gsDma0p( G_OBJ_RECTANGLE, (mptr),0) #define gSPObjRectangleR(pkt, mptr) gDma0p((pkt),G_OBJ_RECTANGLE_R,(mptr),0) #define gsSPObjRectangleR(mptr) gsDma0p( G_OBJ_RECTANGLE_R,(mptr),0) /*---------------------------------------------------------------------------* * 2D Matrix *---------------------------------------------------------------------------*/ #define gSPObjMatrix(pkt, mptr) gDma1p((pkt),G_OBJ_MOVEMEM,(mptr),0,23) #define gsSPObjMatrix(mptr) gsDma1p( G_OBJ_MOVEMEM,(mptr),0,23) #define gSPObjSubMatrix(pkt, mptr) gDma1p((pkt),G_OBJ_MOVEMEM,(mptr),2, 7) #define gsSPObjSubMatrix(mptr) gsDma1p( G_OBJ_MOVEMEM,(mptr),2, 7) /*---------------------------------------------------------------------------* * Loading into TMEM *---------------------------------------------------------------------------*/ #define gSPObjLoadTxtr(pkt, tptr) gDma0p((pkt),G_OBJ_LOADTXTR, (tptr),23) #define gsSPObjLoadTxtr(tptr) gsDma0p( G_OBJ_LOADTXTR, (tptr),23) #define gSPObjLoadTxSprite(pkt, tptr) gDma0p((pkt),G_OBJ_LDTX_SPRITE,(tptr),47) #define gsSPObjLoadTxSprite(tptr) gsDma0p( G_OBJ_LDTX_SPRITE,(tptr),47) #define gSPObjLoadTxRect(pkt, tptr) gDma0p((pkt),G_OBJ_LDTX_RECT, (tptr),47) #define gsSPObjLoadTxRect(tptr) gsDma0p( G_OBJ_LDTX_RECT, (tptr),47) #define gSPObjLoadTxRectR(pkt, tptr) gDma0p((pkt),G_OBJ_LDTX_RECT_R,(tptr),47) #define gsSPObjLoadTxRectR(tptr) gsDma0p( G_OBJ_LDTX_RECT_R,(tptr),47) /*---------------------------------------------------------------------------* * Select Display List *---------------------------------------------------------------------------*/ #define gSPSelectDL(pkt, mptr, sid, flag, mask) \ { gDma1p((pkt), G_RDPHALF_0, (flag), (u32)(mptr) & 0xffff, (sid)); \ gDma1p((pkt), G_SELECT_DL, (mask), (u32)(mptr) >> 16, G_DL_PUSH); } #define gsSPSelectDL(mptr, sid, flag, mask) \ { gsDma1p(G_RDPHALF_0, (flag), (u32)(mptr) & 0xffff, (sid)); \ gsDma1p(G_SELECT_DL, (mask), (u32)(mptr) >> 16, G_DL_PUSH); } #define gSPSelectBranchDL(pkt, mptr, sid, flag, mask) \ { gDma1p((pkt), G_RDPHALF_0, (flag), (u32)(mptr) & 0xffff, (sid)); \ gDma1p((pkt), G_SELECT_DL, (mask), (u32)(mptr) >> 16, G_DL_NOPUSH); } #define gsSPSelectBranchDL(mptr, sid, flag, mask) \ { gsDma1p(G_RDPHALF_0, (flag), (u32)(mptr) & 0xffff, (sid)); \ gsDma1p(G_SELECT_DL, (mask), (u32)(mptr) >> 16, G_DL_NOPUSH); } /*---------------------------------------------------------------------------* * Set general status *---------------------------------------------------------------------------*/ #define G_MW_GENSTAT 0x08 /* G_MW_FOG と同じ値なので注意 */ #define gSPSetStatus(pkt, sid, val) \ gMoveWd((pkt), G_MW_GENSTAT, (sid), (val)) #define gsSPSetStatus(sid, val) \ gsMoveWd( G_MW_GENSTAT, (sid), (val)) /*---------------------------------------------------------------------------* * Set Object Render Mode *---------------------------------------------------------------------------*/ #define G_OBJRM_NOTXCLAMP 0x01 #define G_OBJRM_XLU 0x02 /* Ignored */ #define G_OBJRM_ANTIALIAS 0x04 /* Ignored */ #define G_OBJRM_BILERP 0x08 #define G_OBJRM_SHRINKSIZE_1 0x10 #define G_OBJRM_SHRINKSIZE_2 0x20 #define G_OBJRM_WIDEN 0x40 #define gSPObjRenderMode(pkt, mode) gImmp1((pkt),G_OBJ_RENDERMODE,(mode)) #define gsSPObjRenderMode(mode) gsImmp1( G_OBJ_RENDERMODE,(mode)) /*===========================================================================* * Render Mode Macro *===========================================================================*/ #define RM_RA_SPRITE(clk) \ AA_EN | CVG_DST_CLAMP | \ CVG_X_ALPHA | ALPHA_CVG_SEL | ZMODE_OPA | TEX_EDGE | \ GBL_c##clk(G_BL_CLR_IN, G_BL_A_IN, G_BL_CLR_MEM, G_BL_1MA) #define G_RM_SPRITE G_RM_OPA_SURF #define G_RM_SPRITE2 G_RM_OPA_SURF2 #define G_RM_RA_SPRITE RM_RA_SPRITE(1) #define G_RM_RA_SPRITE2 RM_RA_SPRITE(2) #define G_RM_AA_SPRITE G_RM_AA_TEX_TERR #define G_RM_AA_SPRITE2 G_RM_AA_TEX_TERR2 #define G_RM_XLU_SPRITE G_RM_XLU_SURF #define G_RM_XLU_SPRITE2 G_RM_XLU_SURF2 #define G_RM_AA_XLU_SPRITE G_RM_AA_XLU_SURF #define G_RM_AA_XLU_SPRITE2 G_RM_AA_XLU_SURF2 /*===========================================================================* * External functions *===========================================================================*/ extern u64 gspS2DEX_fifoTextStart[], gspS2DEX_fifoTextEnd[]; extern u64 gspS2DEX_fifoDataStart[], gspS2DEX_fifoDataEnd[]; extern u64 gspS2DEX_fifo_dTextStart[], gspS2DEX_fifo_dTextEnd[]; extern u64 gspS2DEX_fifo_dDataStart[], gspS2DEX_fifo_dDataEnd[]; extern u64 gspS2DEX2_fifoTextStart[], gspS2DEX2_fifoTextEnd[]; extern u64 gspS2DEX2_fifoDataStart[], gspS2DEX2_fifoDataEnd[]; extern u64 gspS2DEX2_xbusTextStart[], gspS2DEX2_xbusTextEnd[]; extern u64 gspS2DEX2_xbusDataStart[], gspS2DEX2_xbusDataEnd[]; extern void guS2DInitBg(uObjBg *); #ifdef F3DEX_GBI_2 # define guS2DEmuBgRect1Cyc guS2D2EmuBgRect1Cyc /*Wrapper*/ # define guS2DEmuSetScissor guS2D2EmuSetScissor /*Wrapper*/ extern void guS2D2EmuSetScissor(u32, u32, u32, u32, u8); extern void guS2D2EmuBgRect1Cyc(Gfx **, uObjBg *); #else extern void guS2DEmuSetScissor(u32, u32, u32, u32, u8); extern void guS2DEmuBgRect1Cyc(Gfx **, uObjBg *); #endif #ifdef _LANGUAGE_C_PLUS_PLUS } #endif #endif /* _GS2DEX_H_ */ /*======== End of gs2dex.h ========*/