---
layout: default-layout
title: TextureDetectionModes - Dynamsoft Capture Vision Parameters
description: Reference for the TextureDetectionModes parameter in Dynamsoft Capture Vision, which controls how texture patterns are detected in an image so they can be removed from the grayscale image before binarization to improve recognition accuracy.
keywords: TextureDetectionModes, parameter reference, parameter
---


# TextureDetectionModes

Parameter `TextureDetectionModes` controls how to detect texture on an image.

## JSON Structure

**Location in template:**
```
ImageParameterOptions[i]
    └── ApplicableStages[j] (Stage object where Stage = "SST_DETECT_TEXTURE")
        └── TextureDetectionModes
```

**Parent object:** [DetectTextureStage](stage-detect-texture.md)

**Example:**

```json
{
    "TextureDetectionModes": [
        {
            "Mode": "TDM_GENERAL_WIDTH_CONCENTRATION"
        }
    ]
}
```

> [!NOTE]
> - This snippet shows only the `TextureDetectionModes` parameter.
> - To use it, embed this parameter within a [DetectTextureStage](stage-detect-texture.md) object.
> - For the complete JSON structure, see:
>   - [Full JSON Structure]({{ site.dcvb_parameters }}file/index.html#full-json-structure)
>   - [Minimal Valid JSON]({{ site.dcvb_parameters }}file/index.html#minimal-valid-json-example)

## Parameter Details

Parameter `TextureDetectionModes` consist of a group of texture detection mode objects. Each texture detection mode object includes a candidate mode and a series of mode arguments. The mode arguments of the texture detection mode object is shown as follow:

### Mode Arguments

<table style = "text-align:left">
    <thead>
        <tr>
            <th nowrap="nowrap">Mode Argument Name</th>
            <th nowrap="nowrap">Mode Argument Summary</th>
        </tr>
    </thead>
    <tr>
        <td rowspan = "4" style="vertical-align:text-top">Mode<br>(Required)</td>
        <td><b>Description</b><br>Any one in Candidate Mode List as string
        </td>
    </tr>
    <tr>
        <td><b>Type</b><br><i>String</i>
        </td>
    </tr>
    <tr>
        <td><b>Candidate Mode List</b><br>TDM_GENERAL_WIDTH_CONCENTRATION<br>TDM_AUTO (Not supported yet.)<br>TDM_SKIP
        </td>
    </tr>
    <tr>
        <td><b>Default Value</b><br>TDM_GENERAL_WIDTH_CONCENTRATION
        </td>
    </tr>
    <tr>
        <td rowspan = "5" style="vertical-align:text-top">Sensitivity<br>(Optional)</td>
        <td><b>Description</b><br>Sets the sensitivity used for texture detection. A larger value means the library will take more effort to detect texture.
        </td>
    </tr>
    <tr>
        <td><b>Type</b><br><i>int</i>
        </td>
    </tr>
    <tr>
        <td><b>Range</b><br>[1, 9]
        </td>
    </tr>
    <tr>
        <td><b>Default Value</b><br>5
        </td>
    </tr>
    <tr>
        <td><b>Valid For</b><br>
        <br>TDM_GENERAL_WIDTH_CONCENTRATION
        </td>
    </tr>
    <tr>
        <td rowspan = "5" style="vertical-align:text-top">LibraryFileName<br>(Optional)</td>
        <td><b>Description</b><br>Sets the file name of the library to load dynamically.
        </td>
    </tr>
    <tr>
        <td><b>Type</b><br><i>String</i>
        </td>
    </tr>
    <tr>
        <td><b>Range</b><br>A string value representing file name.
        </td>
    </tr>
    <tr>
        <td><b>Default Value</b><br>""
        </td>
    </tr>
    <tr>
        <td><b>Valid For</b><br>All modes.
        </td>
    </tr>
    <tr>
        <td rowspan = "5" style="vertical-align:text-top">LibraryParameters<br>(Optional)</td>
        <td><b>Description</b><br>The library must be in the same place with Dynamsoft Barcode Reader Library.
        </td>
    </tr>
    <tr>
        <td><b>Type</b><br><i>String</i>
        </td>
    </tr>
    <tr>
        <td><b>Range</b><br>A string value representing parameters.
        </td>
    </tr>
    <tr>
        <td><b>Default Value</b><br>""
        </td>
    </tr>
    <tr>
        <td><b>Valid For</b><br>All modes.
        </td>
    </tr>
</table>

### Default Setting

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

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

## Candidate Mode Introductions

### TDM_GENERAL_WIDTH_CONCENTRATION

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

**Available Mode Arguments:**

- Sensitivity