.\" @(#)PEXSetWorkstationDisplayUpdateMode.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXSetWorkstationDisplayUpdateMode 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXSetWorkstationDisplayUpdateMode - Set Workstation Display Update Mode
.SH SYNTAX
.HP
void PEXSetWorkstationDisplayUpdateMode\^(\^Display *\fIdisplay\fP\^, PEXWorkstation \fIworkstation\fP\^, int \fIupdate_mode\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 \fIupdate_mode\fP 1i
The workstation display update mode (
.B PEXVisualizeEach,
.B PEXVisualizeEasy,
.B PEXVisualizeNone,
.B PEXSimulateSome,
.B PEXVisualizeWhenever
).
.SH RETURNS
.LP
None
.SH DESCRIPTION
.\" indexing
.IX PEXSetWorkstationDisplayUpdateMode
.LP
This function sets the display update attribute of the specified
.I workstation.
This attribute defines how changes to the display surface will be visualized.
The supported values for display update mode are inquirable via
.BR PEXGetEnumTypeInfo (3) .
.LP
If double-buffering is enabled, the display update mode affects which buffer
is rendered into during traversal.  If the display update mode is
.B PEXVisualizeEach,
.B PEXVisualizeWhenever
or
.B PEXVisualizeNone,
output primitives are rendered into the back (undisplayed) buffer while the
structure network is being traversed.
When the traversal is complete, the front and back buffers are swapped, so the
rendered image is displayed.  If the display update mode is
.B PEXVisualizeEasy
or
.B PEXSimulateSome,
output primitives are always rendered into the front (displayed) buffer.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID	PEXWorkstation;
.fi
.sp
.SH ERRORS
.TP
.SB BadPEXWorkstation
The specified workstation resource identifier is invalid.
.TP
.SB BadValue
The specified display update mode is invalid.
.SH SEE ALSO
.LP
.nf
.BR PEXSetWorkstationBufferMode (3)
.BR PEXGetEnumTypeInfo (3)
.fi