#include <nitro/gx/gx.h>
void GX_SetGraphicsMode(GXDispMode dispMode, GXBGMode bgMode, GXBG0As bg0_2d3d);
dispMode | Display Mode. Selects from Graphics display mode VRAM display mode, Main Memory display mode. |
bgMode | Selects BG mode. |
bg0_2d3d | Selects whether to allocate BG0 to 3D. |
None.
This function sets the display mode for the main graphics engine. If something other than graphics display mode is selected with dispMode
, the values of bgMode
and bg0_2d3d
are used only for capturing the graphics display screen. The bgMode
argument selects the BG mode. The bg0_2d3d
argument specifies whether to use BG0 as 2D or 3D. The bgMode
and bg0_2d3d
values are only used with the capture of the graphics display screen when something other than graphics display mode is selected with dispMode
.
GX_DISPMODE_GRAPHICS |
Show 2D/3D graphics |
GX_DISPMODE_VRAM_A |
VRAM display mode (show VRAM-A) |
GX_DISPMODE_VRAM_B |
VRAM display mode (show VRAM-B) |
GX_DISPMODE_VRAM_C |
VRAM display mode (show VRAM-C) |
GX_DISPMODE_VRAM_D |
VRAM display mode (show VRAM-D) |
GX_DISPMODE_MMEM |
Main memory display mode (transfer with MI_DispMemDmaCopy ) |
GX_BGMODE_0 |
BG0=Text/3D, BG1=Text, BG2=Text, BG3=Text |
GX_BGMODE_1 |
BG0=Text/3D, BG1=Text, BG2=Text, BG3=Affine |
GX_BGMODE_2 |
BG0=Text/3D, BG1=Text, BG2=Affine, BG3=Affine |
GX_BGMODE_3 |
BG0=Text/3D, BG1=Text, BG2=Text, BG3=Affine Extended BG |
GX_BGMODE_4 |
BG0=Text/3D, BG1=Text, BG2=Affine, BG3=Affine Extended BG |
GX_BGMODE_5 |
BG0=Text/3D, BG1=Text, BG2=Affine Extended BG, BG3=Affine Extended BG |
GX_BGMODE_6 |
BG0=3D, BG1=None, BG2=Big Screen 256-color bitmap, BG3=None |
GX_BG0_AS_2D |
BG0 displayed as text. Ignored when GX_BGMODE_6 is selected. |
GX_BG0_AS_3D |
BG0 displayed as 3D. Ignored when GX_BGMODE_6 is selected. |
The following is the type definition for GXDispMode
, GXBGMode
, and GXBG0As
types.
typedef enum { GX_DISPMODE_GRAPHICS = 0x01, GX_DISPMODE_VRAM_A = 0x02, GX_DISPMODE_VRAM_B = 0x06, GX_DISPMODE_VRAM_C = 0x0a, GX_DISPMODE_VRAM_D = 0x0e, GX_DISPMODE_MMEM = 0x03 } GXDispMode; typedef enum { GX_BGMODE_0 = 0, GX_BGMODE_1 = 1, GX_BGMODE_2 = 2, GX_BGMODE_3 = 3, GX_BGMODE_4 = 4, GX_BGMODE_5 = 5, GX_BGMODE_6 = 6 } GXBGMode; typedef enum { GX_BG0_AS_2D = 0, GX_BG0_AS_3D = 1 } GXBG0As;
08/03/2004
02/09/2004
GX_DISPMODE_OFF
. Use GX_DispOff
instead.01/19/2004 Initial version.