Editions
Related Functions
Example
Editions
Related Functions
Example
The IN_ImportLayerToRegion function imports a layer onto the given page and fits the layer into the given rectangle.
Syntax
int IN_ImportLayerToRegion( docwinID, pageID, location, pFileName, pLabel, x1, y1, x2, y2, units, rotation, mode, pNewLayerID )
|
Input Parameters |
Values |
Meaning |
|
IN_DOCWIN docwinID |
0 | docwinID |
active | specific |
|
IN_PAGE pageID |
0 | pageID |
current | specific |
|
SHORT location |
IN_LOCN_DISK (0) |
the file is located on a disk |
|
CHARPTR pFileName |
pointer to the file name of the layer to import | |
|
CHARPTR pLabel |
pointer to the label to give the layer, maximum 80 characters | |
|
DOUBLE x1, y1 |
top-left corner coordinate | |
|
DOUBLE x2, y2 |
bottom-right corner coordinate. Coordinate system. | |
|
SHORT units |
units for the preceding coordinates: IN_UNITS_INCH (1) IN_UNITS_CM (2) IN_UNITS_FT (4) IN_UNITS_MM (5) IN_UNITS_M (6) | |
|
SHORT rotation |
0 |
|
|
SHORT mode |
IN_LYRRGN_* determines how the layer should be mapped to the specified rectangle. See Remarks. POSITION (1) place the image at position x1, y1. Ignore x2, y2. Do not scale the image. FIT (2) fit the layer to the specified rectangle. This may distort the image. PRESERVE_ASPECT (3) | |
|
Meaning | ||
|
IN_LAYER_PTR pNewLayerID |
pointer to the identifier of the new layer created from the import | |
Remarks
For vector layers the mode parameter is always treated as IN_LYRRGN_POSITION.
Release information
Added to Imagenation for Windows in Release 4.42.
As of Release 5.1, also available in Imagenation for UNIX.
See also