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` | 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 |

> 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_TRUE | Use dithering.
> > > KM_FALSE | Do 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.