UPDATE WORKSTATION(3P) — SUNPHIGS LIBRARY

NAME

UPDATE WORKSTATION − execute deferred workstation actions and optionally correct the display

SYNOPSIS

C Syntax

void
pupdatews ( ws, regen_flag )
Pintws;workstation identifier
Pregenregen_flag;when to do the regeneration

FORTRAN Syntax

SUBROUTINE puwk ( WKID, REGFL )
INTEGERWKIDworkstation identifier
INTEGERREGFLregeneration flag (PPOSTP, PPERFO)

Required PHIGS Operating States

(PHOP, WSOP, ∗, ∗ )

DESCRIPTION

Purpose

UPDATE WORKSTATION completes any actions in progress on the specified workstation. Then, depending on the value of the regeneration flag and the correctness of the workstation’s display, the display is regenerated to make it CORRECT.

C Input Parameters

wsThe identifier of the workstation to be updated.

regen_flag
The regeneration flag controls whether the display should be made entirely correct. Valid values are:

PPERFORMMake picture CORRECT if it is not.

PPOSTPONEPostpone regeneration; only complete deferred workstation actions.

FORTRAN Input Parameters

WKIDThe identifier of the workstation to be updated.

REGFL
The regeneration flag controls whether the display should be made entirely correct. Valid values are:

PPOSTPPostpone regeneration; only complete deferred workstation actions.

PPERFOMake picture CORRECT if it is not.

Execution

UPDATE WORKSTATION always initiates transmission of any data buffered from previous actions on the specified workstation, without first clearing the display surface.

Then UPDATE WORKSTATION may regenerate the display, depending on the value of the regeneration flag parameter and the correctness of the workstation’s display. If regeneration flag is set to PERFORM, and the workstation’s display is not entirely CORRECT, UPDATE WORKSTATION regenerates the display, performing the following actions:

1.If the workstation’s display is not empty, the display surface is cleared.

2.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.

3.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.

4.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.

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

6.The workstation’s ‘state of visual representation’ is set to 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 5 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.)

UPDATE WORKSTATION performs the same sequence of actions as REDRAW ALL STRUCTURES when

•regeneration flag is PERFORM, and

•the workstation’s ‘state of visual representation’ is DEFERRED or SIMULATED.

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