Description

Converts a ColdFusion image to grayscale.

Returns

Nothing.

Category

Image functions

Function syntax

ImageGrayscale(name)

See also

ImageBlur, ImageNegative, ImageSetAntialiasing, ImageSharpen, IsImageFile

History

ColdFusion 8: Added this function.

Parameters

Usage

Use the ImageSetAntialiasing function to improve the quality of the rendered image.

Example

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