[Previous] [Contents] [Index] [Next]

PgSetUserClip(), PgSetUserClipAbsolute()

Restrict subsequent draws

Synopsis:

void PgSetUserClip( PhRect_t const *ClipRect );

void PgSetUserClipAbsolute( PhRect_t const *ClipRect );

Description:

These functions restrict all subsequent draws to the area defined by ClipRect. To disable the user clipping rectangle, pass ClipRect as NULL.

PgSetUserClip() sets the user clipping rectangle relative to the current translation whereas PgSetUserClipAbsolute() sets the rectangle independent of the current translation.

The user clipping area is set independent of the clipping that's set by PgSetClipping() and PgSetMultiClip().

All subsequent draws will be clipped to the intersection of the clipping rectangles set by PgSetClipping(), PgSetMultiClip(), and PgSetUserClip().

Unlike PgSetClipping(), these functions don't flush the draw buffer.


Note: PhAttach(), PhReattach(), and PgSetRegion() reset the clipping rectangle to the full size of the region.

This function emits a draw command.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

PgClearTranslation(), PgSetClipping(), PgSetMultiClip(), PgSetTranslation(), PhAttach(), PhReattach(), PgSetRegion()


[Previous] [Contents] [Index] [Next]