IMREXR

GDDM V3R2 Base Application Programming Reference

IMREXR

GDDM V3R2 Base Application Programming Reference
SC33-0868-02

Function

To define rectangular sub-image in real coordinates.

IMREXR (proj-id, coord-type, left-edge, right-edge, top-edge, bottom-edge)

APL code 1656 GDDM RCP code X'3C030102' (1006829826)

Parameters

proj-id (specified by user) (fullword integer)
The identifier of the projection to which this transform element is to be added.

coord-type (specified by user) (fullword integer)
The coordinate type of the rectangle defined by the following edge parameters:

0 Inches

The edges of the rectangle are defined in inches. For this coordinate type, the source image must have a defined resolution.

Note: Negative edge coordinates are not allowed.

1 Meters

The edges of the rectangle are defined in meters. For this coordinate type, the source image must have a defined resolution.

Note: Negative edge coordinates are not allowed.

2 Fractional

The edges of the rectangle are defined as fractions of the h-pixels and v-pixels dimensions of the source image in the range 0.0 through 1.0.

left-edge (specified by user) (short floating point)

right-edge (specified by user) (short floating point)
The left and right edges of the rectangle as a distance from the left edge of the image in the units specified by coord-type. The values are first converted to a floating-point value in the pixel coordinate range, then left-edge is rounded up to the nearest integer and the right-edge rounded down, to address the image.

top-edge (specified by user) (short floating point)

bottom-edge (specified by user) (short floating point)
The top and bottom edges of the rectangle as a distance from the top edge of the image, in the units specified by coord-type. The values are first converted to a floating-point value in the pixel coordinate range, then top-edge is rounded up to the nearest integer and the bottom-edge rounded down, to address the image.

Description

Selects a rectangular subimage, in real coordinates. IMREXR is a normal transform element call except that when it is used it must be the first transform element in the transform, and it cannot be used in the same transform as an IMREX call.

For a description of transforms and projections, see the GDDM Base Application Programming Guide.

Transforms contain transform element calls (IMREX, IMREXR, IMRSCL, IMRORN, IMRREF, IMRNEG, IMRBRI, IMRCON, and IMRCVB), are started by the first such call. They are completed by an IMRPL or IMRPLR call, at which time they become available for transfer using the specified projection.

If any part of the specified rectangle falls outside the source image, that part is filled with default values (zeros for bi-level image).

Principal errors

ADM3362 E: INVALID RECTANGLE COORDINATE VALUE
ADM3401 E: INVALID PROJECTION IDENTIFIER
ADM3402 E: PROJECTION DOES NOT EXIST
ADM3404 E: TRANSFORM ALREADY CONTAINS A CALL TO THIS ROUTINE
ADM3406 E: IMREXR, WHEN CALLED, MUST BE FIRST CALL IN A TRANSFORM
ADM3407 E: INVALID COORD-TYPE VALUE

Notices | Terms of use | Support | Contact z/OS