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')