# LabelRecognizerTaskSetting Parameters

The `LabelRecognizerTaskSetting` object configures settings for label recognition tasks in Dynamsoft Capture Vision, including text line localization, recognition, and correction.

## Example JSON

```json
{
    "LabelRecognizerTaskSettingOptions": [
        {
            "Name": "dlr_task_default",
            "MaxThreadsInOneTask": 4,
            "TextLineSpecificationNameArray": ["tls_default"],
            "BaseLabelRecognizerTaskSettingName": "",
            "SectionArray": [
                {
                    "Section": "ST_REGION_PREDETECTION",
                    "ImageParameterName": "ip_default",
                    "StageArray": [
                        {
                            "Stage": "SST_PREDETECT_REGIONS",
                            "RegionPredetectionModes": []
                        }
                    ]
                },
                {
                    "Section": "ST_TEXT_LINE_LOCALIZATION",
                    "ImageParameterName": "ip_default",
                    "StageArray": [
                        {
                            "Stage": "SST_LOCALIZE_TEXT_LINES",
                            "LocalizationModes": [],
                            "OrientationDetectionModes": []
                        }
                    ]
                },
                {
                    "Section": "ST_TEXT_LINE_RECOGNITION",
                    "ImageParameterName": "ip_default",
                    "StageArray": [
                        {
                            "Stage": "SST_RECOGNIZE_RAW_TEXT_LINES",
                            "DictionaryPath": "",
                            "DictionaryCorrectionThresholds": [],
                            "ConfusableCharactersPath": "ConfusableChars.data",
                            "ClusterSamplesCountThreshold": 0,
                            "OverlappingCharactersPath": "OverlappingChars.data",
                            "EnableRegexForceCorrection": 1
                        },
                        {
                            "Stage": "SST_ASSEMBLE_TEXT_LINES",
                            "StringLengthRange": [3, 200],
                            "StringRegexPattern": ""
                        }
                    ]
                }
            ]
        }
    ]
}
```

## Hierarchical Structure

This tree shows one `LabelRecognizerTaskSetting` object inside `LabelRecognizerTaskSettingOptions`.

```text
LabelRecognizerTaskSetting
├── Name
├── MaxThreadsInOneTask
├── TextLineSpecificationNameArray
├── BaseLabelRecognizerTaskSettingName
└── SectionArray[]
    ├── item (Section = ST_REGION_PREDETECTION)
    │   ├── Section
    │   ├── ImageParameterName
    │   └── StageArray[]
    │       └── item (Stage = SST_PREDETECT_REGIONS)
    │           ├── Stage
    │           └── RegionPredetectionModes
    ├── item (Section = ST_TEXT_LINE_LOCALIZATION)
    │   ├── Section
    │   ├── ImageParameterName
    │   └── StageArray[]
    │       └── item (Stage = SST_LOCALIZE_TEXT_LINES)
    │           ├── Stage
    │           ├── LocalizationModes
    │           └── OrientationDetectionModes
    └── item (Section = ST_TEXT_LINE_RECOGNITION)
        ├── Section
        ├── ImageParameterName
        └── StageArray[]
            ├── item (Stage = SST_RECOGNIZE_RAW_TEXT_LINES)
            │   ├── Stage
            │   ├── DictionaryPath
            │   ├── DictionaryCorrectionThresholds
            │   ├── ConfusableCharactersPath
            │   ├── ClusterSamplesCountThreshold
            │   ├── OverlappingCharactersPath
            │   └── EnableRegexForceCorrection
            └── item (Stage = SST_ASSEMBLE_TEXT_LINES)
                ├── Stage
                ├── StringLengthRange
                └── StringRegexPattern
```

> [!IMPORTANT]
> `Stage` values are constrained by the parent `Section` value, and stage-scoped parameters are constrained by the `Stage` value.

## Top-Level Parameters

