PEXRedrawClipRegion - Redraw Posted Structures Clipped to Clip Region

Synopsis 

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

Arguments

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

workstation
The resource identifier of the workstation.

count
The number of clip rectangles.

clip_rectangles
An array of device clip rectangles.

Returns

None.

Description

Invoke PEXRedrawClipRegion to perform actions similar to PEXRedrawAllStructures except that this function does not modify nor update the workstation state attributes and rendering occurs only in the region defined by the specified clip list.

This function uses the color stored in entry zero of the color table to clear the region defined by the clip list. The clip list must consist of non-overlapping rectangles or the result is undefined. If a z-buffering HLHSR algorithm is used, then only the z-values corresponding to pixels in the clip region are affected. All of the posted structures for the workstation are redrawn, though they are clipped to the clip list. This function does not make pending changes current nor does it modify the visual state.

Errors

BadPEXWorkstation
The specified workstation resource identifier is invalid.

See Also

For a list of PHIGS Workstation functions and related topics, see PHIGS Workstation.