Previous Next Up Title Contents Index Functions Index Top Library

REDRAW ALL STRUCTURES

PREDRAW_ALL_STRUCTS


CALL SEQUENCE

void predraw_all_structs(
)

TYPES

typedef enum {
	PFLAG_COND,
	PFLAG_ALWAYS
} Pctrl_flag ;

PHIGS STATE

(PHOP, WSOP, *, *).

EFFECT

Redraws all posted structures. The operations below are carried out in the following order: - All deferred operations on the workstation ws_id are executed. - If ctrl_flag equals PFLAG_COND and the display surface empty entry of the workstation state list is set to NOTEMPTY, the display surface is cleared. If ctrl_flag equals PFLAG_ALWAYS, the display surface empty entry is ignored and the workstation is cleared.

- If the view transformation update state is PENDING, the following workstation state list view 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 in the workstation state list is PENDING, the current workstation window and current workstation viewport entries are assigned the 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 HLHSR update state entry is PENDING, then the HLHSR mode entry is set to the value contained in the requested entry and the HLHSR update state entry is set to NOTPENDING.

- All the workstation posted 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 redraws all the active views instead of the list of posted structures on the workstation. See the GPHIGS user guide for more details on extended views.

ERRORS

3
Ignoring function, function requires state (PHOP, WSOP,*,*)
54
Ignoring function, the specified workstation is not open
58
Ignoring function, specified workstation is not of category MI
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, update workstation, set display update state, post structure, activate view (ext), post on view (ext), redraw extended view (ext)


Previous Next Up Title Contents Index Functions Index Top Library