[ Previous |
Next |
Contents |
Glossary |
Home |
Search ]
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')
[ Previous |
Next |
Contents |
Glossary |
Home |
Search ]