IN_GetVisibleObjectMER

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

The IN_GetVisibleObjectMER function returns the extents (minimum enclosing rectangle--MER) of the specified page or layer. Only displayed layers are queried. CAD layers cannot be queried.

Syntax

int IN_GetVisibleObjectMER( docwinID, objectID, units, pX1, pY1, pX2, pY2 )

Input Parameters

Values

Meaning

IN_DOCWIN docwinID

0 | docwinID

active | specific

IN_OBJECT objectID

identifier of the page or layer to query. Use 0 for the current page.

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 top coordinate of the extents

DOUBLEPTR pX2

pointer to the right coordinate of the extents

DOUBLEPTR pY2

pointer to the bottom 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.10.

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

See also

Getting page and layer extents