graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPQEF - Inquire Edge Facilities

GPQEF (wstype, start, number, errind, netype, eltype, nelwidth, elwidth, minelw, maxelw, npred)

Note:

This subroutine is a Workstation Description Table (WDT) inquiry. For an overview, see "WDT Inquiries"

Purpose

Use GPQEF to inquire the edge facilities for the specified workstation type.

The graPHIGS API returns a number indicating the total number of available line types and their identifiers (netype[default] the available number of line widths (nelwidth), and the nominal (eltype), minimum (minelw), and maximum values (maxelw) and the number of predefined edge indexes (npred) The graPHIGS API returns the width of lines in Device Coordinate (DC) units.

If the information is available, then the graPHIGS API sets the error indicator to zero and returns the values in the output parameter. 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 the error number indicating the reason, and the values returned in the output parameter 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 line types of edges (>=1)

number -- specified by user, fullword integer

Number of line types of edges requested (>=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
35: WORKSTATION HAS ONLY INPUT CAPABILITIES
538: START VALUE < ONE
539: REQUESTED NUMBER < ZERO
543: START EXCEEDS DATA EXTENT. TOTAL NUMBER AVAILABLE RETURNED
548: SPECIFIED WORKSTATION TYPE CANNOT BE LOADED

netype -- returned by the graPHIGS API, fullword integer

Total number of available line types of edges.

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

List of available edge line types in the workstation's available edge line type table. The table size and specific entries supported are workstation dependent. The default edge line type table for supported entries is defined with the following line types: (1=SOLID_LINE, 2=DASHED, 3=DOTTED, 4=DASH_DOT, 5=LONG_DASH, 6=DOUBLE_DOT, 7=DASH_DOUBLE_DOT, 8-n=SOLID_LINE ) The output array must be large enough to contain the requested data.

nelwidth -- returned by the graPHIGS API, fullword integer

Number of available line widths. (Zero means that the workstation supports a continuous range of line widths of edges.)

elwidth -- returned by the graPHIGS API, short floating-point number (DC)

Nominal line width of edge.

minelw -- returned by the graPHIGS API, short floating-point number (DC)

Minimum linewidth of edge.

maxelw -- returned by the graPHIGS API, short floating-point number (DC)

Maximum linewidth of edge.

npred -- returned by the graPHIGS API, fullword integer

Number of predefined edge bundle table entries.

Error Codes

None

Related Subroutines

GPQRCT: Inquire Realized Connection Type
GPQXER: Inquire Extended Edge Representation
GPXER: Set Extended Edge Representation

RCP code

201339669 (X'0C003315')