UPDATE WORKSTATION

PUPD_WS

CALL SEQUENCE

Pint 	ws_id	/* workstation identifier	*/
Pregen_flag	regen_flag	/* when to do the regeneration	*/

)

TYPES

typedef enum {
	PFLAG_POSTPONE,
	PFLAG_PERFORM
} Pregen_flag;

PHIGS STATE

EFFECT

Updates workstation ws_id by executing all deferred operations. If regen_flag is set to PFLAG_PERFORM and if the workstation state list entry state of visual representation is DEFERRED or SIMULATED, the following actions are carried out in the following order:

- If the display surface empty entry in the workstation state list is set to NOTEMPTY, the display surface is cleared and display surface empty is set to EMPTY.

- If the view transformation update state is PENDING, the following workstation state listview table entries are assigned the values contained in the corresponding requested entries: current view orientation matrix current view mapping matrix

current view clipping limits

current x-y clipping indicator

current back clipping indicator

current front clipping indicator This is carried out for all view tables in the workstation state list. The view transformation update state entry is set to NOTPENDING.

- If the value of the workstation transformation update state entry of the workstation state list is PENDING, the current workstation window and current workstation viewport

entries are assigned values contained in the requested entries and the workstation transformation update state entry is set to NOTPENDING.

- If the value of the workstation state list entry HLHSR update state is PENDING, the HLHSR mode entry is assigned the value contained in the requested entry and the HLHSR update state entry is set to NOTPENDING.

- All posted workstation structures are redisplayed.

- State of visual representation entry is set to CORRECT.

EXTENSION TO THE PHIGS STANDARD

The effect of this function can differ from the standard if used in combination with GPHIGS extended view extensions. If the list of active views of the workstation is not empty, GPHIGS updates all the modified active views instead of the list of posted structures on the workstation. See the GPHIGS user guide for more details on extended views. If the modification mode is not UQUM, GPHIGS updates also all views which cover partially a modified view.

ERRORS

3

Ignoring function, function requires state (PHOP, WSOP,*,*)

54

Ignoring function, the specified workstation is not open

59

Ignoring function, the specified workstation does not have output capability (i.e. the workstation category is neither OUTPUT, OUTIN, nor MO)

SEE ALSO

open workstation, redraw all structures, set display update state, post structure, activate view (ext), post on view (ext), update extended view (ext)