graPHIGS Programming Interface: Subroutine Reference

The graPHIGS Programming Interface : Subroutine Reference

GPCIM3 - Create Image Mapping 3

GPCIM3 (wsid, imap, view, index, origin, size, P, Q, R, method, prior)

Purpose

Use GPCIM3 to define the image mapping of an image to a specified view of a workstation.

A rectangle on the specified image is mapped into a parallelogram in World Coordinates (WC) and is associated with the specified view. The parallelogram is identified by the specified image mapping identifier. If the specified image mapping identifier is already in use, the existing image mapping is deleted and a new image mapping is created.

This subroutine only supports views in parallel projection. If the specified view has its projection type set to perspective, the image mapping is not defined and an error message is issued. If the projection type of a view is set to perspective and image mappings are currently defined to that view, the image mappings for the view are deleted before the projection type is set to perspective.

The priority parameter defines the relationship of this image mapping to others within the same view. Higher priority images will be displayed last.

Parameters

wsid -- specified by user, fullword integer

Workstation identifier.

imap -- specified by user, fullword integer

Image mapping identifier.

view -- specified by user, fullword integer

View index (>=0)

index -- specified by user, fullword integer

Defined image index (>=1)

origin -- specified by user, two fullword integers

Origin of the image rectangle (x, y)

size -- specified by user, two fullword integers

Size of the image rectangle (sx, sy)

P -- specified by user, 3 short floating-point numbers (WC)

Lower left corner of the mapped rectangle in WC.

Q -- specified by user, 3 short floating-point numbers (WC)

Lower right corner of the mapped rectangle in WC.

R -- specified by user, 3 short floating-point numbers (WC)

Top left corner of the mapped rectangle in WC.

method -- specified by user, fullword integer

Image mapping method (1=PIXEL_BY_PIXEL )

prior -- specified by user, short floating-point number

Priority (0.0<= prior<=1.0)

Error Codes

25: SPECIFIED WORKSTATION DOES NOT EXIST
35: WORKSTATION HAS ONLY INPUT CAPABILITIES
59: VIEW INDEX VALUE < ZERO
126: PRIORITY VALUE IS INVALID
236: RECTANGLE DEFINITION IS INVALID
288: IMAGE INDEX NOT WITHIN WORKSTATION TABLE RANGE
290: SPECIFIED IMAGE INDEX IS NOT DEFINED
294: SPECIFIED IMAGE MAPPING METHOD IS NOT SUPPORTED
323: VIEW INDEX EXCEEDS VIEW TABLE CAPACITY
331: PROJECTION TYPE IS INVALID

Related Subroutines

GPDIM: Delete Image Mapping
GPEAV: Empty All Views
GPEV: Empty View
GPQIMC: Inquire Image Mapping Characteristics
GPQIMF: Inquire Image Mapping Facilities
GPQIMI: Inquire Image Mapping of Image
GPQIMV: Inquire Image Mapping on View
GPQIMW: Inquire Image Mapping on Workstation

RCP code

201346308 (X'0C004D04')