.\" @(#)PEXSetWorkstationHLHSRMode.3 1.4 95/03/24 SMI;
.so man3/pex.macs
.TH PEXSetWorkstationHLHSRMode 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXSetWorkstationHLHSRMode - Set Workstation HLHSR Mode
.SH SYNTAX
.HP
void PEXSetWorkstationHLHSRMode\^(\^Display *\fIdisplay\fP\^, PEXWorkstation \fIworkstation\fP\^, int \fIhlhsr_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 \fIhlhsr_mode\fP 1i
The workstation HLHSR mode (
.B PEXHLHSROff,
.B PEXHLHSRZBuffer,
.B PEXHLHSRPainters,
.B PEXHLHSRScanline,
.B PEXHLHSRHiddenLineOnly,
.B PEXHLHSRZBufferID
).
.SH RETURNS
.LP
None
.SH DESCRIPTION
.\" indexing
.IX PEXSetWorkstationHLHSRMode
.LP
This function sets the requested HLHSR mode of the specified
.I workstation.
If the workstation's display surface attribute is
.B PEXEmpty,
or if the dynamic modification for HLHSR mode is
.B PEXIMM,
the current HLHSR mode is set to the specified HLHSR mode and the HLHSR update
is set to
.B PEXNotPending;
otherwise, the HLHSR update is set to
.B PEXPending
and the current HLHSR mode is not changed.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID	PEXWorkstation;
.fi
.sp
.SH ERRORS
.TP
.SB BadAlloc
The server failed to allocate resources needed for HLHSR.
.TP
.SB BadPEXWorkstation
The specified workstation resource identifier is invalid.
.TP
.SB BadValue
The specified HLHSR mode is invalid.