imageGrayscale

Description

Converts a ColdFusion image to grayscale.

Categories

Image Functions

Related

imageBlur imageNegative imageSetAntialiasing imageSharpen isImageFile

History

ColdFusion 8: Added this function.

Syntax

ImageGrayscale(name)

Attributes

AttributeDescriptionRequiredDefault
nameRequired. The ColdFusion image on which this operation is performed.

Returns

Nothing.

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