ColdFusion 8 Image Resize options

From time to time people will ask (either here, or cf-talk, or wherever) about the speed of ColdFusion 8's image resizing. Typically they are asking because the speed can be a bit slow. My normal response is to remind people that Adobe provided numerous ways to resize, ranging from very slow and high quality options to much quicker and less quality options. I've been meaning to write a script that would compare these resize options and I finally got a chance too this morning.

Before I go into the script, I have to apologize. I normally tell people about the resize options (called interpolation algorithms) and then point out that Adobe ships 17 choices. However I was wrong. The options are grouped into a list of values with generic terms like highPerformance or highestQuality and named ones like lanczos and hanning (which sound like Star Trek names if you ask me).

Here is where things get a bit weird. You would think there would be a one to one relation between the generic and named options. However there are more named options than generic ones. My assumption is that Adobe mapped some of the generic options to one of the named options. I created the following list would uses both the generic and named options, and should represent a move from highest quality to highest performance.

  • highestQuality
  • lanczos
  • highquality
  • mitchell
  • mediumPerformance
  • quadratic
  • mediumquality
  • hamming
  • hanning
  • hermite
  • highPerformance
  • blackman
  • bessel
  • highestPerformance
  • nearest
  • bicubic
  • bilinear

My script would go through each of these, perform a resize and see how long it took, how big the file was, and output a link to the image so I could see the quality.

In my first test using a 300k or so JPG, the highest quality resize took a huge amunt of time - close to 4 minutes. In my second test, using a larger image, it took a lot less time. The docs do say that resizing performance/result will depend on the source image, which isn't surprising, but it bares repeating I think.

Something else I noticed was that - both with the super slow to resize image and the not so slow image - I was not able to visibly tell a difference. It may be that I don't have an artist's eyes. It may also be that when I saved the image, I always used the highest quality setting (so in other words, a range of options for resizing, but always the best for saving). Based on what I saw though - at least for images to be shown on the web - I see no reason to not use the quickest resize. Of course 2 tests isn't very scientific, but it's something to keep in mind. ColdFusion defaults to the highest performance. I'd probably not use that default in my applications.

I've included the script I used below. All you have to do is modify the sourceImage line to test yourself. Here is the results from my last test:

MethodSizeTime (Seconds)
highestQuality425Kb1.703
lanczos425Kb1.703
highquality392Kb1.187
mitchell392Kb1.188
mediumPerformance392Kb1.203
quadratic367Kb0.938
mediumquality390Kb0.704
hamming390Kb0.688
hanning398Kb0.687
hermite397Kb0.703
highPerformance390Kb0.687
blackman407Kb0.687
bessel385Kb1.828
highestPerformance433Kb0.031
nearest435Kb0.016
bicubic433Kb0.032
bilinear414Kb0.031

Notice that there seems to be no real difference in file size. At most 50k or so separates them. Also notice that bessel is oddly slow compared to the algorithms near it. That may be one to avoid.

In case you want to see the images themselves (I felt they were too big to include on this blog entry), I've linked the original, highest quality, and highest performance images:

<cfscript>
/**
* Will take a number returned from a File.Filesize, calculate the number in terms of Bytes/Kilobytes/Megabytes and return the result.
* v2 by Haikal Saadh
*
* @param number Size in bytes of the file. (Required)
* @return Returns a string.
* @author Kyle Morgan (admin@kylemorgan.com)
* @version 2, August 7, 2006
*/
function fncFileSize(size) {
if ((size gte 1024) and (size lt 1048576)) {
return round(size / 1024) & "Kb";
} else if (size gte 1048576) {
return decimalFormat(size/1048576) & "Mb";
} else {
return "#size# b";
}
}
</cfscript>

<cfset methods = "highestQuality,lanczos,highquality,mitchell,mediumPerformance,quadratic,mediumquality,hamming,hanning,hermite,highPerformance,blackman,bessel,highestPerformance,nearest,bicubic,bilinear">

<cfset results = queryNew("method,size,time")>
   
<cfset sourceImage = expandPath("./DSC00014.jpg")>

<cfset finfo = getFileInfo(sourceImage)>
<cfset img = imageRead(sourceImage)>
<cfset iinfo = imageInfo(img)>

<cfdump var="#iinfo#" label="File Size in Bytes: #finfo.size#">

<cfimage action="writeToBrowser" source="#sourceImage#">

<hr/>

