GDDM V3R2 Base Application Programming Guide
Previous topic | Next topic | Contents | Index | Contact z/OS | Library | PDF | BOOK


Converting the resolution of an image, using call IMARES

GDDM V3R2 Base Application Programming Guide
SC33-0867-01



You may recall that the IMACRT call specifies whether or not an image has defined resolution, and if so, what are the resolution values. You can use IMARES to change the resolution of an image. Here is a typical call:


     /*          ID  UNIT   HORIZ_RES   VERT_RES   ALGOR
     CALL IMARES(51,   0,      300,       180,       3);

If you code -1 to specify the image scanner, you can only specify scanner-supported resolutions in the third and fourth parameters. You can use the ISQRES call to query the scanner-supported resolutions. See "Querying image-related device characteristics" in topic 17.3.

The permitted values for the parameters and their meanings are described fully in the GDDM Base Application Programming Reference book.

The effect of IMARES depends on whether the image was created with defined or undefined resolution, or subsequently changed to defined or undefined resolution by the IMARF call.

If the image has undefined resolution, the image data itself is not changed, but the resolution returned by a subsequent IMAQRY call reflects the new values.

If the image has defined resolution, the image data is converted to the new resolution.

Go to the previous page Go to the next page



Copyright IBM Corporation 1990, 2012