Sets the display mode of the frame buffer.

Prototype declaration:


KMSTATUS KMAPI
kmSetDisplayMode(
		IN  KMDISPLAYMODE   nDisplayMode,
		IN  KMBPPMODE       nBpp,
		IN  KMBOOLEAN       bDither,
		IN  KMBOOLEAN       bAntiAlias
	);

Description:

This function sets the display mode of the frame buffer.

Parameters:
nDisplayMode(input)
This parameter specifies a display mode.
Type Mode Size scan Freq Remarks
VGA KM_DSPMODE_VGA 640x480Non-interlace 60Hz
KM_DSPMODE_VGA640x240 640x240Non-interlace 60Hz
KM_DSPMODE_VGA320x480 320x480Non-interlace 60Hz
KM_DSPMODE_VGA320x240 320x240Non-interlace 60Hz
NTSC KM_DSPMODE_NTSCNI320x240 320x240Non-interlace 60Hz
KM_DSPMODE_NTSCI320x240 320x240Interlace 30Hz
KM_DSPMODE_NTSCNI320x480 320x240Pseudo non-interlace 60Hz
KM_DSPMODE_NTSCNI320x480FF 320x240Pseudo non-interlace 60HzFlicker-free
KM_DSPMODE_NTSCI320x480 320x240Interlace 30Hz
KM_DSPMODE_NTSCNI640x240 640x240Non-interlace 60Hz
KM_DSPMODE_NTSCI640x240 640x240Interlace 30Hz
KM_DSPMODE_NTSCNI640x480 640x480Pseudo non-interlace 60Hz
KM_DSPMODE_NTSCNI640x480FF 640x480Pseudo non-interlace 60HzFlicker-free
KM_DSPMODE_NTSCI640x480 640x480Interlace 30Hz
PAL KM_DSPMODE_PALNI320x240 320x240Non-interlace 50Hz
KM_DSPMODE_PALI320x240 320x240Interlace 25Hz
KM_DSPMODE_PALNI320x480 320x480Pseudo non-interlace 50Hz
KM_DSPMODE_PALNI320x480FF 320x480Pseudo non-interlace 50HzFlicker-free
KM_DSPMODE_PALI320x480 320x480Interlace 25Hz
KM_DSPMODE_PALNI640x240 640x240Non-interlace 50Hz
KM_DSPMODE_PALI640x240 640x240Interlace 25Hz
KM_DSPMODE_PALNI640x480 640x480Pseudo non-interlace 50Hz
KM_DSPMODE_PALNI640x480FF 640x480Pseudo non-interlace 50HzFlicker-free
KM_DSPMODE_PALI640x480 640x480Interlace 25Hz
nBpp(input)
This parameter specifies a frame buffer color mode, using a predefined constant listed below.
symbol Color Mode bitdepth bit order
KM_DSPBPP_RGB565 RGB565
16
**** **** **** ****
KM_DSPBPP_RGB555 RGB555
16
**** **** **** ****
KM_DSPBPP_ARGB1555 ARGB1555
16
**** **** **** ****
KM_DSPBPP_RGB888 RGB888
24
**** **** **** **** **** ****
KM_DSPBPP_ARGB8888 ARGB8888
32
**** **** **** **** **** **** **** ****
bDither(input)
This parameter determines whether dithering is enabled or not when the PowerVR writes the results of rendering to the 16-bit frame buffer. This flag is ignored if the rendering destination frame buffer is 24 bits/32 bits (= RGB888 or ARGB8888).
KM_TRUEUse dithering.
KM_FALSEDo not use dithering.
bAntiAlias(input)
This parameter determines whether to use an antialiasing filter. Use of the antialiasing filter may reduce the operation speed.
KM_TRUE Use Anti Aliasing Filter.
KM_FALSE Do not use Anti Aliasing Filter.
Return values:
Value Explanation
KMSTATUS_SUCCESS Success
KMSTATUS_INVALID_DISPLAY_MODE Invalid display mode. A display mode that does not match that specified during initialization was specified.