Trimming An Image Canvas With ImageUtils.cfc ColdFusion Image Component

I'm not gonna bother posting the code here, since it's in the ImageUtils.cfc RIA Forge project, but I created two new methods for trimming a ColdFusion image canvas:

TrimCanvas( Image, BackgroundColor [, Tolerance ] )

This will take a ColdFusion image object and, given the background color, it will reduce the size of the canvas to the smallest possible rectangle without hurting any of the primary image data. You can pass in an optional tolerance value. The tolerance allows some flexibility when it comes to matching the current pixel color to the given background color. The tolerance is the allowable delta in any given color channel (0 to 255).

TrimCanvasSide( Image, Side, BackgroundColor [, Tolerance ] )

This will trim just the given side of the canvas. In reality, TrimCanvas() internally calls this method four times - once per side.

These are SLOW functions. This should not be something that is done on the fly, but rather something that is done to prepare a future-static image. That being said, let's take a look at some sample code:

In this demo, we are creating a canvas with a centered circle and some text. Then we are outputting it. Then, we are trimming the canvas and outputting the smaller canvas. Running the above code, we get the following output:

As you can see, the excess "background color" was trimmed away from our original image leaving the smallest possible canvas that contained all of the primary image data. Again, this is a very SLOW function. This demo took several seconds to run and the image that we are working on is rather small. This is not something you are going to want to run all the time. Hopefully, I can think of a better, faster way to do this.

What Other People Are Searching For

[ local search ] trim coldfusion image object
[ local search ] trim image coldfusion
[ local search ] trim image canvas coldfusion
[ local search ] how to trim image coldfusion

You Might Also Be Interested In: