The GetVisibleLayerMER transaction returns the extents (minimum enclosing rectangle--MER) for the specified layer. This can be useful for determining if the layer size is within the limits of the printer being used. CAD layers cannot be queried.
Type XTYP_REQUEST
Syntax [GetVisibleLayerMER(docwinID, layerID, units, <pageID>)]
|
Parameter |
Data type |
Values |
Meaning |
|
docwinID |
DWORD |
0 | docwinID |
active | specific |
|
layerID |
DWORD |
identifier of the layer to get the extents of | |
|
units |
WORD |
units to return the coordinates in: | |
|
|
|
1 |
inches |
|
|
|
2 |
cm |
|
|
|
4 |
feet |
|
|
|
5 |
mm |
|
|
|
6 |
m |
|
|
|
9 | 10 | 11 |
custom 1 | 2 | 3. See Remarks. |
|
pageID |
DWORD |
0 | pageID |
current | specific. Optional parameter. |
|
Reply |
Data type |
Meaning | |
|
x1, y1 |
float |
top-left coordinates of the extents | |
|
x2, y2 |
float |
bottom-right coordinates of the extents. See Remarks. | |
Remarks
To be used, custom units must be defined in Imagenation (through the Units category or dialog box).
If the specified layer is hidden, the coordinates returned will be 0, 0, 0, 0.
Release information
Added in Release 5.10.
See also