Thanks for downloading Dynamsoft Barcode Reader Package!

Your download will start shortly. If your download does not begin, click here to retry.

DeformationResistingModes

DeformationResistingModes is a parameter to control how to handle distorted and deformed barcodes. It consisits of one or more modes, each mode represents a way to implement the deformation resisting.

Candidate Mode List

DRM_GENERAL
DRM_AUTO

DRM_GENERAL

Resists deformation using the general algorithm. This mode has the following arguments for further customizing.

Level
LibraryFileName
LibraryParameters

DRM_AUTO

Lets the library choose a mode automatically. Not supported yet.

Setting Methods

As `PublicRuntimeSettings` Member

DeformationResistingModes can be set dynamically during runtime as a member of FurtherModes, which is a member of PublicRuntimeSettings struct, it is an array with 8 DeformationResistingMode Enumeration items.

Code Snippet in C++

//...other codes
PublicRuntimeSettings* pSettings = new PublicRuntimeSettings;
int errorCode = reader->GetRuntimeSettings(pSettings);
pSettings->deformationResistingModes[0] = DRM_GENERAL;
reader->UpdateRuntimeSettings(pSettings);
reader->SetModeArgument("DeformationResistingModes", 0, "Level", "1");
delete pSettings;
//...other codes

Remarks
GetModeArgument and SetModeArgument need to be called for getting and setting Arguments.

See Also

FurtherModes: C | C++ | .NET | Java | Java-Android | Objective-C & Swift
PublicRuntimeSettings: JavaScript | C | C++ | .NET | Python | Java | Java-Android | Objective-C & Swift
DeformationResistingMode Enumeration
GetModeArgument: JavaScript | C | C++ | .NET | Python | Java | Java-Android | Objective-C & Swift
SetModeArgument: JavaScript | C | C++ | .NET | Python | Java | Java-Android | Objective-C & Swift

As JSON Parameter

DeformationResistingModes 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.
Level	A number from value range of Level	(Optional) Sets the Argument Level.
LibraryFileName	A string from value range of LibraryFileName	(Optional) Sets the Argument LibraryFileName.
LibraryParameters	A string from value range of LibraryFileName	(Optional) Sets the Argument LibraryFileName.

JSON Parameter Example

{
    "DeformationResistingModes": [
        {
            "Mode": "DRM_GENERAL", 
            "Level": 1
        },
        {
            "Mode": "DRM_GENERAL", 
            "Level": 9
        }
    ]
}

Impacts on Performance

Speed

The SDK will loop the setting modes one by one until find as many barcodes as ExpectedBarcodesCount specified or timeout. The more modes you set, the more time the process may take. Setting an appropriate mode first in order or setting only necessary modes may speed up the process.

Read Rate

Setting more modes along with different arguments may improve the Read Rate.

Accuracy

DeformationResistingModes has no influence on the Accuracy.

Level

Sets the effort level used for deformation resisting. Not supported yet.

Value Type	Value Range	Default Value	Valid For
int	[1, 9]	5	DRM_GENERAL

Performance Adaptability
A larger value may improve the Read Rate but slowdown the Speed.

LibraryFileName

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.

LibraryParameters

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