IMREX

GDDM V3R2 Base Application Programming Reference

IMREX

GDDM V3R2 Base Application Programming Reference
SC33-0868-02

Function

To define rectangular sub-image in pixel coordinates.


   IMREX       (proj-id, left-edge, right-edge, top-edge, bottom-edge)

   APL code               1655
   GDDM RCP code          X'3C030101' (1006829825)

Parameters

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

left-edge (specified by user) (fullword integer)

right-edge (specified by user) (fullword integer)
The columns of pixels that form the left and right edges of the rectangle to be extracted. The left-edge parameter must be in the range 0 through 2(29)-2 and right-edge must be in the range -1 through 2(29)-2.

top-edge (specified by user) (fullword integer)

bottom-edge (specified by user) (fullword integer)
The rows of pixels that form the top and bottom edges of the rectangle to be extracted. The top-edge parameter must be in the range 0 through 2(29)-2 and bottom-edge must be in the range -1 through 2(29)-2.

Description

Selects a rectangular sub-image, in pixel coordinates. IMREX 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 IMREXR 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), and 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
ADM3405 E: IMREX, WHEN CALLED, MUST BE FIRST CALL IN A TRANSFORM

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