[ Previous | Next | Contents | Glossary | Home | Search ]
The graPHIGS Programming Interface : Subroutine Reference

GPUPWS - Update Workstation

GPUPWS (wsid, regen)

Purpose

Use GPUPWS to update the specified workstation. If any actions have been deferred or simulated as a result of explicit traversal, the graPHIGS API performs a retraversal to update the display.

This subroutine function executes all deferred actions for the specified workstation without intermediate clearing of the display surface. If the regeneration flag is set to 2=PERFORM and the New Frame Action Necessary at Update entry in the Workstation State List (WSL) is set to 2=YES , then the graPHIGS API executes all the actions in the sequence outlined below:

  1. If the Display Surface Empty entry in the WSL is 1=NOT_EMPTY , then the graPHIGS API clears the display surface. At the conclusion to this step (Step 1), the graPHIGS API sets the entry to 2=IS_EMPTY

  2. 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 entry is set to 1=NOT_PENDING and the transformation view matrix, view mapping and view characteristics change flags are set to NOTCHANGED

  3. The graPHIGS API re-displays all structures associated with views on this workstation. Usually, this action sets the Display Surface Empty entry in the WSL to 1=NOTEMPTY The Transformation Update State entry is set to 1=NOT_PENDING

  4. The state, New Frame Action Necessary at Update, is set to 1=NO in the WSL. If the value of the state, New Frame Action Necessary at Update is set to 2=YES and the regeneration flag is set to 2=PERFORM , then this subroutine is functionally equivalent to the Redraw All Structures (GPRAST) subroutine.

  5. If the current state of visual representation is set to 3=SIMULATED and the modification mode is UQUM (Quick Update Method), then the state of visual representation remains unchanged. In all other cases, the state of visual representation is set to 1=CORRECT

    6. Parameters

    wsid -- specified by user, fullword integer

    Workstation identifier.

    regen -- specified by user, fullword integer

    Regeneration flag (1=POSTPONE, 2=PERFORM )

    When the regeneration flag is set to 1=POSTPONE , the device sends the pending update information without forcing a retraversal if possible. This is workstation dependent.

    When the regeneration flag is set to 2=PERFORM , the device sends the pending update information and immediately initiates a retraversal.

    Error Codes

    25
    SPECIFIED WORKSTATION DOES NOT EXIST
    35
    WORKSTATION HAS ONLY INPUT CAPABILITIES
    302
    REGENERATION FLAG IS INVALID

    Related Subroutines

    GPSHDF
    Set Shell Deferral State
    GPQDV
    Inquire Deferral and Update State Values

    RCP code

    201327874 (X'0C000502')

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