J4L Datamatrix Vision for the Java Platform [TM]

• Introduction
• Installation
• Javadoc pages
• Examples

Installation

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

• Finding all barcodes in large images (for example in a scanned page or document)
• Supports byte, ascii , c40 and text encoding.
• Supports all formats except the following rectangular formats: C8X18, C8x32, C12X26, C12X36,, C16X36 and C16X48

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.
• Barcodes shall not be rotated

Installation

In order to use the component you only need to add rvision.jar and rdmvision.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 DatamatrixReader instance:
   
   DatamatrixReader reader=new DatamatrixReader();
   
   
   
2. 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");
   
   
3. Create a RImage instance and call the read() method of the DatamatrixReader
   
   DatamatrixData[] barcodes=reader.scan(new RImage((BufferedImage) im));
   
   
4. Read the result. The DatamatrixData objects contain the following information: Value ( of the barcode) and position ( x , y).
   
   If no barcode has been found the array returned by read() will be empty.
   

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