ImageBlur

Description

Smooths (blurs) the ColdFusion image.

Returns

Nothing.

Category

Image functions

Function syntax

ImageBlur(name [, blurRadius])

See also

ImageSharpen, IsImageFile

History

ColdFusion 8: Added this function.

Parameters

Parameter

Description

name

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

blurRadius

Optional. The size of the blur radius.

Value must be greater than or equal to 3 and less than or equal to 10. The default value is 3.

Usage

The blurRadius operation affects performance: as the blurRadius value increases, performance decreases.

Example

<!--- This example shows how to blur an image by a radius of 10. ---> 
<!--- Create a ColdFusion image from an existing JPEG file. ---> 
<cfimage source="../cfdocs/images/artgallery/jeff05.jpg" name="myImage"> 
<!--- Use the maximum blur radius to blur the image. ---> 
<cfset ImageBlur(myImage,10)> 
<!--- Save the modified ColdFusion image to a JPEG file. ---> 
<cfimage source="#myImage#" action="write" destination="test_myImage.jpeg" overwrite="yes"> 
<!--- Display the source image and the new image. ---> 
<img src="../cfdocs/images/artgallery/jeff05.jpg"/> 
<img src="test_myImage.jpeg"/>