Previous Next Up Title Contents Index Functions Index Top Library

OPEN WORKSTATION

POPEN_WS


CALL SEQUENCE

void popen_ws(
)

PHIGS STATE

(PHOP, *, *, *).

EFFECT

GPHIGS establishes a connection between the program and the workstation specified by ws_type 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 ws_type, data obtained by interrogating the workstation (screen size, number of input devices...) and other specific workstation data.

The valid values for ws_type are listed in the GPHIGS user guide. Generally, you can use predefined values as follow for example:

PWS_TYPE_X_WINDOW for X-Window workstation

PWS_TYPE_POSTSCRIPT_C_B4 for colour landscape postscript workstation

The conn_id parameter depends on the workstation type. The drivers documentation describes the meaning of conn_id 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