PEXWorkstation PEXCreateWorkstation(
Display *display,
Drawable drawable,
PEXLookupTable line_bundle,
PEXLookupTable marker_bundle,
PEXLookupTable text_bundle,
PEXLookupTable interior_bundle,
PEXLookupTable edge_bundle,
PEXLookupTable color_table,
PEXLookupTable pattern_table,
PEXLookupTable font_table,
PEXLookupTable depth_cue_table,
PEXLookupTable light_table,
PEXLookupTable color_approx_table
PEXNameSet highlight_incl,
PEXNameSet highlight_excl,
PEXNameSet invisibility_incl,
PEXNameSet invisibility_excl,
int buffer_mode
)
- display
- A pointer to a display structure returned by a successful
XOpenDisplay call.
- drawable
- The resource identifier of a drawable.
- line_bundle
- The resource identifier of the
line bundle lookup table.
- marker_bundle
The resource identifier of the
marker bundle lookup table.
- text_bundle
- The resource identifier of the
text bundle lookup table.
- interior_bundle
- The resource identifier of the
interior bundle lookup table.
- edge_bundle
- The resource identifier of the
edge bundle lookup table.
- color_table
- The resource identifier of the
color lookup table.
- pattern_table
- The resource identifier of the
pattern lookup table.
- font_table
- The resource identifier of the
text font lookup table.
- depth_cue_table
- The resource identifier of the
depth cue lookup table.
- light_table
- The resource identifier of the
light lookup table.
- color_approx_table
- The resource identifier of the
color approximation lookup table.
- highlight_incl
- The name set used as the
highlight inclusion set.
- highlight_excl
- The name set used as the
highlight exclusion set.
- invisibility_incl
- The name set used as the
invisibility inclusion set.
- invisibility_excl
- The name set used as the
invisibility exclusion set.
- buffer_mode
- The workstation buffering mode (PEXSingleBuffer or
PEXDoubleBuffer).
The resource identifier of the newly-created workstation.
Invoke PEXCreateWorkstation to create a PHIGS
workstation resource and get its resource identifier.
The specified drawable 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.
To modify or inquire the PHIGS workstation view table,
invoke the
PEXSetWorkstationViewRep and
PEXGetWorkstationViewRep requests.
If the workstation is to operate in double-buffered mode
and the implementation supports double-buffering, then an
additional image buffer is created for the drawable in an
implementation-dependent way.
If you specify a drawable that is a pixmap, then no
double-buffering is performed.
To determine if your implementation supports double-
buffering, invoke the
PEXGetImpDepConstants
function request.
- BadAlloc
- The implementation failed to allocate the resource, or the
implementation failed to allocate resources needed for
double-buffering.
- BadDrawable
- The specified drawable resource identifier is invalid.
- BadMatch
- The specified drawable is unsupported, or a specified
lookup table resource was not created with a compatible
drawable.
- BadPEXLookupTable
- The specified lookup table resource identifier is invalid.
- BadPEXNameSet
- The specified name set resource identifier is invalid.
- BadValue
- The specified buffer mode is invalid.
For a list of PHIGS Workstation functions and related topics,
see PHIGS Workstation.