Editions
Related Transactions
Example
The Merge transaction combines layers in the specified document window according to the merge type, and turns them into a new raster image. Any images that are not rasters are rasterized. The result either is placed in a new window or overwrites the original, depending on the overwrite raster flag.
Type XTYP_EXECUTE or XTYP_REQUEST
Syntax [Merge(docwinID, mergeType, <color>, <dither>, <xDPI>, <yDPI>, <lighten>)]
|
Parameter |
Data type |
Values |
Meaning |
|
docwinID |
DWORD |
0 | docwinID |
active | specific |
|
mergeType |
WORD |
0 |
specify in dialog box |
|
|
|
1 |
whole page |
|
|
|
2 |
displayed layers |
|
|
|
4 |
as displayed |
|
|
|
8 |
active raster |
|
|
|
16 |
active edit |
|
|
|
32 |
displayed rasters |
|
|
|
64 |
displayed edits |
|
|
|
128 |
each page of multipage |
|
color |
BOOL |
0 (default) |
do not perform color merge |
|
|
|
1 |
perform color merge. Optional parameter. |
|
dither |
BOOL |
0 (default) |
do not perform dither |
|
|
|
1 |
perform dither (choose this only if not also choosing color merge). Optional parameter. |
|
xDPI |
WORD |
10 to 4000 |
horizontal dots per inch. Optional parameter. Must be used if yDPI is. |
|
yDPI |
WORD |
10 to 4000 |
vertical dots per inch. Optional parameter. See Remarks. |
|
lighten |
WORD |
-100 to 100 |
specifies the lightness of dithered images. The negative values lighten and the positive values darken. (Default is 0.) Optional parameter. Will be available in Release 5.2. |
|
Reply |
Data type |
Meaning | |
|
newDocwinID |
DWORD |
identifier of the window containing the rasterized image. See Remarks. | |
Remarks
If xDPI is not specified, the default resolution is used. The default resolution is set in the Imagenation Rasterize dialog box, or in the [Session] section of the Imagenation INI file. If yDPI is not specified, it is set to the same value as xDPI.
Replies are only returned when this transaction is called as an XTYP_REQUEST. If the overwrite raster flag is set to on, newDocwinID is the original docwinID.
Release information
Added in Release 3.50.
Modified in Release 5.10 to support a wider range of resolution values.
Modified in Release 5.2: Optional lighten parameter added.
See also