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

Chapter 12. Image Subroutines

This section describes the image subroutines that can be used to manipulate image data. The subroutines discussed in this section allow the following operations:

  • Filling a position of an image board by a constant value.

  • Moving data between an application's image storage to an image board.

  • Defining an image on a workstation for subsequent display.
  • For each subroutine in this section, each target rectangle must have the same horizontal and vertical size as the source rectangle, and the source rectangle must be entirely within the source image data. See The graPHIGS Programming Interface: Understanding Concepts for more information about source and target rectangles.

    GPCAI - Cancel Image

    GPCAI (wsid, index)

    Purpose

    Use GPCAI to cancel an image definition on the specified workstation. If the specified image is used for any image mapping, the image mapping is removed from the view.

    If the specified image is not defined, no action is performed.

    Parameters

    wsid -- specified by user, fullword integer

    Workstation identifier.

    index -- specified by user, fullword integer

    Defined image index (>= 1)

    Error Codes

    25
    SPECIFIED WORKSTATION DOES NOT EXIST
    35
    WORKSTATION HAS ONLY INPUT CAPABILITIES
    288
    IMAGE INDEX NOT WITHIN WORKSTATION TABLE RANGE

    Related Subroutines

    GPCIM2
    Create Image Mapping 2
    GPCIM3
    Create Image Mapping 3
    GPDFI
    Define Image
    GPQIW
    Inquire List of Images on the Workstation

    RCP code

    201346306 (X'0C004D02')


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