IN_GetObjectMER

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

The IN_GetObjectMER function returns the extents (minimum enclosing rectangle--MER) of the specified page or layer. Displayed and hidden layers are queried.

Syntax

int IN_GetObjectMER( objectID, units, pX1, pY1, pX2, pY2 )

Input Parameters

Values

IN_OBJECT objectID

identifier of the object to query. If you use a docwinID, then the MER of the current page is returned. You can also use a pageID or a layerID. You cannot use 0, because it will not be clear which active object to query.

USHORT units

units to return the coordinates in:

IN_UNITS_INCH (1)

IN_UNITS_CM (2)

IN_UNITS_FT (4)

IN_UNITS_MM (5)

IN_UNITS_M (6)

IN_UNITS_CUSTOM1 (9)

IN_UNITS_CUSTOM2 (10)

IN_UNITS_CUSTOM3 (11) See Remarks.

Output Parameters

Meaning

DOUBLEPTR pX1

pointer to the left coordinate of the extents

DOUBLEPTR pY1

pointer to the bottom coordinate of the extents

DOUBLEPTR pX2

pointer to the right coordinate of the extents

DOUBLEPTR pY2

pointer to the top coordinate of the extents

Remarks

To be used, custom units must be defined in Imagenation (through the Units category of the System Preferences dialog box).

Release information

Added to Imagenation for Windows in Release 5.02.

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

See also

Getting page and layer extents