This method pastes a raster image into another raster image.
Parameters
bottomImage
The handle of the bottom image. This is the
image onto which another image is pasted (supports 1, 4, 8, 16, 24,
32 bit images)
angle
Angle of rotation (-35999 to 35999, in 1/100
degree units)
xTurn
Reversal of the x axis (False(0): no reversal,
True (nonzero): reversal)
yTurn
Reversal of the y axis (False(0): no reversal,
True (nonzero): reversal)
transLevel
The level of transparency (from 0 to 255, as this
value increases, the top image becomes visible)
transColor
Sets whether or not there is a transparent color
in the top image
(False(0)No transparent color,
True(nonzero):transparent color)
transRed
Sets the red component of the transparent color
in the top image (from 0 to 255)
transGreen
Sets the green component of the transparent color
in the top image (from 0 to 255)
transBlue
Sets the blue component of the transparent color
in the top image (from 0 to 255)
backRed
Sets the red component of the background
color.
This color is drawn in the area not in either the top
image bottom image (from 0 to 255)
backGreen
Sets the green component of the background
color.
This color is drawn in the area not in either the
top image bottom image (from 0 to 255)
backBlue
Sets the blue component of the background
color.
This color is drawn in the area not in either the
top image bottom image (from 0 to 255)
x,y
The attachment coordinates (in pixels)
Clip
Sets whether or not the image is clipped
(False(0): no clipping, True (nonzero): clipping)
Return Value
Returns True if successful. Returns False if unsuccessful.
Explanation
The PasteImage method pastes one raster image into another raster image. The bottom image, (the image that another image is pasted into) is set into the BottomImage parameter. The image you want to paste into the bottom image is set in the LayerNumber property (either the Image property or the Layer(LayerNumber).Image property). If using a mask image (to determine an area on the image to be processed), then set the image handle of the mask image in the SourceMask property. The PasteImage method supports 1, 4, 8, 16, 24, 32 bit images.
If the PasteImage method is successful and the DestinationAsImageKitImage property is True, the resulting image will be set in the Image property or in the Layer(LayerNumber).Image property, according to the value set in the LayerNumber property.
If the PasteImage method is successful and the DestinationAsImageKitImage property is False, the resulting image will be set in the DestinationImage property.
The Angle, xTurn, and yTurn parameters apply to the images in the LayerNumber property and SourceMask property. The x,y parameters determine the coordinates on the bottom image (the image in the bottomImage parameter) where the CENTER of the LayerNumber and SourceMask images are pasted. When the Clip parameter is True, the result is the same size as the bottom image (the image in the BottomImage parameter) and any excess is clipped. When the TransColor parameter is True, the color specified in the TransRed, TransGreen and TransBlue parameters is transparent.
Regarding the bitcount of the created image: If the bottomImage and the pasted image are both 8 bit less and they are the same bitcount, and they use the same palette, then the created image will be that bitcount and that palette. If the bottomImage and the pasted image are both 8 bit less but they are a different bitcount, or they use a different palette, then the created image will be 24 bit color. If the bottomImage and the pasted image are 16 bit or more, then the created image will be same bitcount as the image with the largest bitcount.