graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPCRWS - Create Workstation

GPCRWS (wsid, ncid, length, connid, wstype, option)

Purpose

Use GPCRWS to open the specified workstation on the specified nucleus and optionally to provide default values to be used by the workstation during its initialization. The current workstation state is set to Workstation Open (WSOP)

The option parameter enables your application to modify the workstation's defaults by specifying a group of procopts. These specified procopts override the procopts available in the Application Defaults Interface Block (ADIB) or the External Defaults File (EDF) (For information about valid procopts and their values, see The graPHIGS Programming Interface: Technical Reference

When no procopts are specified, a fullword integer with a value of zero must be specified for the parameter.

This subroutine does not automatically associate the currently selected structure store with a workstation. In order for association to occur, the application must explicitly issue the Associate Structure Store with Workstation (GPASSW) subroutine.

This subroutine is functionally equivalent to the Open Workstation (GPOPWS) subroutine with nucleus identifier of one with the exception that GPCRWS will not perform the implicit Associate Structure Store with Workstation (GPASSW) processing.

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

ncid -- specified by user, fullword integer

Nucleus identifier.

length -- specified by user, fullword integer

Length of the connection identifier (>0)

connid -- specified by user, variable length character string

Connection identifier indicates the physical device to be opened. (For information about the connection identifier, see The graPHIGS Programming Interface: Technical Reference

wstype -- specified by user, 8-byte character string

One of the graPHIGS API supported workstation types. (For information about the supported workstation types, see The graPHIGS Programming Interface: Technical Reference

option -- specified by user, variable data

Workstation creation option.

The option parameter has the following format:

  --------------------------
  |  total length of data  |  Fullword integer
  |------------------------|
  |  list of procopts      |  Variable length data
  Z                        Z
  |                        |
  --------------------------

For information about valid procopts and their values, see The graPHIGS Programming Interface: Technical Reference When no option is specified, a fullword integer with a value zero must be specified for the parameter.

Error Codes

21: CONNECTION IDENTIFIER IS INVALID
23: SPECIFIED WORKSTATION TYPE DOES NOT EXIST
24: SPECIFIED WORKSTATION IDENTIFIER ALREADY IS IN USE
26: SPECIFIED WORKSTATION CANNOT BE OPENED
61: LENGTH IS INVALID
202: SPECIFIED NUCLEUS DOES NOT EXIST
217: RESOURCE CREATION REQUEST EXCEEDS NUCLEUS TABLE CAPACITY
514: INAPPROPRIATE DEVICE FOR WORKSTATION TYPE
581: PROCOPT SPECIFIES INVALID VIEW TABLE SIZE FOR WORKSTATION
583: PROCOPT SPECIFIES INVALID NUMBER OF INPUT DEVICES FOR WORKSTATION
585: PROCOPT SPECIFIES INVALID KEYBOARD FOR WORKSTATION
586: PROCOPT SPECIFIES INVALID DISPLAY MODEL NUMBER FOR WORKSTATION
587: PROCOPT SPECIFIES INVALID ECHO METHOD FOR WORKSTATION
588: PROCOPT SPECIFIES INVALID FRAME BUFFER VALUE FOR WORKSTATION
596: PROCOPT SPECIFIES INVALID NUMBER OF POLYLINE TABLE ENTRIES
597: PROCOPT SPECIFIES INVALID NUMBER OF POLYMARKER TABLE ENTRIES
598: PROCOPT SPECIFIES INVALID NUMBER OF TEXT TABLE ENTRIES
599: PROCOPT SPECIFIES INVALID NUMBER OF EDGE TABLE ENTRIES
600: PROCOPT SPECIFIES INVALID NUMBER OF DEPTH CUE TABLE ENTRIES
601: PROCOPT SPECIFIES INVALID NUMBER OF LIGHT SOURCE TABLE ENTRIES
602: PROCOPT SPECIFIES INVALID NUMBER OF INTERIOR TABLE ENTRIES
648: PROCOPT SPECIFIES AN INVALID DISPLAY WIDTH AND/OR HEIGHT
649: PROCOPT SPECIFIES AN INVALID IMAGE OUTPUT FORMAT
650: PROCOPT SPECIFIES AN INVALID HLHSR COORDINATE SYSTEM

Related Subroutines

GPASSW: Associate Structure Store with Workstation
GPATR: Attach Resource
GPCLWS: Close Workstation
GPDTR: Detach Resource
GPOPWS: Open Workstation
GPQNCR: Inquire Nucleus Resource Identifier
GPQWSV: Inquire Workstation State Value
GPQWTN: Inquire List of Available Workstation Types on Nucleus
GPQWTO: Inquire Workstation Type and Options

RCP code

201327362 (X'0C000302')