Need better scanning performance?

Get a FREE customized reading template.

TextResultOrderModes

Parameter TextResultOrderModes defines the order of the returned text results. It consists of one or more modes, each mode representing a different ordering criterion.

JSON Structure

Location in template:

BarcodeReaderTaskSettingOptions[i]
    └── TextResultOrderModes

Parent object: BarcodeReaderTaskSetting object

Example:

{
    "TextResultOrderModes": [
        {
            "Mode": "TROM_CONFIDENCE"
        },
        {
            "Mode": "TROM_POSITION"
        },
        {
            "Mode": "TROM_FORMAT"
        }
    ]
}

This snippet shows only the TextResultOrderModes parameter.

To use it, embed this parameter within a BarcodeReaderTaskSetting object at the task-level.

For the complete JSON structure, see:

Full JSON Structure

Minimal Valid JSON

Parameter Details

Parameter TextResultOrderModes consists of a group of text result order mode objects. Each text result order mode object includes a candidate mode and a series of auxiliary mode arguments.

Mode Arguments

The mode arguments of the text result order mode object are as follows:

Mode Arguments

Mode Argument Name	Mode Argument Summary
Mode (Required)	Description Specifies a mode for ordering.
	Type String
	Candidate Mode List TROM_CONFIDENCE TROM_POSITION TROM_FORMAT TROM_SKIP

Default Setting

If the TextResultOrderModes is not configured in your template file, the following setting will be used as the default setting.

{
    "TextResultOrderModes": [
        {
            "Mode": "TROM_CONFIDENCE"
        },
        {
            "Mode": "TROM_POSITION"
        },
        {
            "Mode": "TROM_FORMAT"
        }
    ]
}

Candidate Mode Introductions

TROM_CONFIDENCE

Returns the text results in descending order by confidence.

TROM_POSITION

Returns the text results in position order, from top to bottom, then left to right.

TROM_FORMAT

Returns the text results in alphabetical and numerical order by barcode format string