Accusoft ImagXpress 13
Merge Method

True = subsequent loaded images should be merged

False = subsequent loaded images should not be merged.

An enumMergeSize enumeration value.
An enumMergeStyle enumeration value.

A long expression that evaluates to the transparent color.

The superimpose intensity (when IPMergeStyle = 5).

The upper range of the superimpose intensity (when IPMergeStyle = 6 through 13).

Range:  0 - 100  (percent)

The lower range of the superimpose intensity (when IPMergeStyle = 6 through 13)

Range: 0 - 100 (percent)

Description
Merges the current image with images that are subsequently loaded.
Syntax
Visual Basic
Public Sub Merge( _
   ByVal IPMerge As Boolean, _
   ByVal IPMergeSize As enumMergeSize, _
   ByVal IPMergeStyle As enumMergeStyle, _
   ByVal IPTransparent As Boolean, _
   ByVal IPTransparentColor As Long, _
   ByVal IPMergePctHi As Integer, _
   ByVal IPMergePctLo As Integer _
) 
Parameters
IPMerge

True = subsequent loaded images should be merged

False = subsequent loaded images should not be merged.

IPMergeSize
ValueDescription
MSZ_CropCrop The merge image is cropped to the size of the existing DIB or to the area specified by the Area method.
MSZ_ResizeAreaResize Area to Image The merge area is resized to the size of the merge image.
MSZ_ResizeImageResize Image to Area The merge image is resized to the size of the current image or to the area specified by the Area method.
MSZ_TileImageTile Image to Area The merge image is tiled to the size of the current image or to the area specified by the Area method.
An enumMergeSize enumeration value.
IPMergeStyle
ValueDescription
MST_AdditivePixel values are added to the pixels in the existing image.
MST_Alpha_BackGround_Over_ForeGroundThe background image alpha channel determines which pixels are transparent and opaque. Effectively, the background alpha channel is negated and applied with the net result that the opaque background pixel will show through and the transparent pixel will allow the foreground image to show.
MST_Alpha_ForeGround_Over_BackGroundThe normal way of viewing a merged alpha image. The alpha channel in the foreground image is used to blend the two images together. The alpha channel contains information as to which pixels are opaque and which pixels are transparent in the image, and the degree of transparency. An opaque pixel in the foreground will hide the pixel in the background image. Likewise, a transparent pixel in the foreground image will let the background pixel show through.
MST_Alpha_Least_OpaqueThe least opaque pixel value is chosen from the foreground and background alpha channels and is used for the foreground image.
MST_Alpha_Most_OpaqueThe most opaque pixel value is chosen from the foreground and background alpha channels and is used for the foreground image.
MST_IfDarkerMerges only pixels darker than the ones in the existing image.
MST_IfLighterMerges only pixels lighter than the ones in the existing image.
MST_NormalPixels are merged with the existing image.
MST_SubtractivePixel values are subtracted from the pixels in the existing image.
MST_SuperimposeThe image is superimposed onto the existing image. high merge percentage determines the intensity of the superimposition.
MST_Superimpose_BottomToTopThe image is superimposed onto the existing image. This produces a fading effect where the bottom of the superimposed image is lighter than the top. Here too, merge merge percentage determines intensity of superimposition.
MST_Superimpose_HorizFromCenterThe image is superimposed onto the existing image. This produces a fading effect where the top and bottom of the superimposed image are lighter than the center. Merge merge percentage determines the intensity range of the superimposition.
MST_Superimpose_HorizToCenterThe image is superimposed onto the existing image. This produces a fading effect where the center of the superimposed image is lighter than the top and bottom. High or low merge percentage determines the intensity range of the superimposition.
MST_Superimpose_LeftToRightThe image is superimposed onto the existing image. This produces a fading effect where the left side of the superimposed image is lighter than the right side. The high or low merge percentage determines the intensity range of the superimposition.
MST_Superimpose_RightToLeftThe image is superimposed onto the existing image. This produces a fading effect where the right side of the superimposed image is lighter than the left side. The high or low merge percentage determines the intensity range of the superimposition.
MST_Superimpose_TopToBottomThe image is superimposed onto the existing image. This produces a fading effect where the top of the superimposed image is lighter than the bottom. Merge percentage determines intensity of superimposition.
MST_Superimpose_VerticalFromCenterSuperimpose Vertical from Center The image is superimposed onto the existing image. This produces a fading effect where the center of the superimposed image is lighter than the right and left sides. Merge percentage determines intensity of superimposition.
MST_Superimpose_VerticalToCenterThe image is superimposed onto the existing image. This produces a fading effect where the right and left sides of the superimposed image are lighter than the center. Merge percentage determines intensity range of the superimposition.
An enumMergeStyle enumeration value.
IPTransparent
  • True Merging occurs with transparency. Pixels in the image containing the same color as transparentColor are not merged.

  • False Merging occurs with no transparency.

IPTransparentColor

A long expression that evaluates to the transparent color.

IPMergePctHi

The superimpose intensity (when IPMergeStyle = 5).

The upper range of the superimpose intensity (when IPMergeStyle = 6 through 13).

Range:  0 - 100  (percent)

IPMergePctLo

The lower range of the superimpose intensity (when IPMergeStyle = 6 through 13)

Range: 0 - 100 (percent)

Remarks

Merging combines the current image being processed (ProcessImageID) with another image that is being loaded. The resulting merged image is stored in ProcessImageID.

 

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

See Also

ImagXpress Object  | ImagXpress Members  | ProcessImageID Property  | enumMergeSize Enumeration  | enumMergeStyle Enumeration

 

 


©2018. Accusoft Corporation. All Rights Reserved.

Send Feedback