Prototype declaration:
KMSTATUS KMAPI kmSetDisplayMode( IN KMDISPLAYMODE nDisplayMode, IN KMBPPMODE nBpp, IN KMBOOLEAN bDither, IN KMBOOLEAN bAntiAlias );
Description:
Parameters:This function sets the display mode of the frame buffer.
nDisplayMode(input)
This parameter specifies a display mode.nBpp(input)
Type Mode Size scan Freq Remarks VGA KM_DSPMODE_VGA 640x480 Non-interlace 60Hz KM_DSPMODE_VGA640x240 640x240 Non-interlace 60Hz KM_DSPMODE_VGA320x480 320x480 Non-interlace 60Hz KM_DSPMODE_VGA320x240 320x240 Non-interlace 60Hz NTSC KM_DSPMODE_NTSCNI320x240 320x240 Non-interlace 60Hz KM_DSPMODE_NTSCI320x240 320x240 Interlace 30Hz KM_DSPMODE_NTSCNI320x480 320x240 Pseudo non-interlace 60Hz KM_DSPMODE_NTSCNI320x480FF 320x240 Pseudo non-interlace 60Hz Flicker-free KM_DSPMODE_NTSCI320x480 320x240 Interlace 30Hz KM_DSPMODE_NTSCNI640x240 640x240 Non-interlace 60Hz KM_DSPMODE_NTSCI640x240 640x240 Interlace 30Hz KM_DSPMODE_NTSCNI640x480 640x480 Pseudo non-interlace 60Hz KM_DSPMODE_NTSCNI640x480FF 640x480 Pseudo non-interlace 60Hz Flicker-free KM_DSPMODE_NTSCI640x480 640x480 Interlace 30Hz PAL KM_DSPMODE_PALNI320x240 320x240 Non-interlace 50Hz KM_DSPMODE_PALI320x240 320x240 Interlace 25Hz KM_DSPMODE_PALNI320x480 320x480 Pseudo non-interlace 50Hz KM_DSPMODE_PALNI320x480FF 320x480 Pseudo non-interlace 50Hz Flicker-free KM_DSPMODE_PALI320x480 320x480 Interlace 25Hz KM_DSPMODE_PALNI640x240 640x240 Non-interlace 50Hz KM_DSPMODE_PALI640x240 640x240 Interlace 25Hz KM_DSPMODE_PALNI640x480 640x480 Pseudo non-interlace 50Hz KM_DSPMODE_PALNI640x480FF 640x480 Pseudo non-interlace 50Hz Flicker-free KM_DSPMODE_PALI640x480 640x480 Interlace 25Hz This parameter specifies a frame buffer color mode, using a predefined constant listed below.bDither(input)
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 **** **** **** **** **** **** **** **** 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).bAntiAlias(input)
KM_TRUE Use dithering. KM_FALSE Do not use dithering. This parameter determines whether to use an antialiasing filter. Use of the antialiasing filter may reduce the operation speed.Return values:
KM_TRUE Use Anti Aliasing Filter. KM_FALSE Do not use Anti Aliasing Filter.
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.