imageResize

Resizes a ColdFusion image.

imageResize(name, width, height, interpolation, blurfactor) → returns void

Member Function Syntax

someImage.resize(width, height, interpolation, blurfactor)

  1. CFDocs
  2. Functions
  3. ColdFusion 8 New Functions and Tags
  4. imageResize
  5. CF8+
  6. Lucee4.5+
  7. 0 Issue
  8. Edit
See Also:   imageCrop   imageScaleTofit

Argument Reference

name string
Required

The image on which this operation is performed.

width numeric
Required

New width of the image. If this value is blank, the width is calculated proportionately to the height.

height numeric
Required

New height of the image. If this value is blank, the height is calculated proportionately to the width.

interpolation string

The interpolation method for resampling. You can specify a specific interpolation algorithm by name (for example, hamming), by image quality (for example, mediumQuality), or by performance (for example, highestPerformance).
Values:
  • highestQuality (default)
  • highQuality
  • mediumQuality
  • highestPerformance
  • highPerformance
  • mediumPerformance
  • nearest
  • bilinear
  • bicubic
  • bessel
  • blackman
  • hamming
  • hanning
  • hermite
  • lanczos
  • mitchell
  • quadratic

blurfactor boolean

The blur factor used for resampling. The higher the blur factor, the more blurred the image (also, the longer it takes to resize the image).
Values:
  • 1-10

Examples
Sample code invoking the imageResize function

This example shows how to resize an image to 50% of original size and resize it proportionately to the new width. Notice that the height is blank. 

<cfset myImage=imageNew("http://www.google.com/images/logo_sm.gif")> 
 <cfset imageResize(myImage,"50%","","blackman",2)> 
 <!--- Save the modified image to a file called "test_myImage.jpeg" and display the image in a browser. ---> 
 <cfimage source="#myImage#" action="write" destination="test_myImage.jpeg" overwrite="yes"> 
 <!--- Display the source image and the thumbnail image. ---> 
 <img src="http://www.google.com/images/logo_sm.gif"/> 
 <img src="test_myImage.jpeg"/>

CF 11+ Resize an image

imgObj = imageRead("http://cfdocs.org/apple-touch-icon.png");
imgObj.resize(50,50);
cfimage(action="writeToBrowser", source=imgObj);

Signup for cfbreak to stay updated on the latest news from the ColdFusion / CFML community. One email, every friday.

Fork me on GitHub