Java Barcode Reader Developer Guide

Java Barcode Reader Package Overview

Top

• OnBarcode.BarcodeReader.jar library for Barcode Reader
  
  
• test-src contains testing application, its souce codes and sample images.
  
  
• lib contains two jars for TIFF and bitmap image.
  
  
• Purchase-Java-Barcode-Reader.html contains link to buy OnBarcode.com Java Barcode Reader online.
  
  
• DeveloperGuide.html developer guide.

Java Barcode Reader Install & Requirement

Top

Requirement

You need Java JDK 1.4.2 or later version.

Install

Put BarcodeReader.jar into your Java project classpath.

To read Tiff and bitmap image, you need two extra jars from Sun Microsystem, see how to read barcodes from tiff and bitmap images.

How to read barcodes using Java Barcode Reader?

Top

Read barcodes from image is a simple task with barcode reader for java library.

Here is the sample code.

           String[] datas = BarcodeReader.read(new File("C:/YourBarcodeImage.gif"), BarcodeReader.EAN8);

Pass your barcode image file, and barcode type to BarcodeReader, and it will return barcode datas. Complete demo source code is under test-src folder.

Java Barcode Reader FAQ

Top

How to read barcode from a specified area (rectangle) in the image?

To improve scanning speed, you can specify a rectangle area in the image for scanning barcode.

ScanOption option = new ScanOption();
/**
* specify barcode area in the scanning image
*
* x1, y1, x2, y2, valid values are from 0 to 1, inclusive.
*
* @param x1  barcode area left top point X value, % of image width
* @param y1  barcode area left top point Y value, % of image height
* @param x2  barcode area right bottom point X value, % of image width
* @param y2  barcode area right bottom point Y value, % of image height
*/
// scan top 20% of the image
option.setScanDirection(ScanOption.SCAN_FROM_TOP_TO_BOTTOM);
option.setBarcodeArea(0, 0, 1, 0.2);
String[] datas = BarcodeReader.read(new File("C:/YourBarcodeImage.gif"), BarcodeReader.EAN8, option);

• Pass your barcode image file, and barcode type, and ScanOption object to BarcodeReader, and it will return barcode datas in the specified area from the image.

TIFF/Bitmap Image Reader

For TIFF or Bitmap image reading only, developers need include two Java Advanced Imaging jars from Sun Microsystems, jai_codec.jar, jai_core.jar. Both are included under lib folder.
To know more details about Java Advanced Imaging, please go to Java Advanced Imageing Site.

How to get supplement barcode data?

For barcode EAN 8, EAN 13, UPC-A, UPC-E, their barcode image may contain 2 or 5 digits supplement barcode, Java Barcode Reader will add supplement barcode data to the main barcode data.

For example, Java barcode reader will return data as "123450512345" for above sample image. The First 7 digits "1234505" is UPCE data, and the last 5 digits "12345" is UPCE supplement data.

About UPC-E data

For UPC-E barcode, usually there are 8 digits printed on the barcode label. The first digit is UPC-E number system, valid values are 0 or 1. The next 6 digits are UPC-E data, and the last one is checksum.

Our library will return 6 digits data and the last one checksum. Developer should use the first 6 digits as UPC-E data, according to UPC-E specification.

For the above barcode image, 0 is the number system, 123450 is the UPC-E data, and 5 is the checksum. Our library will return 1234505, plus suppliment barcode 12345. So the final output will be 123450512345.

Support Multi-page Tiff File

For multi-page tiff file, Java barcode reader will scan every page in the file, and return all barcodes in all pages.