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.
Download TBR Wizard:
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 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:
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.
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
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 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 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.
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 |
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 |
|
|
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 |
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.