IN_UnitConversion

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

The IN_UnitConversion function takes a value in one unit of measure and returns the equivalent value in the specified unit.

Syntax

int IN_UnitConversion( InUnits, InValue, OutUnits, OutValue )

Input Parameters

Values

Meaning

int InUnits

IN_UNITS_*

INCH (1)

CM (2)

PIXEL (3)

FT (4)

MM (5)

M (6)

POINTS (7)

TWIPS (8)

original unit:

inches

centimeters

pixels

feet

millimeters

meters

points

twips

DOUBLE InValue

0 | 1 | 2 | ...

original value

int OutUnits

IN_UNITS_*

INCH (1)

CM (2)

PIXEL (3)

FT (4)

MM (5)

M (6)

POINTS (7)

TWIPS (8)

unit to convert to:

inches

centimeters

pixels

feet

millimeters

meters

points

twips

Output Parameters

Meaning

DOUBLEPTR OutValue

pointer to the value in the unit specified by OutUnits

See Remarks.

Remarks

Only the defined unit values are supported in this function. Custom units cannot be converted.

You can create integrations with this function that use combinations of other functions that do not support the same units. For example, some functions only support proportional units or pixels for coordinates, while others only support measurements in inches or centimeters.

Release information

Added to Imagenation for Windows in Release 7.2.

Not supported in Imagenation for UNIX.

See also

Calibrating measurements