Description

Inverts the pixel values of a ColdFusion image.

Returns

Nothing.

Category

Image functions

Function syntax

ImageNegative(name)

See also

ImageBlur, ImageGrayscale, ImageSetAntialiasing, ImageSharpen, IsImageFile

History

ColdFusion 8: Added this function.

Parameters

Usage

The resulting image has the same dimensions of the source image, but not necessarily the same number bytes. Use the ImageSetAntialiasing function to improve the quality of the rendered image.

Example

<!--- This example shows how to create a negative version of an image. --->
<!--- Create a ColdFusion image from and existing JPEG file. --->
<cfimage source="../cfdocs/images/artgallery/jeff05.jpg" name="myImage">
<!--- Turn on antialiasing to improve image quality. --->
<cfset ImageSetAntialiasing(myImage,"on")>
<!--- Create a negative version of the image. --->
<cfset ImageNegative(myImage)>
<!--- Save the modified image to a file. --->
<cfimage source="#myImage#" action="write" destination="test_myImage.jpg" overwrite="yes">
<!--- Display the source image and the negative image. --->
<img src="../cfdocs/images/artgallery/jeff05.jpg"/>
<img src="test_myImage.jpg"/>