CIB ocr technical manual (EN)

This property sets the name of the outputfile to which values of all barcodes found in the inputfile are written. 
The property BarcodeOutputFilename is optional, if it is empty - BarcodeValueLength  and BarcodeValue are used . 
For format/extension look at OutputFormat  

The format of this file is given by “BarcodeOutputType ”. 

Syntax 

BarcodeOutputFilename=<filename> 
<filename>:name.ext 

default=No input, BarcodeValueLength and BarcodeValue are used . 

 Example 

BarcodeOutputFilename=barcodes.txt 

This property defines whether the output should  be in memory or to file. 
This property is automatically set depending on whether BarcodeOutputFilename is set  or not. If BarcodeOutputFilename is set ,  then BarcodeO utputType=File is set,  otherwise  BarcodeOutputType=Memory .   

Syntax 

BarcodeOutputType=<type> 
<type>: File | Memory  

default=File 

Example 

BarcodeOutputType=File 

With this property it is set that a search for barcodes is only applied on a defined rectangle. 

If a barcode is always situated on the same area of each page , performance is improved by limiting  the  search for barcodes to this area.  
Th is area (= rectangle) is defined by two basic points (left ,top and right,bottom).  
Point of origin is the top-left corner of the page,  the unit is  pixel.  

Syntax 

BarcodeRegion=<rectangle> 
<rectangle>: <left> ";" <top> ";" <right> ";" <bottom> 

default=No input 

The whole page is scanned if no input is done or rectangle given by coordinates is empty. 

Example 

BarcodeRegion=10.5;50;100.0;200.5 

When this property is set, checksum is not considered  when reading a barcode. 

The property can be used for barcodes Code39 , Code39Extended and Code128   

Syntax 

BarcodeRemoveChecksum=<value> 
<value>: 0 | 1 

default=0 
(Checksum is not cut off). 

Example 

BarcodeRemoveChecksum=1 

When this property is set, the page-number of the inputfile where this barcode was found is added to each output barcode from  property “BarcodeValue”. 

Syntax  

BarcodeShowPageNumber=<value> 
<value>: 0 | 1  

default=0 
(No output of page-number). 

Example 

BarcodeShowPageNumber=1 
Afterward property „BarcodeValue“ contains e.g. 
BARCODE:1;DATAMATRIX;00011122233344455566677788;BARCODE:2;DATAMATRIX;899374032904908

For Datamatrix only. 

Defines that search is stopped after retrieving N th barcode. 

Syntax 

BarcodeStopAfter=<value> 
<value>: 1 to N 

default=”” 
No value set means that search continues until the end of inputfile. 

Example 

BarcodeStopAfter=5 

Search stops after retrieving 5th barcode.

This property specifies the type of barcode which is to be searched. 
 

Syntax  

BarcodeType = < onebarcodetype>  

<onebarcodetype>= "DataMatrix" | "Code128" | "Code39" | "Code39Extended" | "QR" 

For Datamatrix only. 

This property  specifies the time (in milliseconds) when CIB  ocr stops looking for more barcode-candidates in the inputfile. 

Syntax 

BarcodeTimeout=<value>
<value>:1 to N  

default=The whole inputfile is processed  to find all barcode-candidates, neglecting the time it takes.  

Example 

BarcodeTimeout=50 

This property contains a list of all barcodes found in the  input-image-file. 
BarcodeValueLength is  necessary to define the  size of the output buffer.  

Syntax of output: 

[BARCODE :[pagenumber;]BarcodeType;TextValue;] 

Example 

BARCODE:DATAMATRIX;00011122233344455566677788 

This property contains the length of the output result and thus gives the required size of output buffer.  

Syntax of output: 

[integer] (string representation)  

Example 

1000 

default=10 

Example 

DatamatrixAngleDeviation=20 

For Datamatrix only. 

This property sets a factor for shrinking a high resolution image internally. 
This sometimes provides a dramatic performance benefit  as the amount of pixels of a page is minimized. It especially helps when  an image has  high resolution but blurry focus.  

Syntax  

DatamatrixShrinkingFactor=<value>
<value>: 1 to N  

Default: 1  
(no change of original resolution) 

Example 

DatamatrixShrinkingFactor=2 

Means resolution is divided in half. 

For Datamatrix only. 

This Property allows specifying the size of the gaps in the grid pattern (using pixels). 

Increasing the gaps (e.g. to 100) can improve performance, but  if the grid is too coarse it may cause that  the barcode is no t found at all. 

Syntax 

DatamatrixScanGap=<value>
<value>: 1 to N 

default=1 

Example 

DatamatrixScanGap=50

For Datamatrix only. 

Lowering the threshold can increase the number of features to be scanned, but thereby slows performance. But this  may be necessary if the image is blurry or has low contrast.  
Sometimes lowering the threshold will actually improve performance if thereby a good barcode candidate  is found more quickly than otherwise. 

Syntax 

DatamatrixThreshold=<value>
<value>: 1 to 100  

default=5 

Example 

DatamatrixThreshold=10 

Weak edges below threshold 10 are ignored. 

(From CIB ocr version 2.4.0) 

Property for tuning of barcode recognition (ZBar functionality). 

Syntax 

ZBarConfig
        =config_
        line1[;config
        _line2[;config_line3...]] 

Example 

ZBarConfig=code39.enable