REDRAW ALL STRUCTURES(3P) — SUNPHIGS LIBRARY

NAME

REDRAW ALL STRUCTURES − redisplay all structures posted to a workstation

SYNOPSIS

C Syntax

void
predrawallstruct ( ws, control_flag )
Pintws;workstation identifier
Pcontrolcontrol_flag;controls the redraw of the structures

FORTRAN Syntax

SUBROUTINE prst ( WKID, COFL )
INTEGERWKIDworkstation identifier
INTEGERCOFLcontrol flag (PCONDI, PALWAY)

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗)

DESCRIPTION

Purpose

REDRAW ALL STRUCTURES updates the specified workstation’s display by

•completing any actions in progress;

•clearing the display surface if the surface is NOT EMPTY, or if the control flag is ALWAYS;

•updating any pending viewing transformation and pending HLHSR mode;

•redisplaying all structures posted to the workstation; and

•setting the workstation’s ‘state of visual representation’ to CORRECT.

C Input Parameters

wsThe identifier of the workstation whose structures are to be redrawn.

control_flag
Controls whether the display surface is automatically cleared or not. Pcontrol is defined in phigs.h. Valid values are:

PCONDITIONALLYClear the display surface before redrawing only if the surface is not empty.

PALWAYSAutomatically clear the surface before redrawing.

FORTRAN Input Parameters

WKIDThe identifier of the workstation whose structures are to be redrawn.

COFLControls whether the display surface is automatically cleared or not. Valid values are defined in phigs77.h:

PCONDIClear the display surface before redrawing only if the surface is not empty.

PALWAYAutomatically clear the surface before redrawing.

Execution

REDRAW ALL STRUCTURES performs the following actions in sequence:

1.Any buffered communications for the specified workstation are completed without first clearing the display surface.

2.If the control flag is set to CONDITIONALLY, the workstation’s display surface is only cleared if it is NOT EMPTY. If the control flag is set to ALWAYS, the display surface is cleared regardless of whether the display is EMPTY. In any case, the entry is then set to EMPTY. Note: Using a control flag of CONDITIONALLY avoids unnecessarily clearing an empty display surface. A value of ALWAYS is useful when generating multiple copies of the current image on hardcopy devices.

3.For every view representation in the workstation’s state list, if the ‘view transformation update state’ is PENDING, the current view representation is loaded from the “requested” view representation, and the update state is set to NOTPENDING.

4.If the ‘workstation transformation update state’ is PENDING, the ‘current workstation window’, and ‘current workstation viewport’ are loaded with the “requested” values for each, and the update state is set to NOTPENDING.

5.If the workstation’s ‘HLHSR update state’ is PENDING, the ‘current HLHSR mode’ is updated to the value of the ‘requested HLHSR mode’; and the update state is set to NOTPENDING.

6.All structure networks posted for this workstation are redisplayed in their priority order.

7.The workstation’s ‘state of visual representation’ is set CORRECT.

The workstation’s ‘state of visual representation’ indicates if the display is CORRECT, SIMULATED or DEFERRED. INQUIRE DISPLAY UPDATE STATE returns the workstation’s ‘display surface empty’ and ‘state of visual representation’ state list entries. Normally, the traversal in step 6 causes the ‘display surface empty’ workstation state to become NOTEMPTY. (If all the posted structures are empty, or contain elements but no output primitive elements, the ‘display surface empty’ may be EMPTY or NOTEMPTY.)

ERRORS

003Ignoring function, function requires state (PHOP, WSOP, ∗, ∗)

054Ignoring function, the specified workstation is not open

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

Museum