INQUIRE EDGE FACILITIES(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

INQUIRE EDGE FACILITIES − inquire list of workstation edge facilities

SYNOPSIS

C Syntax

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

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.

facilities
A pointer to a Pedge_facs 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 {
Pint_listtypes;/∗ list of edge types ∗/
Pintnum_widths;/∗ number of available edge widths ∗/
Pfloatnom_width;/∗ nominal edge width ∗/
Pfloatmin_width;/∗ minimum edge width ∗/
Pfloatmax_width;/∗ maximum edge width ∗/
Pintnum_pred_inds;/∗ number of predefined bundles ∗/
} Pedge_facs;

And Pint_list is defined as follows:

typedef struct {
Pintnum_ints;/∗ number of Pints in list ∗/
Pint∗ints;/∗ list of integers ∗/
} Pint_list;

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

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.

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 (that is, the workstation category is neither OUTPUT, OUTIN, nor MO)

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

Museum