Description

Sharpens a ColdFusion image by using the unsharp mask filter.

Returns

Nothing.

Category

Image functions

Function syntax

ImageSharpen(name [, gain])

See also

ImageBlurImageSetAntialiasingIsImageFile

History

ColdFusion 8: Added this function.

Parameters

Parameter

Description

name

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

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.

Usage

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

Example

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

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