graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPDFI - Define Image

GPDFI (wsid, index, conn, ctid, nibid, libid)

Purpose

Use GPDFI to define an image on a workstation. Image boards included in the image definition become ready to be displayed on the specified workstation. The specified image boards for the image definition must have been created with the same horizontal and vertical sizes or an error is generated and the image is not defined. If the specified image is already defined, it is cancelled and redefined.

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

index -- specified by user, fullword integer

Defined image index (>=1)

conn -- specified by user, fullword integer

Connection type (-1=FRAME_BUFFER_COMPATIBLE,1=COMPONENT, 2=INDEXED )

ctid -- specified by user, fullword integer

Color table identifier. For connection type (conn) -1, this parameter is ignored.

nibid -- specified by user, fullword integer

Number of image boards.

libid -- specified by user, array of fullword integers

List of image board identifiers. For each of the image connection types, the following number of image boards must be specified:

If conn=- 1 (FRAME_BUFFER_COMPATIBLE )

the number of image board identifiers specified in the list equals the number of frame buffer components for the specified workstation.

If conn=1 (COMPONENT )

the image board identifiers must be specified in the list.

If conn=2 (INDEXED )

1 image board identifier must be specified in the list.

Error Codes

25: SPECIFIED WORKSTATION DOES NOT EXIST
35: WORKSTATION HAS ONLY INPUT CAPABILITIES
215: SPECIFIED RESOURCES DO NOT EXIST ON THE SAME NUCLEUS
232: SPECIFIED IMAGE BOARD DOES NOT EXIST
284: COLOR TABLE IDENTIFIER DOES NOT EXIST
288: IMAGE INDEX NOT WITHIN WORKSTATION TABLE RANGE
291: SPECIFIED IMAGE CONNECTION TYPE IS NOT SUPPORTED
292: NUMBER OF IMAGE BOARDS DOES NOT MATCH THE CONNECTION TYPE
293: CHARACTERISTICS OF THE SPECIFIED IMAGE BOARDS DO NOT MATCH

Related Subroutines

GPCAI: Cancel Image
GPCIM2: Create Image Mapping 2
GPCIM3: Create Image Mapping 3
GPCRIB: Create Image Board
GPQCID: Inquire List of Color Table Identifiers
GPQICH: Inquire Image Characteristics
GPQIDF: Inquire Image Definition Facilities
GPQIW: Inquire List of Images on the Workstation
GPQXCF: Inquire Extended Color Facilities

RCP code

201346305 (X'0C004D01')