INQUIRE POSTED STRUCTURES(3P) — SUNPHIGS LIBRARY

NAME

INQUIRE POSTED STRUCTURES − inquire the list of structures posted to a workstation

SYNOPSIS

C Syntax

void
pinqpostedstruct ( ws, length, start, error_ind, list, total_length )
Pintws;workstation identifier
Pintlength;length of application list
Pintstart;starting position
Pint∗error_ind;OUT error indicator
Pstructpostlst∗list;OUT list of posted structures
Pint∗total_length;OUT length of list in PHIGS

FORTRAN Syntax

SUBROUTINE pqpost ( WKID, N, ERRIND, NUMBER, STRID, PRIORT )
INTEGERWKIDworkstation identifier
INTEGERNlist element requested
INTEGERERRINDOUT error indicator
INTEGERNUMBEROUT number of structures posted to that
workstation
INTEGERSTRIDOUT identifier of the Nth structure posted
to that workstation
REALPRIORTOUT display priority of the Nth structure posted
to that workstation

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

Use INQUIRE POSTED STRUCTURES to obtain the list of currently posted structures from a workstation’s state list.

Although the PHIGS standard does not require it, SunPHIGS orders the inquired list of posted structures by increasing display priority. If two structures are posted with the same priority, the structure posted (or reposted) last is sorted last.

C Input Parameters

wsThe workstation identifier of the workstation whose state list is queried.

lengthNumber of items for which the application has allocated memory in the output parameter list. 0 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.

listA pointer to a Pstructpostlst in which the system returns the portion of the list of currently posted structures starting at the entry specified with start. Pstructpostlst is defined in phigs.h as follows:

typedef struct {
Pintnumber;/∗ number of structure postings ∗/
Pstructpost∗postings;/∗ list of postings ∗/

} Pstructpostlst;

The pointer list->postings must be initialized to an array of length Pstructpost elements. Pstructpost is defined in phigs.h as follows:

typedef struct {
Pintid;/∗ structure id ∗/
Pfloatpriority;/∗ structure priority ∗/

} Pstructpost;

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.

FORTRAN Input Parameters

WKIDThe workstation identifier of the workstation whose state list is queried.

NPosition in the list of the item requested. The Nth in the list of posted structures will be returned in STRID.

FORTRAN Output Parameters

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

NUMBER
The total number of structures currently posted to the workstation.

STRID
The Nth in the list of posted structures on workstation WKID.

PRIORT
The display priority with which STRID is currently posted on workstation WKID.

ERRORS

003Ignoring function, function requires state (PHOP, WSOP, ∗, ∗)

054Ignoring function, the specified workstation is not open

059Ignoring function, the specified workstation does not have output capability (i.e., the workstation category is neither OUTPUT, OUTIN, nor MO)

Museum