[ Previous | Next | Contents | Glossary | Home | Search ]
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:

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

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

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

  4. 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
  5. 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')


    [ Previous | Next | Contents | Glossary | Home | Search ]