INQUIRE LIST OF AVAILABLE GENERALIZED DRAWING PRIMITIVES(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

INQUIRE LIST OF AVAILABLE GENERALIZED DRAWING PRIMITIVES − inquire list of workstation available generalized drawing primitives

SYNOPSIS

C Syntax

void
pinq_list_avail_gdp ( type, length, start, error_ind, gdps, total_length )
Pinttype;workstation type
Pintlength;length of application list
Pintstart;starting position
Pint∗error_ind;OUT error indicator
Pint_list∗gdps;OUT list of GDP identifiers
Pint∗total_length;OUT length of list in PHIGS

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE LIST OF AVAILABLE GENERALIZED DRAWING PRIMITIVES to obtain a list of the identifiers of the generalized drawing primitives (GDP)s available on the specified workstation type.

C Input Parameters

typeWorkstation type.

lengthThe number of ints items in the gdps output parameter for which the application has allocated memory. The length is the number of list elements (GDP identifiers) that the system can return in the list of integers. If a value of zero is used here, no data will be returned in the list of integers, but the total number of GDPs available on the specified workstation type will be returned in total_length.

startStarting position in the workstation type list of generalized drawing primitive ids at which the inquiry is to begin. The elements of the list of GDP identifiers, beginning with the item number specified by start, are copied sequentially into the list of integers until it is full or all the GDP identifiers 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.

gdpsA pointer to a Pint_list structure in which the system returns the list of identifiers of the GDPs available on the specified type of workstation. Pint_list is defined in phigs.h as follows:

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

The num_ints component specifies the number of GDP identifiers in the list. The ints component is a pointer to a list, num_ints long, of the GDP identifiers. The application must allocate memory for length elements in the list of integers.

total_length
A pointer to an integer in which the total number of elements in the specified workstation type list of available GDPs is returned. This is the value required for length if all GDP identifiers 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