layout | title | description | keywords | needAutoGenerateSidebar | needGenerateH3Content | permalink |
---|---|---|---|---|---|---|
default-layout |
LocalizationModes - Dynamsoft Barcode Reader Parameter Reference |
This page shows Dynamsoft Barcode Reader Parameter Reference for LocalizationModes. |
LocalizationModes, parameter reference, parameter |
true |
true |
/parameters/reference/localization-modes-v9.2.0.html |
LocalizationModes
is a parameter to control how to localize barcodes. It consists of one or more modes, each mode represents a way to implement the localization.
- LM_CONNECTED_BLOCKS
- LM_STATISTICS
- LM_LINES
- LM_SCAN_DIRECTLY
- LM_STATISTICS_MARKS
- LM_STATISTICS_POSTAL_CODE
- LM_CENTRE
- LM_ONED_FAST_SCAN
Localizes barcodes by searching for connected blocks. This algorithm usually gives best result and it is recommended to set ConnectedBlocks to the highest priority. This mode has the following arguments for further customizing.
Localizes barcodes by groups of contiguous black-white regions. This is optimized for QRCode and DataMatrix. This mode has the following arguments for further customizing.
Localizes barcodes by searching for groups of lines. This is optimized for 1D and PDF417 barcodes. This mode has the following arguments for further customizing.
Localizes barcodes quickly. This mode is recommended in interactive scenario. This mode has the following arguments for further customizing.
Localizes barcodes by groups of marks.This is optimized for DPM codes. This mode has the following arguments for further customizing.
Localizes barcodes by groups of connected blocks and lines.This is optimized for postal codes. This mode has the following arguments for further customizing.
Localizes barcodes from the centre of the image. This mode has the following arguments for further customizing.
Localizes 1D barcodes in a fast mode. This mode is designed for reading 1D barcodes in a very fast mode. This mode has the following arguments for further customizing.
LocalizationModes
can be set dynamically during runtime as a member of PublicRuntimeSettings
struct, it is an array with 8 [LocalizationMode
]({{ site.enumerations }}parameter-mode-enums.html#localizationmode) Enumeration items.
Code Snippet in C++
//...other codes
PublicRuntimeSettings* pSettings = new PublicRuntimeSettings;
int errorCode = reader->GetRuntimeSettings(pSettings);
pSettings->localizationModes[0] = LM_SCAN_DIRECTLY;
pSettings->localizationModes[1] = LM_CONNECTED_BLOCKS;
reader->UpdateRuntimeSettings(pSettings);
reader->SetModeArgument("LocalizationModes", 0, "ScanStride", "5");
delete pSettings;
//...other codes
Remarks
GetModeArgument
and SetModeArgument
need to be called for getting and setting Arguments
.
See Also
PublicRuntimeSettings:
[JavaScript]({{ site.js_api }}interface/RuntimeSettings.html) | [C]({{ site.structs }}PublicRuntimeSettings.html?src=c) | [C++]({{ site.structs }}PublicRuntimeSettings.html?src=cpp) | [.NET]({{ site.dotnet_api }}struct/PublicRuntimeSettings.html) | [Python]({{ site.python_api }}class/PublicRuntimeSettings.html) | [Java]({{ site.java_api }}class/PublicRuntimeSettings.html) | [Java-Android]({{ site.android_api }}auxiliary-PublicRuntimeSettings.html) | [Objective-C & Swift]({{ site.oc_api }}auxiliary-iPublicRuntimeSettings.html)- [
LocalizationMode
Enumeration]({{ site.enumerations }}parameter-mode-enums.html#localizationmode) GetModeArgument:
[JavaScript]({{ site.js_api}}BarcodeReader.html#getmodeargument) | [C]({{ site.c_methods }}parameter-and-runtime-settings-basic.html#dbr_getmodeargument) | [C++]({{ site.cpp_methods }}parameter-and-runtime-settings-basic.html#getmodeargument) | [.NET]({{ site.dotnet_api }}BarcodeReader/parameter-and-runtime-settings-basic.html#getmodeargument) | [Python]({{ site.python_api }}BarcodeReader/parameter-and-runtime-settings-basic.html#get_mode_argument) | [Java]({{ site.java_api }}BarcodeReader/parameter-and-runtime-settings-basic.html#getmodeargument) | [Java-Android]({{ site.android_api }}primary-parameter-and-runtime-settings-basic.html#getmodeargument) | [Objective-C & Swift]({{ site.oc_api }}primary-parameter-and-runtime-settings-basic.html#getmodeargument)SetModeArgument:
[JavaScript]({{ site.js_api}}BarcodeReader.html#setmodeargument) | [C]({{ site.c_methods }}parameter-and-runtime-settings-basic.html#dbr_setmodeargument) | [C++]({{ site.cpp_methods }}parameter-and-runtime-settings-basic.html#setmodeargument) | [.NET]({{ site.dotnet_api }}BarcodeReader/parameter-and-runtime-settings-basic.html#setmodeargument) | [Python]({{ site.python_api }}BarcodeReader/parameter-and-runtime-settings-basic.html#set_mode_argument) | [Java]({{ site.java_api }}BarcodeReader/parameter-and-runtime-settings-basic.html#setmodeargument) | [Java-Android]({{ site.android_api }}primary-parameter-and-runtime-settings-basic.html#setmodeargument) | [Objective-C & Swift]({{ site.oc_api }}primary-parameter-and-runtime-settings-basic.html#setmodeargument)
LocalizationModes
as a JSON parameter is a JSON Object array. Each JSON object is defined as below.
Key Name | Key Value | Description |
---|---|---|
Mode | Any one in Candidate Mode List as string | (Required) Specifies a mode for deformation resisting. |
ScanStride | A number from value range of ScanStride | (Optional) Sets the Argument ScanStride. |
ScanDirection | A number from value range of ScanDirection | (Optional) Sets the Argument ScanDirection. |
ConfidenceThreshold | A number from value range of ConfidenceThreshold | (Optional) Sets the Argument ConfidenceThreshold. |
LibraryFileName | A string from value range of LibraryFileName | (Optional) Sets the Argument LibraryFileName. |
LibraryParameters | A string from value range of LibraryParameters | (Optional) Sets the Argument LibraryParameters. |
JSON Parameter Example
{
"LocalizationModes": [
{
"Mode": "LM_SCAN_DIRECTLY",
"ScanStride": 5
},
{
"Mode": "LM_CONNECTED_BLOCKS"
}
]
}
Sets the stride in pixels between scans when searching for barcodes.
Value Type | Value Range | Default Value | Valid For |
---|---|---|---|
int | [0, 0x7fffffff] | 0 | LM_SCAN_DIRECTLY LM_ONED_FAST_SCAN |
Remarks
- 0: automatically set by the library.
- When the set value is greater than half the width or height of current image, the actual processing is 0.
Performance Adaptability
A smaller value may improve the Read Rate but slow down the Speed.
Sets the scan direction when searching barcode.
Value Type | Value Range | Default Value | Valid For |
---|---|---|---|
int | [0, 2] | 0 | LM_SCAN_DIRECTLY LM_ONED_FAST_SCAN |
Remarks
- 0: Both vertical and horizontal direction.
- 1: Vertical direction.
- 2: Horizontal direction.
Sets the confidence threshold.
Value Type | Value Range | Default Value | Valid For |
---|---|---|---|
int | [0, 100] | 60 | LM_ONED_FAST_SCAN |
Remarks
- The localization result will be discarded if its conficence is less then the threshold.
Sets the file name of the library to load dynamically.
Value Type | Value Range | Default Value | Valid For |
---|---|---|---|
string | A string value representing file name. | "" | All modes |
Remarks
The library must be in the same place with Dynamsoft Barcode Reader Library.
Sets the parameters passed to the library to load dynamically.
Value Type | Value Range | Default Value | Valid For |
---|---|---|---|
string | A string value representing parameters. | "" | All modes |
- [Use RuntimeSettings or Templates for Configuring Parameters]({{ site.features }}use-runtimesettings-or-templates.html)
- [How to use different localization modes]({{ site.scenario_settings }}how-to-set-localization-modes.html)