OPEN WORKSTATION

topen_ws

CALL SEQUENCE

void topen_ws (wkid, conn_id, ws_type)

INPUT PARAMETERS

Pint	wkid;
char	*conn_id;
Pint	ws_type;

ARGUMENTS

wkid

Workstation identifier

conn_id

It permits PHIGURE to establish a connection with a workstation.

ws_type

Workstation type

EFFECT

The workstation is recognized in the application by its identifier wkid. All PHIGURE scene visualization functions are for performing workstation operations and therefore use wkid as an input parameter to identify the workstation. The workstation must be opened before any of PHIGURE's scene visualization functions can be used. Therefore, topen_ws must be called before any display calls are made.

Opening the workstation ensures that the display surface is cleared.

conn_id is an identifier permitting PHIGURE to establish a connection with a workstation:

In general this will be "/dev/tty" if the workstation is an X window. (on Unix-system)

Otherwise, it should be "file_name" if the workstation corresponds to an output file. The #define PDEF_ERR_FILE can also be used (it is similar to stderr).

ws_type specifies the type of driver to use. It designates either a type of workstation, or a low level graphic library used to run the workstation. The following drivers are available:

HARDWARE	TYPE	LIBRARY	WS TYPE
ALLIANT		X-Window	8887
CDC		X-Window	8887
CONVEX		X-Window	8887
CRAY	X-Y	X-Window	8887
DIGITAL	VMS	X-Window	8887
HELWET PACKARD		X-Window	8887
		PEX	8069 or 8070
		Open Gl	7971
		Starbase	8384
IBM	RS6000	X-Window	8887
		Gl	7177
IBM	VM/CMS	X-Window	8887
MIPS		X-Window	8887
SILICON-GRAPHICS		X-Window	8887
		Open Gl	7971
		Gl	7177
SUN		X-Window	8887
		Open Gl	7971
		xgl	8871
SONY		X-Window	8887

Normally, for all types of devices shown above, CONN_ID = "/dev/tty" (for Unix system), or PDEF_ERR_FILE define.

PLOTTER, PRINTER OR OUTPUT FILE	FORMAT	WS_TYPE
VRML	1	8682
PICT		8073
CGM	clear text	0010
	binary	0011
HPGL	A4	72801
	B4	72802
	A3	72803
	B3	72804
	A2	72805
	B2	72806
	A1	72807
	B1	72808
	A0	72809
	B0	72810
HPGL2	A4	72811
	B4	72812
	A3	72813
	B3	72814
	A2	72815
	B2	72816
	A1	72817
	B1	72818
	A0	72819
	B0	72820
PostScript Noir & Blanc	A4 (portrait)	80791
	B4 (landscape)	80792
PostScript couleur	A4 (portrait)	80795
	B4 (landscape)	80796
RLE	raster	90001
EPSON	raster	98203
TEKTRONIX 4692	raster 7 bits	98207
	raster 8 bits	98208
HP PaintJet color	raster 90 dpi portrait	98214
	raster 90 dpi landscape	98314
	raster 180 dpi portrait	98215
	raster 180 dpi landscape	98315

Normally, for all types of devices shown above, CONN_ID = "file_name", where file_name is the name of the file to create.