/*---------------------------------------------------------------------
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; /* �e�N�X�`���̍���ʒu X ���W (u10.5) */
u16 imageW; /* �e�N�X�`���̕� (u10.2) */
s16 frameX; /* �]�������t���[���̍���ʒu(s10.2) */
u16 frameW; /* �]�������t���[���̕� (u10.2) */
u16 imageY; /* �e�N�X�`���̍���ʒu Y ���W (u10.5) */
u16 imageH; /* �e�N�X�`���̍��� (u10.2) */
s16 frameY; /* �]�������t���[���̍���ʒu(s10.2) */
u16 frameH; /* �]�������t���[���̍��� (u10.2) */
u64 *imagePtr; /* DRAM ��̃e�N�X�`���\�[�X�A�h���X */
u16 imageLoad; /* LoadBlock, LoadTile �̂ǂ�����g�p���邩 */
u8 imageFmt; /* �e�N�Z���̃t�H�[�}�b�g G_IM_FMT_* */
u8 imageSiz; /* �e�N�Z���̃T�C�Y G_IM_SIZ_* */
u16 imagePal; /* �p���b�g�ԍ� */
u16 imageFlip; /* �C���[�W�̍��E���] G_BG_FLAG_FLIPS �Ŕ��] */
/* �ȉ��͏��������[�`�� guS2DInitBg() ���Őݒ肳���̂Ń��[�U����
�肷��K�v�͂Ȃ� */
u16 tmemW; /* frame 1 ���C���� TMEM �� Word �T�C�Y
LoadBlock �̎� GS_PIX2TMEM(imageW/4,imageSiz)
LoadTile �̎� GS_PIX2TMEM(frameW/4,imageSiz)+1 */
u16 tmemH; /* ��x�Ƀ��[�h�ł��� TMEM ���� (s13.2) 4�{�l
�ʏ�e�N�X�`���̎� 512/tmemW*4
CI �e�N�X�`���̎� 256/tmemW*4 */
u16 tmemLoadSH; /* SH �l
LoadBlock �̎� tmemSize/2-1
LoadTile �̎� tmemW*16-1 */
u16 tmemLoadTH; /* TH �l or Stride �l
LoadBlock �̎� GS_CALC_DXT(tmemW)
LoadTile �̎� tmemH-1 */
u16 tmemSizeW; /* image 1 ���C������ imagePtr �̃X�L�b�v�l
LoadBlock �̎� tmemW*2
LoadTile �̎� GS_PIX2TMEM(imageW/4,imageSiz)*2 */
u16 tmemSize; /* ���[�h��� imagePtr �̃X�L�b�v�l
= tmemSizeW*tmemH */
} uObjBg_t; /* 40 bytes */
/* Scalable background plane */
typedef struct {
u16 imageX; /* �e�N�X�`���̍���ʒu X ���W (u10.5) */
u16 imageW; /* �e�N�X�`���̕� (u10.2) */
s16 frameX; /* �]�������t���[���̍���ʒu(s10.2) */
u16 frameW; /* �]�������t���[���̕� (u10.2) */
u16 imageY; /* �e�N�X�`���̍���ʒu Y ���W (u10.5) */
u16 imageH; /* �e�N�X�`���̍��� (u10.2) */
s16 frameY; /* �]�������t���[���̍���ʒu(s10.2) */
u16 frameH; /* �]�������t���[���̍��� (u10.2) */
u64 *imagePtr; /* DRAM ��̃e�N�X�`���\�[�X�A�h���X */
u16 imageLoad; /* LoadBlock, LoadTile �̂ǂ�����g�p���邩 */
u8 imageFmt; /* �e�N�Z���̃t�H�[�}�b�g G_IM_FMT_* */
u8 imageSiz; /* �e�N�Z���̃T�C�Y G_IM_SIZ_* */
u16 imagePal; /* �p���b�g�ԍ� */
u16 imageFlip; /* �C���[�W�̍��E���] G_BG_FLAG_FLIPS �Ŕ��] */
u16 scaleW; /* X �����X�P�[���l (u5.10) */
u16 scaleH; /* Y �����X�P�[���l (u5.10) */
s32 imageYorig; /* image �ɂ�����`��n�_ (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 ���W */
u16 scaleW; /* u5.10 �������X�P�[�����O */
u16 imageW; /* u10.5 �e�N�X�`���̕� (S �����̒���) */
u16 paddingX; /* ���g�p ��� 0 */
s16 objY; /* s10.2 OBJ ����[ Y ���W */
u16 scaleH; /* u5.10 ���������X�P�[�����O */
u16 imageH; /* u10.5 �e�N�X�`���̍��� (T �����̒���) */
u16 paddingY; /* ���g�p ��� 0 */
u16 imageStride; /* �e�N�Z���̐܂�Ԃ��� (64bit word �P��) */
u16 imageAdrs; /* TMEM ���̃e�N�X�`���擪�ʒu (64bit word �P��) */
u8 imageFmt; /* �e�N�Z���̃t�H�[�}�b�g G_IM_FMT_* */
u8 imageSiz; /* �e�N�Z���̃T�C�Y G_IM_SIZ_* */
u8 imagePal; /* �p���b�g�ԍ� 0-7 */
u8 imageFlags; /* �\���t���O 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 ��̃e�N�X�`���\�[�X�A�h���X */
u16 tmem; /* ���[�h��� TMEM ���[�h�A�h���X (8byteWORD) */
u16 tsize; /* Texture �T�C�Y �}�N�� GS_TB_TSIZE() �Ŏw�� */
u16 tline; /* Texture 1 ���C���� �}�N�� GS_TB_TLINE() �Ŏw�� */
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 ��̃e�N�X�`���\�[�X�A�h���X */
u16 tmem; /* ���[�h��� TMEM ���[�h�A�h���X (8byteWORD) */
u16 twidth; /* Texture �� �}�N�� GS_TT_TWIDTH() �Ŏw�� */
u16 theight; /* Texture ���� �}�N�� GS_TT_THEIGHT() �Ŏw�� */
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 ��̃e�N�X�`���\�[�X�A�h���X */
u16 phead; /* ���[�h�擪�̃p���b�g�ԍ� 256 �ȏ� 511 �ȉ� */
u16 pnum; /* ���[�h����p���b�g�� - 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 �Ɠ����l�Ȃ̂Œ��� */
#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 ========*/