Accusoft.ImagXpress13.Net
Merge Method




The image that is to be merged with the image in the processor
The area/size the image is to be merged
The style of merge that is to be performed
Merging occurs with transparency or none
The color that is to be the transparent color if transparency is enabled
Determines the upper range of the superimpose intensity when the MergeStyle is a superimpose style
Determines the lower range of the superimpose intenisty when the MergeStyle is a superimpose style
Merges two images together such that the source image is merged with the current image specified in the processor. This method also specifies the type of merging.
Syntax
'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
Remarks

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.

See Also

Reference

Processor Class
Processor Members

 

 


©2017. Accusoft Corporation. All Rights Reserved.

Send Feedback