GPCOND - Set Condition

Purpose

Use GPCOND to insert a Set Condition structure element into the open structure following the element pointer or to replace the element pointed at by the element pointer with a Set Condition structure element depending on the current edit mode.

During structure traversal, this structure element modifies the current condition flag as specified by the parameter. The graPHIGS API uses the condition flag when processing subsequent conditional execute structure and conditional return elements. Flags specified in the on-flag (on) parameter are turned on and flags specified in the off-flag (off parameter are turned off in the condition flag. Mathematically, the current condition flag becomes ([current-flag] or [on-flag]) and (NOT[off-flag])

The condition flag is a 32-bit bit string. Each bit is defined as follows:

    0                        15  16                       29  30     31
    --------------------------------------------------------------------------
    |                           |                            | cull |  prune |
    | reserved for application  |          reserved          | flag |  flag  |
    --------------------------------------------------------------------------
  High bit                                                               Low bit

Note:

Not all GSEs are supported on all workstations. Use the Inquire List of Generalized Structure Elements (GPQGSE) inquiry subroutine to determine the GSEs supported by an open workstation. See also the workstation descriptors described in The graPHIGS Programming Interface: Technical Reference

Parameters