graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPRAST - Redraw All Structures

GPRAST (wsid, flag)

Purpose

Use GPRAST to redraw all structures on the specified workstation.

When your application invokes this subroutine, the graPHIGS API executes the actions in the sequence outlined below:

The graPHIGS API executes all deferred actions for the specified workstation without an intermediate clearing of the display surface.

If the control flag is set to 1=CONDITIONALLY , then the graPHIGS API clears the display surface only if the Display Surface Empty entry in the WSL is 1=NOT_EMPTY If the control flag is set to 2=ALWAYS , then the graPHIGS API clears the display surface regardless of the setting of the Display Surface Empty entry. At the conclusion of this step, the graPHIGS API sets the entry to 2=IS_EMPTY

If the workstation window, viewport, view matrix, view mapping, or view characteristics have changed for any view, then the graPHIGS API assigns the current entries in the Workstation State List (WSL) to the corresponding values from the requested entries. The Transformation Update State is set to 1=NOT_PENDING and the transformation view matrix, view mapping, and view characteristics change flags are set to NOTCHANGED

Finally, the graPHIGS API retraverses all structures associated with views for this workstation. If the set of structures associated with this workstation's views are not empty, retraversal usually sets the Display Surface Empty entry in the WSL to 1=NOT_EMPTY

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

flag -- specified by user, fullword integer

Control flag (1=CONDITIONALLY, 2=ALWAYS )

Error Codes

25: SPECIFIED WORKSTATION DOES NOT EXIST
35: WORKSTATION HAS ONLY INPUT CAPABILITIES
301: CONTROL FLAG IS INVALID

Related Subroutines

GPSHDF: Set Shell Deferral State

RCP code

201327873 (X'0C000501')