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

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
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
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
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
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
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
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
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
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
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
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
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
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
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
@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