'Declaration
 
Public Sub Merge( _
   ByRef sourceImage As ImageX, _
   ByVal mergeSize As MergeSize, _
   ByVal mergeStyle As MergeStyle, _
   ByVal transparent As Boolean, _
   ByVal transparentColor As Color, _
   ByVal mergePercentHigh As Integer, _
   ByVal mergePercentLow As Integer _
) 

'Usage
 
Dim instance As Processor
Dim sourceImage As ImageX
Dim mergeSize As MergeSize
Dim mergeStyle As MergeStyle
Dim transparent As Boolean
Dim transparentColor As Color
Dim mergePercentHigh As Integer
Dim mergePercentLow As Integer
 
instance.Merge(sourceImage, mergeSize, mergeStyle, transparent, transparentColor, mergePercentHigh, mergePercentLow)

public void Merge( 
   ref ImageX sourceImage,
   MergeSize mergeSize,
   MergeStyle mergeStyle,
   bool transparent,
   Color transparentColor,
   int mergePercentHigh,
   int mergePercentLow
)

public: void Merge( 
   ref ImageX* sourceImage,
   MergeSize mergeSize,
   MergeStyle mergeStyle,
   bool transparent,
   Color transparentColor,
   int mergePercentHigh,
   int mergePercentLow
) 

public:
void Merge( 
   ImageX^% sourceImage,
   MergeSize mergeSize,
   MergeStyle mergeStyle,
   bool transparent,
   Color transparentColor,
   int mergePercentHigh,
   int mergePercentLow
) 

Parameters

sourceImage

The image that is to be merged with the image in the processor

mergeSize

The area/size the image is to be merged

mergeStyle

The style of merge that is to be performed

transparent

Merging occurs with transparency or none

transparentColor

The color that is to be the transparent color if transparency is enabled

mergePercentHigh

Determines the upper range of the superimpose intensity when the MergeStyle is a superimpose style

mergePercentLow

Determines the lower range of the superimpose intenisty when the MergeStyle is a superimpose style

Merging combines the current image being processed with another specified ImageX image. The resulting merged image is stored in Image.

If an area or region is active when the Merge method is called, then the source image is merged with the active region or area on the target image.

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 the tags again.

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 is retained.

Note: Sprites also offer the capability of merging a part of an image with another one, but it is more limited in capability.

Reference

Processor Class
Processor Members