INQUIRE EDGE FACILITIES(3P) — SUNPHIGS LIBRARY

NAME

INQUIRE EDGE FACILITIES − inquire list of workstation edge facilities

SYNOPSIS

C Syntax

void
pinqedgefacil ( type, length, start, error_ind, total_length, facilities )
Pwstypetype;workstation type
Pintlength;length of application list
Pintstart;starting position
Pint∗error_ind;OUT error indicator
Pint∗total_length;OUT length of list in PHIGS
Pedgefac∗facilities;OUT edge facilities

FORTRAN Syntax

SUBROUTINE pqedf ( WTYPE, N, ERRIND, NEDT, EDT, NEDW, NOMEDW, REDWMN, REDWMX,
NPEDI )
INTEGERWTYPEworkstation type
INTEGERNlist element requested
INTEGERERRINDOUT error indicator
INTEGERNEDTOUT number of available edgetypes
INTEGEREDTOUT Nth element of list of available edgetypes
INTEGERNEDWOUT number of available edgewidths
REALNOMEDWOUT nominal edgewidth
REALREDWMN, REDWMX OUT range of edgewidths
INTEGERNPEDIOUT number of predefined edge indices

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE EDGE FACILITIES to obtain a list of the edge facilities available for the specified type of workstation.

C Input Parameters

typeWorkstation type.

lengthThe number of elements for which the application has allocated memory in the output parameter list of integers. If a value of zero is used, no data will be returned in this list, but the total number of elements in the workstation list of available edge types will be returned in total_length.

startStarting position in the list of available edge types in the workstation description table at which to begin the inquiry. The elements of the workstation list of available edge types, beginning with the item number specified by start, are copied sequentially into the list of integers until it is full or all the items on the workstation list have been copied.

C Output Parameters

error_ind
A pointer to the location to store the error number of any error detected by this function.

total_length
A pointer to an integer in which the system returns the total number of items in the list of available edge types. This is the value required for length if all the items on the workstation list are to be returned.

facilities
A pointer to a Pedgefac structure in which the system returns a list of the edge facilities available for the specified workstation type. Pedgefac is defined in phigs.h as follows:

typedef struct {
Pintlsttypes;/∗ list of edge types ∗/
Pintwidths;/∗ number of available edge widths ∗/
Pfloatnom;/∗ nominal edge width ∗/
Pfloatmin;/∗ minimum edge width ∗/
Pfloatmax;/∗ maximum edge width ∗/
Pintpredefined;/∗ number of predefined bundles ∗/
} Pedgefac;

And Pintlst is defined as follows:

typedef struct {
Pintnumber;/∗ number of Pints in list ∗/
Pint∗integers;/∗ list of integers ∗/
} Pintlst;

The application must allocate memory for length elements in the list of integers.

FORTRAN Input Parameters

WTYPE
Workstation type.

NElement of the specified workstation type list of available edge types to return. Only one edge type may be inquired per subroutine call. If a value of zero is used here, no edge type data will be returned, but the total number of elements in the workstation list of available edge types will be returned in NEDT.

FORTRAN Output Parameters

ERRIND
The error number of any error detected by this function.

NEDTThe total number of edge types available for the given workstation type.

EDTThe Nth edge type from the list of available edge types for the given workstation type.

NEDW
The number of available edge widths for the given workstation type.

NOMEDW
The nominal edge width used by the given workstation type as a base for edge width scaling.

REDWMN
The minimum available edge width for the given workstation type.

REDWMX
The maximum available edge width for the given workstation type.

NPEDI
The number of predefined edge bundle indices for the given workstation type.

ERRORS

002Ignoring function, function requires state (PHOP, ∗, ∗, ∗)

051Ignoring function, this information is not yet available for this workstation type; open a workstation of this type and use the specific workstation type

052Ignoring function, workstation type not recognized by the implementation

059Ignoring function, the specified workstation does not have output capability (i.e., the workstation category is neither OUTPUT, OUTIN, nor MO)

062Ignoring function, this information is not available for this MO workstation type

Museum

Related Articles