[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface: ISO PHIGS Subroutine Reference

Chapter 7. Structure Display Subroutines

The subroutines included in this section let your application program post or unpost a structure network for display on a workstation.

POST STRUCTURE (PHOP,WSOP,*,*)

Purpose

Use Post Structure to add the specified structure to the list of posted structures in the workstation state list (WSL) of the specified workstation. This subroutine adds the workstation identifier to the list of workstations to which the specified structure is posted. If the specified structure does not exist, then the graPHIGS API creates a new empty structure.

The graPHIGS API assigns the specified display priority to the structure network. The display priority indicates the relative importance of the posted structure network. If your application posts multiple structures for display to the same display space location, then the graPHIGS API displays the higher priority structure network. If two structures have the same priority, then the graPHIGS API considers the last posted structure to have the higher priority.

Upon second and subsequent posting of a structure, the graPHIGS API removes the structure from the list of posted structures, and then reposts it at the priority the application specifies.

Language Bindings

C

ppost_struct (ws_id, struct_id, pri)

Input Parameters

Pint ws_id
Workstation identifier.

Pint struct_id
Structure identifier.

Pfloat pri
Display priority (0.0<=priority<=1.0).

FORTRAN

PPOST (wkid, strid, priort)

Input Parameters

integer wkid
Workstation identifier.

integer strid
Structure identifier.

real priort
Display priority (0.0<=priority<=1.0).

Errors

3
Function Requires State (PHOP,WSOP,*,*)
54
Specified Workstation Is Not Open
59
Specified Workstation Does Not Have Output Capability
208
Display Priority Is Out Of Range

Related Subroutines

  • Inquire Number Of Display Priorities Supported

  • Inquire Posted Structures

  • Inquire Set Of Workstations To Which Posted

  • Unpost All Structures

  • Unpost Structure


  • [ Previous | Next | Contents | Glossary | Home | Search ]