POST STRUCTURE(3P) — SUNPHIGS LIBRARY

NAME

POST STRUCTURE − assign a structure network to a workstation for display

SYNOPSIS

C Syntax

void
ppoststruct ( ws, struct_id, priority )
Pintws;workstation identifier
Pintstruct_id;structure identifier
Pfloatpriority;priority

FORTRAN Syntax

SUBROUTINE ppost ( WKID, STRID, PRIORT )
INTEGERWKIDworkstation identifier
INTEGERSTRIDstructure identifier
REALPRIORTpriority

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

POST STRUCTURE assigns a structure, and the structure network of which it is the root, to a workstation for display. The workstation’s display update state determines when the structure network is traversed, updating the display.

C Input Parameters

wsThe identifier of the workstation to which the structure should be posted.

struct_id
The identifier of the structure to be posted.

priority
The display priority of this structure in relation to other structures posted to the same workstation, in the range of 0.0 to 1.0, inclusive.

FORTRAN Input Parameters

WKIDThe identifier of the workstation to which the structure should be posted.

STRID
The identifier of the structure to be posted.

PRIORT
The display priority of this structure in relation to other structures posted to the same workstation, in the range of 0.0 to 1.0, inclusive.

Execution

POST STRUCTURE adds structure identifier to the table of posted structures on the workstation with workstation identifier. If the structure does not exist, it will be created as an empty structure and posted to ws.

If more than one structure network is posted to the workstation, display priority determines the display order of the structure networks. Structures with higher priority values take precedence over (i.e., are drawn on top of) structures with lower priority values. If the structure identifier is already posted on the workstation, the structure is removed from the table of posted structures, and reposted with the priority value specified. If two structures are posted with the same priority, the structure posted (or reposted) last assumes a higher priority.

If the workstation’s display update state permits, POST STRUCTURE initiates traversal of all the structure networks posted to the workstation, ordered by their priority. (See SET DISPLAY UPDATE STATE(3P) for more information on the workstation display update state.) The structure elements are traversed in sequence, beginning with the first element of the posted structure. Traversal of subordinate structures in the network is prompted by EXECUTE STRUCTURE elements.

The structure network and the workstation state together determine the image displayed on the workstation’s display surface. While a structure remains posted to a workstation, any changes in the structure network or the workstation’s tables can result in immediate changes to the display, depending on the structure’s priority and the workstation’s display update state.

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)

208Ignoring function, the display priority is out of range

Museum