[ Previous |
Next |
Contents |
Glossary |
Home |
Search ]
The graPHIGS Programming Interface: ISO PHIGS Subroutine Reference
REDRAW ALL STRUCTURES (PHOP,WSOP,*,*)
Purpose
Use Redraw All Structures to redraw all structures on the specified workstation.
When your application invokes this subroutine, the graPHIGS API executes
all the actions in the sequence outlined below:
- The graPHIGS API executes all deferred actions for the specified workstation without an intermediae clearing of the display surface
- If the control flag is set to CONDITIONALLY,
and only if the Display Surface Empty entry in the Workstation State List (WSL)
is set to NOTEMPTY, then the graPHIGS API clears the display surface.
If the control flag is set to ALWAYS,
then the graPHIGS API clears the display surface regardless of the setting of
the Display Surface Empty entry.
At the conclusion of this step, the graPHIGS API sets the entry in the WSL to
EMPTY
.
- If the view orientation matrix, view mapping matrix, view clipping limits,
x to y clipping indicator, back clipping indicator, or the front clipping
indicator have changed for any view, then the graPHIGS API assigns
the current entries in the Workstation State List (WSL) to the corresponding
values from the requested entries.
The Transformation Update State is set to NOTPENDING.
.
- If the Hidden Line/Hidden Surface Removal (HLHSR) mode has changed,
then the graPHIGS API assigns the current WSL entry to the corresponding value
from the requested entry.
The HLHSR Update State is set to NOTPENDING.
- Finally the graPHIGS API retraverses all structures posted to this workstation.
If the set of structures associated with this workstation is not empty,
retraversal usually sets the Display Surface Empty entry in the WSL to
NOTEMPTY
.
The graPHIGS API sets the state of visual representation in the WSL to
CORRECT
.
Language Bindings
C
predraw_all_structs
(ws_id, ctrl_flag); |
Input Parameters
Pint ws_id
Workstation identifier
Pctrl_flag ctrl_flag
Control flag (0=PFLAG_COND, 1=PFLAG_ALWAYS
).
FORTRAN
Input Parameters
integer wkidWorkstation identifier.
integer coflControl flag (0=PCONDI, 1=PALWAY
).
Errors
- 3
- FUNCTION REQUIRES STATE (PHOP,WSOP,*,*)
- 54
- SPECIFIED WORKSTATION IS NOT OPEN
- 59
- SPECIFIED WORKSTATION DOES NOT HAVE OUTPUT CAPABILITY
Related Subroutines
Update Workstation
[ Previous |
Next |
Contents |
Glossary |
Home |
Search ]