| Parameter Name | Description |
|:---------------|:------------|
| [`Name`](https://www.dynamsoft.com/capture-vision/docs/core/parameters/reference/label-recognizer-task-settings/name.md) | The unique name of the LabelRecognizerTaskSetting object. |
| [`BaseLabelRecognizerTaskSettingName`](https://www.dynamsoft.com/capture-vision/docs/core/parameters/reference/label-recognizer-task-settings/base-label-recognizer-task-setting-name.md) | The name of another LabelRecognizerTaskSetting to inherit from. |
| [`MaxThreadsInOneTask`](https://www.dynamsoft.com/capture-vision/docs/core/parameters/reference/label-recognizer-task-settings/max-threads-in-one-task.md) | The maximum threads in one task. |
| [`TextLineSpecificationNameArray`](https://www.dynamsoft.com/capture-vision/docs/core/parameters/reference/label-recognizer-task-settings/text-line-specification-name-array.md) | The names of TextLineSpecification objects to reference. |
| [`SectionArray`](https://www.dynamsoft.com/capture-vision/docs/core/parameters/reference/label-recognizer-task-settings/section-array.md) | The sections of the label recognizer task. |

## Nested Parameter Quick Links

### Actual Nested Parameters in the Tree

| Parameter Name | Description |
|:---------------|:------------|
| [`RegionPredetectionModes`](https://www.dynamsoft.com/capture-vision/docs/core/parameters/reference/image-parameter/region-predetection-modes.md) | Controls how to find a region of interest (ROI) within the image or frame. |
| [`LocalizationModes`](https://www.dynamsoft.com/capture-vision/docs/core/parameters/reference/label-recognizer-task-settings/localization-modes.md) | The modes for text line localization. |
| [`OrientationDetectionModes`](https://www.dynamsoft.com/capture-vision/docs/core/parameters/reference/label-recognizer-task-settings/orientation-detection-modes.md) | The modes for orientation detection. |
| [`DictionaryPath`](https://www.dynamsoft.com/capture-vision/docs/core/parameters/reference/label-recognizer-task-settings/dictionary-path.md) | The path to the dictionary file. |
| [`DictionaryCorrectionThresholds`](https://www.dynamsoft.com/capture-vision/docs/core/parameters/reference/label-recognizer-task-settings/dictionary-correction-thresholds.md) | The thresholds for dictionary-based correction. |
| [`ConfusableCharactersPath`](https://www.dynamsoft.com/capture-vision/docs/core/parameters/reference/label-recognizer-task-settings/confusable-characters-path.md) | The path to confusable characters definition. |
| [`ClusterSamplesCountThreshold`](https://www.dynamsoft.com/capture-vision/docs/core/parameters/reference/label-recognizer-task-settings/cluster-samples-count-threshold.md) | The threshold for cluster samples count. |
| [`OverlappingCharactersPath`](https://www.dynamsoft.com/capture-vision/docs/core/parameters/reference/label-recognizer-task-settings/overlapping-characters-path.md) | The path to overlapping characters definition. |
| [`EnableRegexForceCorrection`](https://www.dynamsoft.com/capture-vision/docs/core/parameters/reference/label-recognizer-task-settings/enable-regex-force-correction.md) | Whether to enable regex-based force correction. |
| [`StringLengthRange`](https://www.dynamsoft.com/capture-vision/docs/core/parameters/reference/label-recognizer-task-settings/string-length-range.md) | The expected string length range. |
| [`StringRegexPattern`](https://www.dynamsoft.com/capture-vision/docs/core/parameters/reference/label-recognizer-task-settings/string-regex-pattern.md) | The regex pattern for validating recognized strings. |

### Conceptual Section/Stage Objects

| Object | Description |
|:-------|:------------|
| [`SectionRegionsPredetection`](https://www.dynamsoft.com/capture-vision/docs/core/parameters/reference/label-recognizer-task-settings/section-regions-predetection.md) | Section object for `Section = ST_REGION_PREDETECTION`. |
| [`StagePredetectRegions`](https://www.dynamsoft.com/capture-vision/docs/core/parameters/reference/label-recognizer-task-settings/stage-predetect-regions.md) | Stage object under `Section = ST_REGION_PREDETECTION` with `Stage = SST_PREDETECT_REGIONS`. |
| [`SectionTextLinesLocalization`](https://www.dynamsoft.com/capture-vision/docs/core/parameters/reference/label-recognizer-task-settings/section-text-lines-localization.md) | Section object for `Section = ST_TEXT_LINE_LOCALIZATION`. |
| [`StageLocalizeTextLines`](https://www.dynamsoft.com/capture-vision/docs/core/parameters/reference/label-recognizer-task-settings/stage-localize-text-lines.md) | Stage object under `Section = ST_TEXT_LINE_LOCALIZATION` with `Stage = SST_LOCALIZE_TEXT_LINES`. |
| [`SectionTextLinesRecognition`](https://www.dynamsoft.com/capture-vision/docs/core/parameters/reference/label-recognizer-task-settings/section-text-lines-recognition.md) | Section object for `Section = ST_TEXT_LINE_RECOGNITION`. |
| [`StageRecognizeRawTextLines`](https://www.dynamsoft.com/capture-vision/docs/core/parameters/reference/label-recognizer-task-settings/stage-recognize-raw-text-lines.md) | Stage object under `Section = ST_TEXT_LINE_RECOGNITION` with `Stage = SST_RECOGNIZE_RAW_TEXT_LINES`. |
| [`StageAssembleTextLines`](https://www.dynamsoft.com/capture-vision/docs/core/parameters/reference/label-recognizer-task-settings/stage-assemble-text-lines.md) | Stage object under `Section = ST_TEXT_LINE_RECOGNITION` with `Stage = SST_ASSEMBLE_TEXT_LINES`. |