Description: Reads an existing image handle and produces a new one with modifications. The original image is not altered. Returns invalid upon failure.
Returns: Image
Usage: Script
Format: ModifyBitmap(Handle[, Reflect, Hue, Saturation, Lightness, Transparency, Contrast, Colorize, ColorizeHue, ColorizeSaturation, AntiAlias] )
Parameters: Handle { Bitmap } { required } { no default }
The image handle to copy and modify.
Reflect { Boolean } { optional } { default: 0 }
Any logical value that can be set to 1 to reflect the image about the vertical axis. The default is no reflection.
Hue { numeric } { optional } { default: 0 }
The hue rotation to apply to all of the colors in the image. Range -180 to 180. The default is no hue rotation.
Saturation { numeric } { optional } { default: 1 }
A multiplier to the intensity of each primary color component of every color in the image. Range: 0+.
Lightness { numeric } { optional } { default: 0 }
A multiplier to the brightness of the image. Range 0+.
Transparency { numeric } { optional } { default: 1 }
A multiplier to the transparency (alpha value) of every color in the image. Range 0 to 1 (opaque).
Contrast { numeric } { optional } { default: 1 }
Enhances the differences between the colors in the image. Range 0+.
ColorizeHue { numeric } { optional } { default: 0 }
Hue value of a color to be mixed with every color in the image. Range -180 to 180.
ColorizeSaturation { numeric } { optional } { default: 0 }
Intensity of the added color. Zero means that no color is added. Range 0-1.
AntiAlias { Boolean } { optional } { default: 0 }
Set to 1 to enable anti-aliasing when the image is stretched.
.
Comments: Some image modifications have a greater performance impact than would typically be assumed, due to the way image rendering is optimized. Scaling and cropping changes are slow, for example
See Also: