INQUIRE LIST OF AVAILABLE GENERALIZED DRAWING PRIMITIVES(3P) — SUNPHIGS LIBRARY

NAME

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

SYNOPSIS

C Syntax

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

FORTRAN Syntax

SUBROUTINE pqegdp ( WTYPE, N, ERRIND, NGDP, GDPL )
INTEGERWTYPEworkstation type
INTEGERNlist element requested
INTEGERERRINDOUT error indicator
INTEGERNGDPOUT number of available generalized
drawing primitives
INTEGERGDPLOUT Nth element of list of GDP identifiers

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 integers 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 Pintlst structure in which the system returns the list of identifiers of the GDPs available on the specified type of workstation. Pintlst is defined in phigs.h as follows:

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

The number component specifies the number of GDP identifiers in the list. The integers component is a pointer to a list, number 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.

FORTRAN Input Parameters

WTYPE
Workstation type.

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

FORTRAN Output Parameters

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

NGDPThe total number of elements in the specified workstation type list of available GDPs.

GDPLThe identifier of the Nth GDP from the specified workstation type list of available GDPs.

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