J4L Barcode Vision for the Java Platform [TM]

• Introduction
• Installation
• Javadoc pages
• Examples

Installation

J4L Barcode Vision is a Java component which can read (scan) barcodes images. It support the following features:

• Finding all barcodes in large images (for example in a scanned page or document)
• Barcodes can have any orientation (vertical, horizontal, rotated)
• Supported barcode symbologies are: EAN13, EAN8, CODE128/EAN128, CODE39 (and extended) , INTERLEAVED 25, IDENTCODE, UPCA , UPCE .... (more can be devoloped on demand)

The requirements are:

• Java 1.4 or 1.5 (let us know if you need a version for 1.3 or 1.2)

Know limitations are:

• Best result are achieved with black barcodes on white background.
• Shadowed or blurred barcodes can be unreadable.

Installation

In order to use the component you only need to add rvision.jar to your classpath. If you need to scan large images and get a outOfMemory error you will need to increase the Java heap Size using the Java.exe parameter -Xmx.

Javadoc pages

The Javadoc pages are located in the javadoc subdirectory of the component's ZIP file.

Examples

The use of the component is very simple. You must follow these steps:

1. Create a Barcode1DReader instance:
   
   Barcode1DReader reader=new Barcode1DReader();
   
   
2. Set the symbologies you expect to find in the image:
   
   
   // we will be looking for code 128 and code 39 barcodes
   reader.setSymbologies(Barcode1DReader.CODE39 | Barcode1DReader.CODE128);
   
   
3. Load your image into a BufferedImage class. The application Sample.java includes a method called loadImage() you can use for this purpose.
   
   Image image=loadImage("myFile.gif");
   
   
4. Create a RImage instance and call the scan() method of the Barcode1DReader
   
   BarcodeData[] barcodes=reader.scan(new RImage((BufferedImage) im));
   
   
5. Read the result. The BarcodeData objects contain the following information: Symbology (type of barcode), Value ( of the barcode) and position ( x , y).
   
   If no barcode has been found the array returned by scan() will be empty.
   

The component includes a simple test program called Sample.java that will scan all file located in the images subdiretory.