Need better scanning performance?

Get a FREE customized reading template.

DocumentNormalizerTaskSetting Parameters

The DocumentNormalizerTaskSetting object configures the settings for document detection and normalization in Dynamsoft Capture Vision.

Example JSON

{
    "DocumentNormalizerTaskSettingOptions": [
        {
            "Name": "ddn_task_default",
            "MaxThreadsInOneTask": 4,
            "ExpectedDocumentsCount": 1,
            "BaseDocumentNormalizerTaskSettingName": "",
            "SectionArray": [
                {
                    "Section": "ST_REGION_PREDETECTION",
                    "ImageParameterName": "ip_default",
                    "StageArray": [
                        {
                            "Stage": "SST_PREDETECT_REGIONS",
                            "RegionPredetectionModes": []
                        }
                    ]
                },
                {
                    "Section": "ST_DOCUMENT_DETECTION",
                    "ContentType": "CT_DOCUMENT",
                    "ImageParameterName": "ip_default",
                    "StageArray": [
                        { "Stage": "SST_ASSEMBLE_LONG_LINES" },
                        { "Stage": "SST_ASSEMBLE_LOGICAL_LINES" },
                        {
                            "Stage": "SST_DETECT_CORNERS",
                            "CornerAngleRange": {
                                "MaxValue": 110,
                                "MinValue": 70
                            }
                        },
                        { "Stage": "SST_DETECT_EDGES" },
                        {
                            "Stage": "SST_DETECT_QUADS",
                            "QuadrilateralDetectionModes": [
                                {
                                    "Mode": "QDM_GENERAL"
                                }
                            ]
                        }
                    ]
                },
                {
                    "Section": "ST_DOCUMENT_DESKEWING",
                    "ImageParameterName": "ip_default",
                    "StageArray": [
                        {
                            "Stage": "SST_DESKEW_IMAGE",
                            "DeskewMode": {
                                "ContentDirection": 0,
                                "Mode": "DSM_PERSPECTIVE_CORRECTION"
                            },
                            "PageSize": [-1, -1]
                        }
                    ]
                },
                {
                    "Section": "ST_IMAGE_ENHANCEMENT",
                    "ImageParameterName": "ip_0",
                    "StageArray": [
                        {
                            "Stage": "SST_ENHANCE_IMAGE",
                            "ColourMode": "ICM_COLOUR",
                            "Brightness": 0,
                            "Contrast": 0
                        }
                    ]
                }
            ]
        }
    ]
}

Hierarchical Structure

This tree shows one DocumentNormalizerTaskSetting object inside DocumentNormalizerTaskSettingOptions.

DocumentNormalizerTaskSetting
├── Name
├── MaxThreadsInOneTask
├── ExpectedDocumentsCount
├── BaseDocumentNormalizerTaskSettingName
└── SectionArray[]
    ├── item (Section = ST_REGION_PREDETECTION)
    │   ├── Section
    │   ├── ImageParameterName
    │   └── StageArray[]
    │       └── item (Stage = SST_PREDETECT_REGIONS)
    │           ├── Stage
    │           └── RegionPredetectionModes
    ├── item (Section = ST_DOCUMENT_DETECTION)
    │   ├── Section
    │   ├── ContentType
    │   ├── ImageParameterName
    │   └── StageArray[]
    │       ├── item (Stage = SST_ASSEMBLE_LONG_LINES)
    │       │   └── Stage
    │       ├── item (Stage = SST_ASSEMBLE_LOGICAL_LINES)
    │       │   └── Stage
    │       ├── item (Stage = SST_DETECT_CORNERS)
    │       │   ├── Stage
    │       │   └── CornerAngleRange
    │       ├── item (Stage = SST_DETECT_EDGES)
    │       │   └── Stage
    │       └── item (Stage = SST_DETECT_QUADS)
    │           ├── Stage
    │           └── QuadrilateralDetectionModes
    ├── item (Section = ST_DOCUMENT_DESKEWING)
    │   ├── Section
    │   ├── ImageParameterName
    │   └── StageArray[]
    │       └── item (Stage = SST_DESKEW_IMAGE)
    │           ├── Stage
    │           ├── DeskewMode
    │           └── PageSize
    └── item (Section = ST_IMAGE_ENHANCEMENT)
        ├── Section
        ├── ImageParameterName
        └── StageArray[]
            └── item (Stage = SST_ENHANCE_IMAGE)
                ├── Stage
                ├── ColourMode
                ├── Brightness
                └── Contrast

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`	The unique name of the DocumentNormalizerTaskSetting object.
`BaseDocumentNormalizerTaskSettingName`	The name of another DocumentNormalizerTaskSetting to inherit from.
`MaxThreadsInOneTask`	The maximum threads in one task.
`ExpectedDocumentsCount`	The expected number of documents to detect.
`SectionArray`	The sections of the document normalizer task.

Nested Parameter Quick Links

Actual Nested Parameters in the Tree

Parameter Name	Description
`RegionPredetectionModes`	Controls how to find a region of interest (ROI) within the image or frame.
`ContentType`	The content type of the document.
`CornerAngleRange`	The acceptable corner angle range for document detection.
`QuadrilateralDetectionModes`	The modes for detecting document quadrilaterals.
`DeskewMode`	The mode for deskewing the document.
`PageSize`	The page size for normalization.
`ColourMode`	The colour mode for the normalized image.
`Brightness`	The brightness of the normalized image.
`Contrast`	The contrast of the normalized image.

Conceptual Section/Stage Objects

Object	Description
`SectionRegionsPredetection`	Section object for `Section = ST_REGION_PREDETECTION`.
`StagePredetectRegions`	Stage object under `Section = ST_REGION_PREDETECTION` with `Stage = SST_PREDETECT_REGIONS`.
`SectionDocumentDetection`	Section object for `Section = ST_DOCUMENT_DETECTION`.
`StageAssembleLongLines`	Stage object under `Section = ST_DOCUMENT_DETECTION` with `Stage = SST_ASSEMBLE_LONG_LINES`.
`StageAssembleLogicalLines`	Stage object under `Section = ST_DOCUMENT_DETECTION` with `Stage = SST_ASSEMBLE_LOGICAL_LINES`.
`StageDetectCorners`	Stage object under `Section = ST_DOCUMENT_DETECTION` with `Stage = SST_DETECT_CORNERS`.
`StageDetectEdges`	Stage object under `Section = ST_DOCUMENT_DETECTION` with `Stage = SST_DETECT_EDGES`.
`StageDetectQuads`	Stage object under `Section = ST_DOCUMENT_DETECTION` with `Stage = SST_DETECT_QUADS`.
`SectionDocumentDeskewing`	Section object for `Section = ST_DOCUMENT_DESKEWING`.
`StageDeskewImage`	Stage object under `Section = ST_DOCUMENT_DESKEWING` with `Stage = SST_DESKEW_IMAGE`.
`SectionImageEnhancement`	Section object for `Section = ST_IMAGE_ENHANCEMENT`.
`StageEnhanceImage`	Stage object under `Section = ST_IMAGE_ENHANCEMENT` with `Stage = SST_ENHANCE_IMAGE`.