INQUIRE POLYLINE FACILITIES(3P) — SUNPHIGS LIBRARY

NAME

INQUIRE POLYLINE FACILITIES − inquire list of polyline facilities from workstation description table

SYNOPSIS

C Syntax

void
pinqlinefacil ( 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
Plnfac∗facilities;OUT polyline facilities

FORTRAN Syntax

SUBROUTINE pqplf ( WTYPE, N, ERRIND, NLT, LT, NLW, NOMLW, RLWMIN, RLWMAX, NPPLI )
INTEGERWTYPEworkstation type
INTEGERNlist element requested
INTEGERERRINDOUT error indicator
INTEGERNLTOUT number of available linetypes
INTEGERLTOUT Nth element of list of available linetypes
INTEGERNLWOUT number of available linewidths
REALNOMLWOUT nominal linewidth (DC)
REALRLWMIN, RLWMAX OUT range of linewidths (DC)
INTEGERNPPLIOUT number of predefined polyline indices

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

INQUIRE POLYLINE FACILITIES obtains a list of the polyline facilities supported on the specified type of workstation.

C Input Parameters

typeGet the polyline facilities for this workstation type.

lengthThe number of elements for which memory is allocated in the output parameter list of integers. Zero may be specified, in order to get the total length of the list.

startStarting position in the list at which to begin the inquiry.

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 to return the total length of the list. This is the value required for length if all the items in the list are to be returned.

facilities
A pointer to a structure in which the system returns the portion of the list of polyline facilities from the workstation description table, starting with start. Plnfac is defined in phigs.h as:

typedef struct {
Pintlsttypes;/∗ list of line types ∗/
Pintwidths;/∗ number of available line widths ∗/
Pfloatnom_width;/∗ nominal line width ∗/
Pfloatmin_width;/∗ minimum line width ∗/
Pfloatmax_width;/∗ maximum line width ∗/
Pintpredefined;/∗ number of predefined bundles ∗/
} Plnfac;

And Pintlst is defined in phigs.h as:

typedef struct {
Pint number;/∗ number of integers ∗/
Pint∗integers;/∗ list of integers ∗/

} Pintlst;

Prior to calling this function, the integers field of the Pintlst structure must contain a pointer to an application supplied buffer. This buffer must be at least as large as the corresponding length parameter.

FORTRAN Input Parameters

WTYPE
Get the polyline facilities for this workstation type.

NGet the Nth element from the list of polyline facilities.

FORTRAN Output Parameters

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

NLTThe number of available linetypes.

LTThe Nth linetype from the list of available linetypes.

NLWThe number of available linewidths.

LWThe Nth linewidth from the list of available linewidths.

NOMLW
The nominal linewidth, in Device Coordinates (DC).

RLWMIN
The minimum linewidth, in DC.

RLWMAX
The maximum linewidth, in DC.

NPPLI
The number of predefined polyline indices.

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