Ninja Library - System Function

njChangeSystem

Changes the system

FORMAT

void njChangeSystem( mode, frame, count )
Int mode
Int frame
Int count

PARAMETER

 mode  Screen mode 
 frame  Frame buffer color mode 
 count  Frame count number 

RETURN

None

DESCRIPTION

Changes the system to the specified screen resolution. The size of the 2D clip area is set to the same size as the screen. The frame count is specified in 1/60-second units. For example, if "2" is specified at frame, the frame changes every 1/30 seconds. Frame changes are performed with njWaitVSync() function.

The following screen modes can be set.

NJD_RESOLUTION_VGA
NJD_RESOLUTION_320x240_NTSCNI
NJD_RESOLUTION_320x240_NTSCI
NJD_RESOLUTION_640x240_NTSCNI
NJD_RESOLUTION_640x240_NTSCI
NJD_RESOLUTION_320x480_NTSCNI_FF
NJD_RESOLUTION_320x480_NTSCNI
NJD_RESOLUTION_320x480_NTSCI
NJD_RESOLUTION_640x480_NTSCNI_FF
NJD_RESOLUTION_640x480_NTSCNI
NJD_RESOLUTION_640x480_NTSCI
NJD_RESOLUTION_320x240_PALNI
NJD_RESOLUTION_320x240_PALI
NJD_RESOLUTION_640x240_PALNI
NJD_RESOLUTION_640x240_PALI
NJD_RESOLUTION_320x480_PALNI_FF
NJD_RESOLUTION_320x480_PALNI
NJD_RESOLUTION_320x480_PALI
NJD_RESOLUTION_640x480_PALNI_FF
NJD_RESOLUTION_640x480_PALNI
NJD_RESOLUTION_640x480_PALI
NJD_RESOLUTION_VGA_ANTI
NJD_RESOLUTION_320x240_NTSCNI_ANTI
NJD_RESOLUTION_320x240_NTSCI_ANTI
NJD_RESOLUTION_640x240_NTSCNI_ANTI
NJD_RESOLUTION_640x240_NTSCI_ANTI
NJD_RESOLUTION_320x480_NTSCNI_FF_ANTI
NJD_RESOLUTION_320x480_NTSCNI_ANTI
NJD_RESOLUTION_320x480_NTSCI_ANTI
NJD_RESOLUTION_640x480_NTSCNI_FF_ANTI
NJD_RESOLUTION_640x480_NTSCNI_ANTI
NJD_RESOLUTION_640x480_NTSCI_ANTI
NJD_RESOLUTION_320x240_PALNI_ANTI
NJD_RESOLUTION_320x240_PALI_ANTI
NJD_RESOLUTION_640x240_PALNI_ANTI
NJD_RESOLUTION_640x240_PALI_ANTI
NJD_RESOLUTION_320x480_PALNI_FF_ANTI
NJD_RESOLUTION_320x480_PALNI_ANTI
NJD_RESOLUTION_320x480_PALI_ANTI
NJD_RESOLUTION_640x480_PALNI_FF_ANTI
NJD_RESOLUTION_640x480_PALNI_ANTI
NJD_RESOLUTION_640x480_PALI_ANTI

Each meaning is as follows.
 Notation  Meaning 
 VGA  VGA mode 
 320x240  Screen resolution 320x240 
 320x480  Screen resolution 320x480 
 640x240  Screen resolution 640x240 
 640x480  Screen resolution 640x480 
 NTSC/PAL  Type of display 
 I/NI  30Int Display/60Int Display 
 ANTI  Anti-aliase 
 FF  TypeB flicker free * 

When FF is not specified, it becomes TypeA flicker free. Please refer to Hardware Overview(dreamcast_hw.doc) for more details.

Frame buffer color modes are as follows.

 Notation  Meaning 
 NJD_FRAMEBUFFER_MODE_RGB565  red 5bit/green 6bit/blue 5bit 
 NJD_FRAMEBUFFER_MODE_RGB555  red 5bit/green 5bit/blue 5bit 
 NJD_FRAMEBUFFER_MODE_ARGB1555  alpha 1bit/red 5bit/green 5bit/blue 5bit 
 NJD_FRAMEBUFFER_MODE_RGB888  red 8bit/green 8bit/blue 8bit 
 NJD_FRAMEBUFFER_MODE_ARGB8888  alpha 8bit/red 8bit/green 8bit/blue 8bit 


EXAMPLE

The following makes a system change after stopping the frame buffer.
njStopDisplay();
njReleaseTextureAll();
njChangeSystem(NJD_RESOLUTION_640x480_NTSCI, NJD_FRAMEBUFFER_MODE_RGB565, 1);
njInitVertexBuffer( 800000, 0, 300000, 0 ,0 );
njLoadTexture( &texlist );

NOTE

Release all textures before using this function and reload them afterwards with the njInitVertexBuffer() function.

REFERENCE

njInitSystem()
njInitVertexBuffer()
njWaitVSync()

njChangeSystem
COPYRIGHT © SEGA ENTERPRISES, LTD., 1998,1999