PEXRedrawClipRegion(3) — Subroutines

Name

PEXRedrawClipRegion - Redraw Posted Structures Clipped to Clip Region

Synopsis

void PEXRedrawClipRegion(Display ∗display, PEXWorkstation workstation, unsigned long count, PEXDeviceRect ∗clip_rectangles)

Arguments

displayA pointer to a display structure returned by a successful XOpenDisplay call.

workstationThe resource identifier of the workstation.

countThe number of clip rectangles.

clip_rectangles
An array of device clip rectangles.

Returns

None

Description

This function performs actions similar to PEXRedrawAllStructures except that the workstation state attributes are not modified or updated by this function and rendering will occur only in the region defined by the specified clip list. The color stored in entry zero of the color table is used to clear the region defined by the clip list. The clip list must consist of non-overlapping rectangles or the result will be undefined. If a z-buffering HLHSR algorithm is used, only the z-values corresponding to pixels in the clip region will be affected. All of the posted structures for the workstation are redrawn, but clipped to the clip list. Pending changes are not made current, nor is the visual state modified.

Data Structures

typedef XID             PEXWorkstation;
typedef struct {
    short               xmin;
    short               ymin;
    short               xmax;
    short               ymax;
} PEXDeviceRect;

Errors

BadPEXWorkstation
The specified workstation resource identifier is invalid.

Museum