<cfloop index="m" list="#methods#">
   <cfoutput>
   <h2>Resize Method: #m#</h2>
   <cfset newImage = duplicate(img)>
   <cfset timer = getTickCount()>
   <cfset imageScaleToFit(newImage, 700, 700, m)>
   <cfset total = getTickCount() - timer>
   <cfset filename = m & "_" & getFileFromPath(sourceImage)>
   <cfset imageWrite(newImage,expandPath(filename),1)>
   <cfset finfo = getFileInfo(expandPath(filename))>
   <cfoutput><p>#fncFileSize(finfo.size)# bytes at #total/1000# seconds</p></cfoutput>
   <img src="./#m#_#getFileFromPath(sourceImage)#">
   </cfoutput>
   <cfset queryAddRow(results)>
   <cfset querySetCell(results, "method", m)>
   <cfset querySetCell(results, "size", fncFileSize(finfo.size))>
   <cfset querySetCell(results, "time", total/1000)>
   <cfflush>
</cfloop>

<cftable query="results" border colHeaders htmlTable>
   <cfcol header="Method" text="#method#">
   <cfcol header="Size" text="#size#">
   <cfcol header="Time (Seconds)" text="#time#">
</cftable>

Comments

James Edmunds's Gravatar VERY interesting. I wonder if you would have a different "human" evaluation of the finished images if you added ImageSetAntialiasing before the resize...
# Posted By James Edmunds | 11/1/08 10:46 AM
Raymond Camden's Gravatar According to the docs, that is for drawing and doing text on images. I'm not sure it would apply.

One thing I may want to look at is the blurFactor option for resizing. To be honest, I was a bit unsure of why you would want _any_ blur. It seems like that would be used for enlarging images only.
# Posted By Raymond Camden | 11/1/08 10:56 AM
James Edmunds's Gravatar Most of the examples in the live docs include something like this, as a matter of course:

<!--- Turn on antialiasing to improve image quality. --->
<cfset ImageSetAntialiasing(myImage,"on")>
<cfset ImageScaleToFit(myImage,100,"","lanczos")>


... although I've never seen side-by-sides that demonstrated what that improved quality was supposed to look like, or seen any other explanation of what it does beyond what you are citing from the live docs.

Hmmmmm....
# Posted By James Edmunds | 11/1/08 11:08 AM
Raymond Camden's Gravatar You are correct. From the docs:

Use the ImageSetAntialiasing function to improve the quality of the rendered image.

Testing now...
# Posted By Raymond Camden | 11/1/08 11:12 AM
Raymond Camden's Gravatar So I added this to my code:

<cfif structKeyExists(url, "aa")>
   <cfset imageSetAntiAliasing(newImage)>
</cfif>

I added it right after the first gettickcount. I tested both w/o it, and with it. The times are a bit off, but not in a significant way. To be honest, I see no difference. I thought maybe I could see it in the moss, looking closely, but I was not able to.

I'm going to try a third option now - off. I assume it is the same as not setting it at all... but I'm going to test that too.
# Posted By Raymond Camden | 11/1/08 11:16 AM
Raymond Camden's Gravatar I tested, and still can't tell. But it could be my source image. I had thought that a 'scenic' pic like that would be best for revealing problems, but maybe I'm wrong.
# Posted By Raymond Camden | 11/1/08 11:38 AM
James Edmunds's Gravatar When I do that kind of testing, I like to take a "people" portrait about 1000 pixels wide and take it down to 200 pixels or so, but I don't have anything readily on hand to demo the effects. Maybe if work quiets down next week I'll mimic the script in your posting and give it a try with that sort of image...
# Posted By James Edmunds | 11/1/08 12:49 PM
Raymond Camden's Gravatar Funny you mention people portrait. I tried a picture of me and still wasn't able to see any differences. It was of me from the waist up, not too close though.
# Posted By Raymond Camden | 11/1/08 12:58 PM
Raymond Camden's Gravatar I wonder if this test implies that - in general, quality is pretty darn good when you resize. You lose more quality when you _save_. Since I always saved at top quality, it could be why I'm not seeing as much of a change.

I should also try a GIF and TIFF too.
# Posted By Raymond Camden | 11/1/08 1:44 PM
Richard Tugwell's Gravatar This is interesting. I gave up on cfimage and went back to Efflare CFImagecr3 because of the times. Minutes for high quality, and the image quality for faster speed was poor compared with Efflare. I'm interested that you had varying results depending on the actualy image, and not the size. I'm mostly resizing images of paintings which have rather a lot of detail and colour so that may impact things, although still in the 400-500k size. Can you show me the image that took 4 minutes?
# Posted By Richard Tugwell | 11/2/08 9:13 AM
Raymond Camden's Gravatar The picture was a shot of some ships at harbor by Steven Erat (http://www.talkingtree.com). I'm trying to find it online so I can link to it there. I don't want to post it here w/o his permission. If I can't find it I'll ask him.
# Posted By Raymond Camden | 11/2/08 9:50 AM
Richard Tugwell's Gravatar Thanks Ray - Camden Harbour eh?

