IN_SetSystemUnit

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

The IN_SetSystemUnit function defines Metric, Imperial, the System default, or a custom value as the measurement unit to use in the Measurements window.

Syntax

int IN_SetSystemUnit( MeasSys, customIndex, name, unit, value )

Parameters

Values

Meaning

SHORT MeasSys

IN_MEAS_SYSTEM_*
DEFAULT
METRIC
IMPERIAL

measurement system to use:
system default
Metric
Imperial

SHORT customIndex

0 | 1 | 2 | 3

custom unit to use. See Remarks.

CHARPTR name

name of new custom unit

SHORT unit

IN_UNITS_*

INCH (1)

CM (2)

PIXEL (3)

FT (4)

MM (5)

M (6)

POINTS (7)

TWIPS (8)

unit used to define custom unit
inches

centimeters

pixels

feet

millimeters

meters

points

twips

DOUBLE value

number of real units equal to custom unit

Remarks

You can define and use up to three custom units. If the customIndex value is zero (0), then the name, unit, and value parameters are ignored.

Release information

Added to Imagenation for Windows in Release 7.4.

Not yet available in Imagenation for UNIX.

See also

Displaying the Measurements window

Calibrating measurements