.\" @(#)PEXCreateWorkstation.3 1.5 95/03/24 SMI;
.so man3/pex.macs
.TH PEXCreateWorkstation 3 "May 1995" "Solaris PEXlib Reference Manual" ""
.SH NAME
PEXCreateWorkstation \- Create Workstation
.SH SYNTAX
.HP
PEXWorkstation PEXCreateWorkstation\^(\^Display *\fIdisplay\fP\^, Drawable \fIdrawable\fP\^, PEXLookupTable \fIline_bundle\fP\^, PEXLookupTable \fImarker_bundle\fP\^, PEXLookupTable \fItext_bundle\fP\^, PEXLookupTable \fIinterior_bundle\fP\^, PEXLookupTable \fIedge_bundle\fP\^, PEXLookupTable \fIcolor_table\fP\^, PEXLookupTable \fIpattern_table\fP\^, PEXLookupTable \fIfont_table\fP\^, PEXLookupTable \fIdepth_cue_table\fP\^, PEXLookupTable \fIlight_table\fP\^, PEXLookupTable \fIcolor_approx_table\fP\^, PEXNameSet \fIhighlight_incl\fP\^, PEXNameSet \fIhighlight_excl\fP\^, PEXNameSet \fIinvisibility_incl\fP\^, PEXNameSet \fIinvisibility_excl\fP\^, int \fIbuffer_mode\fP\^)
.SH PARAMETERS
.TP 1i
\fIdisplay\fP
A pointer to a display structure returned by a successful
.B XOpenDisplay
call.
.TP
.I drawable
The resource identifier of a drawable.
.TP
.I line_bundle
The resource identifier of the line bundle lookup table.
.TP
.I marker_bundle
The resource identifier of the marker bundle lookup table.
.TP
.I text_bundle
The resource identifier of the text bundle lookup table.
.TP
.I interior_bundle
The resource identifier of the interior bundle lookup table.
.TP
.I edge_bundle
The resource identifier of the edge bundle lookup table.
.TP
.I color_table
The resource identifier of the color lookup table.
.TP
.I pattern_table
The resource identifier of the pattern lookup table.
.TP
.I font_table
The resource identifier of the text font lookup table.
.TP
.I depth_cue_table
The resource identifier of the depth cue lookup table.
.TP
.I light_table
The resource identifier of the light lookup table.
.TP
.I color_approx_table
The resource identifier of the color approximation lookup table.
.TP
.I highlight_incl
The name set used as the highlight inclusion set.
.TP
.I highlight_excl
The name set used as the highlight exclusion set.
.TP
.I invisibility_incl
The name set used as the invisibility inclusion set.
.TP
.I invisibility_excl
The name set used as the invisibility exclusion set.
.TP
.I buffer_mode
The workstation buffering mode (
.B PEXSingleBuffer
or
.B PEXDoubleBuffer
).
.SH RETURNS
The resource identifier of the newly-created workstation.
.SH DESCRIPTION
.\" indexing
.IX PEXCreateWorkstation
.IX "Workstation" "PEXCreateWorkstation"
.LP
This function creates a PHIGS workstation resource and returns its
resource identifier.  The drawable specified
is associated with the newly-created workstation resource.  The named
tables and name sets are also bound to the workstation resource for
use during rendering.  A view table that supports current and requested
view table entries is allocated for the workstation automatically at
creation time.  The requests
.BR PEXSetWorkstationViewRep (3)
and
.BR PEXGetWorkstationViewRep (3)
are used to modify and inquire the PHIGS workstation view table.
.LP
If the workstation is to operate in double-buffered mode and double-buffering
is supported (see
.BR PEXGetImpDepConstants (3)
), an additional
image buffer will be created for the drawable in an implementation-dependent
fashion.  If the specified drawable is a pixmap, no double-buffering will be
performed.
.SH DATA STRUCTURES
.LP
.nf
typedef  XID	PEXWorkstation;
typedef  XID	PEXLookupTable;
typedef  XID	PEXNameSet;
.fi
.SH ERRORS
.TP
.SB BadAlloc
The server failed to allocate the resource, or the server failed to allocate
resources needed for double-buffering.
.TP
.SB BadDrawable
The specified drawable resource identifier is invalid.
.TP
.SB BadMatch
The specified drawable is unsupported, or a specified lookup table resource
was not created with a compatible drawable.
.TP
.SB BadPEXLookupTable
The specified lookup table resource identifier is invalid.
.TP
.SB BadPEXNameSet
The specified name set resource identifier is invalid.
.TP
.SB BadValue
The specified buffer mode is invalid.
.SH SEE ALSO
.LP
.nf
.BR PEXFreeWorkstation (3)
.BR PEXGetImpDepConstants (3)
.fi