Editions
Related Functions
Example
Editions
Related Functions
Example
The IN_Merge function rasterizes layers in the specified document window according to the rasterizeType, and creates a new raster image. The result is either placed in a new window or overwrites the original, depending on the overwrite raster flag.
Syntax
int IN_Merge( docwinID, rasterizeType, xResolution, yResolution, bColor, bDither, pNewDocwinID )
|
Input Parameters |
Values |
Meaning |
|
IN_DOCWIN docwinID |
0 | docwinID |
active | specific |
|
SHORT rasterizeType |
IN_RASTERIZE_* USER_PROMPT (0) specify in dialog box DOCUMENT (1) entire page LAYERS (2) displayed layers AS_DISPLAYED (3) as displayed RASTERS_DISPLAYED (4) displayed raster layers EDITS_DISPLAYED (5) displayed edit layers ACTIVE_RASTER (6) active raster layer ACTIVE_EDIT (7) active edit layer MULTIPAGE (8) all pages | |
|
SHORT xResolution |
0
10 to 4000 |
current resolution. See Remarks. horizontal dots per inch |
|
SHORT yResolution |
0 10 to 4000 |
current resolution vertical dots per inch |
|
IN_BOOL bColor |
FALSE do not merge to color TRUE merge to color | |
|
IN_BOOL bDither |
FALSE do not dither TRUE dither (choose this only if bColor is FALSE) | |
|
Meaning | ||
|
IN_DOCWIN_PTR pNewDocwinID |
pointer to the new document window identifier. See Remarks. | |
Remarks
The current resolution is determined by the active raster layer on the page, if any, or the first raster, if no raster layers are active. If the page contains only edit layers, then the current resolution is usually 1200 dpi.
The pNewDocwinID is the same as the original document window if the overwrite raster flag is set to on, NULL if the function fails.
Release information
Added to Imagenation for Windows in Release 4.00.
Modified in Release 5.1: IN_MERGE_* constants changed to IN_RASTERIZE_* constants. Also supports a wider range of resolution values.
Further modified in Release 5.11: Supports resolution value of 0 to maintain current image resolution.
As of Release 5.1, also available in Imagenation for UNIX.
Also supported in Imagenation 3.3 for UNIX.
See also