Ben Nadel
On User Experience (UX) Design, JavaScript, ColdFusion, Node.js, Life, and Love.
I am the chief technical officer at InVision App, Inc - a prototyping and collaboration platform for designers, built by designers. I also rock out in JavaScript and ColdFusion 24x7.
Meanwhile on Twitter
Loading latest tweet...
Ben Nadel at Scotch On The Rock (SOTR) 2010 (London) with:

Trimming An Image Canvas With ImageUtils.cfc ColdFusion Image Component

By Ben Nadel on
Tags: ColdFusion

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:

  • <!--- Create the image utils object. --->
  • <cfset objImageUtils = CreateObject(
  • "component",
  • "imageutilsroot.imageUtils"
  • ).Init()
  • />
  •  
  •  
  • <!--- Create a large, off-white canvas. --->
  • <cfset objImage = ImageNew(
  • "",
  • 300,
  • 300,
  • "argb",
  • "##F5F5F5"
  • ) />
  •  
  • <!--- Set the drawing color. --->
  • <cfset ImageSetDrawingColor(
  • objImage,
  • "##FF9900"
  • ) />
  •  
  • <!--- Draw a circle in the middle of the canvas. --->
  • <cfset ImageDrawOval(
  • objImage,
  • 100,
  • 100,
  • 100,
  • 100,
  • "yes"
  • ) />
  •  
  • <!--- Set up our font properties. --->
  • <cfset objFont = {
  • Size = "20",
  • Font = "Arial Black"
  • } />
  •  
  • <!--- Draw text. --->
  • <cfset ImageDrawText(
  • objImage,
  • "MY FIRST CIRCLE",
  • 45,
  • 250,
  • objFont
  • ) />
  •  
  •  
  • <p>
  • <!--- Write image to browser. --->
  • <cfimage
  • action="writetobrowser"
  • source="#objImage#"
  • />
  • </p>
  •  
  •  
  •  
  •  
  •  
  • <!--- Trim the canvas. --->
  • <cfset objImage = objImageUtils.TrimCanvas(
  • objImage,
  • "##F5F5F5"
  • ) />
  •  
  • <p>
  • <!--- Write image to browser. --->
  • <cfimage
  • action="writetobrowser"
  • source="#objImage#"
  • />
  • </p>

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:


 
 
 

 
Trimming ColdFusion Image Canvas - Before Trimming  
 
 
 

 
 
 

 
Trimming ColdFusion Image Canvas - After Trimming  
 
 
 

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.




Reader Comments

Post A Comment

You — Get Out Of My Dreams, Get Into My Comments
Live in the Now
Oops!
Comment Etiquette: Please do not post spam. Please keep the comments on-topic. Please do not post unrelated questions or large chunks of code. And, above all, please be nice to each other - we're trying to have a good conversation here.