UPDATE WORKSTATION(3P) — Kubota Pacfic Computer Inc. (29 February 1991)

NAME

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

SYNOPSIS

C Syntax

void
pupd_ws ( ws, regen_flag )
Pintws;workstation identifier
Pregen_flagregen_flag;when to do the regeneration

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 PVISUAL_ST_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:

PFLAG_PERFORM Make picture PVISUAL_ST_CORRECT if it is not
PFLAG_POSTPONE Postpone regeneration; only complete deferred workstation actions

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 PFLAG_PERFORM, and the workstation’s display is not entirely PVISUAL_ST_CORRECT, UPDATE WORKSTATION regenerates the display, performing the following actions:

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

2.For every view representation in the View workstation state list, if the view transformation update state is PUPD_PEND, the current view representation is loaded from the requested view representation, and the update state is set to PUPD_NOT_PEND.

3.If the workstation transformation update state is PUPD_PEND, the current workstation window, and current workstation viewport are loaded with the requested values for each, and the update state is set to PUPD_NOT_PEND.

4.If the workstation’s HLHSR update state is PUPD_PEND, the current HLHSR mode is updated to the value of the requested HLHSR mode; and the update state is set to PUPD_NOT_PEND.

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

The workstation’s state of visual representation indicates if the display is PVISUAL_ST_CORRECT, PVISUAL_ST_SIMULATED, or PVISUAL_ST_DEFER. 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 PSTAT_NOTEMPTY. (If all the posted structures are empty, or contain elements but no output primitive elements, the display surface empty may be PSTRUCT_STATUS_EMPTY or PSTAT_NOTEMPTY.)

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

•regeneration flag is PFLAG_PERFORM.

•The workstation’s state of visual representation is PVISUAL_ST_DEFER or PVISUAL_ST_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 (that is, the workstation category is neither OUTPUT, OUTIN, nor MO)

Museum