[ 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:

  1. The graPHIGS API executes all deferred actions for the specified workstation without an intermediae clearing of the display surface
  2. 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 .
  3. 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. .
  4. 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.
  5. 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

prst (wkid, cofl)

Input Parameters

integer wkid
Workstation identifier.

integer cofl
Control 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 ]