Thanks for downloading Dynamsoft Barcode Reader Package!

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

TextureDetectionModes

TextureDetectionModes is a parameter to control how to detect texture on an image. It consisits of one or more modes, each mode represents a way to implement the detection.

Candidate Mode List

TDM_GENERAL_WIDTH_CONCENTRATION

TDM_GENERAL_WIDTH_CONCENTRATION

Detects texture using the general algorithm. This mode has the following arguments for further customizing.

Sensitivity
LibraryFileName
LibraryParameters

Setting Methods

As `PublicRuntimeSettings` Member

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

Code Snippet in C++

//...other codes
PublicRuntimeSettings* pSettings = new PublicRuntimeSettings;
int errorCode = reader->GetRuntimeSettings(pSettings);
pSettings->textureDetectionModes[0] = TDM_GENERAL_WIDTH_CONCENTRATION;
reader->UpdateRuntimeSettings(pSettings);
reader->SetModeArgument("TextureDetectionModes", 0, "Sensitivity", "5");
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
TextureDetectionMode 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

TextureDetectionModes 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 text filtering.
Sensitivity	A number from value range of Sensitivity	(Optional) Sets the Argument Sensitivity.
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

{
    "TextureDetectionModes": [
        {
            "Mode": "TDM_GENERAL_WIDTH_CONCENTRATION", 
            "Sensitivity": 5
        }
    ]
}

Impacts on Performance

Speed

Enabling texture detection may slow down the Speed when the image has clean background.

Read Rate

For barcodes surrounded by a textured background, enabling texture detection may improve the Accuracy.

Accuracy

For barcodes surrounded by a textured background, enabling texture detection may improve the Accuracy.

Sensitivity

Sets the sensitivity used for texture detection.

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

Remarks
A larger value means the library will take more effort to detect texture.

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