Previous Next Up Title Contents Index Functions Index Top Library

OPEN WORKSTATION

POPWK


CALL SEQUENCE

CALL POPWK (WKID, CONID, WTYPE)

INPUT PARAMETERS

INTEGER WKID
Workstation identifier.
INTEGER CONID
Connection number.
INTEGER WTYPE
Workstation type.

PHIGS STATE

(PHOP, *, *, *).

EFFECT

GPHIGS establishes a connection between the program and the workstation specified by WTYPE clearing the display surface if necessary.

The following operations are carried after the connection to the workstation is established: - workstation state set to WSOP. - workstation state list allocated and initialized based on the type of workstation.

- ws_id added to the list of opened workstations in the PHIGS STATE list.

When a workstation is opened, a specific description table is created, and the data it contains is established from data from the initial workstation description table for type WTYPE, data obtained by interrogating the workstation (screen size, number of input devices...) and other specific workstation data.

The valid values for WTYPE are listed in the GPHIGS user guide.

The CONID parameter depends on the workstation type. The drivers documentation describes the meaning of CONID for each driver type.

EXTENSION TO THE PHIGS STANDARD

GPHIGS defines non standard workstation attributes necessaries for some type of workstation (window size, double buffering control,...). See the GPHIGS user guide for more details on these attributes.

ERRORS

2
Ignoring function, function requires state (PHOP, *,*,*)
53
Ignoring function, workstation identifier already is in use
50
Ignoring function, connection identifier not recognized by the implementation
52
Ignoring function, workstation type not recognized by the implementation
55
Ignoring function, workstation cannot be opened for an implementation dependent reason
63
Ignoring function, opening this workstation would exceed the maximum of simultaneously open workstations

SEE ALSO

close workstation, inquire workstation state value, inquire set of open workstations, inquire workstation connection and type, set x window identifier (ext), set configuration file name (ext), clear workstation (ext)


Previous Next Up Title Contents Index Functions Index Top Library