.\" @(#)PEXRedrawClipRegion.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXRedrawClipRegion 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXRedrawClipRegion - Redraw Posted Structures Clipped to Clip Region
.SH SYNTAX
.HP
void PEXRedrawClipRegion\^(\^Display *\fIdisplay\fP\^, PEXWorkstation \fIworkstation\fP\^, unsigned long \fIcount\fP\^, PEXDeviceRect *\fIclip_rectangles\fP\^)
.SH PARAMETERS
.IP \fIdisplay\fP 1i
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.IP \fIworkstation\fP 1i
The resource identifier of the workstation.
.IP \fIcount\fP 1i
The number of clip rectangles.
.IP \fIclip_rectangles\fP 1i
An array of device clip rectangles.
.SH RETURNS
.LP
None
.SH DESCRIPTION
.\" indexing
.IX PEXRedrawClipRegion
.LP
This function performs actions similar to
.BR PEXRedrawAllStructures (3)
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.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID	PEXWorkstation;
.sp
typedef struct {
	short		xmin;
	short		ymin;
	short		xmax;
	short		ymax;
.br
} PEXDeviceRect;
.fi
.SH ERRORS
.TP
.SB BadPEXWorkstation
The specified workstation resource identifier is invalid.
.SH SEE ALSO
.LP
.nf
.BR PEXRedrawAllStructures (3)
.BR PEXExecuteDeferredActions (3)
.fi