IN_ChangeRaster

image\bltlrgsq_shg.gif Editions  image\bltlrgsq_shg.gif  Related Functions  image\bltlrgsq_shg.gif  Example

The IN_ChangeRaster function changes the resolution, rotation, mirroring, and other characteristics of the specified raster. The result either is placed in a new window or overwrites the original, depending on the overwrite raster flag.

Syntax

int IN_ChangeRaster( docwinID, pageID, xResolution, yResolution, rotation, mirror, negate, pNewDocwinID )

Input Parameters

Values

Meaning

IN_DOCWIN docwinID

0 | docwinID

active | specific

IN_PAGE pageID

0

placeholder

SHORT xResolution

10 to 4000, inclusive

horizontal resolution in dpi

SHORT yResolution

10 to 4000, inclusive

vertical resolution in dpi

SHORT rotation

rotation values in degrees counter-clockwise:

IN_ROTATION_0 (0)

IN_ROTATION_90 (1)

IN_ROTATION_180 (2)

IN_ROTATION_270 (3)

IN_ROTATION_90_CW (4)

IN_ROTATION_90_CCW (5)

IN_ROTATION_180_REL (6). See Remarks.

SHORT mirror

0 | 1

do not mirror | mirror

SHORT negate

0 | 1

do not negate | negate. Example

Output Parameters

Values

Meaning

IN_DOCWIN_PTR pNewDocwinID

pointer

new document window identifier. See Remarks.

Remarks

The specified rotation value is added to the header rotation of the file (if any).

If the overwrite raster flag is set to on, pNewDocwinID is the original docwinID. The value is NULL if the function fails.

Release information

Added to Imagenation for Windows in Release 4.10.

Modified in Release 5.10 to support a wider range of resolution values.

As of Release 5.1, also available in Imagenation for UNIX.

Also supported in Imagenation 3.3 for UNIX.

See also

Changing raster characteristics

Improving raster images