IMRSCL

GDDM V3R2 Base Application Programming Reference

IMRSCL

GDDM V3R2 Base Application Programming Reference
SC33-0868-02

Function

To scale extracted image.


   IMRSCL      (proj-id, h-scale, v-scale)

   APL code               1659
   GDDM RCP code          X'3C030105' (1006829829)

Parameters

proj-id (specified by user) (fullword integer)
A projection with an incomplete transform, to which this transform element is to be added.

h-scale (specified by user) (short floating point)
The horizontal scale factor by which the h-pixels value of the extracted image are to be multiplied. Negative values are not allowed.

v-scale (specified by user) (short floating point)
The vertical scale factor by which the v-pixels value of the extracted image are to be multiplied. Negative values are not allowed.

Description

Scales the extracted image in the horizontal direction, or vertical direction, or both of these. The scaling factors h-scale and v-scale are multipliers for h-pixels and v-pixels.

Note: Negative h-scale and v-scale values are not allowed, and cause an error message to be issued.

The parameters h-pixels and v-pixels for the extracted image become h-pixels*h-scale and v-pixels*v-scale, rounded to the nearest integer.

Only one IMRSCL call is allowed for a given transform. Subsequent IMRSCL calls are an error.

The scaling factors h-scale and v-scale refer to the extracted image after it has been operated on by any calls that were specified earlier. Therefore, a rotation by 90 degrees followed by a scale with an h-scale value of 2 and a v-scale value of 1 corresponds to a scale with an h-scale value of 1 and a v-scale value of 2 followed by a rotation by 90 degrees.

The scaling algorithm to be used can be specified with the IMRRAL call.

Principal errors

ADM3401 E: INVALID PROJECTION IDENTIFIER
ADM3402 E: PROJECTION DOES NOT EXIST
ADM3404 E: TRANSFORM ALREADY CONTAINS A CALL TO THIS ROUTINE
ADM3410 E: INVALID H-SCALE OR V-SCALE VALUE

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