Merging is the operation of combining the current image being processed (ProcessImageID) with another image. The resulting merged image is stored in ProcessImageID.

To merge images:

1. Call Merge method.
2. Load another image, using Picture, Filename, hDIB properties, or LoadBlob method. This image merges with the existing image.
3. The resulting merged image stores at ProcessImageID, overwriting the existing image.

If an area or region is active when Merge is called, then the source image is merged with the active region or area on the target image. If either of the images being merged has a bit depth of less than 24-bits, then both images are converted to 24-bit images, then merged. However a 1-bit image merged with another 1-bit image may result in a 1-bit image. If either of the images being merged has an associated color profile, then each image's profile is applied, then the images are merged. No color profile is retained. When the images being merged are both TIFF files that have tags, ensure that the tags are saved when merging, by first capturing the tags, then merging, then applying tags again. Sprites also offer limited capability of merging a part of an image with another one.

See Also