Name

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

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

Syntax

PRST (WKID, COFL)

Argument        Data Type      Access   Description
---------------------------------------------------------------------------
WKID            Integer        Read     Workstation identifier
COFL            Integer        Read     Control flag
---------------------------------------------------------------------------

Constants

Defined Argument      Constant      Description
---------------------------------------------------------------------------
COFL                  PCONDI        Clear conditionally
                      PALWAY        Clear always
---------------------------------------------------------------------------

Description

PRST accepts workstation identifier and control flag arguments.  The control flag value may be set to either PCONDI or PALWAY.  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 PCONDI 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 PALWAY, 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 PRST 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

PQDUS
PQPOST
PPOST
PSDUS
PUWK
DUPWSS