Name

pupd_ws − Illustrates the effects deferred by the pset_disp_upd_st function. 

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

Syntax

void pupd_ws (
  Pint           wsid,         /∗ (I) Workstation identifier ∗/
  Pregen_flag    regen_flag    /∗ (I) Regeneration flag ∗/
)

Data Structures

typedef enum {
    PFLAG_POSTPONE,    /∗ regeneration flag perform ∗/
    PFLAG_PERFORM      /∗ regeneration flag suppress ∗/
} Pregen_flag;

Description

Depending upon the value of the regeneration flag, pupd_ws illustrates the effects deferred by the pset_disp_upd_st function, for the workstation specified by the workstation identifier.  This function executes all deferred actions for the specified workstation without intermediate clearing of the display surface.  If the specified regeneration flag is set to PFLAG_PERFORM and the state of visual representation entry in the workstation state list is DEFERRED or SIMULATED, Digital PHIGS performs the following in sequence:

1Digital PHIGS clears the display surface and sets the display surface empty entry in the workstation state list to EMPTY. 

2If the viewing 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
Current viewing entries        Requested viewing entries
----------------------------------------------------------------------

Also, Digital PHIGS sets the viewing transformation update state entry to NOTPENDING. 

3If the HLHSR update state entry in the workstation state list is PENDING, Digital PHIGS assigns the values of the requested HLHSR mode entry to the current HLHSR mode entry in the workstation state list.  Also, Digital PHIGS sets the HLHSR update state entry to NOTPENDING. 

4Digital PHIGS displays all structures posted for the specified workstation (that is, all structures identified in the list of posted structures in the workstation state list).  The redisplay action sets the display surface empty entry in the workstation state list to NOTEMPTY.  It also sets the viewing transformation update state entry to NOTPENDING. 

5Digital PHIGS sets the state of visual representation entry in the workstation state list to CORRECT. 

Other possible effects of this function include the following:

•The specified value of the regeneration flag is PFLAG_PERFORM. 

This function suspends the effect of the pset_disp_upd_st function, and has the effect of the following sequence of functions:

pinq_ws_st
(save the deferral state value)
pset_disp_upd_st (ASAP...)
(set the deferral state to the saved value)

•The state of visual representation entry in the workstation state list is CORRECT, or the specified value of the regeneration flag is PFLAG_POSTPONE. 

This function initiates the transmission of blocked data and takes no other action. 

•The state of visual representation entry in the workstation state list is PFLAG_PERFORM. 

This function behaves as if the application called the predraw_all_structs function. 

See Also

pinq_disp_upd_st
pinq_posted_structs
predraw_all_structs
pset_disp_upd_st
pe_upd_ws_synch