graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPQWCV - Inquire Workstation Configuration Variability

GPQWCV (wstype, start, number, errind, totnum, flist)

Purpose

Use GPQWCV to inquire the items that may vary based on the configuration of the specified workstation type.

The graPHIGS API returns a value indicating the total number of workstation dependent features and a list of their identifiers.

If the inquired information is available, then the graPHIGS API sets the error indicator to zero and returns the values in the output parameters. If the error indicator is 543 (the start value exceeds the extent of the available data), then only the total number (totnum) parameter is set. If the inquired information is unavailable, then the error indicator (errind) contains an error number indicating the reason, and the values returned in the output parameters are unpredictable.

Parameters

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

Workstation type.

start -- specified by user, fullword integer

Starting member of the list of workstation variable features (>=1)

number -- specified by user, fullword integer

Number of requested feature identifiers (>=0)

errind -- returned by the graPHIGS API, fullword integer

Error indicator. If the error indicator is zero, the request has been completed. Otherwise, one of the following errors exists:

23: SPECIFIED WORKSTATION TYPE DOES NOT EXIST
538: START VALUE < ONE
539: REQUESTED NUMBER < ZERO
543: START EXCEEDS DATA EXTENT. TOTAL NUMBER AVAILABLE RETURNED
548: SPECIFIED WORKSTATION TYPE CANNOT BE LOADED

totnum -- returned by the graPHIGS API, fullword integer

Total number of configuration-dependent features.

flist -- returned by the graPHIGS API, array of fullword integers.

List of the configuration-dependent features. The output array must be large enough to contain the requested data.

The following items represent possible variable features:

01: Workstation category
02: Maximum display surface size in device coordinates
03: Maximum display surface size in addressable units
04: Number of definable view table entries
05: Polyline linetypes
06: Polyline line widths
07: Number of polyline bundle table entries
08: Polymarker marker types
09: Polymarker marker sizes
10: Number of polymarker bundle table entries
11: Workstation character set facilities
12: Number of text bundle table entries
13: Interior style indexes
14: Number of interior bundle table entries
15: Number of edge bundle table entries
16: Line widths of edges
17: Number of edge bundle table entries
18: Pattern facilities
19: Hatch facilities
20: Number of color table entries
21: Color availability
22: Color model
23: Generalized drawing primitives
24: Dynamic modification accepted
25: Locator input devices
26: Stroke input devices
27: Valuator input devices
28: Choice input devices
29: Pick input devices
30: String input devices
31: Maximum pattern array dimensions
32: Workstation display classification
33: (reserved)
34: Available break action
35: Default break action
36: Supported escape identifiers
37: Available triggers for locator devices
38: Available triggers for stroke devices
39: Available triggers for valuator devices
40: Available triggers for choice devices
41: Available triggers for pick devices
42: Available triggers for string devices
43: Default triggers for locator devices
44: Default triggers for stroke devices
45: Default triggers for valuator devices
46: Default triggers for choice devices
47: Default triggers for pick devices
48: Default triggers for string devices
49: Maximum number of choice alternatives
50: Available triggers on the workstation.

Error Codes

None

Related Subroutines

None

RCP code

201339398 (X'0C003206')