imageSharpen

Description

Sharpens a ColdFusion image by using the unsharp mask filter.

History

ColdFusion 8: Added this function.

Syntax

ImageSharpen(name [, gain])

Attributes

Attribute	Description	Required	Default
gain	Optional. -1 <= gain <= 2. Gain values can be integers or real numbers. The default value is 1.0. The value determines whether the image is blurred or sharpened: If > 0, the image is sharpened. If = 0, no effect If < 0, the image is blurred.
name	Required. The ColdFusion image on which this operation is performed.

Returns

Nothing.

Usage

Use this function to sharpen outlines in photographs. Use the ImageSetAntialiasing function to improve the quality of the rendered image.

Example

<!--- Create a ColdFusion image from an existing JPEG file. ---> 
<cfimage source="../cfdocs/images/artgallery/paul01.jpg" name="myImage"> 
<!--- Turn on antialiasing to improve image quality. ---> 
<cfset ImageSetAntialiasing(myImage,"on")> 
<!--- Sharpen myImage by 2. ---> 
<cfset ImageSharpen(myImage,2)> 
<!--- Write the sharpened image to a file. ---> 
<cfimage source="#myImage#" action="write" destination="test_myImage.jpg" overwrite="yes"> 
<!--- Display the original and the sharpened images. ---> 
<img src="../cfdocs/images/artgallery/paul01.jpg"/> 
<img src="test_myImage.jpg"/>

cfmldocs