Description

Converts a ColdFusion image to grayscale.

Returns

Nothing.

Category

Image functions

Function syntax

ImageGrayscale(name)

See also

ImageBlurImageNegativeImageSetAntialiasingImageSharpenIsImageFile

History

ColdFusion 8: Added this function.

Parameters

Parameter

Description

name

Required. The ColdFusion image on which this operation is performed.

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

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy