ImageGrayscale

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