TBR Wizard
TBR Wizard is an application that identifies the best TBR Code(s) to maximize the recognition rate or speed for your typical images.
Using TBR Wizard
Installation
Download TBR Wizard:
Basic examples
Find the best TBR code to read the pdf417 barcode from a file:
Find the best TBR code to read code39 and code128 barcodes from TIF and PDF files in a folder:
See TBR Wizard Reference for a complete list of command line options.
TBR Wizard Results
TBR Results present the following essential information.
- TESTED TBR is a list of analyzed TBR codes. If -tbr option is not set, this is a list of valid TBR codes for the specified -type.
- RECOMMENDED TBR is one or more TBR codes that read a maximum number of barcodes in the shortest time.
- Alternative TBR is a list of TBR codes that read a similar number of barcodes but slower than RECOMMENDED TBR.
Additional intermediate data are available by setting a -verbosity option.
TBR Wizard results are based on real-time measurements. Actual timing varies between TBR Wizard sessions; therefore, the preferred and alternative codes might change between sessions.
An example of TBR Wizard results:
Using TBR Wizard results
Activate recommended TBR codes in your Inlite Products:
- ClearImage SDK - Set the TbrCode property of the readers. If multiple TBR codes are recommended, use one of the methods:
- Repeat reading operations with each TBR code
- Barcode Reader CLI - Set the -tbr option. To use multiple TBR codes, set them as a comma-separated list.
The external TBR mechanism is available for all Inlite Products to:
- Override default processing
- Read using multiple TBR codes
The following considerations affect the utilization of the TBR Wizard recommendations.
- TBR technology employs sophisticated image processing algorithms, which consume more CPU cycles than the default algorithms. Consequently, recognizing marginal, poor-quality images may require more time to read more barcodes.
- The analysis of the TBR Wizard provides statistical data, which enables the user to balance speed vs. recognition rate.
- If multiple barcode-type groups are used, combine the recommendations of the TBR Wizard for each of the groups. Each group is processed separately, thus adding time to the total reading time.
- Actual recognition speed in production reader mode can be faster than the TBR Wizard measurements because:
- Inlite's Barcode Readers can run multi-threaded, using available CPUs. However, TBR Wizard runs as single-threaded to perform accurate timing measurements.
- Inlite's Barcode Readers can limit the number of barcodes found on a page. On the other hand, TBR Wizard tries to find all barcodes on a page.
Reference
Command line format
Where:
options - options specified in this document. See option rules
sources - files, folders, or URLs identifying input files
configuration-file - zero one or more configurations files
Source
The source parameter specifies the location of image files to read barcodes from. Multiple sources can be specified. Sources can be:
- Local image file
- Local folder
The rules for source values are:
- The value of the source should use UTF-8 to represent non-English file names.
- The value containing spaces should be enclosed in double quotes ("")
Options
Option rules
- Options are specified as -name=value, except
- If the value is described as a list, zero or more valid values can be set. A comma should separate multiple values. No spaces are allowed in the list.
- All options (except -type) are optional.
Reader options
Reader options configure the barcode reader parameters to be applied to a source.
Name | Value Description | Default | Valid values |
|---|---|---|---|
-type -t | Required. List of barcode types | | code39 code128 codabar ucc128 code93 upca ean8 upce ean13 i25 datamatrix pdf417 drvlic qr imb bpo aust sing 4state patch |
-tbr | List of TBR Codes | 0 | Valid TBR codes for a given type are displayed by the TBR Wizard |
-dir | List of barcode directions | all | all horz vert |
-type option is a comma-separated list of barcodes to analyze. All specified types should belong to only one of the following groups:
- code39 code128 codabar ucc128 code93 upca ean8 upce ean13 i25
- datamatrix
- pdf417
- qr
- imb bpo aust sing 4state
- patch
-tbr option is a comma-separated list of TBR codes TBR Wizard will analyze. If not set, all valid TBR codes for the selected group will be evaluated.
Source options - Multi-page file format
This option control processing of multi-page file formats: PDF, TIFF, GIF
Name | Value Description | Default | Valid values |
|---|---|---|---|
-pages | List of page selectors to limit reading to a set of pages. NMB is an explicit page number (1-based) START is an explicit page number or first STOP is an explicit page number or last | all | all even odd first last NMB START-STOP |
Source options - Folder processing
These options control the selection of image files when the source is a folder.
Name | Value Description | Default | Valid values |
|---|---|---|---|
-sub -subfolders | Include subfolders of the source folder in the processing | true | true false |
-incl | List of file name masks to be included in the processing | *.tif,*.tiff,*.jpg,*.jpeg,*.pdf,*.bmp,*.png |
|
-excl | List of file name masks to be excluded from processing |
|
|
Miscellaneous options
Name | Value Description |
|---|---|
-help -h | Flag to output command-line help to console. No processing is done |
-verbosity | Defines the amount of information presented in the output 0 (default) - Essential information, including recommended TBR codes to use 1 - Adds summary of found barcodes and timing 2 - Display the TBR codes test and number of barcodes during measurements |
Configuration file
A configuration file is a convenient way to define a set of options and/or sources shared by multiple systems or sessions. The format rules for configuration files are:
- -name sets command line flags
- -name=value sets command line options with values
- source specifies the location of image files to read barcodes from. It can be an image file, a folder containing image files, or a URL. Values with spaces should be enclosed in double quotes ("some text")
- # starts the comment portion of a line. If # is the first character, the whole line is treated as a comment.
- exit ends the processing of a configuration file. The rest of the file is ignored.
The configuration file should be in UTF-8 to include non-English file names.