Whatever message this page gives is out now! Go check it out!

ImageNegative

Last update:
May 18, 2026

Description

Inverts the pixel values of a ColdFusion image.

Returns

Nothing.

Category

Function syntax

ImageNegative(name)

See also

History

ColdFusion 8: Added this function.

Parameters

Parameter
Description
name
Required. The ColdFusion image on which this operation is performed.

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"/>

Share this page

Was this page helpful?
We're glad. Tell us how this page helped.
We're sorry. Can you tell us what didn't work for you?
Thank you for your feedback. Your response will help improve this page.

On this page