ColdFusion Muse

Handling Faxes and 2D Barcodes in Coldfusion 8

Mark Kruger December 12, 2007 11:10 AM Coldfusion 8 Comments (9)

I have a secret that has nothing to do with underwear. People think I'm pretty smart but the truth is that I'm surrounded every day by talented developers who know how to solve problems and find innovative solutions. Just rubbing shoulders with people like that tends to increase my level of knowledge and ability. Among those people is Ryan Stille, a Coldfusion and Linux Guru who has added tremendously to the wealth of knowledge here at CF Webtools. In the last few days Ryan has managed to piece together a cost effective and innovative solution for a customer who wishes to handle incoming faxes in Coldfusion. Eventually he will post a CFC on his blog - but meanwhile I wanted to explain the problem and the elegant solution involved.

Just the Fax Ma'am

A customer of ours has subscription users who log into his system. The customer wanted his users to be able to get documents into their account using fax. Somehow the arriving faxes (in digital form) would be read by the system and placed in the users account.

We set up VOIP trunks into our asterisk server so that incoming faxes arrived as PDF files. So far so good - we had the faxes in digital format. The next hurdle was how to figure out who the user was from the cover sheet. There were a variety of hurdles to overcome.

  • File size and Images - Even though we were only concerned with the first page the PDF was basically n number of pages each containing what amounted to an embedded tiff or jpg file. How do we "get at" just the first page.
  • Information Encoding - What do we put on the cover sheet that is machine "readable" and will survive the fax process. Faxes are dirty, inexact machines. The result is often quite imperfect.
  • Cost and Time - We found some commercial Optical Character Recognition software (OCR) on the market along with some OCR open source projects. Nothing we looked at seemed cost effective or simple enough to make for an elegant solution.
  • Weight Gain - I have been gaining weight. Ok, this is really not a problem with our fax solution but I thought I'd throw it in here to see if you are paying attention.

Coldfusion developer Jim Rising suggested on the CF-Talk list that we look into using a 2D bar code. If you are not familiar with a 2D barcode (or a "data matrix" as it is sometimes called), it looks like this:

Jim also pointed us to a company called Java4Less, which had some commercial components for less than 120.00. We decided to experiment to see how easy it would be to use them in Coldfusion. Before Ryan tried his hand I came up with a few attempts using the sample Java application I found along with the docs for the object. The problem I ran into was that I could not get a "bufferedImage" object populated to use in creating an "RImage" object (a specific custom class needed by the reader).

I won't give away Ryan's thunder but let's just say that he was able to overcome this hurdle and several others (including some very tricky issues with channels) using CF8's new "CFIMAGE" tag and the various image functions now native to Coldfusion:

  • ImageGetBufferedImage( ) - not surprisingly, this function fixed my problem with getting a Buffered image object populated.
  • ImageGetWidth() and ImageGetHeight()
  • ImageCopy()
  • ImageNew()
  • ImagePaste() - I had no idea we would ever need this one.
It almost seemed like Coldfusion 8 had anticipated our need to accomplish this very task.

Image Thumbnail

One more little tip I'll leave you with. Remember how one of our hurdles was figuring out how to get at the embedded image on the first page. The new "Cfpdf" tag came to our rescue. Since Ryan knew that the barcode was on the first page of the fax, he simply created a thumbnail of the first page using CFPDF. The code looks like this:

<cfpdf     action="thumbnail"

This code made a PNG file 100 percent in size that could be read by our reader class.


To recap our solution, using a combination of Coldfusion 8's image functions, Cfpdf, and CFImage combined with two commercial jar files from Java4Less we were able to write 2D bar codes encoded with user account tokens onto a printable cover sheet, and then read the 2D bar codes from incoming faxes. This allowed us to deliver faxes directly to a users account. I'd have to say that rocks.

Stay tuned. When Ryan finishes the CFC code he will post it for download. Using the CFC and a licensed copy of the datamatrix and RVision objects you will be able to handle 2D encoding and decoding from within Coldfusion.

  • Share:

Related Blog Entries


  • Adrian J. Moreno's Gravatar
    Posted By
    Adrian J. Moreno | 12/12/07 10:54 AM
    Mark, could that CFC work with as well?
  • Jim Rising's Gravatar
    Posted By
    Jim Rising | 12/12/07 12:00 PM
    barbecue doesn't support datamatrix, which for faxes is really a lot more robust than any of the 1d barcodes. i wouldn't think it would be hard to build a wrapper around barbecue, but it looks like ryan went with wrapping the Java4Less api instead to take advantage of the datamatrix capabilities.

    keep in mind also that the Java4Less vision api supports reading datamatrix barcodes as well as creating them, so you have a very inexpensive solution being made available by these guys. i think it's worth supporting.
  • Jim Rising's Gravatar
    Posted By
    Jim Rising | 12/12/07 12:06 PM
    not to mention that the datamatrix barcode just looks cool. :)
  • Fro's Gravatar
    Posted By
    Fro | 12/12/07 8:21 PM
    That sounds amazing Mark. I think this will work perfectly to enhance, if not completely automate, one of our processes. I'll be looking forward to Ryan's post about it.
  • Troy Allen's Gravatar
    Posted By
    Troy Allen | 12/13/07 8:11 AM
    Great stuff...please post a comment to this entry when Ryan posts the solution (I have subscribed to this thread). THANKS!
  • Ryan Stille's Gravatar
    Posted By
    Ryan Stille | 12/15/07 2:04 PM
    I've released the cfc wrapper, you can read more about it here:
  • Nadav Givoni's Gravatar
    Posted By
    Nadav Givoni | 10/6/09 3:27 PM
    I was wondering if anyone experienced a situation where the JAVA object couldn't read the barcode due to the fact that the Fax image was degraded?
  • Mark Kruger's Gravatar
    Posted By
    Mark Kruger | 10/6/09 4:03 PM

    Yes... this is a common problem. Noisy fax lines can produce substandard images. There is not a lot you can do about it. You can try increasing the size of the image.
  • Nadav Givoni's Gravatar
    Posted By
    Nadav Givoni | 10/6/09 8:13 PM
    Mark, thanks for your quick response. I went ahead and added a cfimage process to increase the size of the thumbnail about 400% and it seemed to do the trick. I'd be nice if that cfpdf allowed you to do that, but no dice. I'll post if I find any other issues. Thanks again.