This project is based on the CodeProject article: Reading Barcodes from an Image - II by qlipoth. I asked and got permission from qlipoth to publish an enhanced version of his code.
My company has a need for reading barcodes from images that also contain text on the same page as the barcode(s). When searching for a solution in C#, I found qlipoth's CodeProject article: Reading Barcodes from an Image - II. His code came a long way towards what I wanted, but I needed a few improvements. In the end, my changes amounted to a significant rewrite that justifies a new CodeProject publication.
This code has several improvements compared to the original code written in 2005:
- Validation is added for Code39 barcodes. The code has much less chance of detecting a "barcode" that is not actually present.
- Detection speed is improved. The main problem in the original project was that it used
Bitmap.RotateFlip, and that function is quite slow.
- Added EAN/UPC and Code128 barcode support. The original project could only detect Code39 barcodes.
- Fixed some bugs that were reported for qlipoth's project and for the related project Reading Barcodes from an Image published by Benjamin Liedblad in 2004.
Using the code
To open the solution, you'll need Visual Studio 2008. However, I have not used any constructs that are not .NET 1.1 compatible, so the actual code should also be compilable in Visual Studio 2003 or 2005.
To use the code, call
ScanPage with the Windows
Bitmap object containing your image. The included TestApp (written in VB.NET) demonstrates the basic use:
Dim barcodes As New System.Collections.ArrayList
BarcodeImaging.FullScanPage(barcodes, Me.PictureBox1.Image, 100)
If barcodes.Count > 0 Then
numscans parameter in both functions indicates how many bands of pixels should be scanned across or down the image. With a higher number, the code finds more barcodes, but of course, will also run slightly slower. Usually 50 - 100 scans will be OK to find all barcodes on a full page image.
Difference between FullScanPage and ScanPage
FullScanPage always scans horizontally and vertically, and attempts to detect all supported barcode types. If you know that your input material is always scanned in the same orientation, or if you do not need detection of all barcode types, you can make your program run faster by using
public static void ScanPage(ref System.Collections.ArrayList CodesRead,
Bitmap bmp, int numscans, ScanDirection direction, BarcodeType types)
With the additional parameters
types, you can fine-tune barcode detection:
direction: can be
Vertical for detecting barcodes with vertical bars, or
Horizontal if you expect barcodes that are rotated 90 degrees.
BarcodeType.All to detect all supported barcode types, or you can specify one or more specific barcode types, like this:
ScanPage(ref CodesRead, bmp, numscans, ScanDirection.Vertical,
BarcodeType.Code39 | BarcodeType.Code128);
Supported types are Code39, EAN, and Code128. The EAN reader will also detect UPC codes.
Points of interest
- The EAN reader also reads the 2 or 5 digits supplemental barcodes often found on books and periodicals. As shown in the screenshot, a supplemental barcode will be returned as a separate barcode string starting with "S".
- The Code128 reader has mixed code page support. The serial number in the sample image Code128test-CodeC.png starts as Code C, but the last digit is added as Code B.
- The code uses a more advanced approach for measuring the "narrow bar width" than qlipoth's and Liedblad's versions. This should allow for better detection rates when reading EAN and Code128. In Code39, we only need to distinguish between narrow and wide bars, but the other barcode types use four different bar widths.
- I have added the concept of "barcode zones", to allow detection of differently scaled barcodes on the same scan line. In Code128test-CodeC.png, this enables the software to read both the serial number and the UPC code that are printed side-by-side.
I used the following references while writing this project:
- For implementing EAN detection: Wikipedia articles on the European Article Number, EAN-2, and EAN-5.
- For implementing Code 128: the character table and checksum calculation as published on code128barcodes.com, and the barcode generator published by IDAutomation.com Inc., for testing.
- October 5, 2009: Original.
- October 19, 2009: Improved Code39 detection, bugfixes. Added VB.NET translation of the barcode detection class and the COM interface provided by Alessandro Gubbiotti.