kmSetPixelClipping

Specifies pixel-unit clipping.


KMSTATUS KMAPI
kmSetPixelClipping(
IN KMINT32 Xmin,
IN KMINT32 Ymin,
IN KMINT32 Xmax,
IN KMINT32 Ymax
)

Description:

This function sets pixel-unit clipping for rendering output to the frame buffer.

Parameters:

Xmin, Ymin, Xmax, Ymax(input)
These parameters specify the coordinates of the upper-left and lower-right corners of a clipping area in pixel units. "(Xmin,Ymin) - (Xmax,Ymax)" cannot be larger than the screen size. If screen mode is 24 bpp, coordinates specified for a clipping area must be even numbers; in other words, the clipping area can be specified only in two-pixel units. If they are not even, values that are 1 greater than specified are assumed for (Xmin,Ymin), and values that are 1 less than specified are assumed for (Xmax,Ymax).

Return values:

ValueExplanation
KMSTATUS_SUCCESS Success
KMSTATUS_INVALID_PARAMETER Invalid parameter

  kmSetPixelClipping