INQUIRE LIST OF AVAILABLE GENERALIZED STRUCTURE ELEMENTS(3P) — SUNPHIGS LIBRARY

NAME

INQUIRE LIST OF AVAILABLE GENERALIZED STRUCTURE ELEMENTS − inquire list of workstation available generalized structure elements

SYNOPSIS

C Syntax

void
pinqgse ( type, length, start, error_ind, gses, total_length )
Pwstypetype;workstation type
Pintlength;length of application list
Pintstart;starting position
Pint∗error_ind;OUT error indicator
Pintlst∗gses;OUT list of GSEs
Pint∗total_length;OUT length of list in PHIGS

FORTRAN Syntax

SUBROUTINE pqegse ( WTYPE, N, ERRIND, NGSE, GSEL )
INTEGERWTYPEworkstation type
INTEGERNlist element requested
INTEGERERRINDOUT error indicator
INTEGERNGSEOUT number of available generalized
structure elements
INTEGERGSELOUT Nth element of list of GSE identifiers

Required PHIGS Operating States

(PHOP, ∗, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE LIST OF AVAILABLE GENERALIZED STRUCTURE ELEMENTS to obtain a list of the identifiers of the generalized structure elements (GSE)s available on the specified workstation type.

C Input Parameters

typeWorkstation type.

lengthThe number of integers items in the gses output parameter for which the application has allocated memory. The length is the number of list elements (GSE 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 GSEs available on the specified workstation type will be returned in total_length.

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

gsesA pointer to a Pintlst structure in which the system returns the list of identifiers of the GSEs 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 GSE identifiers in the list. The integers component is a pointer to a list, number long, of the GSE 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 GSEs is returned. This is the value required for length if all GSE identifiers are to be returned.

FORTRAN Input Parameters

WTYPE
Workstation type.

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

FORTRAN Output Parameters

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

NGSEThe total number of elements in the specified workstation type list of available GSEs.

GSELThe identifier of the Nth GSE from the specified workstation type list of available GSEs.

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