Name

predraw_all_structs − Redraws the structures, according to the values assigned to various flags. 

Operating States: PHOP, WSOP, ∗, ∗
PHIGS standard function

Syntax

void predraw_all_structs (
   Pint         wsid,          /∗ (I) Workstation identifier ∗/
   Pctrl_flag   control_flag   /∗ (I) Control flag ∗/
)

Data Structures

typedef enum {
    PFLAG_COND,     /∗ clear conditionally ∗/
    PFLAG_ALWAYS    /∗ clear always ∗/
} Pctrl_flag;

Description

predraw_all_structs accepts workstation identifier and control flag arguments.  The control flag value may be set to either PFLAG_COND or PFLAG_ALWAYS.  The function causes the following actions to occur:

1All deferred actions for the specified workstation are executed without intermediate clearing of the display surface. 

2If the specified control flag is set to PFLAG_COND and the display surface empty entry in the workstation state list is NOTEMPTY, the display surface is cleared.  If the control flag is set to PFLAG_ALWAYS, the display is cleared  regardless of the value of the display surface empty entry.  The display surface empty entry is then set to EMPTY. 

3If the view transformation update state entry in the workstation state list is PENDING, requested entry values are assigned to the current entries in the workstation state list, as follows:

From                                 To
------------------------------------------------------------------------
Current view orientation matrix      Requested view orientation matrix
Current view mapping matrix          Requested view mapping matrix
Current view clipping limits         Requested view clipping limits
Current front clipping indicator     Requested front clipping indicator
------------------------------------------------------------------------

The view transformation update state entry is then set to NOTPENDING. 

4If the workstation transformation update state entry in the workstation state list is PENDING, Digital PHIGS assigns requested entry values to the current entries in the workstation state list as follows:

From                                 To
------------------------------------------------------------------------
Current workstation window           Requested workstation window
Current workstation viewport         Requested workstation viewport
------------------------------------------------------------------------

The workstation transformation update state entry is then set to NOTPENDING. 

5If the HLHSR update state entry in the workstation state list is PENDING, the values of the requested HLHSR mode entry are assigned to the current HLHSR mode entry in the workstation state list.  The HLHSR update state entry is then set to NOTPENDING. 

6All structures posted for the specified workstation (that is, all structures identified in the table of posted structures in the workstation state list) are redisplayed.  The redisplay action sets the display surface empty entry in the workstation state list to NOTEMPTY if the set of structures posted to the workstation is also not empty. 

7The state of visual representation entry in the workstation state list is set to CORRECT. 

Making repeated calls to predraw_all_structs with the specified control flag value set to ALWAYS allows generation of multiple copies of the posted structure networks on image storage (hardcopy) workstations. 

See Also

pinq_disp_upd_st
pinq_posted_structs
ppost_struct
pset_disp_upd_st
pupd_ws
pe_upd_ws_synch