I'll do some tests with this image, although I'm really surprised it makes a big difference
# Posted By Richard Tugwell | 11/2/08 10:16 AM
Tom K's Gravatar Has anyone written a CFC yet which essentially replicates photoshop's save for web command?
# Posted By Tom K | 11/3/08 3:30 AM
JC's Gravatar I'd guess the blurfactor is intended mostly for reducing artifacts & shrinking file sizes when using high compression? But I'm being lazy and not actually testing it, so the max value could be like a giant gaussian blur instead of a just slightly noticable modification....
# Posted By JC | 11/3/08 6:16 AM
Raymond Camden's Gravatar @TomK: I don't use Photoshop, so I have no idea what that is. ;) But there _is_ a CFC that does a lot of common stuff. Check out imageUtils at RIAForge.org.
# Posted By Raymond Camden | 11/3/08 8:34 AM
Alirio Boquin's Gravatar Great Post, was a really help !!!

Thanks
# Posted By Alirio Boquin | 1/13/09 5:00 PM
Jon Carlson's Gravatar This post just saved me a lot of time and headaches. A massive flex image upload system I wrote last year broke once Coldfusion 8 was deployed to our servers. Seems that Coldfusion was taking forever to resize large progressive images, and would eventually just timeout. After reading this, I added a "bilinear" interpolation to the ImageResize function and it works perfectly (and without a significant drop in quality!) Thanks alot Raymond.
# Posted By Jon Carlson | 3/6/09 10:00 AM
Raymond Camden's Gravatar Glad I could help.
# Posted By Raymond Camden | 3/6/09 11:51 AM
Jules Gravinese's Gravatar I've found that in photoshop it's better to reduce images in 50% steps. It yields much better images.
For instance if your image is 1000px and you want a 100px thumbnail it would take 4 resize operations:
1000 : 50% = 500
500 : 50% = 250
250 : 50% = 125
125 : manual resize = 100
I wonder if the same is true with CFimage as well.
# Posted By Jules Gravinese | 3/10/09 8:45 AM
Raymond Camden's Gravatar Try it and tell us. :) Should be easy enough to automate in CF.
# Posted By Raymond Camden | 3/10/09 8:53 AM
Jules Gravinese's Gravatar haha yeah I've been trying to do so all day! You know what it's like to have a lot of open projects.
Maybe my next project will be something that converts ideas into time. :P
# Posted By Jules Gravinese | 3/10/09 10:32 AM
Jules Gravinese's Gravatar Show and tell:
http://www.webveteran.com/blog/index.php/web-codin...

"Sure enough, the multiple pass method in PhotoShop yields a nicer image. However, it looks like a single pass resize with CFimage looks better."
# Posted By Jules Gravinese | 3/10/09 12:23 PM
Raymond Camden's Gravatar Now of course you should also compare using the multiple resize types as well. :)
# Posted By Raymond Camden | 3/10/09 12:44 PM
Jules Gravinese's Gravatar Naahhh... why would I want a lower quality images?
# Posted By Jules Gravinese | 3/10/09 5:42 PM
Rafe's Gravatar great article, i did my own testing after reading this and can confirm those findings, and the results appeared to be very similar for gifs or jpgs (in magnitude, not actual processing times). small note, if you have fonts on your images then the difference between bilinear and highestquality does become very noticeable; for images with fonts on them i found the best low setting to be "highperformance". Maybe adjusting the antialiasing as mentioned in a comment above would improve the font output at lower levels? might be worth playing with
# Posted By Rafe | 3/31/09 9:38 PM
Sveinbjorn Gretarsson's Gravatar Great blog!
I've also been testing the ImageResize with the ImageSetAntialiasing on/off and I see no different.
My biggest probelem is to get good quality for my thumbs.
If I Resize e.g. 3504x2336 px image to 920x613 and then to 100x67 the 920x613 quality is fine (specially if I use the ImageSharpen) but the 100x67 is has poor quality.
I tryed both bilinear and the Highest Quality and the differnt was negligible in the 920 pixel image but huge in the 100 pixel thub.
Do you know any trick's to help me whit my thumbs?
# Posted By Sveinbjorn Gretarsson | 5/3/09 12:24 PM