IN_SetPageCalibration

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

The IN_SetPageCalibration function defines a scale factor for the page to be used when you are measuring lines and regions on that page. Calibration is used when the measurements based on the image resolution are not accurate. For example, you may know that an image line is 1.5 inches long, but the value returned when you use the Measure tool on it is 3 inches. In that case you could calibrate the page by a scale factor of 0.5.

Syntax

int IN_SetPageCalibration( docwinID, pageID, scaleFactor1, units1, scaleFactor2, units2, type )

Parameters

Values

Meaning

IN_DOCWIN docwinID

0 | docwinID

active | specific

IN_PAGE pageID

0 | pageID

current | specific

DOUBLE scaleFactor1

floating point

calibrated scale factor for the page

USHORT units1

units to calibrate to:

IN_UNITS_INCH (1)

IN_UNITS_CM (2)

IN_UNITS_PIXEL (3)

IN_UNITS_FT (4)

IN_UNITS_MM (5)

IN_UNITS_M (6)

IN_UNITS_POINTS (7)

IN_UNITS_TWIPS (8)

IN_UNITS_CUSTOM1 (9)

IN_UNITS_CUSTOM2 (10)

IN_UNITS_CUSTOM3 (11). See Remarks.

IN_UNITS_DEFAULT (12)

DOUBLE scaleFactor2

0

placeholder

USHORT units2

0

placeholder

USHORT type

0

placeholder

Remarks

To use custom units, they must be defined in Imagenation.

Release information

Added to Imagenation for Windows in Release 4.31.

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

See also

Calibrating measurements