diff --git a/_includes/barcode-format.md b/_includes/barcode-format.md new file mode 100644 index 0000000..0cb5d8c --- /dev/null +++ b/_includes/barcode-format.md @@ -0,0 +1,55 @@ + + +| Format | Description | +| ------ | ----------- | +| BF_ALL | All supported formats. | +| BF_DEFAULT | The default barcode format settings. It's a combined value of BF_ONED, BF_GS1_DATABAR, BF_PDF417, BF_QR_CODE, BF_DATAMATRIX, BF_AZTEC, BF_MAXICODE, BF_MICRO_QR, BF_MICRO_PDF417, BF_GS1_COMPOSITE. | +| BF_ONED | Combined value of BF_CODABAR, BF_CODE_128, BF_CODE_39, BF_CODE_39_Extended, BF_CODE_93, BF_EAN_13, BF_EAN_8, INDUSTRIAL_25, BF_ITF, BF_UPC_A, BF_UPC_E, BF_MSI_CODE. | +| BF_GS1_DATABAR | Combined value of BF_GS1_DATABAR_OMNIDIRECTIONAL, BF_GS1_DATABAR_TRUNCATED, BF_GS1_DATABAR_STACKED, BF_GS1_DATABAR_STACKED_OMNIDIRECTIONAL, BF_GS1_DATABAR_EXPANDED, BF_GS1_DATABAR_EXPANDED_STACKED, BF_GS1_DATABAR_LIMITED. | +| BF_POSTALCODE | Combined value of BF_USPSINTELLIGENTMAIL, BF_POSTNET, BF_PLANET, BF_AUSTRALIANPOST, BF_RM4SCC, BF_KIX. | +| BF_CODE_39 | Code 39. | +| BF_CODE_128 | Code 128. | +| BF_CODE_93 | Code 93. | +| BF_CODABAR | Codabar. | +| BF_ITF | Interleaved 2 of 5. | +| BF_EAN_13 | EAN-13. | +| BF_EAN_8 | EAN-8. | +| BF_UPC_A | UPC-A. | +| BF_UPC_E | UPC-E. | +| BF_INDUSTRIAL_25 | Industrial 2 of 5. | +| BF_CODE_39_EXTENDED | CODE39 Extended. | +| BF_GS1_DATABAR_OMNIDIRECTIONAL | GS1 Databar Omnidirectional. | +| BF_GS1_DATABAR_TRUNCATED | GS1 Databar Truncated. | +| BF_GS1_DATABAR_STACKED | GS1 Databar Stacked. | +| BF_GS1_DATABAR_STACKED_OMNIDIRECTIONAL | GS1 Databar Stacked Omnidirectional. | +| BF_GS1_DATABAR_EXPANDED | GS1 Databar Expanded. | +| BF_GS1_DATABAR_EXPANDED_STACKED | GS1 Databar Expanded Stacked. | +| BF_GS1_DATABAR_LIMITED | GS1 Databar Limited. | +| BF_PATCHCODE | Patch code. | +| BF_CODE_32 | Code 32. | +| BF_PDF417 | PDF417. | +| BF_QR_CODE | QRCode. | +| BF_DATAMATRIX | DataMatrix. | +| BF_AZTEC | AZTEC. | +| BF_MAXICODE | MAXICODE. | +| BF_MICRO_QR | Micro QR Code. | +| BF_MICRO_PDF417 | Micro PDF417. | +| BF_GS1_COMPOSITE | GS1 Composite Code. | +| BF_MSI_CODE | MSI Code. | +| BF_CODE_11 | Code 11. | +| BF_TWO_DIGIT_ADD_ON | Decode barcode with 2 digital addons. | +| BF_FIVE_DIGIT_ADD_ON | Decode barcode with 5 digital addons. | +| BF_MATRIX_25 | Matrix 25. | +| BF_TELEPEN | Telepen. | +| BF_TELEPEN_NUMERIC | Telepen Numeric. A variation of the Telepen format optimized for encoding numeric data only. | +| BF_NONSTANDARD_BARCODE | Nonstandard barcode. | +| BF_USPSINTELLIGENTMAIL | USPS Intelligent Mail. | +| BF_POSTNET | Postnet. | +| BF_PLANET | Planet. | +| BF_AUSTRALIANPOST | Australian Post. | +| BF_RM4SCC | Royal Mail 4-State Customer Barcode. | +| BF_KIX | KIX. | +| BF_DOTCODE | DotCode. | +| BF_PHARMACODE_ONE_TRACK | Pharmacode One Track. | +| BF_PHARMACODE_TWO_TRACK | Pharmacode Two Track. | +| BF_PHARMACODE | Combined value of BF_PHARMACODE_ONE_TRACK, BF_PHARMACODE_TWO_TRACK. | diff --git a/_includes/sidelist-parameters-organization.html b/_includes/sidelist-parameters-organization.html index 4a6c2b9..0dc1761 100644 --- a/_includes/sidelist-parameters-organization.html +++ b/_includes/sidelist-parameters-organization.html @@ -427,6 +427,7 @@
  • AustralianPostEncodingTable
  • BarcodeAngleRangeArray
  • BarcodeBytesLengthRangeArray
  • +
  • BarcodeFormatIds
  • BarcodeHeightRangeArray
  • BarcodeTextLengthRangeArray
  • BarcodeTextRegExPattern
  • @@ -491,10 +492,11 @@ diff --git a/architecture/image-processing/barcode-decoding.md b/architecture/image-processing/barcode-decoding.md deleted file mode 100644 index 693fb8c..0000000 --- a/architecture/image-processing/barcode-decoding.md +++ /dev/null @@ -1,55 +0,0 @@ ---- -layout: default-layout -title: Barcode Decoding Section - Dynamsoft Capture Vision Architecture -description: This article introduces Barcode Decoding Section in the Dynamsoft Capture Vision architecture. -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true -permalink: /architecture/image-processing/barcode-decoding.html ---- - -The following diagram shows how sections connect to each other to form tasks: - -```mermaid -flowchart LR; - A[1.Region Pre-Detection]-->C[2.1.Shared Detection] - C---D[2.2.Barcode Localization] - C---E[2.2.Text-line Localization] - C---F[2.2.Document Detection] - D---G[3.Barcode Decoding] - E---H[3.Text-line Recognition] - F---I[3.Document Normalization] - style G fill:#f96,stroke:#333,stroke-width:4px -``` - -In this article, we'll discuss the section **Barcode Decoding** which is usually the 3rd section of a "Read-Barcodes" task. - -# Section 3 - Barcode Decoding - -The purpose of this section is to optimize the quality of the "barcode zones" found by the previous section "Barcode Localization" before decoding the barcode to get the encoded text. - -## Constituting Stages - -This section consists of the following stages: - -1. Cropping: to cut out the barcode zones based on barcode localization results. This results in one or multiple colour images. -2. Grayscaling: to convert the colour image(s) to grayscale. -3. Transforming: to transform the grayscale image(s). -4. Deformation-reducing: to reduce the deformation of the image(s). -5. Barcode-complementing: to complement incomplete barcode(s). -6. Up-scaling: to up-scale the barcode(s) to make it easier to decode. -7. Barcode-decoding: to decode the barcode and get the encoded text. - -## Output and Parameters - -Each of these stages has its own output (known as an intermediate result) and usually a specific parameter that can regulate the operation: - -| Stage | Intermediate Result Type | Related Parameter | -| --------------------- | ----------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | -| Cropping | `IRUT_COLOUR_IMAGE` | N/A | -| Grayscaling | `IRUT_GRAYSCALE_IMAGE` | [`ColourConversionModes`](../../parameters/reference/image-parameter/colour-conversion-modes.md) | -| Transforming | `IRUT_TRANSFORMED_GRAYSCALE_IMAGE` | [`GrayscaleTransformationModes`](../../parameters/reference/image-parameter/grayscale-transformation-modes.md) | -| Deformation-reducing | `IRUT_DEFORMATION_RESISTED_BARCODE_IMAGE` | [`DeformationResistingModes`](../../parameters/reference/barcode-reader-task-settings/deformation-resisting-modes.md) | -| Barcode-complementing | `IRUT_COMPLEMENTED_BARCODE_IMAGE` | [`BarcodeComplementModes`](../../parameters/reference/barcode-reader-task-settings/barcode-complement-modes.md) | -| Up-scaling | `IRUT_SCALED_UP_BARCODE_IMAGE` | [`ScaleUpModes`](../../parameters/reference/image-parameter/scale-up-modes.md) | -| Barcode-decoding | `IRUT_DECODED_BARCODES` | N/A | \ No newline at end of file diff --git a/architecture/image-processing/barcode-localization.md b/architecture/image-processing/barcode-localization.md deleted file mode 100644 index b9eb783..0000000 --- a/architecture/image-processing/barcode-localization.md +++ /dev/null @@ -1,51 +0,0 @@ ---- -layout: default-layout -title: Barcode Localization Section - Dynamsoft Capture Vision Architecture -description: This article introduces Barcode Localization Section in the Dynamsoft Capture Vision architecture. -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true -permalink: /architecture/image-processing/barcode-localization.html ---- - -The following diagram shows how sections connect to each other to form tasks: - -```mermaid -flowchart LR; - A[1.Region Pre-Detection]-->C[2.1.Shared Detection] - C---D[2.2.Barcode Localization] - C---E[2.2.Text-line Localization] - C---F[2.2.Document Detection] - D---G[3.Barcode Decoding] - E---H[3.Text-line Recognition] - F---I[3.Document Normalization] - style D fill:#f96,stroke:#333,stroke-width:4px -``` - -In this article, we'll discuss the section **Barcode Localization** which is the product-specific part of the 2nd section of a "Read-Barcodes" task. - -> The 2nd section of a "Read-Barcodes" task consists of [**Shared Detection**](shared-detection.md) and **Barcode Localization**. - -# Section 2.2 - Barcode Localization - -The purpose of this section is to find the exact locations of barcodes on the image. - -## Constituting Stages - -This section consists of multiple stages which forms a fixed and relatively complete set of workflow: - -1. Contour-locating: to find contours that may be part of barcodes. -2. Line-locating: to extract lines from the contours. -3. Candidates-locating: to find zones that may contain barcodes. -4. Barcodes-locating: to find exact locations of barcodes. - -## Output and Parameters - -Each of these stages has its own output (known as an intermediate result) and usually a specific parameter that can regulate the operation: - -| Stage | Intermediate Result Type | Related Parameter | -| ------------------- | ------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Contour-locating | `IRUT_CONTOURS` | [`LocalizationModes`](../../parameters/reference/barcode-reader-task-settings/localization-modes.md) | -| Line-locating | `IRUT_LINE_SEGMENTS` | [`LocalizationModes`](../../parameters/reference/barcode-reader-task-settings/localization-modes.md) | -| Candidates-locating | `IRUT_CANDIDATE_BARCODE_ZONES` | [`LocalizationModes`](../../parameters/reference/barcode-reader-task-settings/localization-modes.md) | -| Barcodes-locating | `IRUT_LOCALIZED_BARCODES` | [`LocalizationModes`](../../parameters/reference/barcode-reader-task-settings/localization-modes.md) | \ No newline at end of file diff --git a/architecture/image-processing/document-detection.md b/architecture/image-processing/document-detection.md deleted file mode 100644 index c179149..0000000 --- a/architecture/image-processing/document-detection.md +++ /dev/null @@ -1,71 +0,0 @@ ---- -layout: default-layout -title: Document Detection Section - Dynamsoft Capture Vision Architecture -description: This article introduces Document Detection Section in the Dynamsoft Capture Vision architecture. -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true -permalink: /architecture/image-processing/document-detection.html ---- - -The following diagram shows how sections connect to each other to form tasks: - -```mermaid -flowchart LR; - A[1.Region Pre-Detection]-->C[2.1.Shared Detection] - C---D[2.2.Barcode Localization] - C---E[2.2.Text-line Localization] - C---F[2.2.Document Detection] - D---G[3.Barcode Decoding] - E---H[3.Text-line Recognition] - F---I[3.Document Normalization] - style F fill:#f96,stroke:#333,stroke-width:4px -``` - -In this article, we'll discuss the section **Document Detection** which is the product-specific part of the 2nd section of a "Normalize-a-Document" task. - -> The 2nd section of a "Normalize-a-Document" task consists of [**Shared Detection**](shared-detection.md) and **Document Detection**. - -# Section 2.2 - Document Detection - -The purpose of this section is to find the exact locations of "documents" on the image. - -> A document is an object that exhibit clear boundaries. - -## Constituting Stages - -This section consists of multiple stages which forms a fixed and relatively complete set of workflow: - -1. Contour-locating: to find contours that may be part of the document boundaries. -2. Line-locating: to find lines that may be part of the document boundaries. -3. Long-line-merging: to merge line segments into long lines. -4. Corner-locating: to find corners at intersections of long lines. -5. Candidate-quad-edge-locating: to find candidate edges that may be part of the quads. -6. Quad-locating: to find exact locations of documents. - -### Main Work Flow - -The algorithm first finds the contour of the target item and extracts line segments from the contour. After a series of processing, the library calculates the corners, edges, and finally determines the position of the boundaries. Each boundary is output as a quadrilateral and the coordinates of its four vertices. - -
    -

    document-detection

    -

    -
    - -## Output and Parameters - -Each of these stages has its own output (known as an intermediate result) and usually a specific parameter that can regulate the operation: - -| Stage | Intermediate Result Type | Related Parameter | -| ---------------------------- | --------------------------- | ------------------------------------------------------------------------------------------------------------------- | -| Contour-locating | `IRUT_CONTOURS` | N/A | -| Line-locating | `IRUT_LINE_SEGMENTS` | [`LineExtractionModes`](../../parameters/reference/document-normalizer-task-settings/line-extraction-modes.md) | -| Long-line-merging | `IRUT_LONG_LINES` | N/A | -| Corner-locating | `IRUT_CORNERS` | [`CornerAngleRange`](../../parameters/reference/document-normalizer-task-settings/corner-angle-range.md) | -| Candidate-quad-edge-locating | `IRUT_CANDIDATE_QUAD_EDGES` | N/A | -| Quad-locating | `IRUT_DETECTED_QUADS` | N/A | - -The following parameter may affect the whole process: - -- [`ContentType`](../../parameters/reference/document-normalizer-task-settings/content-type.md) -- [`QuadrilateralDetectionModes`](../../parameters/reference/document-normalizer-task-settings/quadrilateral-detection-modes.md) diff --git a/architecture/image-processing/document-normalization.md b/architecture/image-processing/document-normalization.md deleted file mode 100644 index a693a3d..0000000 --- a/architecture/image-processing/document-normalization.md +++ /dev/null @@ -1,45 +0,0 @@ ---- -layout: default-layout -title: Document Normalization Section - Dynamsoft Capture Vision Architecture -description: This article introduces Document Normalization Section in the Dynamsoft Capture Vision architecture. -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true ---- - -The following diagram shows how sections connect to each other to form tasks: - -```mermaid -flowchart LR; - A[1.Region Pre-Detection]-->C[2.1.Shared Detection] - C---D[2.2.Barcode Localization] - C---E[2.2.Text-line Localization] - C---F[2.2.Document Detection] - D---G[3.Barcode Decoding] - E---H[3.Text-line Recognition] - F---I[3.Document Deskewing] - I---J[4.Image Enhancement] - style I fill:#f96,stroke:#333,stroke-width:4px -``` - -In this article, we'll discuss the section **Document Deskewing** which is usually the 3rd section of a "Normalize-a-Document" task. - -# Section 3 - Document Deskewing - -The purpose of this section is to generate a standard rectangular image of the "document" localized in the section "Document Detection". - -> A document is an object that exhibit clear boundaries. - -## Constituting Stages - -This section consists of just one stage: - -- Document-deskewing: to deskew the document which may involve one or several of these actions: - - Deskew - - Perspective correction - -## Output and Parameters - -| Stage | Intermediate Result Type | Related Parameter | -| ----- | ------------------------ | ----------------- | -| Document-deskewing | `IRUT_DESKEWED_IMAGE` | [`PageSize`](../../parameters/reference/document-normalizer-task-settings/page-size.md), [`DeskewMode`](../../parameters/reference/document-normalizer-task-settings/deskew-mode.md) | diff --git a/architecture/image-processing/region-predetection.md b/architecture/image-processing/region-predetection.md deleted file mode 100644 index 240c227..0000000 --- a/architecture/image-processing/region-predetection.md +++ /dev/null @@ -1,51 +0,0 @@ ---- -layout: default-layout -title: Region-Pre-detection Section - Dynamsoft Capture Vision Architecture -description: This article introduces Region-Pre-detection Section in the Dynamsoft Capture Vision architecture. -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true -permalink: /architecture/image-processing/region-predetection.html ---- - -The following diagram shows how sections connect to each other to form tasks: - -```mermaid -flowchart LR; - A[1.Region Pre-Detection]-->C[2.1.Shared Detection] - C---D[2.2.Barcode Localization] - C---E[2.2.Text-line Localization] - C---F[2.2.Document Detection] - D---G[3.Barcode Decoding] - E---H[3.Text-line Recognition] - F---I[3.Document Normalization] - style A fill:#f96,stroke:#333,stroke-width:4px -``` - -In this article, we'll discuss the first section of a task - **Region Pre-Detection**: - -# Section 1 - Region Pre-Detection - -The purpose of this section is to reduce the overall time cost of the task by finding regions of interest (ROIs) and thus ignoring other parts of the image during subsequent processing. It is not required for the task and can be skipped in many cases. - -## Constituting Stages - -This section consists of multiple stages: - -1. Cropping: to crop out the original ROI *specified* by the user. If not specified, return the original image as a whole. -2. Down-scaling: to down-scale a massive image. -3. Grayscaling: to convert a colour image to grayscale. -4. Transforming: to transform a grayscale image. -5. Pre-Detecting: to pre-detect the regions exhibit specific features. - -## Output and Parameters - -Each of the five stages has its own output (known as an intermediate result) and a specific parameter that can regulate the operation: - -| Stage | Intermediate Result Type | Related Parameter | -| ------------- | ---------------------------------- | --------------------------------------------------------------------------------------------------------------- | -| Cropping | `IRUT_COLOUR_IMAGE` | [`Location`](../../parameters/reference/target-roi-def/location.md) | -| Down-scaling | `IRUT_SCALED_DOWN_COLOUR_IMAGE` | [`ScaleDownThreshold`](../../parameters/reference/image-parameter/scale-down-threshold.md) | -| Grayscaling | `IRUT_GRAYSCALE_IMAGE` | [`ColourConversionModes`](../../parameters/reference/image-parameter/colour-conversion-modes.md) | -| Transforming | `IRUT_TRANSFORMED_GRAYSCALE_IMAGE` | [`GrayscaleTransformationModes`](../../parameters/reference/image-parameter/grayscale-transformation-modes.md) | -| Pre-Detecting | `IRUT_PREDETECTED_REGIONS` | [`RegionPredetectionModes`](../../parameters/reference/image-parameter/region-predetection-modes.md) | diff --git a/architecture/image-processing/shared-detection.md b/architecture/image-processing/shared-detection.md deleted file mode 100644 index dc63608..0000000 --- a/architecture/image-processing/shared-detection.md +++ /dev/null @@ -1,71 +0,0 @@ ---- -layout: default-layout -title: Shared Detection - Dynamsoft Capture Vision Architecture -description: This article introduces Shared Detection in the Dynamsoft Capture Vision architecture. -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true -permalink: /architecture/image-processing/shared-detection.html ---- - -The following diagram shows how sections connect to each other to form tasks: - -```mermaid -flowchart LR; - A[1.Region Pre-Detection]-->C[2.1.Shared Detection] - C---D[2.2.Barcode Localization] - C---E[2.2.Text-line Localization] - C---F[2.2.Document Detection] - D---G[3.Barcode Decoding] - E---H[3.Text-line Recognition] - F---I[3.Document Normalization] - style C fill:#f96,stroke:#333,stroke-width:4px -``` - -In this article, we'll discuss the special section - **Shared Detection**. - -# Section 2.1 - Shared Detection - -As discussed in ["Divide Tasks into Sections"](index.md#divide-tasks-into-sections), an image-processing task usually consists of three sections. The 2nd section is one of the following three - -- Barcode Localization -- Text-line Localization -- Document Detection - -Each of these three sections consists of multiple stages and they all start with 11 identical stages which are grouped together with the name "Shared Detection". - -> **Important NOTE** -> -> **The section "Shared Detection" is only a concept invented to simplify the explanation of the image-processing workflow. It doesn't technically exist and is not a member of the parameter `Section` which are found in [`SectionImageParameterArray`](../../parameters/reference/shared-parameter/section-image-parameter-array.md) and [`TerminateSetting`](../../parameters/reference/shared-parameter/terminate-setting.md), etc. and cannot be assigned to the parameter [`StartSection`](../../parameters/reference/shared-parameter/start-section.md).** - -## Constituting Stages - -1. Cropping: to crop out the regions of interest which are found by the previous section "Region Pre-detection". If no such region was found, return the original image as a whole. -2. Down-scaling: to down-scale a massive image. -3. Grayscaling: to convert a colour image to grayscale. -4. Transforming: to transform a grayscale image. -5. Enhancing: to improve the quality of a grayscale image. -6. Binarizing: to convert a grayscale image to black & white. -7. Texture-detecting: to detect texture on a binary image. -8. Texture-removing-1: to remove the texture of a grayscale image. -9. Texture-removing-2: to remove the texture of a binary image. -10. Text-zone-detecting: to find the exact locations of text zones. -11. Text-removing: to remove text from a binary image. - -## Output and Parameters - -Each of these stages has its own output (known as an intermediate result) and usually a specific parameter that can regulate the operation: - -| Stage | Intermediate Result Type | Related Parameter | -| ------------------- | -------------------------------------- | --------------------------------------------------------------------------------------------------------------- | -| Cropping | `IRUT_COLOUR_IMAGE` | N/A | -| Down-scaling | `IRUT_SCALED_DOWN_COLOUR_IMAGE` | [`ScaleDownThreshold`](../../parameters/reference/image-parameter/scale-down-threshold.md) | -| Grayscaling | `IRUT_GRAYSCALE_IMAGE` | [`ColourConversionModes`](../../parameters/reference/image-parameter/colour-conversion-modes.md) | -| Transforming | `IRUT_TRANSFORMED_GRAYSCALE_IMAGE` | [`GrayscaleTransformationModes`](../../parameters/reference/image-parameter/grayscale-transformation-modes.md) | -| Enhancing | `IRUT_ENHANCED_GRAYSCALE_IMAGE` | [`GrayscaleEnhancementModes`](../../parameters/reference/image-parameter/grayscale-enhancement-modes.md) | -| Binarizing | `IRUT_BINARY_IMAGE` | [`BinarizationModes`](../../parameters/reference/image-parameter/binarization-modes.md) | -| Texture-detecting | `IRUT_TEXTURE_DETECTION_RESULT` | [`TextureDetectionModes`](../../parameters/reference/image-parameter/texture-detection-modes.md) | -| Texture-removing-1 | `IRUT_TEXTURE_REMOVED_GRAYSCALE_IMAGE` | N/A | -| Texture-removing-2 | `IRUT_TEXTURE_REMOVED_BINARY_IMAGE` | N/A | -| Text-zone-detecting | `IRUT_TEXT_ZONES` | [`TextDetectionMode`](../../parameters/reference/image-parameter/text-detection-mode.md) | -| Text-removing | `IRUT_TEXT_REMOVED_BINARY_IMAGE` | [`IfEraseTextZone`](../../parameters/reference/image-parameter/if-erase-text-zone.md) | diff --git a/architecture/image-processing/textline-localization.md b/architecture/image-processing/textline-localization.md deleted file mode 100644 index f28a474..0000000 --- a/architecture/image-processing/textline-localization.md +++ /dev/null @@ -1,43 +0,0 @@ ---- -layout: default-layout -title: Text-line Localization Section - Dynamsoft Capture Vision Architecture -description: This article introduces Text-line Localization Section in the Dynamsoft Capture Vision architecture. -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true -permalink: /architecture/image-processing/textline-localization.html ---- - -The following diagram shows how sections connect to each other to form tasks: - -```mermaid -flowchart LR; - A[1.Region Pre-Detection]-->C[2.1.Shared Detection] - C---D[2.2.Barcode Localization] - C---E[2.2.Text-line Localization] - C---F[2.2.Document Detection] - D---G[3.Barcode Decoding] - E---H[3.Text-line Recognition] - F---I[3.Document Normalization] - style E fill:#f96,stroke:#333,stroke-width:4px -``` - -In this article, we'll discuss the section **Text-line Localization** which is the product-specific part of the 2nd section of a "Recognize-Text-Lines" task. - -> The 2nd section of a "Recognize-Text-Lines" task consists of [**Shared Detection**](shared-detection.md) and **Text-line Localization**. - -# Section 2.2 - Text-line Localization - -The purpose of this section is to detect the exact locations of text-lines. - -## Constituting Stages - -This section consists of only one stage: - -- Text-line-locating: to find the exact locations of the text-lines. - -## Output and Parameters - -| Stage | Intermediate Result Type | Related Parameter | -| ------------------ | --------------------------- | ----------------- | -| Text-line-locating | `IRUT_LOCALIZED_TEXT_LINES` | N/A | diff --git a/architecture/image-processing/textline-recognition.md b/architecture/image-processing/textline-recognition.md deleted file mode 100644 index 178ff04..0000000 --- a/architecture/image-processing/textline-recognition.md +++ /dev/null @@ -1,49 +0,0 @@ ---- -layout: default-layout -title: Text-line Recognition Section - Dynamsoft Capture Vision Architecture -description: This article introduces Text-line Recognition Section in the Dynamsoft Capture Vision architecture. -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true -permalink: /architecture/image-processing/textline-recognition.html ---- - -The following diagram shows how sections connect to each other to form tasks: - -```mermaid -flowchart LR; - A[1.Region Pre-Detection]-->C[2.1.Shared Detection] - C---D[2.2.Barcode Localization] - C---E[2.2.Text-line Localization] - C---F[2.2.Document Detection] - D---G[3.Barcode Decoding] - E---H[3.Text-line Recognition] - F---I[3.Document Normalization] - style H fill:#f96,stroke:#333,stroke-width:4px -``` - -In this article, we'll discuss the section **Text-line Recognition** which is usually the 3rd section of a "Recognize-Text-Lines" task. - -# Section 3 - Text-line Recognition - -The purpose of this section is to recognize the text from the text-line areas identified in the previous section "Text-line Localization". - -## Constituting Stages - -This section consists of the following stages: - -1. Cropping: to cut out the text-line areas based on text-line localization results. This results in one or multiple colour images. -2. Grayscaling: to convert the colour image(s) to grayscale. -3. Transforming: to transform the grayscale image(s). -4. Text-line-recognizing: to recognize the text. - -## Output and Parameters - -Each of these stages has its own output (known as an intermediate result) and usually a specific parameter that can regulate the operation: - -| Stage | Intermediate Result Type | Related Parameter | -| --------------------- | ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -| Cropping | `IRUT_COLOUR_IMAGE` | N/A | -| Grayscaling | `IRUT_GRAYSCALE_IMAGE` | [`ColourConversionModes`](../../parameters/reference/image-parameter/colour-conversion-modes.md) | -| Transforming | `IRUT_TRANSFORMED_GRAYSCALE_IMAGE` | [`GrayscaleTransformationModes`](../../parameters/reference/image-parameter/grayscale-transformation-modes.md) | -| Text-line-recognizing | `IRUT_RECOGNIZED_TEXT_LINES` | [`DictionaryPath`](../../parameters/reference/label-recognizer-task-settings/dictionary-path.md)
    [`DictionaryCorrectionThresholds`](../../parameters/reference/label-recognizer-task-settings/dictionary-correction-thresholds.md)
    [`StringLengthRange`](../../parameters/reference/label-recognizer-task-settings/string-length-range.md)
    [`StringRegExPattern`](../../parameters/reference/label-recognizer-task-settings/string-regex-pattern.md) | diff --git a/architecture/index.md b/architecture/index.md index d54a850..f0522bd 100644 --- a/architecture/index.md +++ b/architecture/index.md @@ -5,7 +5,6 @@ description: This is the main page of Dynamsoft Capture Vision Architecture. needAutoGenerateSidebar: true needGenerateH3Content: true noTitleIndex: false -permalink: /architecture/index.html --- # Architecture of Dynamsoft Capture Vision @@ -42,16 +41,16 @@ In the DCV architecture, an **image source** refers to any object that implement At runtime, CVR accepts an image source and acts as the image input provider for functional products. Typically, this process is continuous and only ends when the image source is exhausted. -### Coordinating Image-Processing Tasks +### Coordinating Processing Tasks -CVR accepts and maintains a list of image-processing settings known as [CaptureVisionTemplates](../parameters/file/capture-vision-template.md). Each template defines the tasks to be performed on an image. These tasks can be configured to run either in parallel or sequentially. +CVR accepts and maintains a list of processing settings known as [parameter template](../parameters/file/index.md). Each template defines the tasks to be performed on an image. These tasks can be configured to run either in parallel or sequentially. At runtime, CVR selects a *CaptureVisionTemplate* and analyzes it to construct a task workflow, which then runs for all images acquired from the image source. - For tasks that can run in parallel, CVR processes the next image as long as there is an available working thread to create a *functional product* instance. Read more about [Parallel Image-Processing](#parallel-image-processing). - For tasks that must run in sequence, CVR ensures that each task follows the correct order of operations. -> There are two types of tasks. Learn more about [Image-Processing Tasks](../parameters/file/task-settings/index.md) and [Semantic-Processing Tasks](semantic-processing.md). +> There are two types of tasks. Learn more about [Image-Processing Tasks](./image-processing/index.md) and [Semantic-Processing Tasks](semantic-processing.md). ### Dispatching Results to Listening Objects @@ -62,7 +61,7 @@ As CVR processes images, different types of results are generated. These results 1. **Final results** (*Captured Results*): These are the outputs of a completed task. Read more about them [here](output.md#final-results). 2. **Intermediate results**: These are results produced at various checkpoints during task execution. - > These checkpoints are called *stages*. These stages are further grouped into seven categories known as *image-processing sections*. Learn more about [Image-Processing Tasks](../parameters/file/task-settings/index.md). + > These checkpoints are called *stages*. These stages are further grouped into seven categories known as *image-processing sections*. Learn more about [Image-Processing Tasks](./image-processing/index.md). The following diagram provides a simplified overview of the CVR workflow: @@ -106,7 +105,7 @@ The required tasks for processing this image are: 2. **Read the barcode** to retrieve the patient ID (*DBR Task*). 3. **Extract text above the barcode** to determine COVID-19 test results (*DLR Task*). -Here’s a simple representation of "task coordination": +Here's a simple representation of "task coordination": ![CVR-Task-Coordination](assets/CVR-Tasks-Coordination.png) ***Diagram 3: CVR Task Coordination*** @@ -119,9 +118,9 @@ DCV optimizes performance through **Intermediate Results Sharing** and **Paralle #### **Intermediate Results Sharing** -Previously, we discussed how [CVR dispatches results to listening objects](#dispatching-results-to-listening-objects) and [coordinates image-processing tasks](#coordinating-image-processing-tasks). Some tasks share "common image analysis stages", allowing **intermediate results** to be reused across tasks. +Previously, we discussed how [CVR dispatches results to listening objects](#dispatching-results-to-listening-objects) and [coordinates processing tasks](#coordinating-processing-tasks). Some tasks share "common image analysis stages", allowing **intermediate results** to be reused across tasks. -Here’s a demonstration of **intermediate result sharing**: +Here's a demonstration of **intermediate result sharing**: ![Intermediate-Result-Sharing](assets/Intermediate-Result-Sharing.png) ***Diagram 4: Intermediate Results Sharing*** @@ -150,18 +149,18 @@ As shown in **Diagram 3** above, CVR maintains a pool of functional product inst One of the biggest advantages of the DCV architecture is its **simple outward-facing API**. -Let’s revisit the three core jobs of **CVR** (see [Capture Vision Router](#capture-vision-router) and *Diagram 2*): +Let's revisit the three core jobs of **CVR** (see [Capture Vision Router](#capture-vision-router) and *Diagram 2*): | **Index** | **Description** | **Corresponding API of CVR** | |:---------:|-----------------------------------------|---------------------------------------------------------------------------------------------| | **1** | Retrieve images from the image source | `SetInput()` accepts an image source. | -| **2** | Coordinate image-processing tasks | `InitSettings()` loads a parameter file defining workflows, and `StartCapturing()` executes a workflow. | +| **2** | Coordinate processing tasks | `InitSettings()` loads a parameter file defining workflows, and `StartCapturing()` executes a workflow. | | **3** | Dispatch results to listening objects | `AddResultReceiver()` registers one or more listeners. | - Jobs 1 & 3 handle straightforward **input and output**. - Job 2 determines the **actual workflow and application behavior**. -In some scenarios, workflows remain consistent, allowing predefined settings to be used. These settings are called ["CaptureVisionTemplates"](../parameters/file/capture-vision-template.md). Customers can simply select a template, reducing development effort. Read more about [common scenarios](../introduction/index.md#simplicity-with-packable-scenarios). +In some scenarios, workflows remain consistent, allowing predefined settings to be used. These settings are called `preset template`. Customers can simply select a template, reducing development effort. Read more about [common scenarios](../introduction/index.md#simplicity-with-packable-scenarios). ### Bidirectional Interactivity with Intermediate Results @@ -175,7 +174,7 @@ For example, during barcode reading, one stage may *detect* the barcode location To address this, we use a **listening object** with the [Intermediate Result Receiver (IRR) interface](output.md#intermediate-result-receiver). This object listens for localized barcodes and decoded barcodes, applying different visual cues. -Here’s a visual representation of how CVR dispatches intermediate results: +Here's a visual representation of how CVR dispatches intermediate results: ![Intermediate-Result-Dispatch](assets/Intermediate-Result-Dispatch.png) ***Diagram 5: Intermediate Results Dispatching*** @@ -188,11 +187,11 @@ Here’s a visual representation of how CVR dispatches intermediate results: 1. A specific type of *intermediate result* is generated. 2. CVR dispatches the result to a registered listener and pauses processing. -3. The customer’s code in the callback function receives the result. +3. The customer's code in the callback function receives the result. 4. The code examines, modifies, and returns the result to CVR. 5. CVR injects the updated data back into the workflow and resumes processing. -Here’s a visual demonstration of this process: +Here's a visual demonstration of this process: ![Intermediate-Result-Intervention](assets/Intermediate-Result-Intervention.png) ***Diagram 6: Intermediate Results Intervention*** diff --git a/enums/barcode-reader/barcode-format.md b/enums/barcode-reader/barcode-format.md deleted file mode 100644 index 8b7b4fc..0000000 --- a/enums/barcode-reader/barcode-format.md +++ /dev/null @@ -1,767 +0,0 @@ ---- -layout: default-layout -title: BarcodeFormat - Dynamsoft Barcode Reader Enumerations -description: The enumeration BarcodeFormat of Dynamsoft Barcode Reader defines the supported barcode formats. -keywords: Barcode formats -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: BarcodeFormat -codeAutoHeight: true ---- - -# Enumeration BarcodeFormat - -`BarcodeFormat` defines the supported barcode formats. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - >- C# - >- Python - > -> -```javascript -enum EnumBarcodeFormat { - /** No barcode format specified.*/ - BF_NULL = 0x00, - /** Represents all supported barcode formats. Useful for scanning operations where any type of barcode is acceptable. */ - BF_ALL = 0xFFFFFFFEFFFFFFFF, - /** Default barcode formats that are commonly used. This is a subset of `BF_ALL` tailored for general use. */ - BF_DEFAULT = 0xFE3BFFFF, - /** One-dimensional barcode formats, including BF_CODE_39, BF_CODE_128, BF_CODE_93, BF_CODABAR, BF_ITF, BF_EAN_13, BF_EAN_8, BF_UPC_A, BF_UPC_E, INDUSTRIAL_25, BF_CODE_39_Extended, BF_CODE_11 and BF_MSI_CODE. */ - BF_ONED = 0x3007FF, - /** Code 39 format, widely used in various industries for inventory and manufacturing. */ - BF_CODE_39 = 0x1, - /** Code 128 format, a high-density barcode for alphanumeric or numeric-only data. */ - BF_CODE_128 = 0x2, - /** Code 93 format, similar to Code 39 but more compact and secure with support for the full ASCII character set. */ - BF_CODE_93 = 0x4, - /** Codabar format, used for various numeric barcodes in libraries, blood banks, and parcels. */ - BF_CODABAR = 0x8, - /** Interleaved 2 of 5 format, a numeric-only barcode used in warehousing, distribution, and logistics. */ - BF_ITF = 0x10, - /** EAN-13 format, a superset of the UPC-A barcode used worldwide for marking retail goods. */ - BF_EAN_13 = 0x20, - /** EAN-8 format, a compressed version of EAN-13 for smaller packages. */ - BF_EAN_8 = 0x40, - /** UPC-A format, widely used in the United States and Canada for tracking trade items in stores. */ - BF_UPC_A = 0x80, - /** UPC-E format, a smaller version of the UPC-A barcode used for smaller packages. */ - BF_UPC_E = 0x100, - /** Industrial 2 of 5 format, an older, numeric-only barcode used in the industrial sector. */ - BF_INDUSTRIAL_25 = 0x200, - /** Extended Code 39 format, capable of encoding the full ASCII character set by combining standard Code 39 characters. */ - BF_CODE_39_EXTENDED = 0x400, - /** GS1 DataBar barcode formats, including BF_GS1_DATABAR_OMNIDIRECTIONAL, BF_GS1_DATABAR_TRUNCATED, BF_GS1_DATABAR_STACKED, BF_GS1_DATABAR_STACKED_OMNIDIRECTIONAL, BF_GS1_DATABAR_EXPANDED, BF_GS1_DATABAR_EXPANDED_STACKED, BF_GS1_DATABAR_LIMITED. These barcodes are designed for use in retail and healthcare for fresh foods and small items. */ - BF_GS1_DATABAR = 0x3F800, - BF_GS1_DATABAR_OMNIDIRECTIONAL = 0x800, - BF_GS1_DATABAR_TRUNCATED = 0x1000, - BF_GS1_DATABAR_STACKED = 0x2000, - BF_GS1_DATABAR_STACKED_OMNIDIRECTIONAL = 0x4000, - BF_GS1_DATABAR_EXPANDED = 0x8000, - BF_GS1_DATABAR_EXPANDED_STACKED = 0x10000, - BF_GS1_DATABAR_LIMITED = 0x20000, - /** Patch code, a special barcode used for document scanning applications to separate batches of documents. */ - BF_PATCHCODE = 0x40000, - /** Micro PDF417, a compact version of PDF417 used for applications where space is limited. */ - BF_MICRO_PDF417 = 0x80000, - /** MSI Code, a barcode used in inventory and warehouse to encode information in the distribution of goods. */ - BF_MSI_CODE = 0x100000, - /** Code 11, used primarily for labeling telecommunications equipment. */ - BF_CODE_11 = 0x200000, - /** Two-Digit Add-On, an extension to UPC and EAN codes for magazines and books. */ - BF_TWO_DIGIT_ADD_ON = 0x400000, - /** Five-Digit Add-On, used with UPC and EAN codes for additional data, such as suggested retail price. */ - BF_FIVE_DIGIT_ADD_ON = 0x800000, - /** Code 32, also known as Italian PharmaCode, used specifically in the Italian pharmaceutical industry. */ - BF_CODE_32 = 0x1000000, - /** PDF417, a two-dimensional barcode used in a variety of applications, capable of encoding large amounts of data. */ - BF_PDF417 = 0x2000000, - /** QR Code, a widely used two-dimensional barcode with high data capacity and error correction capability. */ - BF_QR_CODE = 0x4000000, - /** DataMatrix, a two-dimensional barcode used for marking small items, providing high data density and reliability. */ - BF_DATAMATRIX = 0x8000000, - /** Aztec, a two-dimensional barcode known for its compact size and suitability for encoding small amounts of data efficiently. */ - BF_AZTEC = 0x10000000, - /** MaxiCode, a two-dimensional barcode used primarily for parcel and package tracking in logistics and postal services. */ - BF_MAXICODE = 0x20000000, - /** Micro QR, a smaller version of the QR Code designed for applications where space is limited. */ - BF_MICRO_QR = 0x40000000, - /** GS1 Composite, a group of barcodes used in conjunction with GS1 DataBar or linear barcodes to provide additional information. */ - BF_GS1_COMPOSITE = 0x80000000, - /** Nonstandard barcode, a placeholder for barcodes that do not conform to established industry standards. */ - BF_NONSTANDARD_BARCODE = 0x100000000, - /** DotCode, a two-dimensional barcode designed for high-speed printing applications. */ - BF_DOTCODE = 0x200000000, - /** PharmaCode, a general category that includes both BF_PHARMACODE_ONE_TRACK and BF_PHARMACODE_TWO_TRACK. */ - BF_PHARMACODE = 0xC00000000, - /** PharmaCode One Track, used in the pharmaceutical industry for packaging control. */ - BF_PHARMACODE_ONE_TRACK = 0x400000000, - /** PharmaCode Two Track, an extension of PharmaCode for encoding additional data. */ - BF_PHARMACODE_TWO_TRACK = 0x800000000, - /** Matrix 2 of 5, an older form of barcode used in warehouse sorting and conveyor systems. */ - BF_MATRIX_25 = 0x1000000000, - /** Postal code barcodes, including various formats (BF_USPSINTELLIGENTMAIL, BF_POSTNET, BF_PLANET, BF_AUSTRALIANPOST, BF_RM4SCC and BF_KIX) used by postal services worldwide for efficient mail sorting and delivery. */ - BF_POSTALCODE = 0x3F0000000000000, - /** USPS Intelligent Mail, a barcode used by the United States Postal Service to provide greater information and tracking capabilities. */ - BF_USPSINTELLIGENTMAIL = 0x10000000000000, - /** Postnet, used by the USPS for automating the sorting of mail. */ - BF_POSTNET = 0x20000000000000, - /** Planet, another USPS barcode, similar to Postnet, but with additional data capacity. */ - BF_PLANET = 0x40000000000000, - /** Australian Post, barcodes used by the Australian postal service for mail sorting. */ - BF_AUSTRALIANPOST = 0x80000000000000, - /** RM4SCC (Royal Mail 4 State Customer Code), used by the UK's Royal Mail for automated mail sorting. */ - BF_RM4SCC = 0x100000000000000, - /** KIX (Klant index - Customer index), used by the Dutch postal service for sorting mail. */ - BF_KIX = 0x200000000000000 -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumBarcodeFormat { - /**All supported formats in BarcodeFormat.*/ - public static final long BF_ALL = 0xFFFFFFFEFFFFFFFF; - /**The default settings.*/ - public static final long BF_DEFAULT = 0xFE3BFFFFL; - /**Combined value of BF_CODABAR, BF_CODE_128, BF_CODE_39, BF_CODE_39_Extended, BF_CODE_93, BF_EAN_13, BF_EAN_8, INDUSTRIAL_25, BF_ITF, BF_UPC_A, BF_UPC_E, BF_MSI_CODE.*/ - public static final long BF_ONED = 0x3007FFL; - /**Combined value of BF_GS1_DATABAR_OMNIDIRECTIONAL, BF_GS1_DATABAR_TRUNCATED, BF_GS1_DATABAR_STACKED, BF_GS1_DATABAR_STACKED_OMNIDIRECTIONAL, BF_GS1_DATABAR_EXPANDED, BF_GS1_DATABAR_EXPANDED_STACKED, BF_GS1_DATABAR_LIMITED*/ - public static final long BF_GS1_DATABAR = 0x3F800L; - /**Disable all barcode format.*/ - public static final long BF_NULL = 0L; - /**Code 39.*/ - public static final long BF_CODE_39 = 1L << 0; - /**Code 128.*/ - public static final long BF_CODE_128 = 1L << 1; - /**Code 93.*/ - public static final long BF_CODE_93 = 1L << 2; - /**Codabar.*/ - public static final long BF_CODABAR = 1L << 3; - /**Interleaved 2 of 5.*/ - public static final long BF_ITF = 1L << 4; - /**EAN 13.*/ - public static final long BF_EAN_13 = 1L << 5; - /**EAN_8 barcode.*/ - public static final long BF_EAN_8 = 1L << 6; - /**UPC_A barcode.*/ - public static final long BF_UPC_A = 1L << 7; - /**UPC_E barcode.*/ - public static final long BF_UPC_E = 1L << 8; - /**Industrial 25 barcode*/ - public static final long BF_INDUSTRIAL_25 = 1L << 9; - /**Code 39 Extended.*/ - public static final long BF_CODE_39_EXTENDED = 1L << 10; - /**GS1 Databar - Omnidirectional.*/ - public static final long BF_GS1_DATABAR_OMNIDIRECTIONAL = 1L << 11; - /**GS1 Databar - Truncated.*/ - public static final long BF_GS1_DATABAR_TRUNCATED = 1L << 12; - /**GS1 Databar - Stacked.*/ - public static final long BF_GS1_DATABAR_STACKED = 1L << 13; - /**GS1 Databar - Stacked omnidirectional.*/ - public static final long BF_GS1_DATABAR_STACKED_OMNIDIRECTIONAL = 1L << 14; - /**GS1 Databar - Expanded.*/ - public static final long BF_GS1_DATABAR_EXPANDED = 1L << 15; - /**GS1 Databar - Expanded stacked.*/ - public static final long BF_GS1_DATABAR_EXPANDED_STACKED = 1L << 16; - /**GS1 Databar - Limited.*/ - public static final long BF_GS1_DATABAR_LIMITED = 1L << 17; - /**Patch code.*/ - public static final long BF_PATCHCODE = 1L << 18; - /**Micro PDF417 barcode.*/ - public static final long BF_MICRO_PDF417 = 1L << 19; - /**MSI code.*/ - public static final long BF_MSI_CODE = 1L << 20; - /**Code 11.*/ - public static final long BF_CODE_11 = 1L << 21; - /**Decode barcode with 2 digital addons.*/ - public static final long BF_TWO_DIGIT_ADD_ON = 1L << 22, - /**Decode barcode with 5 digital addons.*/ - public static final long BF_FIVE_DIGIT_ADD_ON = 1L << 23, - /**Code 32*/ - public static final long BF_CODE_32 = 1L << 24; - /**PDF417 barcode.*/ - public static final long BF_PDF417 = 1L << 25; - /**QR code.*/ - public static final long BF_QR_CODE = 1L << 26; - /**Data matrix.*/ - public static final long BF_DATAMATRIX = 1L << 27; - /**AZTEC barcode.*/ - public static final long BF_AZTEC = 1L << 28; - /**Maxicode.*/ - public static final long BF_MAXICODE = 1L << 29; - /**Micro QR Code.*/ - public static final long BF_MICRO_QR = 1L << 30; - /**GS1 Composite Code.*/ - public static final long BF_GS1_COMPOSITE = 1L << 31; - /**Nonstandard barcode.*/ - public static final long BF_NONSTANDARD_BARCODE = 1L << 32; - /**Dotcode.*/ - public static final long BF_DOTCODE = 1L << 33; - /**Pharma code.*/ - public static final long BF_PHARMACODE = 0xC00000000L; - /**Pharma code with one track.*/ - public static final long BF_PHARMACODE_ONE_TRACK = 1L << 34; - /**Pharma code with two track.*/ - public static final long BF_PHARMACODE_TWO_TRACK = 1L << 35; - /**Matrix25.*/ - public static final long BF_MATRIX_25 = 1L << 36; - /**Postal code*/ - public static final long BF_POSTALCODE = 0x1F0000000000000L; - /**USPS Intelligent Mail barcode.*/ - public static final long BF_USPSINTELLIGENTMAIL = 1L << 52; - /**Postnet barcode.*/ - public static final long BF_POSTNET = 1L << 53; - /**Planet barcode.*/ - public static final long BF_PLANET = 1L << 54; - /**Australian post barcode.*/ - public static final long BF_AUSTRALIANPOST = 1L << 55; - /**Royal Mail 4-State Customer barcode.*/ - public static final long BF_RM4SCC = 1L << 56; - /**Kix.*/ - public static final long BF_KIX = 1L << 57; -} -``` -> -```objc -typedef NS_OPTIONS(NSUInteger , DSBarcodeFormat) -{ - /**No barcode format in BarcodeFormat*/ - DSBarcodeFormatNull = 0, - /**All supported formats in BarcodeFormat .*/ - DSBarcodeFormatAll = 0xFFFFFFFEFFFFFFFF, - DSBarcodeFormatDefault = 0xFE3BFFFF, - /**Code 39*/ - DSBarcodeFormatCode39 = 1, - /**Code 128*/ - DSBarcodeFormatCode128 = 1 << 1, - /**Code 93*/ - DSBarcodeFormatCode93 = 1 << 2, - /**Codabar*/ - DSBarcodeFormatCodabar = 1 << 3, - /**Interleaved 2 of 5*/ - DSBarcodeFormatITF = 1 << 4, - /**EAN-13*/ - DSBarcodeFormatEAN13 = 1 << 5, - /**EAN-8*/ - DSBarcodeFormatEAN8 = 1 << 6, - /**UPC-A*/ - DSBarcodeFormatUPCA = 1 << 7, - /**UPC-E*/ - DSBarcodeFormatUPCE = 1 << 8, - /**Industrial 2 of 5*/ - DSBarcodeFormatIndustrial25 = 1 << 9, - /**CODE39 Extended*/ - DSBarcodeFormatCode39Extended = 1 << 10, - /**DataBar Omnidirectional*/ - DSBarcodeFormatGS1DatabarOmniDirectional = 1 << 11, - /**DataBar Truncated*/ - DSBarcodeFormatGS1DatabarTruncated = 1 << 12, - /**DataBar Stacked*/ - DSBarcodeFormatGS1DatabarStacked = 1 << 13, - /**DataBar Stacked Omnidirectional*/ - DSBarcodeFormatGS1DatabarStackedOmniDirectional = 1 << 14, - /**DataBar Expanded*/ - DSBarcodeFormatGS1DatabarExpanded = 1 << 15, - /**DataBar Expaned Stacked*/ - DSBarcodeFormatGS1DatabarExpandedStacked = 1 << 16, - /**DataBar Limited*/ - DSBarcodeFormatGS1DatabarLimited = 1 << 17, - /**Patch code.*/ - DSBarcodeFormatPatchCode = 1 << 18, - /**Micro PDF417*/ - DSBarcodeFormatMicroPDF417 = 1 << 19, - /**MSI Code*/ - DSBarcodeFormatMSICode = 1 << 20, - /**CODE_11 .*/ - DSBarcodeFormatCode11 = 1 << 21, - /**Decode barcode with 2 digital addons.*/ - DSBarcodeFormatTwoDigitAddOn = 1 << 22, - /**Decode barcode with 5 digital addons.*/ - DSBarcodeFormatFiveDigitAddOn = 1 << 23, - /**Code 32*/ - DSBarcodeFormatCode32 = 1L << 24, - /**PDF417*/ - DSBarcodeFormatPDF417 = 1 << 25, - /**QRCode*/ - DSBarcodeFormatQRCode = 1 << 26, - /**DataMatrix*/ - DSBarcodeFormatDataMatrix = 1 << 27, - /**AZTEC*/ - DSBarcodeFormatAztec = 1 << 28, - /**MAXICODE*/ - DSBarcodeFormatMaxiCode = 1 << 29, - /**Micro QR Code*/ - DSBarcodeFormatMicroQR = 1 << 30, - /**GS1 Composite Code*/ - DSBarcodeFormatGS1Composite = 1 << 31, - /**Combined value of BF_CODABAR, BF_CODE_128, BF_CODE_39, BF_CODE_39_Extended, BF_CODE_93, BF_EAN_13, BF_EAN_8, INDUSTRIAL_25, BF_ITF, BF_UPC_A, BF_UPC_E, BF_MSI_CODE*/ - DSBarcodeFormatOneD = 0x3007FF, - /**Combined value of BF_GS1_DATABAR_OMNIDIRECTIONAL, BF_GS1_DATABAR_TRUNCATED, BF_GS1_DATABAR_STACKED, BF_GS1_DATABAR_STACKED_OMNIDIRECTIONAL, BF_GS1_DATABAR_EXPANDED, BF_GS1_DATABAR_EXPANDED_STACKED, BF_GS1_DATABAR_LIMITED*/ - DSBarcodeFormatGS1Databar = 0x3F800, - DSBarcodeFormatNonStandardBarcode = 1 << 32, - /**DotCode Barcode. - When you set this barcode format, the library will automatically add DSLocalizationModeStatisticsMarks to LocalizationMode if you don't set it,*/ - DSBarcodeFormatDotCode = 1 << 33, - /**PHARMACODE_ONE_TRACK*/ - DSBarcodeFormatPharmaCodeOneTrack = 1 << 34, - /**PHARMACODE_ONE_TRACK*/ - DSBarcodeFormatPharmaCodeTwoTrack = 1 << 35, - /**Matrix25.*/ - DSBarcodeFormatMatrix25 = 1L << 36, - /**PHARMACODE*/ - DSBarcodeFormatPharmaCode = 0xC00000000, - /**Combined value of DSBarcodeFormatUSPSINTELLIGENTMAIL, DSBarcodeFormatPOSTNET, DSBarcodeFormatPLANET, DSBarcodeFormatAUSTRALIANPOST, DSBarcodeFormatRM4SCC. - When you set this barcode format, the library will automatically add LocalizationModeStatisticsPostalCode to LocalizationMode if you don't set it,*/ - DSBarcodeFormatPostalCode = 0x1F0000000000000, - /**USPS Intelligent Mail. - When you set this barcode format, the library will automatically add LocalizationModeStatisticsPostalCode to LocalizationMode if you don't set it,*/ - DSBarcodeFormatUSPSIntelligentMail = 1 << 52, - /**Postnet. - When you set this barcode format, the library will automatically add LocalizationModeStatisticsPostalCode to LocalizationMode if you don't set it,*/ - DSBarcodeFormatPostnet = 1 << 53, - /**Planet. - When you set this barcode format, the library will automatically add LocalizationModeStatisticsPostalCode to LocalizationMode if you don't set it,*/ - DSBarcodeFormatPlant = 1 << 54, - /**Australian Post. - When you set this barcode format, the library will automatically add LocalizationModeStatisticsPostalCode to LocalizationMode if you don't set it,*/ - DSBarcodeFormatAustralianPost = 1 << 55, - /**Royal Mail 4-State Customer Barcode. - When you set this barcode format, the library will automatically add LocalizationModeStatisticsPostalCode to LocalizationMode if you don't set it,*/ - DSBarcodeFormatRM4SCC = 1 << 56, - /**Kix*/ - DSBarcodeFormatKix = 1L << 57 -}; -``` -> -```swift -public enum BarcodeFormat : Int -{ - /**No barcode format in BarcodeFormat*/ - Null = 0 - /**All supported formats in BarcodeFormat .*/ - all = 0xFFFFFFFEFFFFFFFF - default = 0xFE3BFFFF - /**Code 39*/ - code39 = 1 - /**Code 128*/ - code128 = 1 << 1 - /**Code 93*/ - code93 = 1 << 2 - /**Codabar*/ - codabar = 1 << 3 - /**Interleaved 2 of 5*/ - ITF = 1 << 4 - /**EAN-13*/ - EAN13 = 1 << 5 - /**EAN-8*/ - EAN8 = 1 << 6 - /**UPC-A*/ - UPCA = 1 << 7 - /**UPC-E*/ - UPCE = 1 << 8 - /**Industrial 2 of 5*/ - industrial25 = 1 << 9 - /**CODE39 Extended*/ - code39Extended = 1 << 10 - /**DataBar Omnidirectional*/ - gs1DatabarOmnidirectional = 1 << 11 - /**DataBar Truncated*/ - gs1DatabarTruncated = 1 << 12 - /**DataBar Stacked*/ - gs1DatabarStacked = 1 << 13 - /**DataBar Stacked Omnidirectional*/ - gs1DatabarStackedOmnidirectional = 1 << 14 - /**DataBar Expanded*/ - gs1DatabarExpanded = 1 << 15 - /**DataBar Expaned Stacked*/ - gs1DatabarExpandedStacked = 1 << 16 - /**DataBar Limited*/ - gs1DatabarLimited = 1 << 17 - /**Patch code.*/ - patchCode = 1 << 18 - /**Micro PDF417*/ - microPDF417 = 1 << 19 - /**MSI Code*/ - msiCode = 1 << 20 - /**CODE_11.*/ - code11 = 1 << 21 - /**Decode barcode with 2 digital addons.*/ - twoDigitAddOn = 1 << 22 - /**Decode barcode with 5 digital addons.*/ - fiveDigitAddOn = 1 << 23 - /**Code 32*/ - code32 = 1L << 24 - /**PDF417*/ - PDF417 = 1 << 25 - /**QRCode*/ - qrCode = 1 << 26 - /**DataMatrix*/ - dataMatrix = 1 << 27 - /**AZTEC*/ - aztec = 1 << 28 - /**MAXICODE*/ - maxiCode = 1 << 29 - /**Micro QR Code*/ - microQR = 1 << 30 - /**GS1 Composite Code*/ - gs1Composite = 1 << 31 - /**Combined value of BF_CODABAR, BF_CODE_128, BF_CODE_39, BF_CODE_39_Extended, BF_CODE_93, BF_EAN_13, BF_EAN_8, INDUSTRIAL_25, BF_ITF, BF_UPC_A, BF_UPC_E, BF_MSI_CODE*/ - oneD = 0x3007FF - /**Combined value of BF_GS1_DATABAR_OMNIDIRECTIONAL, BF_GS1_DATABAR_TRUNCATED, BF_GS1_DATABAR_STACKED, BF_GS1_DATABAR_STACKED_OMNIDIRECTIONAL, BF_GS1_DATABAR_EXPANDED, BF_GS1_DATABAR_EXPANDED_STACKED, BF_GS1_DATABAR_LIMITED*/ - gs1Databar = 0x3F800, - nonStandardBarcode = 1 << 32 - /**DotCode Barcode. - When you set this barcode format, the library will automatically add DSLocalizationModeStatisticsMarks to LocalizationMode if you don't set it,*/ - dotCode = 1 << 33 - /**PHARMACODE_ONE_TRACK*/ - pharmaCodeOneTrack = 1 << 34 - /**PHARMACODE_ONE_TRACK*/ - pharmaCodeTwoTrack = 1 << 35 - /**Matrix25.*/ - matrix25 = 1L << 36 - /**PHARMACODE*/ - pharmaCode = 0xC00000000 - /**Combined value of DSBarcodeFormatUSPSINTELLIGENTMAIL, DSBarcodeFormatPOSTNET, DSBarcodeFormatPLANET, DSBarcodeFormatAUSTRALIANPOST, DSBarcodeFormatRM4SCC. - When you set this barcode format, the library will automatically add LocalizationModeStatisticsPostalCode to LocalizationMode if you don't set it,*/ - postalCode = 0x1F0000000000000, - /**USPS Intelligent Mail. - When you set this barcode format, the library will automatically add LocalizationModeStatisticsPostalCode to LocalizationMode if you don't set it,*/ - uspsIntelligentMail = 1 << 52 - /**Postnet. - When you set this barcode format, the library will automatically add LocalizationModeStatisticsPostalCode to LocalizationMode if you don't set it,*/ - postnet = 1 << 53 - /**Planet. - When you set this barcode format, the library will automatically add LocalizationModeStatisticsPostalCode to LocalizationMode if you don't set it,*/ - planet = 1 << 54 - /**Australian Post. - When you set this barcode format, the library will automatically add LocalizationModeStatisticsPostalCode to LocalizationMode if you don't set it,*/ - australianPost = 1 << 55 - /**Royal Mail 4-State Customer Barcode. - When you set this barcode format, the library will automatically add LocalizationModeStatisticsPostalCode to LocalizationMode if you don't set it,*/ - RM4SCC = 1 << 56, - /**Kix*/ - kix = 1L << 57 -} -``` -> -```cpp -enum BarcodeFormat : unsigned long long -{ - /**No barcode format in BarcodeFormat.*/ - BF_NULL = 0x00, - /**All supported formats in BarcodeFormat.*/ - BF_ALL = 0xFFFFFFFEFFFFFFFF, - /**Use the default barcode format settings.*/ - BF_DEFAULT = 0xFE3BFFFF, - /**Combined value of BF_CODABAR, BF_CODE_128, BF_CODE_39, BF_CODE_39_Extended, BF_CODE_93, BF_EAN_13, BF_EAN_8, INDUSTRIAL_25, BF_ITF, BF_UPC_A, BF_UPC_E, BF_MSI_CODE;*/ - BF_ONED = 0x003007FF, - /**Combined value of BF_GS1_DATABAR_OMNIDIRECTIONAL, BF_GS1_DATABAR_TRUNCATED, BF_GS1_DATABAR_STACKED, BF_GS1_DATABAR_STACKED_OMNIDIRECTIONAL, BF_GS1_DATABAR_EXPANDED, BF_GS1_DATABAR_EXPANDED_STACKED, BF_GS1_DATABAR_LIMITED*/ - BF_GS1_DATABAR = 0x0003F800, - /**Code 39*/ - BF_CODE_39 = 0x1, - /**Code 128*/ - BF_CODE_128 = 0x2, - /**Code 93*/ - BF_CODE_93 = 0x4, - /**Codabar*/ - BF_CODABAR = 0x8, - /**Interleaved 2 of 5*/ - BF_ITF = 0x10, - /**EAN-13*/ - BF_EAN_13 = 0x20, - /**EAN-8*/ - BF_EAN_8 = 0x40, - /**UPC-A*/ - BF_UPC_A = 0x80, - /**UPC-E*/ - BF_UPC_E = 0x100, - /**Industrial 2 of 5*/ - BF_INDUSTRIAL_25 = 0x200, - /**CODE39 Extended*/ - BF_CODE_39_EXTENDED = 0x400, - /**GS1 Databar Omnidirectional*/ - BF_GS1_DATABAR_OMNIDIRECTIONAL = 0x800, - /**GS1 Databar Truncated*/ - BF_GS1_DATABAR_TRUNCATED = 0x1000, - /**GS1 Databar Stacked*/ - BF_GS1_DATABAR_STACKED = 0x2000, - /**GS1 Databar Stacked Omnidirectional*/ - BF_GS1_DATABAR_STACKED_OMNIDIRECTIONAL = 0x4000, - /**GS1 Databar Expanded*/ - BF_GS1_DATABAR_EXPANDED = 0x8000, - /**GS1 Databar Expaned Stacked*/ - BF_GS1_DATABAR_EXPANDED_STACKED = 0x10000, - /**GS1 Databar Limited*/ - BF_GS1_DATABAR_LIMITED = 0x20000, - /**Patch code.*/ - BF_PATCHCODE = 0x00040000, - /**Code 32*/ - BF_CODE_32 = 0x1000000, - /**PDF417*/ - BF_PDF417 = 0x02000000, - /**QRCode*/ - BF_QR_CODE = 0x04000000, - /**DataMatrix*/ - BF_DATAMATRIX = 0x08000000, - /**AZTEC*/ - BF_AZTEC = 0x10000000, - /**MAXICODE*/ - BF_MAXICODE = 0x20000000, - /**Micro QR Code*/ - BF_MICRO_QR = 0x40000000, - /**Micro PDF417*/ - BF_MICRO_PDF417 = 0x00080000, - /**GS1 Composite Code*/ - BF_GS1_COMPOSITE = 0x80000000, - /**MSI Code*/ - BF_MSI_CODE = 0x100000, - /**Code 11*/ - BF_CODE_11 = 0x200000, - /**Decode barcode with 2 digital addons.*/ - BF_TWO_DIGIT_ADD_ON = 0x400000, - /**Decode barcode with 5 digital addons.*/ - BF_FIVE_DIGIT_ADD_ON = 0x800000, - /**Matrix 25*/ - BF_MATRIX_25 = 0x1000000000, - /**Combined value of BF2_USPSINTELLIGENTMAIL, BF2_POSTNET, BF2_PLANET, BF2_AUSTRALIANPOST, BF2_RM4SCC.*/ - BF_POSTALCODE = 0x3F0000000000000, - /**Nonstandard barcode*/ - BF_NONSTANDARD_BARCODE = 0x100000000, - /**USPS Intelligent Mail.*/ - BF_USPSINTELLIGENTMAIL = 0x10000000000000, - /**Postnet.*/ - BF_POSTNET = 0x20000000000000, - /**Planet.*/ - BF_PLANET = 0x40000000000000, - /**Australian Post.*/ - BF_AUSTRALIANPOST = 0x80000000000000, - /**Royal Mail 4-State Customer Barcode.*/ - BF_RM4SCC = 0x100000000000000, - /**KIX.*/ - BF_KIX = 0x200000000000000, - /**DotCode.*/ - BF_DOTCODE = 0x200000000, - /**_PHARMACODE_ONE_TRACK.*/ - BF_PHARMACODE_ONE_TRACK = 0x400000000, - /**PHARMACODE_TWO_TRACK.*/ - BF_PHARMACODE_TWO_TRACK = 0x800000000, - /**PHARMACODE.*/ - BF_PHARMACODE = 0xC00000000 -}; -``` -> -```csharp - public enum EnumBarcodeFormat : ulong - { - /**No barcode format in BarcodeFormat*/ - BF_NULL = 0x00, - /**All supported formats in BarcodeFormat*/ - BF_ALL = 0xFFFFFFFEFFFFFFFF, - /**Use the default barcode format settings*/ - BF_DEFAULT = 0xFE3BFFFF, - /**Combined value of BF_CODABAR, BF_CODE_128, BF_CODE_39, BF_CODE_39_Extended, BF_CODE_93, BF_EAN_13, BF_EAN_8, INDUSTRIAL_25, BF_ITF, BF_UPC_A, BF_UPC_E, BF_MSI_CODE; */ - BF_ONED = 0x003007FF, - /**Combined value of BF_GS1_DATABAR_OMNIDIRECTIONAL, BF_GS1_DATABAR_TRUNCATED, BF_GS1_DATABAR_STACKED, BF_GS1_DATABAR_STACKED_OMNIDIRECTIONAL, BF_GS1_DATABAR_EXPANDED, BF_GS1_DATABAR_EXPANDED_STACKED, BF_GS1_DATABAR_LIMITED*/ - BF_GS1_DATABAR = 0x0003F800, - /**Code 39 */ - BF_CODE_39 = 0x1, - /**Code 128 */ - BF_CODE_128 = 0x2, - /**Code 93 */ - BF_CODE_93 = 0x4, - /**Codabar */ - BF_CODABAR = 0x8, - /**Interleaved 2 of 5 */ - BF_ITF = 0x10, - /**EAN-13 */ - BF_EAN_13 = 0x20, - /**EAN-8 */ - BF_EAN_8 = 0x40, - /**UPC-A */ - BF_UPC_A = 0x80, - /**UPC-E */ - BF_UPC_E = 0x100, - /**Industrial 2 of 5 */ - BF_INDUSTRIAL_25 = 0x200, - /**CODE39 Extended */ - BF_CODE_39_EXTENDED = 0x400, - /**GS1 Databar Omnidirectional*/ - BF_GS1_DATABAR_OMNIDIRECTIONAL = 0x800, - /**GS1 Databar Truncated*/ - BF_GS1_DATABAR_TRUNCATED = 0x1000, - /**GS1 Databar Stacked*/ - BF_GS1_DATABAR_STACKED = 0x2000, - /**GS1 Databar Stacked Omnidirectional*/ - BF_GS1_DATABAR_STACKED_OMNIDIRECTIONAL = 0x4000, - /**GS1 Databar Expanded*/ - BF_GS1_DATABAR_EXPANDED = 0x8000, - /**GS1 Databar Expaned Stacked*/ - BF_GS1_DATABAR_EXPANDED_STACKED = 0x10000, - /**GS1 Databar Limited*/ - BF_GS1_DATABAR_LIMITED = 0x20000, - /**Patch code*/ - BF_PATCHCODE = 0x00040000, - /**Code 32*/ - BF_CODE_32 = 0x1000000, - /**PDF417 */ - BF_PDF417 = 0x02000000, - /**QRCode */ - BF_QR_CODE = 0x04000000, - /**DataMatrix */ - BF_DATAMATRIX = 0x08000000, - /**AZTEC */ - BF_AZTEC = 0x10000000, - /**MAXICODE */ - BF_MAXICODE = 0x20000000, - /**Micro QR Code*/ - BF_MICRO_QR = 0x40000000, - /**Micro PDF417*/ - BF_MICRO_PDF417 = 0x00080000, - /**GS1 Composite Code*/ - BF_GS1_COMPOSITE = 0x80000000, - /**MSI Code*/ - BF_MSI_CODE = 0x100000, - /*Code 11*/ - BF_CODE_11 = 0x200000, - /*Decode barcode with 2 digital addons*/ - BF_TWO_DIGIT_ADD_ON = 0x400000, - /*Decode barcode with 5 digital addons*/ - BF_FIVE_DIGIT_ADD_ON = 0x800000, - /*Matrix 25*/ - BF_MATRIX_25 = 0x1000000000, - /**Combined value of BF2_USPSINTELLIGENTMAIL, BF2_POSTNET, BF2_PLANET, BF2_AUSTRALIANPOST, BF2_RM4SCC.*/ - BF_POSTALCODE = 0x3F0000000000000, - /**Nonstandard barcode */ - BF_NONSTANDARD_BARCODE = 0x100000000, - /**USPS Intelligent Mail.*/ - BF_USPSINTELLIGENTMAIL = 0x10000000000000, - /**Postnet.*/ - BF_POSTNET = 0x20000000000000, - /**Planet.*/ - BF_PLANET = 0x40000000000000, - /**Australian Post.*/ - BF_AUSTRALIANPOST = 0x80000000000000, - /**Royal Mail 4-State Customer Barcode.*/ - BF_RM4SCC = 0x100000000000000, - /**KIX.*/ - BF_KIX = 0x200000000000000, - /**DotCode.*/ - BF_DOTCODE = 0x200000000, - /**_PHARMACODE_ONE_TRACK.*/ - BF_PHARMACODE_ONE_TRACK = 0x400000000, - /**PHARMACODE_TWO_TRACK.*/ - BF_PHARMACODE_TWO_TRACK = 0x800000000, - /**PHARMACODE.*/ - BF_PHARMACODE = 0xC00000000 - } -``` -> -```python -class EnumBarcodeFormat(IntEnum): - #No barcode format in BarcodeFormat - BF_NULL = 0x00 - #All supported formats in BarcodeFormat - BF_ALL = 0xFFFFFFFEFFFFFFFF - #Use the default barcode format settings - BF_DEFAULT = 0xFE3BFFFF - #Combined value of BF_CODABAR, BF_CODE_128, BF_CODE_39, BF_CODE_39_Extended, BF_CODE_93, BF_EAN_13, BF_EAN_8, INDUSTRIAL_25, BF_ITF, BF_UPC_A, BF_UPC_E,BF_MSI_CODE; - BF_ONED = 0x003007FF - #Combined value of BF_GS1_DATABAR_OMNIDIRECTIONAL, BF_GS1_DATABAR_TRUNCATED, BF_GS1_DATABAR_STACKED, BF_GS1_DATABAR_STACKED_OMNIDIRECTIONAL,BF_GS1_DATABAR_EXPANDED, BF_GS1_DATABAR_EXPANDED_STACKED, BF_GS1_DATABAR_LIMITED - BF_GS1_DATABAR = 0x0003F800 - #Code 39 - BF_CODE_39 = 0x1 - #Code 128 - BF_CODE_128 = 0x2 - #Code 93 - BF_CODE_93 = 0x4 - #Codabar - BF_CODABAR = 0x8 - #Interleaved 2 of 5 - BF_ITF = 0x10 - #EAN-13 - BF_EAN_13 = 0x20 - #EAN-8 - BF_EAN_8 = 0x40 - #UPC-A - BF_UPC_A = 0x80 - #UPC-E - BF_UPC_E = 0x100 - #Industrial 2 of 5 - BF_INDUSTRIAL_25 = 0x200 - #CODE39 Extended - BF_CODE_39_EXTENDED = 0x400 - #GS1 Databar Omnidirectional - BF_GS1_DATABAR_OMNIDIRECTIONAL = 0x800 - #GS1 Databar Truncated - BF_GS1_DATABAR_TRUNCATED = 0x1000 - #GS1 Databar Stacked - BF_GS1_DATABAR_STACKED = 0x2000 - #GS1 Databar Stacked Omnidirectional - BF_GS1_DATABAR_STACKED_OMNIDIRECTIONAL = 0x4000 - #GS1 Databar Expanded - BF_GS1_DATABAR_EXPANDED = 0x8000 - #GS1 Databar Expaned Stacked - BF_GS1_DATABAR_EXPANDED_STACKED = 0x10000 - #GS1 Databar Limited - BF_GS1_DATABAR_LIMITED = 0x20000 - #Patch code - BF_PATCHCODE = 0x00040000 - #Code 32 - BF_CODE_32 = 0x1000000 - #PDF417 - BF_PDF417 = 0x02000000 - #QRCode - BF_QR_CODE = 0x04000000 - #DataMatrix - BF_DATAMATRIX = 0x08000000 - #AZTEC - BF_AZTEC = 0x10000000 - #MAXICODE - BF_MAXICODE = 0x20000000 - #Micro QR Code - BF_MICRO_QR = 0x40000000 - #Micro PDF417 - BF_MICRO_PDF417 = 0x00080000 - #GS1 Composite Code - BF_GS1_COMPOSITE = 0x80000000 - #MSI Code - BF_MSI_CODE = 0x100000 - #Code 11 - BF_CODE_11 = 0x200000 - #Decode barcode with 2 digital addons - BF_TWO_DIGIT_ADD_ON = 0x400000 - #Decode barcode with 5 digital addons - BF_FIVE_DIGIT_ADD_ON = 0x800000 - #Matrix 25 - BF_MATRIX_25 = 0x1000000000 - #Combined value of BF2_USPSINTELLIGENTMAIL, BF2_POSTNET, BF2_PLANET, BF2_AUSTRALIANPOST, BF2_RM4SCC. - BF_POSTALCODE = 0x3F0000000000000 - #Nonstandard barcode - BF_NONSTANDARD_BARCODE = 0x100000000 - #USPS Intelligent Mail. - BF_USPSINTELLIGENTMAIL = 0x10000000000000 - #Postnet. - BF_POSTNET = 0x20000000000000 - #Planet. - BF_PLANET = 0x40000000000000 - #Australian Post. - BF_AUSTRALIANPOST = 0x80000000000000 - #Royal Mail 4-State Customer Barcode. - BF_RM4SCC = 0x100000000000000 - #KIX. - BF_KIX = 0x200000000000000 - #DotCode. - BF_DOTCODE = 0x200000000 - #_PHARMACODE_ONE_TRACK. - BF_PHARMACODE_ONE_TRACK = 0x400000000 - #PHARMACODE_TWO_TRACK. - BF_PHARMACODE_TWO_TRACK = 0x800000000 - #PHARMACODE. - BF_PHARMACODE = 0xC00000000 -``` diff --git a/enums/barcode-reader/deblur-mode.md b/enums/barcode-reader/deblur-mode.md deleted file mode 100644 index 34be600..0000000 --- a/enums/barcode-reader/deblur-mode.md +++ /dev/null @@ -1,222 +0,0 @@ ---- -layout: default-layout -title: DeblurMode - Dynamsoft Barcode Reader Enumerations -description: The enumeration DeblurMode of Dynamsoft Barcode Reader describes deblur modes that implemented on the localized barcodes. -keywords: Deblur mode -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: DeblurMode -codeAutoHeight: true ---- - -# Enumeration DeblurMode - -`DeblurMode` specifies the image processing algorithms applied to the localized zones containing barcodes, aimed at generating a binary image for extracting barcode data during the final phase of the barcode decoding process. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - >- C# - >- Python - > -> -```javascript -enum EnumDeblurMode { - /** Skips the process, no deblurring is applied. */ - DM_SKIP = 0x00, - /** Applies a direct binarization algorithm for generating the binary image. */ - DM_DIRECT_BINARIZATION = 0x01, - /** Utilizes a threshold binarization algorithm for generating the binary image, dynamically determining the threshold based on the image content. */ - DM_THRESHOLD_BINARIZATION = 0x02, - /** Employs a gray equalization algorithm to adjust the contrast and brightness, improving the clarity of the gray-scale image before binarization. */ - DM_GRAY_EQUALIZATION = 0x04, - /** Implements a smoothing algorithm to reduce noise and artifacts, smoothing out the gray-scale image before binarization. */ - DM_SMOOTHING = 0x08, - /** Uses a morphing algorithm to enhance the gray-scale image before binarization. */ - DM_MORPHING = 0x10, - /** Engages in a deep analysis of the grayscale image based on the barcode format to intelligently generate the optimized binary image, tailored to complex or severely blurred images. */ - DM_DEEP_ANALYSIS = 0x20, - /** Applies a sharpening algorithm to enhance the edges and details of the barcode, making it more distinguishable on the gray-scale image before binarization. */ - DM_SHARPENING = 0x40, - /** Decodes the barcodes based on the binary image obtained during the localization process. */ - DM_BASED_ON_LOC_BIN = 0x80, - /** Combines sharpening and smoothing algorithms for a comprehensive deblurring effect, targeting both clarity and smoothness of the gray-scale image before binarization. */ - DM_SHARPENING_SMOOTHING = 0x100, - /** Reserved for future use. */ - DM_REV = -2147483648 -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumDeblurMode { - /** Performs deblur process using the direct binarization algorithm. */ - public static final int DM_DIRECT_BINARIZATION = 0x01; - /** Performs deblur process using the threshold binarization algorithm. */ - public static final int DM_THRESHOLD_BINARIZATION = 0x02; - /** Performs deblur process using the gray equalization algorithm. */ - public static final int DM_GRAY_EQUALIZATION = 0x04; - /** Performs deblur process using the smoothing algorithm. */ - public static final int DM_SMOOTHING = 0x08; - /** Performs deblur process using the morphing algorithm. */ - public static final int DM_MORPHING = 0x10; - /** Performs deblur process using the deep analysis algorithm. */ - public static final int DM_DEEP_ANALYSIS = 0x20; - /** Performs deblur process using the sharpening algorithm. */ - public static final int DM_SHARPENING = 0x40; - /** Performs deblur process based on the binary image from the localization process. */ - public static final int DM_BASED_ON_LOC_BIN = 0x80; - /** Performs deblur process using the sharpening and smoothing algorithm. */ - public static final int DM_SHARPENING_SMOOTHING = 0x100; - /**Reserved setting for deblur mode.*/ - public static final int DM_REV = -2147483648; - /**Skips the deblur process.*/ - public static final int DM_SKIP = 0x00 -} -``` -> -```objc -typedef NS_ENUM(NSInteger , DSDeblurMode) -{ - /**Performs deblur process using the direct binarization algorithm.*/ - DSDeblurModeDirectBinarization = 0x01, - /**Performs deblur process using the threshold binarization algorithm.*/ - DSDeblurModeThresholdBinarization = 0x02, - /**Performs deblur process using the gray equalization algorithm.*/ - DSDeblurModeGrayEqualization = 0x04, - /**Performs deblur process using the smoothing algorithm.*/ - DSDeblurModeSmoothing = 0x08, - /**Performs deblur process using the morphing algorithm.*/ - DSDeblurModeMorphing = 0x10, - /**Performs deblur process using the deep analysis algorithm.*/ - DSDeblurModeDeepAnalysis = 0x20, - /**Performs deblur process using the sharpening algorithm.*/ - DSDeblurModeSharpening = 0x40, - /**Performs deblur process based on the binary image from the localization process.*/ - DSDeblurModeBasedOnLocBin = 0x80, - /**Performs deblur process using the sharpening and smoothing algorithm.*/ - DSDeblurModeSharpeningSmoothing = 0x100, - /**Reserved setting for deblur mode.*/ - DSDeblurModeRev = -2147483648, - /**Skips the deblur process.*/ - DSDeblurModeSkip = 0x00 -}; -``` -> -```swift -public enum DeblurMode : Int -{ - /**Performs deblur process using the direct binarization algorithm.*/ - directBinarization = 0x01 - /**Performs deblur process using the threshold binarization algorithm.*/ - thresholdBinarization = 0x02 - /**Performs deblur process using the gray equalization algorithm.*/ - grayEqualization = 0x04 - /**Performs deblur process using the smoothing algorithm.*/ - smoothing = 0x08 - /**Performs deblur process using the morphing algorithm.*/ - morphing = 0x10 - /**Performs deblur process using the deep analysis algorithm.*/ - deepAnalysis = 0x20 - /**Performs deblur process using the sharpening algorithm.*/ - sharpening = 0x40 - /**Performs deblur process based on the binary image from the localization process.*/ - basedOnLocBin = 0x80 - /**Performs deblur process using the sharpening and smoothing algorithm.*/ - sharpeningSmoothing = 0x100 - /**Reserved setting for deblur mode.*/ - rev = -2147483648 - /**Skips the deblur process.*/ - skip = 0x00 -} -``` -> -```cpp -typedef enum DeblurMode -{ - /** Performs deblur process using the direct binarization algorithm. */ - DM_DIRECT_BINARIZATION = 0x01, - /** Performs deblur process using the threshold binarization algorithm. */ - DM_THRESHOLD_BINARIZATION = 0x02, - /** Performs deblur process using the gray equalization algorithm. */ - DM_GRAY_EQUALIZATION = 0x04, - /** Performs deblur process using the smoothing algorithm. */ - DM_SMOOTHING = 0x08, - /** Performs deblur process using the morphing algorithm. */ - DM_MORPHING = 0x10, - /** Performs deblur process using the deep analysis algorithm. */ - DM_DEEP_ANALYSIS = 0x20, - /** Performs deblur process using the sharpening algorithm. */ - DM_SHARPENING = 0x40, - /** Performs deblur process based on the binary image from the localization process. */ - DM_BASED_ON_LOC_BIN = 0x80, - /** Performs deblur process using the sharpening and smoothing algorithm. */ - DM_SHARPENING_SMOOTHING = 0x100, - /** Reserved setting for deblur mode. */ -#if defined(_WIN32) || defined(_WIN64) - DM_REV = 0x80000000, -#else - DM_REV = -2147483648, -#endif - /**Skips the deblur process. */ - DM_SKIP = 0x00 -}DeblurMode; -``` -> -```csharp -public enum EnumDeblurMode -{ - /**Performs deblur process using the direct binarization algorithm.*/ - DM_DIRECT_BINARIZATION = 0x01, - /**Performs deblur process using the threshold binarization algorithm.*/ - DM_THRESHOLD_BINARIZATION = 0x02, - /**Performs deblur process using the gray equalization algorithm.*/ - DM_GRAY_EQUALIZATION = 0x04, - /**Performs deblur process using the smoothing algorithm.*/ - DM_SMOOTHING = 0x08, - /**Performs deblur process using the morphing algorithm.*/ - DM_MORPHING = 0x10, - /**Performs deblur process using the deep analysis algorithm.*/ - DM_DEEP_ANALYSIS = 0x20, - /**Performs deblur process using the sharpening algorithm.*/ - DM_SHARPENING = 0x40, - /**Performs deblur process based on the binary image from the localization process.*/ - DM_BASED_ON_LOC_BIN = 0x80, - /**Performs deblur process using the sharpening and smoothing algorithm.*/ - DM_SHARPENING_SMOOTHING = 0x100, - /**Reserved setting for deblur mode.*/ - DM_REV = -2147483648, - /**Skips the deblur process.*/ - DM_SKIP = 0x00 -} -``` -> -```python -class EnumDeblurMode(IntEnum): - #Performs deblur process using the direct binarization algorithm. - DM_DIRECT_BINARIZATION = 0x01 - #Performs deblur process using the threshold binarization algorithm. - DM_THRESHOLD_BINARIZATION = 0x02 - #Performs deblur process using the gray equalization algorithm. - DM_GRAY_EQUALIZATION = 0x04 - #Performs deblur process using the smoothing algorithm. - DM_SMOOTHING = 0x08 - #Performs deblur process using the morphing algorithm. - DM_MORPHING = 0x10 - #Performs deblur process using the deep analysis algorithm. - DM_DEEP_ANALYSIS = 0x20 - #Performs deblur process using the sharpening algorithm. - DM_SHARPENING = 0x40 - #Performs deblur process based on the binary image from the localization process. - DM_BASED_ON_LOC_BIN = 0x80 - #Performs deblur process using the sharpening and smoothing algorithm. - DM_SHARPENING_SMOOTHING = 0x100 - #Reserved setting for deblur mode. - DM_REV = -2147483648 - #Skips the deblur process. - DM_SKIP = 0x00 -``` diff --git a/enums/barcode-reader/extended-barcode-result-type.md b/enums/barcode-reader/extended-barcode-result-type.md deleted file mode 100644 index d92180a..0000000 --- a/enums/barcode-reader/extended-barcode-result-type.md +++ /dev/null @@ -1,108 +0,0 @@ ---- -layout: default-layout -title: ExtendedBarcodeResultType - Dynamsoft Barcode Reader Enumerations -description: The enumeration ExtendedBarcodeResultType of Dynamsoft Barcode Reader describes the type of the extended barcode result. -keywords: Extended barcode result type -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: ExtendedBarcodeResultType -codeAutoHeight: true ---- - -# Enumeration ExtendedBarcodeResultType - -`ExtendedBarcodeResultType` determines the type of text result returned from a barcode scan. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - >- C# - >- Python - > -> -```javascript -enum EnumExtendedBarcodeResultType -{ - /**Specifies the standard text. This means the barcode value. */ - EBRT_STANDARD_RESULT = 0, - /**Specifies all the candidate text. This means all the standard text results decoded from the barcode. */ - EBRT_CANDIDATE_RESULT = 1, - /**Specifies the partial text. This means part of the text result decoded from the barcode. */ - EBRT_PARTIAL_RESULT = 2 -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumExtendedBarcodeResultType -{ - /**Specifies the standard text. This means the barcode value. */ - public static final int EBRT_STANDARD_RESULT = 0; - /**Specifies all the candidate text. This means all the standard text results decoded from the barcode. */ - public static final int EBRT_CANDIDATE_RESULT = 1; - /**Specifies the partial text. This means part of the text result decoded from the barcode. */ - public static final int EBRT_PARTIAL_RESULT = 2; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSExtendedBarcodeResultType) -{ - /**Specifies the standard text. This means the barcode value. */ - DSExtendedBarcodeResultTypeStandardResult = 0, - /**Specifies all the candidate text. This means all the standard text results decoded from the barcode. */ - DSExtendedBarcodeResultTypeCandidateResult = 1, - /**Specifies the partial text. This means part of the text result decoded from the barcode. */ - DSExtendedBarcodeResultTypePartialResult = 2 -}; -``` -> -```swift -public enum ExtendedBarcodeResultType : Int -{ - /**Specifies the standard text. This means the barcode value. */ - standardResult = 0 - /**Specifies all the candidate text. This means all the standard text results decoded from the barcode. */ - candidateResult = 1 - /**Specifies the partial text. This means part of the text result decoded from the barcode. */ - partialResult = 2 -} -``` -> -```cpp -typedef enum ExtendedBarcodeResultType -{ - /**Specifies the standard text. This means the barcode value. */ - EBRT_STANDARD_RESULT, - /**Specifies all the candidate text. This means all the standard text results decoded from the barcode. */ - EBRT_CANDIDATE_RESULT, - /**Specifies the partial text. This means part of the text result decoded from the barcode. */ - EBRT_PARTIAL_RESULT -}ExtendedBarcodeResultType; -``` -> -```csharp -public enum EnumExtendedBarcodeResultType -{ - /**Specifies the standard text. This means the barcode value. */ - EBRT_STANDARD_RESULT, - /**Specifies all the candidate text. This means all the standard text results decoded from the barcode. */ - EBRT_CANDIDATE_RESULT, - /**Specifies the partial text. This means part of the text result decoded from the barcode. */ - EBRT_PARTIAL_RESULT -} -``` -> -```python -class EnumExtendedBarcodeResultType(IntEnum): - #Specifies the standard text. This means the barcode value. - EBRT_STANDARD_RESULT - #Specifies all the candidate text. This means all the standard text results decoded from the barcode. - EBRT_CANDIDATE_RESULT - #Specifies the partial text. This means part of the text result decoded from the barcode. - EBRT_PARTIAL_RESULT -``` diff --git a/enums/barcode-reader/localization-mode.md b/enums/barcode-reader/localization-mode.md deleted file mode 100644 index e873c6d..0000000 --- a/enums/barcode-reader/localization-mode.md +++ /dev/null @@ -1,224 +0,0 @@ ---- -layout: default-layout -title: LocalizationMode - Dynamsoft Barcode Reader Enumerations -description: The enumeration LocalizationMode of Dynamsoft Barcode Reader describes the localization modes of the barcodes. -keywords: Localization mode -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: LocalizationMode -codeAutoHeight: true ---- - -# Enumeration LocalizationMode - -`LocalizationMode` specifies the strategies used to identify the locations of barcodes within an image. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - >- C# - >- Python - > -> -```javascript -enum EnumLocalizationMode { - /** Omits the localization process entirely. */ - LM_SKIP = 0x00, - /** Automatic localization mode selection; not yet implemented. */ - LM_AUTO = 0x01, - /** Identifies barcodes by finding connected blocks, offering optimal results, especially recommended for highest priority in most scenarios. */ - LM_CONNECTED_BLOCKS = 0x02, - /** Detects barcodes through analysis of patterns of contiguous black and white regions, tailored for QR Codes and DataMatrix codes. */ - LM_STATISTICS = 0x04, - /** Locates barcodes by identifying linear patterns, designed primarily for 1D barcodes and PDF417 codes. */ - LM_LINES = 0x08, - /** Provides rapid barcode localization, suited for interactive applications where speed is crucial. */ - LM_SCAN_DIRECTLY = 0x10, - /** Targets barcode localization through detection of specific mark groups, optimized for Direct Part Marking (DPM) codes. */ - LM_STATISTICS_MARKS = 0x20, - /** Combines methods of locating connected blocks and linear patterns to efficiently localize postal codes. */ - LM_STATISTICS_POSTAL_CODE = 0x40, - /** Initiates barcode localization from the image center, facilitating faster detection in certain layouts. */ - LM_CENTRE = 0x80, - /** Specialized for quick localization of 1D barcodes, enhancing performance in fast-scan scenarios. */ - LM_ONED_FAST_SCAN = 0x100, - /** Reserved for future use in localization mode settings. */ - LM_REV = -2147483648 -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumLocalizationMode { - /**Not supported yet. */ - public static final int LM_AUTO = 1; - /**Localizes barcodes by searching for connected blocks. This algorithm usually gives best result and it is recommended to set ConnectedBlocks to the highest priority. */ - public static final int LM_CONNECTED_BLOCKS = 2; - /**Localizes barcodes by groups of contiguous black-white regions. This is optimized for QRCode and DataMatrix. */ - public static final int LM_STATISTICS = 4; - /**Localizes barcodes by searching for groups of lines. This is optimized for 1D and PDF417 barcodes. */ - public static final int LM_LINES = 8; - /**Localizes barcodes quickly. This mode is recommended in interactive scenario. Check @ref LM for available argument settings.*/ - public static final int LM_SCAN_DIRECTLY = 16; - /**Localizes barcodes by groups of marks.This is optimized for DPM codes. */ - public static final int LM_STATISTICS_MARKS = 32; - /**Localizes barcodes by groups of connected blocks and lines.This is optimized for postal codes. */ - public static final int LM_STATISTICS_POSTAL_CODE = 64; - /**Localizes barcodes from the centre of the image. Check @ref LM for available argument settings. */ - public static final int LM_CENTRE = 128; - /**Localizes 1D barcodes fast. Check @ref LM for available argument settings. */ - public static final int LM_ONED_FAST_SCAN = 256; - /**Skips localization. */ - public static final int LM_SKIP = 0; - /**Reserved setting for localization mode. */ - public static final int LM_REV = 2147483648; -} -``` -> -```objc -typedef NS_ENUM(NSInteger , DSLocalizationMode) -{ - /**Not supported yet. */ - DSLocalizationModeAuto = 0x01, - /**Localizes barcodes by searching for connected blocks. This algorithm usually gives best result and it is recommended to set ConnectedBlocks to the highest priority. */ - DSLocalizationModeConnectedBlocks = 0x02, - /**Localizes barcodes by groups of contiguous black-white regions. This is optimized for QRCode and DataMatrix. */ - DSLocalizationModeStatistics = 0x04, - /**Localizes barcodes by searching for groups of lines. This is optimized for 1D and PDF417 barcodes. */ - DSLocalizationModeLines = 0x08, - /**Localizes barcodes quickly. This mode is recommended in interactive scenario. Check @ref LM for available argument settings.*/ - DSLocalizationModeScanDirectly = 0x10, - /**Localizes barcodes by groups of marks.This is optimized for DPM codes. */ - DSLocalizationModeStatisticsMarks = 0x20, - /**Localizes barcodes by groups of connected blocks and lines.This is optimized for postal codes. */ - DSLocalizationModeStatisticsPostalCode = 0x40, - /**Localizes barcodes from the centre of the image. Check @ref LM for available argument settings. */ - DSLocalizationModeCentre = 0x80, - /**Localizes 1D barcodes fast. Check @ref LM for available argument settings. */ - DSLocalizationModeOneDFastScan = 0x100, - /**Reserved setting for localization mode.*/ - DSLocalizationModeRev = -2147483648, - /**Skips localization. */ - DSLocalizationModeSkip = 0x00 -}; -``` -> -```swift -public enum LocalizationMode : Int -{ - /**Not supported yet. */ - auto = 0x01 - /**Localizes barcodes by searching for connected blocks. This algorithm usually gives best result and it is recommended to set ConnectedBlocks to the highest priority. */ - connectedBlocks = 0x02 - /**Localizes barcodes by groups of contiguous black-white regions. This is optimized for QRCode and DataMatrix. */ - statistics = 0x04 - /**Localizes barcodes by searching for groups of lines. This is optimized for 1D and PDF417 barcodes. */ - lines = 0x08 - /**Localizes barcodes quickly. This mode is recommended in interactive scenario. Check @ref LM for available argument settings.*/ - scanDirectly = 0x10 - /**Localizes barcodes by groups of marks.This is optimized for DPM codes. */ - statisticsMarks = 0x20 - /**Localizes barcodes by groups of connected blocks and lines.This is optimized for postal codes. */ - postalCode = 0x40 - /**Localizes barcodes from the centre of the image. Check @ref LM for available argument settings. */ - centre = 0x80, - /**Localizes 1D barcodes fast. Check @ref LM for available argument settings. */ - oneDFastScan = 0x100 - /**Reserved setting for localization mode.*/ - rev = -2147483648 - /**Skips localization. */ - skip = 0x00 -} -``` -> -```cpp -typedef enum LocalizationMode -{ - /**Not supported yet. */ - LM_AUTO = 0x01, - /**Localizes barcodes by searching for connected blocks. This algorithm usually gives best result and it is recommended to set ConnectedBlocks to the highest priority. */ - LM_CONNECTED_BLOCKS = 0x02, - /**Localizes barcodes by groups of contiguous black-white regions. This is optimized for QRCode and DataMatrix. */ - LM_STATISTICS = 0x04, - /**Localizes barcodes by searching for groups of lines. This is optimized for 1D and PDF417 barcodes. */ - LM_LINES = 0x08, - /**Localizes barcodes quickly. This mode is recommended in interactive scenario. Check @ref LM for available argument settings. */ - LM_SCAN_DIRECTLY = 0x10, - /**Localizes barcodes by groups of marks.This is optimized for DPM codes. */ - LM_STATISTICS_MARKS = 0x20, - /**Localizes barcodes by groups of connected blocks and lines.This is optimized for postal codes. */ - LM_STATISTICS_POSTAL_CODE = 0x40, - /**Localizes barcodes from the centre of the image. Check @ref LM for available argument settings. */ - LM_CENTRE = 0x80, - /**Localizes 1D barcodes fast. Check @ref LM for available argument settings. */ - LM_ONED_FAST_SCAN = 0x100, - /**Reserved setting for localization mode. */ -#if defined(_WIN32) || defined(_WIN64) - LM_REV = 0x80000000, -#else - LM_REV = -2147483648, -#endif - /**Skips localization. */ - LM_SKIP = 0x00 -}LocalizationMode; -``` -> -```csharp -public enum EnumLocalizationMode -{ - /**Not supported yet. */ - LM_AUTO = 0x01, - /**Localizes barcodes by searching for connected blocks. This algorithm usually gives best result and it is recommended to set ConnectedBlocks to the highest priority. */ - LM_CONNECTED_BLOCKS = 0x02, - /**Localizes barcodes by groups of contiguous black-white regions. This is optimized for QRCode and DataMatrix. */ - LM_STATISTICS = 0x04, - /**Localizes barcodes by searching for groups of lines. This is optimized for 1D and PDF417 barcodes. */ - LM_LINES = 0x08, - /**Localizes barcodes quickly. This mode is recommended in interactive scenario.*/ - LM_SCAN_DIRECTLY = 0x10, - /**Localizes barcodes by groups of marks.This is optimized for DPM codes. */ - LM_STATISTICS_MARKS = 0x20, - /**Localizes barcodes by groups of connected blocks and lines.This is optimized for postal codes. */ - LM_STATISTICS_POSTAL_CODE = 0x40, - /**Localizes barcodes from the centre of the image.*/ - LM_CENTRE = 0x80, - /**Localizes 1D barcodes fast.*/ - LM_ONED_FAST_SCAN = 0x100, - /**Reserved setting for localization mode.*/ - LM_REV = -2147483648, - /**Skips localization. */ - LM_SKIP = 0x00 -} -``` -> -```python -class EnumLocalizationMode(IntEnum): -{ - #Not supported yet. - LM_AUTO = 0x01 - #Localizes barcodes by searching for connected blocks. This algorithm usually gives best result and it is recommended to set ConnectedBlocks to the highest priority. - LM_CONNECTED_BLOCKS = 0x02 - #Localizes barcodes by groups of contiguous black-white regions. This is optimized for QRCode and DataMatrix. - LM_STATISTICS = 0x04 - #Localizes barcodes by searching for groups of lines. This is optimized for 1D and PDF417 barcodes. - LM_LINES = 0x08 - #Localizes barcodes quickly. This mode is recommended in interactive scenario. - LM_SCAN_DIRECTLY = 0x10 - #Localizes barcodes by groups of marks.This is optimized for DPM codes. - LM_STATISTICS_MARKS = 0x20 - #Localizes barcodes by groups of connected blocks and lines.This is optimized for postal codes. - LM_STATISTICS_POSTAL_CODE = 0x40 - #Localizes barcodes from the centre of the image. - LM_CENTRE = 0x80 - #Localizes 1D barcodes fast. - LM_ONED_FAST_SCAN = 0x100 - #Reserved setting for localization mode. - LM_REV = -2147483648 - #Skips localization. - LM_SKIP = 0x00 -} -``` diff --git a/enums/barcode-reader/qr-code-error-correction-level.md b/enums/barcode-reader/qr-code-error-correction-level.md deleted file mode 100644 index f1e3734..0000000 --- a/enums/barcode-reader/qr-code-error-correction-level.md +++ /dev/null @@ -1,121 +0,0 @@ ---- -layout: default-layout -title: QRCodeErrorCorrectionLevel - Dynamsoft Barcode Reader Enumerations -description: The enumeration QRCodeErrorCorrectionLevel of Dynamsoft Barcode Reader describes the error correction level when processing the QR code. -keywords: QR code error correction level -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: QRCodeErrorCorrectionLevel -codeAutoHeight: true ---- - -# Enumeration QRCodeErrorCorrectionLevel - -`QRCodeErrorCorrectionLevel` describes the error correction level when processing the QR code. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - >- C# - >- Python - > -> -```javascript -enum EnumQRCodeErrorCorrectionLevel{ - /** High error correction level, allowing for up to 30% data recovery. Suitable for environments where QR codes might be subject to significant damage. */ - QRECL_ERROR_CORRECTION_H = 0, - /** Low error correction level, allowing for up to 7% data recovery. Optimal for scenarios where QR code integrity is less likely to be compromised. */ - QRECL_ERROR_CORRECTION_L = 1, - /** Medium-low error correction level, allowing for up to 15% data recovery. Balances the need for data integrity with the desire to maximize data capacity. */ - QRECL_ERROR_CORRECTION_M = 2, - /** Medium-high error correction level, allowing for up to 25% data recovery. Designed for situations where some QR code damage might be expected. */ - QRECL_ERROR_CORRECTION_Q = 3 -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumQRCodeErrorCorrectionLevel -{ - /**Error Correction Level H (high) */ - public static final int QRECL_ERROR_CORRECTION_H = 0; - /**Error Correction Level L (low) */ - public static final int QRECL_ERROR_CORRECTION_L = 1; - /**Error Correction Level M (medium-low) */ - public static final int QRECL_ERROR_CORRECTION_M = 2; - /**Error Correction Level Q (medium-high) */ - public static final int QRECL_ERROR_CORRECTION_Q = 3; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSQRCodeErrorCorrectionLevel) -{ - /**Error Correction Level H (high) */ - DSQRCodeErrorCorrectionLevelErrorCorrectionH = 0, - /**Error Correction Level L (low) */ - DSQRCodeErrorCorrectionLevelErrorCorrectionL = 1, - /**Error Correction Level M (medium-low) */ - DSQRCodeErrorCorrectionLevelErrorCorrectionM = 2, - /**Error Correction Level Q (medium-high) */ - DSQRCodeErrorCorrectionLevelErrorCorrectionQ = 3 -}; -``` -> -```swift -public enum QRCodeErrorCorrectionLevel : Int -{ - /**Error Correction Level H (high) */ - errorCorrectionH = 0 - /**Error Correction Level L (low) */ - errorCorrectionL = 1 - /**Error Correction Level M (medium-low) */ - errorCorrectionM = 2 - /**Error Correction Level Q (medium-high) */ - errorCorrectionQ = 3 -} -``` -> -```cpp -typedef enum QRCodeErrorCorrectionLevel -{ - /**Error Correction Level H (high) */ - QRECL_ERROR_CORRECTION_H, - /**Error Correction Level L (low) */ - QRECL_ERROR_CORRECTION_L, - /**Error Correction Level M (medium-low) */ - QRECL_ERROR_CORRECTION_M, - /**Error Correction Level Q (medium-high) */ - QRECL_ERROR_CORRECTION_Q -}QRCodeErrorCorrectionLevel; -``` -> -```csharp -public enum EnumQRCodeErrorCorrectionLevel -{ - /**Error Correction Level H (high) */ - QRECL_ERROR_CORRECTION_H, - /**Error Correction Level L (low) */ - QRECL_ERROR_CORRECTION_L, - /**Error Correction Level M (medium-low) */ - QRECL_ERROR_CORRECTION_M, - /**Error Correction Level Q (medium-high) */ - QRECL_ERROR_CORRECTION_Q -} -``` -> -```python -class EnumQRCodeErrorCorrectionLevel(IntEnum): - #Error Correction Level H (high) - QRECL_ERROR_CORRECTION_H - #Error Correction Level L (low) - QRECL_ERROR_CORRECTION_L - #Error Correction Level M (medium-low) - QRECL_ERROR_CORRECTION_M - #Error Correction Level Q (medium-high) - QRECL_ERROR_CORRECTION_Q -``` diff --git a/enums/camera-enhancer/camera-position.md b/enums/camera-enhancer/camera-position.md deleted file mode 100644 index 6a9f58b..0000000 --- a/enums/camera-enhancer/camera-position.md +++ /dev/null @@ -1,68 +0,0 @@ ---- -layout: default-layout -title: CameraPosition - Dynamsoft Camera Enhancer Enumerations -description: The enumeration CameraPosition of Dynamsoft Camera Enhancer describes the camera position. -keywords: Camera Position -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: CameraPosition ---- - -# CameraPosition - -Enumeration `CameraPosition` describes the camera position. - -
    - >- Android - >- Objective-C - >- Swift - > -> -```java -@IntDef({CP_FRONT,CP_BACK}) -@Retention(RetentionPolicy.CLASS) -public @interface EnumCameraPosition { - // The back-facing camera. - public static final int CP_FRONT= 0; - // The front-facing camera. - public static final int CP_BACK = 1; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSCameraPosition) -{ - /** The back-facing camera. */ - DSCameraPositionBack = 0, - /** The front-facing camera. */ - DSCameraPositionBack = 1, - /** - * The back-facing ultra-wide-angle camera. It is an ultra-wide-angle camera for macro-distance capturing. - */ - DSCameraPositionBackUltraWide, - /** - * A back-facing virtual camera. It is a vitural camera that can switch between the wide-angle camera and the ultra-wide-angle camera automatically. - * Supported devices include: iPhone 13 Pro, iPhone 13 Pro Max, iPhone 14 Pro, iPhone 14 Pro Max, iPhone 15 Pro, iPhone 15 Pro Max. - */ - DSCameraPositionBackDualWideAuto -}; -``` -> -```swift -public enum CameraPosition : Int{ - /** The back-facing camera. */ - back = 0 - /** The front-facing camera. */ - front = 1 - /** - * The back-facing ultra-wide-angle camera. It is an ultra-wide-angle camera for macro-distance capturing. - */ - backUltraWide - /** - * A back-facing virtual camera. It is a vitural camera that can switch between the wide-angle camera and the ultra-wide-angle camera automatically. - * Supported devices include: iPhone 13 Pro, iPhone 13 Pro Max, iPhone 14 Pro, iPhone 14 Pro Max, iPhone 15 Pro, iPhone 15 Pro Max. - */ - backDualWideAuto -} -``` diff --git a/enums/camera-enhancer/camera-state.md b/enums/camera-enhancer/camera-state.md deleted file mode 100644 index 38916cc..0000000 --- a/enums/camera-enhancer/camera-state.md +++ /dev/null @@ -1,78 +0,0 @@ ---- -layout: default-layout -title: CameraState - Dynamsoft Camera Enhancer Enumerations -description: The enumeration CameraState of Dynamsoft Camera Enhancer describes the camera state. -keywords: Camera state -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: CameraState ---- - -# CameraState - -Enumeration `CameraState` describes the camera state. - -
    - >- Android - >- Objective-C - >- Swift - > -> -```java -@IntDef({OPENING,OPENED,CLOSING,CLOSED}) -@Retention(RetentionPolicy.CLASS) -public @interface EnumCameraState { - // The camera is opening. - public static final int OPENING = 0; - // The camera is opened. - public static final int OPENED = 1; - // The camera is closing. - public static final int CLOSING = 2; - // The camera is closed. - public static final int CLOSED = 3; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSCameraState) -{ - /** - * The camera is opening. - */ - CameraStateOpening = 0, - /** - * The camera is opened. - */ - CameraStateOpened = 1, - /** - * The camera is closing. - */ - CameraStateClosing = 2, - /** - * The camera is closed. - */ - CameraStateClosed = 3 -}; -``` -> -```swift -public enum CameraState : Int{ - /** - * The camera is opening. - */ - opening = 0 - /** - * The camera is opened. - */ - opened = 1 - /** - * The camera is closing. - */ - closing = 2 - /** - * The camera is closed. - */ - closed = 3 -} -``` diff --git a/enums/camera-enhancer/coordinate-base.md b/enums/camera-enhancer/coordinate-base.md deleted file mode 100644 index aff7fa5..0000000 --- a/enums/camera-enhancer/coordinate-base.md +++ /dev/null @@ -1,57 +0,0 @@ ---- -layout: default-layout -title: CameraPosition - Dynamsoft Camera Enhancer Enumerations -description: The enumeration CameraPosition of Dynamsoft Camera Enhancer describes the camera position. -keywords: Camera Position -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: CameraPosition ---- - -# CameraPosition - -Enumeration `CameraPosition` describes the camera position. - -
    - >- Android - >- Objective-C - >- Swift - > -> -```java -@IntDef({CB_IMAGE,CB_VIEW}) -@Retention(RetentionPolicy.CLASS) -public @interface EnumCoordinateBase { - // pixel, percentage - public static final int CB_IMAGE = 0; - // DP - public static final int CB_VIEW = 1; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSCoordinateBase) { - /** - * Image coordinate. - */ - DSCoordinateBaseImage = 0, - /** - * View coordinate. - */ - DSCoordinateBaseView = 1 -}; -``` -> -```swift -public enum CoordinateBase : Int{ - /** - * Image coordinate. - */ - image = 0 - /** - * View coordinate. - */ - view = 1 -} -``` diff --git a/enums/camera-enhancer/drawing-item-media-type.md b/enums/camera-enhancer/drawing-item-media-type.md deleted file mode 100644 index 9f10797..0000000 --- a/enums/camera-enhancer/drawing-item-media-type.md +++ /dev/null @@ -1,108 +0,0 @@ ---- -layout: default-layout -title: CameraPosition - Dynamsoft Camera Enhancer Enumerations -description: The enumeration CameraPosition of Dynamsoft Camera Enhancer describes the camera position. -keywords: Camera Position -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: CameraPosition ---- - -# CameraPosition - -Enumeration `CameraPosition` describes the camera position. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - > -> -```javascript -enum EnumDrawingItemMediaType { - /**The mediate type of the DrawingItem is rectangle. */ - DIMT_RECTANGLE = 1, - /**The mediate type of the DrawingItem is quadrilateral. */ - DIMT_QUADRILATERAL = 2, - /**The mediate type of the DrawingItem is text. */ - DIMT_TEXT = 4, - /**The mediate type of the DrawingItem is arc. */ - DIMT_ARC = 8, - /**The mediate type of the DrawingItem is image. */ - DIMT_IMAGE = 16, - /**The mediate type of the DrawingItem is polygon. */ - DIMT_POLYGON = 32, - /**The mediate type of the DrawingItem is line. */ - DIMT_LINE = 64, - /**The mediate type of the DrawingItem is a group of shapes. */ - DIMT_GROUP = 128 -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumDrawingItemMediaType { - // The mediate type of the DrawingItem is rectangle. - public static final int DIMT_RECTANGLE = 1; - // The mediate type of the DrawingItem is quadrilateral. - public static final int DIMT_QUADRILATERAL = 2; - // The mediate type of the DrawingItem is text. - public static final int DIMT_TEXT = 4; - // The mediate type of the DrawingItem is line. - public static final int DIMT_LINE = 8; - // The mediate type of the DrawingItem is Arc. - public static final int DIMT_ARC = 16; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSDrawingItemMediaType) { - /** - * The mediate type of the DrawingItem is rectangle. - */ - DSDrawingItemMediaTypeRectangle = 1, - /** - * The mediate type of the DrawingItem is quadrilateral. - */ - DSDrawingItemMediaTypeQuadrilateral = 2, - /** - * The mediate type of the DrawingItem is text. - */ - DSDrawingItemMediaTypeText = 4, - /** - * The mediate type of the DrawingItem is line. - */ - DSDrawingItemMediaTypeLine = 8, - /** - * The mediate type of the DrawingItem is arc. - */ - DSDrawingItemMediaTypeArc = 16 -}; -``` -> -```swift -public enum DrawingItemMediaType : Int{ - /** - * The mediate type of the DrawingItem is rectangle. - */ - rectangle = 1 - /** - * The mediate type of the DrawingItem is quadrilateral. - */ - quadrilateral = 2 - /** - * The mediate type of the DrawingItem is text. - */ - text = 4 - /** - * The mediate type of the DrawingItem is line. - */ - line = 8 - /** - * The mediate type of the DrawingItem is arc. - */ - arc = 16 -} -``` diff --git a/enums/camera-enhancer/drawing-item-state.md b/enums/camera-enhancer/drawing-item-state.md deleted file mode 100644 index 181cfa1..0000000 --- a/enums/camera-enhancer/drawing-item-state.md +++ /dev/null @@ -1,67 +0,0 @@ ---- -layout: default-layout -title: CameraPosition - Dynamsoft Camera Enhancer Enumerations -description: The enumeration CameraPosition of Dynamsoft Camera Enhancer describes the camera position. -keywords: Camera Position -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: CameraPosition ---- - -# CameraPosition - -Enumeration `CameraPosition` describes the camera position. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - > -> -```javascript -enum EnumDrawingItemState { - /**The state of the DrawingItem is the default state. */ - DIS_DEFAULT = 1, - /**The state of the DrawingItem is selected. */ - DIS_SELECTED = 2 -} -``` -> -```java -@IntDef({DIS_DEFAULT,DIS_SELECTED}) -@Retention(RetentionPolicy.CLASS) -public @interface EnumDrawingItemState { - // The state of the DrawingItem is the default state. - public static final int DIS_DEFAULT = 1; - // The state of the DrawingItem is selected. - public static final int DIS_SELECTED = 2; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSDrawingItemState) { - /** - * The state of the DrawingItem is the default state. - */ - DSDrawingItemStateDefault = 1, - /** - * The state of the DrawingItem is selected. - */ - DSDrawingItemStateSelected = 2 -}; -``` -> -```swift -public enum CameraPosition : Int{ - /** - * The state of the DrawingItem is the default state. - */ - default = 1 - /** - * The state of the DrawingItem is selected. - */ - selected = 2 -} -``` diff --git a/enums/camera-enhancer/enhancer-features.md b/enums/camera-enhancer/enhancer-features.md deleted file mode 100644 index 4e11f35..0000000 --- a/enums/camera-enhancer/enhancer-features.md +++ /dev/null @@ -1,116 +0,0 @@ ---- -layout: default-layout -title: EnhancerFeatures - Dynamsoft Camera Enhancer Enumerations -description: The enumeration EnhancerFeatures of Dynamsoft Camera Enhancer describes the features of camera enhancer. -keywords: Camera enhancer features -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: EnhancerFeatures ---- - -# EnhancerFeatures - -Enumeration `EnhancerFeatures` indicates the advanced features of Dynamsoft Camera Enhancer. - -- `Frame Filter`: The frame sharpness filter feature of DCE. By enabling this feature, the low-quality frame will be recognized and discarded automatically. -- `Sensor Control`: The sensor filter feature of DCE. By enabling this feature, the frames will be discarded automatically while the device is shaking. -- `Enhanced Focus`: The enhanced focus feature. DCE will support the camera in triggering auto-focus. -- `Fast Mode`: The fast mode of DCE. By enabling the fast mode, the frames will be cropped to speed up the following processing. -- `Auto Zoom`: The auto-zoom feature of DCE. By enabling this feature, the camera will automatically zoom in to the interest area. -- `Smart Torch`: Add a smart torch on the UI. The torch will be hided when the environment brightness is high and displayed when the brightness is low. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - > -> -```javascript -enum EnumEnhancedFeatures { - /**Enable the camera focus feature. */ - EF_ENHANCED_FOCUS = 0x04, - /**Enable the autozoom feature. */ - EF_AUTO_ZOOM = 0x10, - /**Enable the tap to focus feature. */ - EF_TAP_TO_FOCUS = 0x40 -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumEnhancedFeatures { - //Enable the Frame filter feature of DCE - public static final int EF_FRAME_FILTER = 0x01; - //Enable the sensor control feature of DCE - public static final int EF_SENSOR_CONTROL = 0x02; - //Enable the camera focus features of DCE - public static final int EF_ENHANCED_FOCUS = 0x04; - //Enable the autozoom feature - public static final int EF_AUTO_ZOOM = 0x10; - //Enable the smart torch button - public static final int EF_SMART_TORCH = 0x20; - // Enable all. - public static final int EF_ALL = 0x3F; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSEnhancedFeatures) -{ - /** - * Enable frame filter feature of the camera enhancer to make a filter out the low-quality frames. - */ - EnhancedFeatureFrameFilter = 0X01, - /** - * Enable sensor control to filter out all the frames when the device is shaking. - */ - EnhancedFeatureSensorControl = 0X02, - /** - * Enhanced focus helps low-end devices on focusing. - */ - EnhancedFeatureEnhancedFocus = 0X04, - /** - * Enable the camera zoom-in automatically when barcode is far away. - */ - EnhancedFeatureAutoZoom = 0X10, - /** - * Display a torch button when the environment light is low. - */ - EnhancedFeatureSmartTorch = 0X20, - /** - * Enable all the enhanced features. - */ - EnhancedFeatureAll = 0X3F -}; -``` -> -```swift -public enum EnhancedFeatures : Int{ - /** - * Enable frame filter feature of the camera enhancer to make a filter out the low-quality frames. - */ - frameFilter = 0X01 - /** - * Enable sensor control to filter out all the frames when the device is shaking. - */ - sensorControl = 0X02 - /** - * Enhanced focus helps low-end devices on focusing. - */ - enhancedFocus = 0X04 - /** - * Enable the camera zoom-in automatically when barcode is far away. - */ - autoZoom = 0X10 - /** - * Display a torch button when the environment light is low. - */ - smartTorch = 0X20 - /** - * Enable all the enhanced features. - */ - all = 0X3F -} -``` diff --git a/enums/camera-enhancer/focus-mode.md b/enums/camera-enhancer/focus-mode.md deleted file mode 100644 index 52ff997..0000000 --- a/enums/camera-enhancer/focus-mode.md +++ /dev/null @@ -1,57 +0,0 @@ ---- -layout: default-layout -title: FocusMode - Dynamsoft Camera Enhancer Enumerations -description: The enumeration FocusMode of Dynamsoft Camera Enhancer describes the focus mode. -keywords: Focus mode -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: FocusMode ---- - -# FocusMode - -Enumeration `FocusMode` describes the focus mode. - -
    - >- Android - >- Objective-C - >- Swift - > -> -```java -@IntDef({FM_LOCKED,FM_CONTINUOUS_AUTO}) -@Retention(RetentionPolicy.CLASS) -public @interface EnumFocusMode { - // Lock the focal length. - public static final int FM_LOCKED = 1; - // Keep continuous auto-focus. - public static final int FM_CONTINUOUS_AUTO = 2; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSFocusMode){ - /** - * Lock the focal length. - */ - FocusModeLocked = 1, - /** - * Enable the continuous auto-focus. - */ - FocusModeContinuousAuto = 2 -}; -``` -> -```swift -public enum FocusMode : Int{ - /** - * Lock the focal length. - */ - locked = 1 - /** - * Enable the continuous auto-focus. - */ - continuousAuto = 2 -} -``` diff --git a/enums/camera-enhancer/resolution.md b/enums/camera-enhancer/resolution.md deleted file mode 100644 index 14a6c34..0000000 --- a/enums/camera-enhancer/resolution.md +++ /dev/null @@ -1,90 +0,0 @@ ---- -layout: default-layout -title: Resolution - Dynamsoft Camera Enhancer Enumerations -description: The enumeration Resolution of Dynamsoft Camera Enhancer describes the resolution. -keywords: Resolution -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: Resolution ---- - -# EnumResolution - -Enumeration `Resolution` describes the resolution. - -
    - >- Android - >- Objective-C - >- Swift - > -> -```java -@IntDef({RESOLUTION_AUTO,RESOLUTION_480P,RESOLUTION_720P,RESOLUTION_1080P,RESOLUTION_2K,RESOLUTION_4K}) -@Retention(RetentionPolicy.CLASS) -public @interface EnumResolution { - // Auto choose resolution, expected 1080P, if can't choose, choose first lower than 1080P. - public static final int RESOLUTION_AUTO = 0; - // 480P - public static final int RESOLUTION_480P = 1; - // 720P - public static final int RESOLUTION_720P = 2; - // 1080P - public static final int RESOLUTION_1080P = 3; - // 2K - public static final int RESOLUTION_2K = 4; - // 4K - public static final int RESOLUTION_4K = 5; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSResolution) -{ - /** - * Set the video streaming to the auto selected resolution. - */ - ResolutionAuto = 0, - /** - * Set the video streaming to the 480P resolution. - */ - Resolution480P = 1, - /** - * Set the video streaming to the 720P resolution. - */ - Resolution720P = 2, - /** - * Set the video streaming to the 480P resolution. - */ - Resolution1080P = 3, - /** - * Set the video streaming to the 4K resolution. - */ - Resolution4K = 4 -}; -``` -> -```swift -public enum Resolution : Int{ - /** - * Set the video streaming to the auto selected resolution. - */ - auto = 0 - /** - * Set the video streaming to the 480P resolution. - */ - 480P = 1 - /** - * Set the video streaming to the 720P resolution. - */ - 720P = 2 - /** - * Set the video streaming to the 480P resolution. - */ - 1080P = 3 - /** - * Set the video streaming to the 4K resolution. - */ - 4K = 4 -} -``` diff --git a/enums/capture-vision-router/capture-state.md b/enums/capture-vision-router/capture-state.md deleted file mode 100644 index f2cd99a..0000000 --- a/enums/capture-vision-router/capture-state.md +++ /dev/null @@ -1,105 +0,0 @@ ---- -layout: default-layout -title: CaptureState - Dynamsoft Vision Router Enumerations -description: The enumeration CaptureState of Dynamsoft Vision Router describes the state of data capturing. -keywords: Capture state -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: CaptureState ---- - -# Enumeration CaptureState - -`CaptureState` describes the state of data capturing. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - >- C# - >- Python - > -> -```javascript -enum EnumCaptureState -{ - /** The data capturing is started. */ - CS_STARTED = 0, - /** The data capturing is stopped. */ - CS_STOPPED = 1 -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumCaptureState -{ - /** The data capturing is started. */ - public static final int CS_STARTED = 0; - /** The data capturing is stopped. */ - public static final int CS_STOPPED = 1; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSCaptureState) -{ - /** The data capturing is started. */ - DSCaptureStateStarted, - /** The data capturing is stopped. */ - DSCaptureStateStopped -}; -``` -> -```swift -public enum CaptureState : Int -{ - /** The data capturing is started. */ - started - /** The data capturing is stopped. */ - stopped -}; -``` -> -```cpp -typedef enum CaptureState -{ - /** The data capturing is started. */ - CS_STARTED, - /** The data capturing is stopped. */ - CS_STOPPED, - /**The data capturing is paused.*/ - CS_PAUSED, - /**The data capturing is resumed.*/ - CS_RESUMED -} CaptureState; -``` -> -```csharp -public enum EnumCaptureState -{ - /**The data capturing is started.*/ - CS_STARTED, - /**The data capturing is stopped.*/ - CS_STOPPED, - /**The data capturing is paused.*/ - CS_PAUSED, - /**The data capturing is resumed.*/ - CS_RESUMED -} -``` -> -```python -class EnumCaptureState(IntEnum): - #The data capturing is started. - CS_STARTED - #The data capturing is stopped. - CS_STOPPED - #The data capturing is paused. - CS_PAUSED - #The data capturing is resumed. - CS_RESUMED -``` diff --git a/enums/capture-vision-router/image-source-state.md b/enums/capture-vision-router/image-source-state.md deleted file mode 100644 index 59b78c5..0000000 --- a/enums/capture-vision-router/image-source-state.md +++ /dev/null @@ -1,95 +0,0 @@ ---- -layout: default-layout -title: ImageSourceState - Dynamsoft Core Enumerations -description: The enumeration ImageSourceState of Dynamsoft Core describes the state of ImageSourceAdapter. -keywords: Image source state -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: ImageSourceState -codeAutoHeight: true ---- - - -# Enumeration ImageSourceState - -`ImageSourceState` describes the state of an object that conforms to the `ImageSourceAdapter` interface and is designated as the image source in a `CaptureVisionRouter` object. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - >- C# - >- Python - > -> -```javascript -enum EnumImageSourceState -{ - /** Indicates that the buffer of the image source is currently empty. */ - ISS_BUFFER_EMPTY = 0, - /** Signifies that the source for the image source has been depleted. */ - ISS_EXHAUSTED = 1 -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumImageSourceState -{ - /** Indicates that the buffer of the image source is currently empty. */ - public static final int ISS_BUFFER_EMPTY = 0; - /** Signifies that the source for the image source has been depleted. */ - public static final int ISS_EXHAUSTED = 1; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSImageSourceState) -{ - /** Indicates that the buffer of the image source is currently empty. */ - DSImageSourceStateBufferEmpty = 0, - /** Signifies that the source for the image source has been depleted. */ - DSImageSourceStateExhausted = 1 -}; -``` -> -```swift -public enum ImageSourceState : Int -{ - /** Indicates that the buffer of the image source is currently empty. */ - bufferEmpty = 0 - /** Signifies that the source for the image source has been depleted. */ - exhausted = 1 -}; -``` -> -```cpp -typedef enum ImageSourceState -{ - /** Indicates that the buffer of the image source is currently empty. */ - ISS_BUFFER_EMPTY, - /** Signifies that the source for the image source has been depleted. */ - ISS_EXHAUSTED -} ImageSourceState; -``` -> -```csharp -public enum EnumImageSourceState -{ - /**The buffer of ImageSourceAdapter is temporarily empty.*/ - ISS_BUFFER_EMPTY, - /**The source of ImageSourceAdapter is empty.*/ - ISS_EXHAUSTED -} -``` -> -```python -class EnumImageSourceState(IntEnum): - #The buffer of ImageSourceAdapter is temporarily empty. - ISS_BUFFER_EMPTY - #The source of ImageSourceAdapter is empty. - ISS_EXHAUSTED -``` diff --git a/enums/capture-vision-router/preset-template.md b/enums/capture-vision-router/preset-template.md deleted file mode 100644 index 442e20d..0000000 --- a/enums/capture-vision-router/preset-template.md +++ /dev/null @@ -1,252 +0,0 @@ ---- -layout: default-layout -title: PresetTemplate - Dynamsoft Vision Router Enumerations -description: The enumeration PresetTemplate of Dynamsoft Vision Router describes the preset template. -keywords: Capture state -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true ---- - -# Enumeration PresetTemplate - -`PresetTemplate` describes the preset template names. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- Python - > -> -```javascript -enum EnumPresetTemplate { - /** - * @brief Versatile function for barcode reading, document detection, or text recognition. - */ - PT_DEFAULT = "Default", - /** - * @brief Scans a single barcode. - */ - PT_READ_BARCODES = "ReadBarcodes_Default", - /** - * @brief Identifies and reads any text present. - */ - PT_RECOGNIZE_TEXT_LINES = "RecognizeTextLines_Default", - /** - * @brief RIdentifies the edges of a document. - */ - PT_DETECT_DOCUMENT_BOUNDARIES = "DetectDocumentBoundaries_Default", - /** - * @brief Detects document edges and standardizes its format. - */ - PT_DETECT_AND_NORMALIZE_DOCUMENT = "DetectAndNormalizeDocument_Default", - /** - * @brief Adjusts a document to a standard format using detected borders. - */ - PT_NORMALIZE_DOCUMENT = "NormalizeDocument_Default", - /** - * @brief Represents a barcode reading mode where speed is prioritized. - * - * In this mode, the barcode reader will optimize for faster barcode detection - * and decoding, sacrificing some level of accuracy and read rate. It is suitable - * for situations where a quick response time is more important than perfect - * barcode recognition. - */ - PT_READ_BARCODES_SPEED_FIRST = "ReadBarcodes_SpeedFirst", - /** - * @brief Represents a barcode reading mode where barcode read rate is prioritized. - * - * In this mode, the barcode reader will optimize for higher barcode read rates, - * even if it may sometimes result in reduced accuracy and speed. It is suitable for - * scenarios where maximizing the number of successfully read barcodes is critical. - */ - PT_READ_BARCODES_READ_RATE_FIRST = "ReadBarcodes_ReadRateFirst", - /** - * @brief Represents a balanced barcode reading mode. - * - * This mode aims for a reasonable balance between speed and read rate in barcode - * recognition. It is suitable for most common use cases where a compromise between - * speed and read rate is acceptable. - */ - PT_READ_BARCODES_BALANCE = "ReadBarcodes_Balance", - /** - * @brief Represents a barcode reading mode for single barcode code detection. - * - * In this mode, the barcode reader will focus on detecting and decoding a single - * barcode code, ignoring any additional codes in the same image. It is efficient - * when the target image has only one barcode. - */ - PT_READ_SINGLE_BARCODE = "ReadBarcodes_Balanced", - /** - * @brief Represents a barcode reading mode optimized for dense barcode codes. - * - * This mode is designed to handle dense or closely packed barcode codes where - * accuracy is paramount. It may operate slower than other modes but is suitable - * for challenging scenarios where code density is high. - */ - PT_READ_DENSE_BARCODES = "ReadDenseBarcodes", - /** - * @brief Represents a barcode reading mode optimized for distant barcode codes. - * - * This mode is designed to scanning a barcode that is placed far from the device. - */ - PT_READ_DISTANT_BARCODES = "ReadDistantBarcodes", - /** - * @brief Represents a text recognition mode focused on recognizing numbers. - */ - PT_RECOGNIZE_NUMBERS = "RecognizeNumbers", - /** - * @brief Represents a text recognition mode focused on recognizing alphabetic characters (letters). - * - */ - PT_RECOGNIZE_LETTERS = "RecognizeLetters", - /** - * @brief Represents a text recognition mode that combines numbers and alphabetic characters (letters) recognition. - */ - PT_RECOGNIZE_NUMBERS_AND_LETTERS = "RecognizeNumbersAndLetters", - /** - * @brief Represents a text recognition mode that combines numbers and uppercase letters recognition. - */ - PT_RECOGNIZE_NUMBERS_AND_UPPERCASE_LETTERS = "RecognizeNumbersAndUppercaseLetters", - /** - * @brief Represents a text recognition mode focused on recognizing uppercase letters. - */ - PT_RECOGNIZE_UPPERCASE_LETTERS = "RecognizeUppercaseLetters" -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumPresetTemplate -{ - /** Template name: "Default". It implements barcode decoding, label recognizing and document normalizing. */ - String PT_DEFAULT = "Default"; - /** Template name: "ReadBarcodes_Default". */ - String PT_READ_BARCODES = "ReadBarcodes_Default"; - /** Template name: "RecognizeTextLines_Default". */ - String PT_RECOGNIZE_TEXT_LINES = "RecognizeTextLines_Default"; - /** Template name: "DetectDocumentBoundaries_Default". */ - String PT_DETECT_DOCUMENT_BOUNDARIES = "DetectDocumentBoundaries_Default"; - /** Template name: "DetectAndNormalizeDocument_Default". */ - String PT_DETECT_AND_NORMALIZE_DOCUMENT = "DetectAndNormalizeDocument_Default"; - /** Template name: "NormalizeDocument_Default". */ - String PT_NORMALIZE_DOCUMENT = "NormalizeDocument_Default"; - /** Template name: "ReadBarcodes_SpeedFirst". */ - String PT_READ_BARCODES_SPEED_FIRST = "ReadBarcodes_SpeedFirst"; - /** Template name: "ReadBarcodes_ReadRateFirst". */ - String PT_READ_BARCODES_READ_RATE_FIRST = "ReadBarcodes_ReadRateFirst"; - /** Template name: "ReadSingleBarcode". */ - String PT_READ_SINGLE_BARCODE = "ReadSingleBarcode"; - /** Template name: "RecognizeNumbers". */ - String PT_RECOGNIZE_NUMBERS = "RecognizeNumbers"; - /** Template name: "RecognizeLetters". */ - String PT_RECOGNIZE_LETTERS = "RecognizeLetters"; - /** Template name: "RecognizeNumbersAndLetters". */ - String PT_RECOGNIZE_NUMBERS_AND_LETTERS = "RecognizeNumbersAndLetters"; - /** Template name: "RecognizeNumbersAndUppercaseLetters". */ - String PT_RECOGNIZE_NUMBERS_AND_UPPERCASE_LETTERS = "RecognizeNumbersAndUppercaseLetters"; - /** Template name: "RecognizeUppercaseLetters". */ - String PT_RECOGNIZE_UPPERCASE_LETTERS = "RecognizeUppercaseLetters"; -} -``` -> -```objc -/** DSPresetTemplate defines the enumerations that indicates the preset capture vision templates.*/ -typedef NSString * DSPresetTemplate NS_STRING_ENUM NS_SWIFT_NAME(PresetTemplate); -/** The default template that performs barcode decoding, label recognizing, boundary detecting and document normalizing. The template name is "Default".*/ -FOUNDATION_EXPORT DSPresetTemplate const _Nonnull DSPresetTemplateDefault NS_SWIFT_NAME(presetDefault); -/** The template that enables barcode decoding only. The template name is "ReadBarcodes_Default".*/ -FOUNDATION_EXPORT DSPresetTemplate const _Nonnull DSPresetTemplateReadBarcodes NS_SWIFT_NAME(readBarcodes); -/** The template that enables label recognizing only. The template name is "RecognizeTextLines_Default".*/ -FOUNDATION_EXPORT DSPresetTemplate const _Nonnull DSPresetTemplateRecognizeTextLines NS_SWIFT_NAME(recognizeTextLines); -/** The template that enables boundary detecting only. The template name is "DetectDocumentBoundaries_Default".*/ -FOUNDATION_EXPORT DSPresetTemplate const _Nonnull DSPresetTemplateDetectDocumentBoundaries NS_SWIFT_NAME(detectDocumentBoundaries); -/** The template that enables both boundary detecting and document normalizing. The template name is "DetectAndNormalizeDocument_Default".*/ -FOUNDATION_EXPORT DSPresetTemplate const _Nonnull DSPresetTemplateDetectAndNormalizeDocument NS_SWIFT_NAME(detectAndNormalizeDocument); -/** The template that enables document normalizing only. The template name is "NormalizeDocument_Default".*/ -FOUNDATION_EXPORT DSPresetTemplate const _Nonnull DSPresetTemplateNormalizeDocument NS_SWIFT_NAME(normalizeDocument); -/** The template that enables barcode decoding and the speed performance is prioritized. The template name is "ReadBarcodes_SpeedFirst".*/ -FOUNDATION_EXPORT PresetTemplate const _Nonnull DSPresetTemplateReadBarcodesSpeedFirst NS_SWIFT_NAME(readBarcodesSpeedFirst); -/** The template that enables barcode decoding and the read rate performance is prioritized. The template name is "ReadBarcodes_ReadRateFirst".*/ -FOUNDATION_EXPORT PresetTemplate const _Nonnull DSPresetTemplateReadBarcodesReadRateFirst NS_SWIFT_NAME(readBarcodesReadRateFirst); -/** This template is specially configured for single barcode decoding. The template name is "ReadSingleBarcode".*/ -FOUNDATION_EXPORT PresetTemplate const _Nonnull DSPresetTemplateReadSingleBarcode NS_SWIFT_NAME(readSingleBarcode); -/** This template is specially configured for recognizing numbers from the text lines. The template name is "RecognizeNumbers".*/ -FOUNDATION_EXPORT PresetTemplate const _Nonnull DSPresetTemplateRecognizeNumbers NS_SWIFT_NAME(recognizeNumbers); -/** This template is specially configured for recognizing letters from the text lines. The template name is "RecognizeLetters".*/ -FOUNDATION_EXPORT PresetTemplate const _Nonnull DSPresetTemplateRecognizeLetters NS_SWIFT_NAME(recognizeLetters); -/** This template is specially configured for recognizing number and letters from the text lines. The template name is "RecognizeNumbersAndLetters".*/ -FOUNDATION_EXPORT PresetTemplate const _Nonnull DSPresetTemplateRecognizeNumbersAndLetters NS_SWIFT_NAME(recognizeNumbersAndLetters); -/** This template is specially configured for recognizing number and upper case letters from the text lines. The template name is "RecognizeNumbersAndUppercaseLetters".*/ -FOUNDATION_EXPORT PresetTemplate const _Nonnull DSPresetTemplateRecognizeNumbersAndUppercaseLetters NS_SWIFT_NAME(recognizeNumbersAndUppercaseLetters); -/** This template is specially configured for recognizing upper case letters from the text lines. The template name is "RecognizeUppercaseLetters".*/ -FOUNDATION_EXPORT PresetTemplate const _Nonnull DSPresetTemplateRecognizeUppercaseLetters NS_SWIFT_NAME(recognizeUppercaseLetters); -``` -> -```swift -struct PresetTemplate -{ - /** The default template that performs barcode decoding, label recognizing, boundary detecting and document normalizing. The template name is "Default".*/ - static let default = "default" - /** The template that enables barcode decoding only. The template name is "ReadBarcodes_Default".*/ - static let readBarcodes = "read-barcodes" - /** The template that enables label recognizing only. The template name is "RecognizeTextLines_Default".*/ - static let recognizeTextLines = "recognize-textLines" - /** The template that enables boundary detecting only. The template name is "DetectDocumentBoundaries_Default".*/ - static let detectDocumentBoundaries = "detect-document-boundaries" - /** The template that enables both boundary detecting and document normalizing. The template name is "DetectAndNormalizeDocument_Default".*/ - static let detectAndNormalizeDocument = "DetectAndNormalizeDocument_Default" - /** The template that enables document normalizing only. The template name is "NormalizeDocument_Default".*/ - static let normalizeDocument = "NormalizeDocument_Default" - /** The template that enables barcode decoding and the speed performance is prioritized. The template name is "ReadBarcodes_SpeedFirst".*/ - static let readBarcodesSpeedFirst = "ReadBarcodes_SpeedFirst" - /** The template that enables barcode decoding and the read rate performance is prioritized. The template name is "ReadBarcodes_ReadRateFirst".*/ - static let readBarcodesReadRateFirst = "ReadBarcodes_ReadRateFirst" - /** This template is specially configured for single barcode decoding. The template name is "ReadSingleBarcode".*/ - static let readSingleBarcode = "ReadSingleBarcode" - /** This template is specially configured for recognizing numbers from the text lines. The template name is "RecognizeNumbers".*/ - static let recognizeNumbers = "RecognizeNumbers" - /** This template is specially configured for recognizing letters from the text lines. The template name is "RecognizeLetters".*/ - static let recognizeLetters = "RecognizeLetters" - /** This template is specially configured for recognizing number and letters from the text lines. The template name is "RecognizeNumbersAndLetters".*/ - static let recognizeNumbersAndLetters = "RecognizeNumbersAndLetters" - /** This template is specially configured for recognizing number and upper case letters from the text lines. The template name is "RecognizeNumbersAndUppercaseLetters".*/ - static let recognizeNumbersAndUppercaseLetters = "RecognizeNumbersAndUppercaseLetters" - /** This template is specially configured for recognizing upper case letters from the text lines. The template name is "RecognizeUppercaseLetters".*/ - static let recognizeUppercaseLetters = "RecognizeUppercaseLetters" -} -``` -> -```python -class EnumPresetTemplate(str, Enum): - # Template name: "Default". It supports barcode decoding, label recognizing and document normalizing. - PT_DEFAULT = "Default" - # Template name: "ReadBarcodes_Default". It only supports barcode decoding. - PT_READ_BARCODES = "ReadBarcodes_Default" - # Template name: "RecognizeTextLines_Default". It only supports label recognition. - PT_RECOGNIZE_TEXT_LINES = "RecognizeTextLines_Default" - # Template name: "DetectDocumentBoundaries_Default". It only supports detecting document boundaries. - PT_DETECT_DOCUMENT_BOUNDARIES = "DetectDocumentBoundaries_Default" - # Template name: "DetectAndNormalizeDocument_Default". It supports detecting document boundaries and normalizing documents. - PT_DETECT_AND_NORMALIZE_DOCUMENT = "DetectAndNormalizeDocument_Default" - # Template name: "NormalizeDocument_Default". It only supports normalizing documents. - PT_NORMALIZE_DOCUMENT = "NormalizeDocument_Default" - # Template name: "ReadBarcodes_SpeedFirst". Represents a barcode reading mode where speed is prioritized. - PT_READ_BARCODES_SPEED_FIRST = "ReadBarcodes_SpeedFirst" - # Template name: "ReadBarcodes_ReadRateFirst". Represents a barcode reading mode where barcode read rate is prioritized. - PT_READ_BARCODES_READ_RATE_FIRST = "ReadBarcodes_ReadRateFirst" - # Template name: "ReadSingleBarcode". Represents a barcode reading mode for single barcode code detection. - PT_READ_SINGLE_BARCODE = "ReadSingleBarcode" - # Template name: "RecognizeNumbers". Represents a text recognition mode focused on recognizing numbers. - PT_RECOGNIZE_NUMBERS = "RecognizeNumbers" - # Template name: "RecognizeLetters". Represents a text recognition mode focused on recognizing alphabetic characters (letters). - PT_RECOGNIZE_LETTERS = "RecognizeLetters" - # Template name: "RecognizeNumbersAndLetters". Represents a text recognition mode that combines numbers and alphabetic characters (letters) recognition. - PT_RECOGNIZE_NUMBERS_AND_LETTERS = "RecognizeNumbersAndLetters" - # Template name: "RecognizeNumbersAndUppercaseLetters". Represents a text recognition mode that combines numbers and uppercase letters recognition. - PT_RECOGNIZE_NUMBERS_AND_UPPERCASE_LETTERS = "RecognizeNumbersAndUppercaseLetters" - # Template name: "RecognizeUppercaseLetters". Represents a text recognition mode focused on recognizing uppercase letters. - PT_RECOGNIZE_UPPERCASE_LETTERS = "RecognizeUppercaseLetters" -``` \ No newline at end of file diff --git a/enums/code-parser/mapping-status.md b/enums/code-parser/mapping-status.md deleted file mode 100644 index d81e935..0000000 --- a/enums/code-parser/mapping-status.md +++ /dev/null @@ -1,111 +0,0 @@ ---- -layout: default-layout -title: MappingStatus - Dynamsoft Code Parser Enumerations -description: The enumeration MappingStatus of Dynamsoft Code Parser represents the outcome of a mapping operation on a field. -keywords: Mapping status -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: MappingStatus ---- - -# Enumeration MappingStatus - -`MappingStatus` represents the outcome of a mapping operation on a field. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - >- C# - >- Python - > -> -```javascript -enum EnumMappingStatus { - /** - * Indicates that no mapping operation has been initiated. - */ - MS_NONE = 0, - /** - * Indicates that the mapping operation was successfully completed. - */ - MS_SUCCEEDED = 1, - /** - * Indicates that the mapping operation failed to complete. - */ - MS_FAILED = 2 -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumMappingStatus { - /** The field has no mapping specified. */ - public static final int MS_NONE = 0; - /** Find a mapping for the field value. */ - public static final int MS_SUCCEEDED = 1; - /** Failed to find a mapping for the field value. */ - public static final int MS_FAILED = 2; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSMappingStatus) -{ - /** The field has no mapping specified. */ - DSMappingStatusNotSpecified = 0, - /** Find a mapping for the field value. */ - DSMappingStatusSucceeded = 1, - /** Failed to find a mapping for the field value. */ - DSMappingStatusFailed = 2 -}; -``` -> -```swift -public enum MappingStatus : Int -{ - /** The field has no mapping specified. */ - none = 0 - /** Find a mapping for the field value. */ - succeeded = 1 - /** Failed to find a mapping for the field value. */ - failed = 2 -} -``` -> -```cpp -typedef enum MappingStatus -{ - /** The field has no mapping specified. */ - MS_NONE, - /** Find a mapping for the field value. */ - MS_SUCCEEDED, - /** Failed to find a mapping for the field value. */ - MS_FAILED -} MappingStatus; -``` -> -```csharp -public enum EnumMappingStatus -{ - /** The field has no mapping specified. */ - MS_NONE, - /** Find a mapping for the field value. */ - MS_SUCCEEDED, - /** Failed to find a mapping for the field value. */ - MS_FAILED -} -``` -> -```python -class EnumMappingStatus(IntEnum): - # The field has no mapping specified. - MS_NONE - # Find a mapping for the field value. - MS_SUCCEEDED - # Failed to find a mapping for the field value. - MS_FAILED -``` diff --git a/enums/code-parser/validation-status.md b/enums/code-parser/validation-status.md deleted file mode 100644 index a85009f..0000000 --- a/enums/code-parser/validation-status.md +++ /dev/null @@ -1,112 +0,0 @@ ---- -layout: default-layout -title: ValidationStatus - Dynamsoft Code Parser Enumerations -description: The enumeration ValidationStatus of Dynamsoft Code Parser describes the outcome of a validation process on a field. -keywords: Validation status -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: ValidationStatus ---- - -# Enumeration ValidationStatus - -`ValidationStatus` describes the outcome of a validation process on a field. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - >- C# - >- Python - > -> -```javascript -enum EnumValidationStatus { - /** - * Indicates that no validation has been performed. - */ - VS_NONE = 0, - /** - * Indicates that the validation process was completed successfully. - */ - VS_SUCCEEDED = 1, - /** - * Indicates that the validation process failed. - */ - VS_FAILED = 2 -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumValidationStatus -{ - /** The field has no validation specified. */ - public static final int VS_NONE = 0; - /** The validation for the field has been succeeded. */ - public static final int VS_SUCCEEDED = 1; - /** The validation for the field has been failed. */ - public static final int VS_FAILED = 2; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSValidationStatus) -{ - /** The field has no validation specified. */ - DSValidationStatusNone = 0, - /** The validation for the field has been succeeded. */ - DSValidationStatusSucceeded = 1, - /** The validation for the field has been failed. */ - DSValidationStatusFailed = 2 -}; -``` -> -```swift -public enum ValidationStatus : Int -{ - /** The field has no validation specified. */ - none = 0 - /** The validation for the field has been succeeded. */ - succeeded = 1 - /** The validation for the field has been failed. */ - failed = 2 -} -``` -> -```cpp -typedef enum ValidationStatus -{ - /** The field has no validation specified. */ - VS_NONE, - /** The validation for the field has been succeeded. */ - VS_SUCCEEDED, - /** The validation for the field has been failed. */ - VS_FAILED -} ValidationStatus; -``` -> -```csharp -public enum EnumValidationStatus -{ - /** The field has no validation specified. */ - VS_NONE, - /** The validation for the field has been succeeded. */ - VS_SUCCEEDED, - /** The validation for the field has been failed. */ - VS_FAILED -} -``` -> -```python -class EnumValidationStatus(IntEnum): - # The field has no validation specified. - VS_NONE - # The validation for the field has been succeeded. - VS_SUCCEEDED - # The validation for the field has been failed. - VS_FAILED -``` diff --git a/enums/core/buffer-overflow-protection-mode.md b/enums/core/buffer-overflow-protection-mode.md deleted file mode 100644 index 24e9a9a..0000000 --- a/enums/core/buffer-overflow-protection-mode.md +++ /dev/null @@ -1,93 +0,0 @@ ---- -layout: default-layout -title: BufferOverflowProtectionMode - Dynamsoft Core Enumerations -description: The enumeration BufferOverflowProtectionMode of Dynamsoft Core describes the protection modes when the buffer of ImageSourceAdapter is overflow. -keywords: Buffer overflow protection mode -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: BufferOverflowProtectionMode -codeAutoHeight: true ---- - -# Enumeration BufferOverflowProtectionMode - -`BufferOverflowProtectionMode` describes the protection modes to manage situations when the `ImageSourceAdapter`'s buffer exceeds its capacity. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - >- C# - >- Python - > -> -```javascript -enum EnumBufferOverflowProtectionMode { - /** New images are blocked when the buffer is full.*/ - BOPM_Block = 0, - /** New images are appended at the end, and oldest images are pushed out from the beginning if the buffer is full.*/ - BOPM_Update = 1 -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumBufferOverflowProtectionMode -{ - /** New images are blocked when the buffer is full.*/ - public static final int BOPM_BLOCK = 0; - /** New images are appended at the end, and oldest images are pushed out from the beginning if thebuffer is full.*/ - public static final int BOPM_UPDATE = 1; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSBufferOverflowProtectionMode) -{ - /** New images are blocked when the buffer is full.*/ - DSBufferOverflowProtectionModeBlock = 0, - /** New images are appended at the end, and oldest images are pushed out from the beginning if thebuffer is full.*/ - DSBufferOverflowProtectionModeUpdate = 1, -}NS_SWIFT_NAME(BufferOverflowProtectionMode); -``` -> -```swift -public enum BufferOverflowProtectionMode : Int -{ - /** New images are blocked when the buffer is full.*/ - block = 0 - /** New images are appended at the end, and oldest images are pushed out from the beginning if thebuffer is full.*/ - update = 1 -} -``` -> -```cpp -typedef enum BufferOverflowProtectionMode -{ - /** New images are blocked when the buffer is full. */ - BOPM_BLOCK = 0, - /** New images are appended at the end, and oldest images are pushed out from the beginning if the buffer is full. */ - BOPM_UPDATE = 1 -} BufferOverflowProtectionMode; -``` -> -```csharp -public enum EnumBufferOverflowProtectionMode -{ - /** New images are blocked when the buffer is full. */ - BOPM_BLOCK = 0x00, - /** New images are appended at the end, and the oldest images are pushed out from the beginning if the buffer is full. */ - BOPM_UPDATE = 0x01, -} -``` -> -```python -class EnumBufferOverflowProtectionMode(IntEnum): - # New images are blocked when the buffer is full. - BOPM_BLOCK = 0x00 - # New images are appended at the end, and the oldest images are pushed out from the beginning if the buffer is full. - BOPM_UPDATE = 0x01 -``` diff --git a/enums/core/captured-result-item-type.md b/enums/core/captured-result-item-type.md deleted file mode 100644 index dcbc635..0000000 --- a/enums/core/captured-result-item-type.md +++ /dev/null @@ -1,167 +0,0 @@ ---- -layout: default-layout -title: CapturedResultItemType - Dynamsoft Core Enumerations -description: The enumeration CapturedResultItemType of Dynamsoft Core describes all types of captured result item. -keywords: Captured result types -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: CapturedResultItemType -codeAutoHeight: true ---- - -# Enumeration CapturedResultItemType - -`CapturedResultItemType` defines the various categories of items that can be recognized and captured. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - >- C# - >- Python - > -> -```javascript -enum EnumCapturedResultItemType { - /** - * Represents an original image captured by the system. - * This type is used to identify the raw, unmodified image data directly obtained from the image source. - */ - CRIT_ORIGINAL_IMAGE = 1, - /** - * Identifies a captured item as a barcode within the image. - * This type signifies that the item has been recognized as a barcode and contains data extracted from the barcode. - */ - CRIT_BARCODE = 2, - /** - * Identifies a captured item as a line of text within the image. - * This type signifies that the item has been recognized as a line of text and contains the textual content. - */ - CRIT_TEXT_LINE = 4, - /** - * Identifies a captured item as a quadrilateral detected within the image. - * This type is typically used for geometric shapes or areas of interest that have been identified, often in the context of document scanning. - */ - CRIT_DETECTED_QUAD = 8, - /** - * Represents an image that has been processed and normalized based on the original image. - * Normalization may include adjustments such as deskewing, perspective correction, etc. to standardize the image presentation. - */ - CRIT_NORMALIZED_IMAGE = 16, - /** - * Indicates a parsed result item. - * This type is used for items that have undergone further interpretation by Dynamsoft Code Parser, transforming raw data into a structured format. - */ - CRIT_PARSE_RESULT = 32 -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumCapturedResultItemType -{ - /** The type of the CapturedResultItem is "original image". */ - public static final int CRIT_ORIGINAL_IMAGE = 1; - /** The type of the CapturedResultItem is "barcode". */ - public static final int CRIT_BARCODE = 2; - /** The type of the CapturedResultItem is "text line". */ - public static final int CRIT_TEXT_LINE = 4; - /** The type of the CapturedResultItem is "detected quad". */ - public static final int CRIT_DETECTED_QUAD = 8; - /** The type of the CapturedResultItem is "normalized image". */ - public static final int CRIT_NORMALIZED_IMAGE = 16; - /** The type of the CapturedResultItem is "parsed result". */ - public static final int CRIT_PARSED_RESULT = 32; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSCapturedResultItemType) -{ - /** The captured result is a original image. You can convert it into a DSOriginalImageResultItem. */ - DSCapturedResultItemTypeOriginalImage = 1, - /** The captured result is a decoded barcode. You can convert it into a DSBarcodeResultItem. */ - DSCapturedResultItemTypeBarcode = 2, - /** The captured result is a recognized text line. You can convert it into a DSTextLineResultItem. */ - DSCapturedResultItemTypeTextLine = 4, - /** The captured result is a detected quadrilateral. You can convert it into a DSDetectedQuadResultItem. */ - DSCapturedResultItemTypeDetectedQuad = 8, - /** The captured result is a normalized image. You can convert it into a DSNormalizedImageResultItem. */ - DSCapturedResultItemTypeNormalizedImage = 16, - /** The captured result is a parsed result. You can convert it into a DSParsedResultItem. */ - DSCapturedResultItemTypeParsedResult = 32 -}; -``` -> -```swift -public enum CapturedResultItemType : Int -{ - /** The captured result is a original image. You can convert it into a DSOriginalImageResultItem. */ - originalImage = 1 - /** The captured result is a decoded barcode. You can convert it into a DSBarcodeResultItem. */ - barcode = 2 - /** The captured result is a recognized text line. You can convert it into a DSTextLineResultItem. */ - textLine = 4 - /** The captured result is a detected quadrilateral. You can convert it into a DSDetectedQuadResultItem. */ - detectedQuad = 8 - /** The captured result is a normalized image. You can convert it into a DSNormalizedImageResultItem. */ - normalizedImage = 16 - /** The captured result is a parsed result. You can convert it into a DSParsedResultItem. */ - parsedResult = 32 -}; -``` -> -```cpp -typedef enum CapturedResultItemType -{ - /** The type of the CapturedResultItem is "original image". */ - CRIT_ORIGINAL_IMAGE = 1, - /** The type of the CapturedResultItem is "barcode". */ - CRIT_BARCODE = 2, - /** The type of the CapturedResultItem is "text line". */ - CRIT_TEXT_LINE = 4, - /** The type of the CapturedResultItem is "detected quad". */ - CRIT_DETECTED_QUAD = 8, - /** The type of the CapturedResultItem is "normalized image". */ - CRIT_NORMALIZED_IMAGE = 16, - /** The type of the CapturedResultItem is "parsed result". */ - CRIT_PARSED_RESULT = 32 -} CapturedResultItemType; -``` -> -```csharp -public enum EnumCapturedResultItemType -{ - /** The type of the CapturedResultItem is "original image". */ - CRIT_ORIGINAL_IMAGE = 1, - /** The type of the CapturedResultItem is "barcode". */ - CRIT_BARCODE = 2, - /** The type of the CapturedResultItem is "text line". */ - CRIT_TEXT_LINE = 4, - /** The type of the CapturedResultItem is "detected quad". */ - CRIT_DETECTED_QUAD = 8, - /** The type of the CapturedResultItem is "normalized image". */ - CRIT_NORMALIZED_IMAGE = 16, - /** The type of the CapturedResultItem is "parsed result". */ - CRIT_PARSED_RESULT = 32 -} -``` -> -```python -class EnumCapturedResultItemType(IntEnum): - # The type of the CapturedResultItem is "original image". - CRIT_ORIGINAL_IMAGE = 1 - # The type of the CapturedResultItem is "barcode". - CRIT_BARCODE = 2 - # The type of the CapturedResultItem is "text line". - CRIT_TEXT_LINE = 4 - # The type of the CapturedResultItem is "detected quad". - CRIT_DETECTED_QUAD = 8 - # The type of the CapturedResultItem is "normalized image". - CRIT_NORMALIZED_IMAGE = 16 - # The type of the CapturedResultItem is "parsed result". - CRIT_PARSED_RESULT = 32 -``` diff --git a/enums/core/colour-channel-usage-type.md b/enums/core/colour-channel-usage-type.md deleted file mode 100644 index 1be1e3a..0000000 --- a/enums/core/colour-channel-usage-type.md +++ /dev/null @@ -1,167 +0,0 @@ ---- -layout: default-layout -title: ColourChannelUsageType - Dynamsoft Core Enumerations -description: The enumeration ColourChannelUsageType of Dynamsoft Core describes how the color channel is used in the image. -keywords: Corner type -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: ColourChannelUsageType -codeAutoHeight: true ---- - -# Enumeration ColourChannelUsageType - -`ColourChannelUsageType` enumerates the different ways color channels can be utilized in image processing. This allows for flexible image analysis and manipulation by specifying how color data should be handled. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - >- C# - >- Python - > -> -```javascript -enum EnumColourChannelUsageType { - /** - * Automatically determines how color channels are used. - * This option allows the SDK to choose the most appropriate channel usage mode dynamically. - */ - CCUT_AUTO = 0, - /** - * Utilizes all available color channels in the image for processing. - * This mode is ideal for scenarios where full color information is necessary for accurate analysis or processing. - */ - CCUT_FULL_CHANNEL = 1, - /** - * Processes images using only the Y (luminance) channel, specifically in NV21 format images. - * This mode is useful for operations that require analyzing the brightness or intensity of the image while ignoring color information. - */ - CCUT_Y_CHANNEL_ONLY = 2, - /** - * Uses only the red color channel for processing in RGB images. - * This mode is useful for tasks that require analysis or manipulation based on the red component of the image. - */ - CCUT_RGB_R_CHANNEL_ONLY = 3, - /** - * Uses only the green color channel for processing in RGB images. - * This mode is useful for tasks where the green component is most relevant. - */ - CCUT_RGB_G_CHANNEL_ONLY = 4, - /** - * Uses only the blue color channel for processing in RGB images. - * This mode is useful for tasks where the blue component is of particular interest. - */ - CCUT_RGB_B_CHANNEL_ONLY = 5 -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumColourChannelUsageType -{ - /** Automatic color channel usage determination based on image pixel format and scene. */ - public static final int CCUT_AUTO = 0; - /** Use all available color channels for processing. */ - public static final int CCUT_FULL_CHANNEL = 1; - /** Use only the Y (luminance) channel for processing in images represented in the NV21 format. */ - public static final int CCUT_NV21_Y_CHANNEL_ONLY = 2; - /** Use only the red channel for processing in RGB images.*/ - public static final int CCUT_RGB_R_CHANNEL_ONLY = 3; - /** Use only the green channel for processing in RGB images.*/ - public static final int CCUT_RGB_G_CHANNEL_ONLY = 4; - /** Use only the blue channel for processing in RGB images.*/ - public static final int CCUT_RGB_B_CHANNEL_ONLY = 5; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSColourChannelUsageType) -{ - /** Automatic color channel usage determination based on image pixel format and scene. */ - DSColourChannelUsageTypeAuto = 0, - /** Use all available color channels for processing. */ - DSColourChannelUsageTypeFullChannel = 1, - /** Use only the Y (luminance) channel for processing in images represented in the NV21 format. */ - DSColourChannelUsageTypeNV21YChannelOnly = 2, - /** Use only the red channel for processing in RGB images.*/ - DSColourChannelUsageTypeRGBRChannelOnly = 3, - /** Use only the green channel for processing in RGB images.*/ - DSColourChannelUsageTypeRGBGChannelOnly = 4, - /** Use only the blue channel for processing in RGB images.*/ - DSColourChannelUsageTypeRGBBChannelOnly = 5 -}; -``` -> -```swift -public enum ColourChannelUsageType : Int -{ - /** Automatic color channel usage determination based on image pixel format and scene. */ - auto = 0, - /** Use all available color channels for processing. */ - fullChannel = 1, - /** Use only the Y (luminance) channel for processing in images represented in the NV21 format. */ - nv21YChannelOnly = 2, - /** Use only the red channel for processing in RGB images.*/ - rgbrChannelOnly = 3, - /** Use only the green channel for processing in RGB images.*/ - rgbgChannelOnly = 4, - /** Use only the blue channel for processing in RGB images.*/ - rgbbChannelOnly = 5 -}; -``` -> -```cpp -typedef enum ColourChannelUsageType -{ - /** Automatic color channel usage determination based on image pixel format and scene. */ - CCUT_AUTO, - /** Use all available color channels for processing. */ - CCUT_FULL_CHANNEL, - /** Use only the Y (luminance) channel for processing in images represented in the NV21 format. */ - CCUT_NV21_Y_CHANNEL_ONLY, - /** Use only the red channel for processing in RGB images.*/ - CCUT_RGB_R_CHANNEL_ONLY, - /** Use only the green channel for processing in RGB images.*/ - CCUT_RGB_G_CHANNEL_ONLY, - /** Use only the blue channel for processing in RGB images.*/ - CCUT_RGB_B_CHANNEL_ONLY -} ColourChannelUsageType; -``` -> -```csharp -public enum EnumColourChannelUsageType -{ - /**Automatic color channel usage determination based on image pixel format and scene.*/ - CCUT_AUTO, - /**Use all available color channels for processing.*/ - CCUT_FULL_CHANNEL, - /**Use only the Y(luminance) channel for processing in images represented in the NV21 format.*/ - CCUT_Y_CHANNEL_ONLY, - /**Use only the red channel for processing in RGB images.*/ - CCUT_RGB_R_CHANNEL_ONLY, - /**Use only the green channel for processing in RGB images.*/ - CCUT_RGB_G_CHANNEL_ONLY, - /**Use only the blue channel for processing in RGB images.*/ - CCUT_RGB_B_CHANNEL_ONLY -} -``` -> -```python -class EnumColourChannelUsageType(IntEnum): - #Automatic color channel usage determination based on image pixel format and scene. - CCUT_AUTO - #Use all available color channels for processing. - CCUT_FULL_CHANNEL - #Use only the Y(luminance) channel for processing in images represented in the NV21 format. - CCUT_Y_CHANNEL_ONLY - #Use only the red channel for processing in RGB images. - CCUT_RGB_R_CHANNEL_ONLY - #Use only the green channel for processing in RGB images. - CCUT_RGB_G_CHANNEL_ONLY - #Use only the blue channel for processing in RGB images. - CCUT_RGB_B_CHANNEL_ONLY -``` diff --git a/enums/core/corner-type.md b/enums/core/corner-type.md deleted file mode 100644 index 823a1b8..0000000 --- a/enums/core/corner-type.md +++ /dev/null @@ -1,118 +0,0 @@ ---- -layout: default-layout -title: CornerType - Dynamsoft Core Enumerations -description: The enumeration CornerType of Dynamsoft Core describes how the corner is formed by its sides. -keywords: Corner type -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: CornerType -codeAutoHeight: true ---- - -# Enumeration CornerType - -`CornerType` categorizes the nature of a corner based on the intersection of its adjoining sides. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - >- Python - > -> -```javascript -enum EnumCornerType { - /** - * Represents a corner formed by the standard intersection of two line segments at a point, creating a typical corner shape. - * This is the most common corner type, where the angle between the line segments can vary from acute to obtuse. - */ - CT_NORMAL_INTERSECTED = 0, - /** - * Describes a corner where two line segments intersect in a T-shape. - * This occurs when one line segment terminates at the midpoint of another, creating three distinct angles. - */ - CT_T_INTERSECTED = 1, - /** - * Characterizes a corner formed by two line segments intersecting each other in a cross shape. - * This configuration results in four angles and is commonly encountered in grid or lattice patterns. - */ - CT_CROSS_INTERSECTED = 2, - /** - * Defines a scenario where two line segments do not physically intersect but conceptually form a corner. - * This can occur in virtual shapes or when the corner is implied by the continuation of lines beyond their endpoints. - */ - CT_NOT_INTERSECTED = 3 -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumCornerType -{ - /** The corner is formed by two intersecting line segments. */ - public static final int CT_NORMAL_INTERSECTED = 0; - /** The corner is formed by two T intersecting line segments. */ - public static final int CT_T_INTERSECTED = 1; - /** The corner is formed by two cross intersecting line segments. */ - public static final int CT_CROSS_INTERSECTED = 2; - /** The two line segments are not intersected but they definitely consist a corner. */ - public static final int CT_NOT_INTERSECTED = 3; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSCornerType) -{ - /** The corner is formed by two intersecting line segments. */ - DSCornerTypeNormalIntersected, - /** The corner is formed by two T intersecting line segments. */ - DSCornerTypeTIntersected, - /** The corner is formed by two cross intersecting line segments. */ - DSCornerTypeCrossIntersected, - /** The two line segments are not intersected but they definitely consist a corner. */ - DSCornerTypeNotIntersected -}; -``` -> -```swift -public enum CornerType : Int -{ - /** The corner is formed by two intersecting line segments. */ - intersected - /** The corner is formed by two T intersecting line segments. */ - tIntersected - /** The corner is formed by two cross intersecting line segments. */ - crossIntersected - /** The two line segments are not intersected but they definitely consist a corner. */ - notIntersected -}; -``` -> -```cpp -typedef enum CornerType -{ - /* The sides of the corner is normally intersected. */ - CT_NORMAL_INTERSECTED = 0, - /* The sides of the corner is T-intersected. */ - CT_T_INTERSECTED = 1, - /* The sides of the corner is cross-intersected. */ - CT_CROSS_INTERSECTED = 2, - /* The sides are not intersected but they definitely make up a corner. */ - CT_NOT_INTERSECTED = 3, -} CornerType; -``` -> -```python -class EnumCornerType(IntEnum): - # The sides of the corner is normally intersected. - CT_NORMAL_INTERSECTED - # The sides of the corner is T-intersected. - CT_T_INTERSECTED - # The sides of the corner is cross-intersected. - CT_CROSS_INTERSECTED - # The sides are not intersected but they definitely make up a corner. - CT_NOT_INTERSECTED -``` diff --git a/enums/core/cross-verification-status.md b/enums/core/cross-verification-status.md deleted file mode 100644 index 265f349..0000000 --- a/enums/core/cross-verification-status.md +++ /dev/null @@ -1,83 +0,0 @@ ---- -layout: default-layout -title: CrossVerificationStatus - Dynamsoft Core Enumerations -description: The enumeration CrossVerificationStatus of Dynamsoft Core describes the status of the captured results. -keywords: cross verification status -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: CrossVerificationStatus -codeAutoHeight: true ---- - -# Enumeration CrossVerificationStatus - -`CrossVerificationStatus` describes the status of the captured results. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - > -> -```javascript -enum EnumCrossVerificationStatus { - /** The cross verification has not been performed yet. */ - CVS_NOT_VERIFIED = 0, - /** The cross verification has been passed successfully. */ - CVS_PASSED = 1, - /** The cross verification has failed. */ - CVS_FAILED = 2 - } -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumCrossVerificationStatus -{ - /** The cross verification has not been performed yet. */ - public static final int CVS_NOT_VERIFIED; - /** The cross verification has been passed successfully. */ - public static final int CVS_PASSED; - /** The cross verification has failed. */ - public static final int CVS_FAILED; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSCrossVerificationStatus) -{ - /** The cross verification has not been performed yet. */ - DSCrossVerificationStatusNotVerified, - /** The cross verification has been passed successfully. */ - DSCrossVerificationStatusPassed, - /** The cross verification has failed. */ - DSCrossVerificationStatusFailed -}; -``` -> -```swift -public enum CrossVerificationStatus : Int -{ - /** The cross verification has not been performed yet. */ - notVerified, - /** The cross verification has been passed successfully. */ - passed, - /** The cross verification has failed. */ - failed -}; -``` -> -```cpp -typedef enum CrossVerificationStatus -{ - /** The cross verification has not been performed yet. */ - CVS_NOT_VERIFIED, - /** The cross verification has been passed successfully. */ - CVS_PASSED, - /** The cross verification has failed. */ - CVS_FAILED -} CrossVerificationStatus; -``` diff --git a/enums/core/error-code.md b/enums/core/error-code.md deleted file mode 100644 index 325363e..0000000 --- a/enums/core/error-code.md +++ /dev/null @@ -1,1618 +0,0 @@ ---- -layout: default-layout -title: ErrorCode - Dynamsoft Core Enumerations -description: The enumeration ErrorCode of Dynamsoft Core describes all error codes. -keywords: Error code -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: ErrorCode -codeAutoHeight: true ---- - -# Enumeration ErrorCode - -`ErrorCode` enumerates the specific error codes that the SDK may return, providing a systematic way to identify and handle errors encountered during its operation. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - >- C# - >- Python - > -> -```javascript -enum EnumErrorCode -{ - /** Operation completed successfully. */ - EC_OK = 0, - // Common error codes range from -10000 to -19999 - /** An unspecified error occurred. */ - EC_UNKNOWN = -10000, - /** The system does not have enough memory to perform the requested operation. */ - EC_NO_MEMORY = -10001, - /** A null pointer was encountered where a valid pointer was required. */ - EC_NULL_POINTER = -10002, - /** The provided license is not valid. */ - EC_LICENSE_INVALID = -10003, - /** The provided license has expired. */ - EC_LICENSE_EXPIRED = -10004, - /** The specified file could not be found. */ - EC_FILE_NOT_FOUND = -10005, - /** The file type is not supported for processing. */ - EC_FILE_TYPE_NOT_SUPPORTED = -10006, - /** The image's bits per pixel (BPP) is not supported. */ - EC_BPP_NOT_SUPPORTED = -10007, - /** The specified index is out of the valid range. */ - EC_INDEX_INVALID = -10008, - /** The specified custom region value is invalid or out of range. */ - EC_CUSTOM_REGION_INVALID = -10010, - /** Failed to read the image due to an error in accessing or interpreting the image data. */ - EC_IMAGE_READ_FAILED = -10012, - /** Failed to read a TIFF image, possibly due to corruption or unsupported format. */ - EC_TIFF_READ_FAILED = -10013, - /** The provided DIB (Device-Independent Bitmaps) buffer is invalid or corrupted. */ - EC_DIB_BUFFER_INVALID = -10018, - /** Failed to read a PDF image, possibly due to corruption or unsupported format. */ - EC_PDF_READ_FAILED = -10021, - /** Required PDF processing DLL is missing. */ - EC_PDF_DLL_MISSING = -10022, - /** The specified page number is invalid or out of bounds for the document. */ - EC_PAGE_NUMBER_INVALID = -10023, - /** The specified custom size is invalid or not supported. */ - EC_CUSTOM_SIZE_INVALID = -10024, - /** The operation timed out. */ - EC_TIMEOUT = -10026, - /** Failed to parse JSON input. */ - EC_JSON_PARSE_FAILED = -10030, - /** The JSON type is invalid for the expected context. */ - EC_JSON_TYPE_INVALID = -10031, - /** The JSON key is invalid or unrecognized in the current context. */ - EC_JSON_KEY_INVALID = -10032, - /** The JSON value is invalid for the specified key. */ - EC_JSON_VALUE_INVALID = -10033, - /** The required "Name" key is missing in the JSON data. */ - EC_JSON_NAME_KEY_MISSING = -10034, - /** The value of the "Name" key is duplicated and conflicts with existing data. */ - EC_JSON_NAME_VALUE_DUPLICATED = -10035, - /** The template name is invalid or does not match any known template. */ - EC_TEMPLATE_NAME_INVALID = -10036, - /** The reference made by the "Name" key is invalid or points to nonexistent data. */ - EC_JSON_NAME_REFERENCE_INVALID = -10037, - /** The parameter value provided is invalid or out of the expected range. */ - EC_PARAMETER_VALUE_INVALID = -10038, - /** The domain of the current site does not match the domain bound to the current product key. */ - EC_DOMAIN_NOT_MATCH = -10039, - /** The reserved information does not match the reserved info bound to the current product key. */ - EC_RESERVED_INFO_NOT_MATCH = -10040, - /** The license key does not match the license content. */ - EC_LICENSE_KEY_NOT_MATCH = -10043, - /** Failed to request the license content from the server. */ - EC_REQUEST_FAILED = -10044, - /** Failed to initialize the license. */ - EC_LICENSE_INIT_FAILED = -10045, - /** Error setting the mode's argument, indicating invalid or incompatible arguments. */ - EC_SET_MODE_ARGUMENT_ERROR = -10051, - /** The license content is invalid or corrupted. */ - EC_LICENSE_CONTENT_INVALID = -10052, - /** The license key is invalid or does not match any known valid keys. */ - EC_LICENSE_KEY_INVALID = -10053, - /** The license key has reached its maximum allowed usage and has no remaining quota. */ - EC_LICENSE_DEVICE_RUNS_OUT = -10054, - /** Failed to retrieve the mode's argument, possibly due to invalid state or configuration. */ - EC_GET_MODE_ARGUMENT_ERROR = -10055, - /** The Intermediate Result Types (IRT) license is invalid or not present. */ - EC_IRT_LICENSE_INVALID = -10056, - /** Failed to save the file, possibly due to permissions, space, or an invalid path. */ - EC_FILE_SAVE_FAILED = -10058, - /** The specified stage type is invalid or not supported in the current context. */ - EC_STAGE_TYPE_INVALID = -10059, - /** The specified image orientation is invalid or not supported. */ - EC_IMAGE_ORIENTATION_INVALID = -10060, - /** Failed to convert complex template to simplified settings, indicating a configuration or compatibility issue. */ - EC_CONVERT_COMPLEX_TEMPLATE_ERROR = -10061, - /** Rejecting function call while capturing is in progress, to prevent conflicts or data corruption. */ - EC_CALL_REJECTED_WHEN_CAPTURING = -10062, - /** The specified image source was not found, indicating a missing or inaccessible input source. */ - EC_NO_IMAGE_SOURCE = -10063, - /** Failed to read the directory, possibly due to permissions, non-existence, or other access issues. */ - EC_READ_DIRECTORY_FAILED = -10064, - /** A required module (e.g., DynamsoftBarcodeReader, DynamsoftLabelRecognizer) was not found. */ - EC_MODULE_NOT_FOUND = -10065, - /** The operation does not support multi-page files; use FileFetcher for processing such files. */ - EC_MULTI_PAGES_NOT_SUPPORTED = -10066, - /** Indicates an attempt to write to a file that already exists, with overwriting explicitly disabled. This error suggests the need for either enabling overwriting or ensuring unique file names to avoid conflicts. */ - EC_FILE_ALREADY_EXISTS = -10067, - /** The specified file path does not exist and could not be created. This error could be due to insufficient permissions, a read-only filesystem, or other environmental constraints preventing file creation. */ - EC_CREATE_FILE_FAILED = -10068, - /** The input ImageData object contains invalid parameters. This could be due to incorrect data types, out-of-range values, or improperly formatted data being passed to a function expecting ImageData. */ - EC_IMGAE_DATA_INVALID = -10069, - // DLS license error codes range from -20000 to -29999 - /** Indicates no license is available or the license is not set. */ - EC_NO_LICENSE = -20000, - /** The provided Handshake Code is invalid or does not match expected format. */ - EC_HANDSHAKE_CODE_INVALID = -20001, - /** Encountered failures while attempting to read or write to the license buffer. */ - EC_LICENSE_BUFFER_FAILED = -20002, - /** Synchronization with the license server failed, possibly due to network issues or server unavailability. */ - EC_LICENSE_SYNC_FAILED = -20003, - /** The device attempting to use the license does not match the device specified in the license buffer. */ - EC_DEVICE_NOT_MATCH = -20004, - /** Binding the device to the license failed, indicating possible issues with the license or device identifier. */ - EC_BIND_DEVICE_FAILED = -20005, - /** The number of instances using the license exceeds the limit allowed by the license terms. */ - EC_INSTANCE_COUNT_OVER_LIMIT = -20008, - /** InitLicenseFromDLS must be called before any SDK objects are created to ensure proper license initialization. */ - EC_LICENSE_INIT_SEQUENCE_FAILED = -20009, - /** Indicates the license in use is a trial version with limited functionality or usage time. */ - EC_TRIAL_LICENSE = -20010, - /** The system failed to reach the License Server, likely due to network connectivity issues. */ - EC_FAILED_TO_REACH_DLS = -20200, - // DBR error codes range from -30000 to -39999 - /** The specified barcode format is invalid or unsupported. */ - EC_BARCODE_FORMAT_INVALID = -30009, - /** The license for decoding QR Codes is invalid or not present. */ - EC_QR_LICENSE_INVALID = -30016, - /** The license for decoding 1D barcodes is invalid or not present. */ - EC_1D_LICENSE_INVALID = -30017, - /** The license for decoding PDF417 barcodes is invalid or not present. */ - EC_PDF417_LICENSE_INVALID = -30019, - /** The license for decoding DataMatrix barcodes is invalid or not present. */ - EC_DATAMATRIX_LICENSE_INVALID = -30020, - /** The specified custom module size for barcode generation is invalid or outside acceptable limits. */ - EC_CUSTOM_MODULESIZE_INVALID = -30025, - /** The license for decoding Aztec barcodes is invalid or not present. */ - EC_AZTEC_LICENSE_INVALID = -30041, - /** The license for decoding Patchcode barcodes is invalid or not present. */ - EC_PATCHCODE_LICENSE_INVALID = -30046, - /** The license for decoding postal code formats is invalid or not present. */ - EC_POSTALCODE_LICENSE_INVALID = -30047, - /** The license for Direct Part Marking (DPM) decoding is invalid or not present. */ - EC_DPM_LICENSE_INVALID = -30048, - /** A frame decoding thread is already running, indicating a concurrent operation conflict. */ - EC_FRAME_DECODING_THREAD_EXISTS = -30049, - /** Stopping the frame decoding thread failed, indicating potential issues with thread management. */ - EC_STOP_DECODING_THREAD_FAILED = -30050, - /** The license for decoding MaxiCode barcodes is invalid or not present. */ - EC_MAXICODE_LICENSE_INVALID = -30057, - /** The license for decoding GS1 DataBar barcodes is invalid or not present. */ - EC_GS1_DATABAR_LICENSE_INVALID = -30058, - /** The license for decoding GS1 Composite codes is invalid or not present. */ - EC_GS1_COMPOSITE_LICENSE_INVALID = -30059, - /** The license for decoding DotCode barcodes is invalid or not present. */ - EC_DOTCODE_LICENSE_INVALID = -30061, - /** The license for decoding Pharmacode barcodes is invalid or not present. */ - EC_PHARMACODE_LICENSE_INVALID = -30062, - // DLR error codes range from -40000 to -49999 - /** Indicates that the required character model file was not found, possibly due to incorrect paths or missing files. */ - EC_CHARACTER_MODEL_FILE_NOT_FOUND = -40100, - // DDN error codes range from -50000 to -59999 - /** The specified quadrilateral is invalid, potentially due to incorrect points or an unprocessable shape. */ - EC_QUADRILATERAL_INVALID = -50057, - // Panorama error codes range from -70000 to -79999 - /** The license for generating or processing panoramas is invalid or missing. */ - EC_PANORAMA_LICENSE_INVALID = -70060, - // Reserved error codes range from -80000 to -89999 - // DCP error codes range from -90000 to -99999 - /** The specified resource path does not exist, indicating a missing directory or incorrect path specification. */ - EC_RESOURCE_PATH_NOT_EXIST = -90001, - /** Failed to load the specified resource, which might be due to missing files, access rights, or other issues preventing loading. */ - EC_RESOURCE_LOAD_FAILED = -90002, - /** The code specification required for processing was not found, indicating a missing or incorrect specification. */ - EC_CODE_SPECIFICATION_NOT_FOUND = -90003, - /** The full code string provided is empty, indicating no data was provided for processing. */ - EC_FULL_CODE_EMPTY = -90004, - /** Preprocessing the full code string failed, possibly due to invalid format, corruption, or unsupported features. */ - EC_FULL_CODE_PREPROCESS_FAILED = -90005, - /** The license required for parsing South Africa Driver License data is invalid or not present. */ - EC_ZA_DL_LICENSE_INVALID = -90006, - /** The license required for parsing North America DL/ID (AAMVA) data is invalid or not present. */ - EC_AAMVA_DL_ID_LICENSE_INVALID = -90007, - /** The license required for parsing Aadhaar data is invalid or not present. */ - EC_AADHAAR_LICENSE_INVALID = -90008, - /** The license required for parsing Machine Readable Travel Documents (MRTD) is invalid or not present. */ - EC_MRTD_LICENSE_INVALID = -90009, - /** The license required for parsing Vehicle Identification Number (VIN) data is invalid or not present. */ - EC_VIN_LICENSE_INVALID = -90010, - /** The license required for parsing customized code types is invalid or not present. */ - EC_CUSTOMIZED_CODE_TYPE_LICENSE_INVALID = -90011 -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumErrorCode -{ - /** Successful. */ - public static final int EC_OK = 0; - /** -10000~-19999: Common error code. */ - /** Unknown error. */ - public static final int EC_UNKNOWN = -10000, - /**Not enough memory to perform the operation. */ - public static final int EC_NO_MEMORY = -10001, - /** Null pointer */ - public static final int EC_NULL_POINTER = -10002, - /** License invalid. */ - public static final int EC_LICENSE_INVALID = -10003, - /** License expired. */ - public static final int EC_LICENSE_EXPIRED = -10004, - /** File not found. */ - public static final int EC_FILE_NOT_FOUND = -10005, - /** The file type is not supported. */ - public static final int EC_FILE_TYPE_NOT_SUPPORTED = -10006, - /** The BPP (Bits Per Pixel) is not supported. */ - public static final int EC_BPP_NOT_SUPPORTED = -10007, - /** The index is invalid. */ - public static final int EC_INDEX_INVALID = -10008, - /** The input region value parameter is invalid. */ - public static final int EC_CUSTOM_REGION_INVALID = -10010, - /** Failed to read the image. */ - public static final int EC_IMAGE_READ_FAILED = -10012, - /** Failed to read the TIFF image. */ - public static final int EC_TIFF_READ_FAILED = -10013, - /** The DIB (Device-Independent Bitmaps) buffer is invalid. */ - public static final int EC_DIB_BUFFER_INVALID = -10018, - /** Failed to read the PDF image. */ - public static final int EC_PDF_READ_FAILED = -10021, - /** The PDF DLL is missing. */ - public static final int EC_PDF_DLL_MISSING = -10022, - /** The page number is invalid. */ - public static final int EC_PAGE_NUMBER_INVALID = -10023, - /** The custom size is invalid. */ - public static final int EC_CUSTOM_SIZE_INVALID = -10024, - /** timeout. */ - public static final int EC_TIMEOUT = -10026, - /** Json parse failed. */ - public static final int EC_JSON_PARSE_FAILED = -10030, - /** Json type invalid. */ - public static final int EC_JSON_TYPE_INVALID = -10031, - /** Json key invalid. */ - public static final int EC_JSON_KEY_INVALID = -10032, - /** Json value invalid. */ - public static final int EC_JSON_VALUE_INVALID = -10033, - /** Json name key missing. */ - public static final int EC_JSON_NAME_KEY_MISSING = -10034, - /** The value of the key "Name" is duplicated. */ - public static final int EC_JSON_NAME_VALUE_DUPLICATED = -10035, - /** Template name invalid. */ - public static final int EC_TEMPLATE_NAME_INVALID = -10036, - /** The name reference is invalid. */ - public static final int EC_JSON_NAME_REFERENCE_INVALID = -10037, - /** Parameter value invalid. */ - public static final int EC_PARAMETER_VALUE_INVALID = -10038, - /** The domain of your current site does not match the domain bound in the current product key. */ - public static final int EC_DOMAIN_NOT_MATCH = -10039, - /** The reserved info does not match the reserved info bound in the current product key. */ - public static final int EC_RESERVED_INFO_NOT_MATCH = -10040, - /** The license key does not match the license content. */ - public static final int EC_LICENSE_KEY_NOT_MATCH = -10043, - /** Failed to request the license content. */ - public static final int EC_REQUEST_FAILED = -10044, - /** Failed to init the license. */ - public static final int EC_LICENSE_INIT_FAILED = -10045, - /** Failed to set mode's argument. */ - public static final int EC_SET_MODE_ARGUMENT_ERROR = -10051, - /** The license content is invalid. */ - public static final int EC_LICENSE_CONTENT_INVALID = -10052, - /** The license key is invalid. */ - public static final int EC_LICENSE_KEY_INVALID = -10053, - /** The license key has no remaining quota. */ - public static final int EC_LICENSE_DEVICE_RUNS_OUT = -10054, - /** Failed to get mode's argument. */ - public static final int EC_GET_MODE_ARGUMENT_ERROR = -10055, - /** The Intermediate Result Types license is invalid. */ - public static final int EC_IRT_LICENSE_INVALID = -10056, - /** Failed to save file. */ - public static final int EC_FILE_SAVE_FAILED = -10058, - /** The stage type is invalid. */ - public static final int EC_STAGE_TYPE_INVALID = -10059, - /** The image orientation is invalid. */ - public static final int EC_IMAGE_ORIENTATION_INVALID = -10060, - /** Complex tempalte can't be converted to simplified settings. */ - public static final int EC_CONVERT_COMPLEX_TEMPLATE_ERROR = -10061, - /** Reject function call while capturing in progress.*/ - public static final int EC_CALL_REJECTED_WHEN_CAPTURING = -10062, - /**The input image source was not found.*/ - public static final int EC_NO_IMAGE_SOURCE = -10063, - /**Failed to read directory.*/ - public static final int EC_READ_DIRECTORY_FAILED = -10064, - /**[Name] Module not found.*/ - /**Name : */ - /**DynamsoftBarcodeReader*/ - /**DynamsoftLabelRecognizer*/ - /**DynamsoftDocumentNormalizer*/ - public static final int EC_MODULE_NOT_FOUND = -10065, - /**The file already exists but overwriting is disabled.*/ - public static final int EC_FILE_ALREADY_EXISTS = -10067, - /**The file path does not exist but cannot be created, or cannot be created for any other reason.*/ - public static final int EC_CREATE_FILE_FAILED = -10068, - /**The input ImageData object contains invalid parameter(s).*/ - public static final int EC_IMGAE_DATA_INVALID = -10069, - /**The size of the input image do not meet the requirements.*/ - public static final int EC_IMAGE_SIZE_NOT_MATCH = -10070, - /**The pixel format of the input image do not meet the requirements.*/ - public static final int EC_IMAGE_PIXEL_FORMAT_NOT_MATCH = -10071, - /**The section level result is irreplaceable.*/ - public static final int EC_SECTION_LEVEL_RESULT_IRREPLACEABLE = -10072, - /**The axis definition is incorrect.*/ - public static final int EC_AXIS_DEFINITION_INCORRECT = -10073, - /**The result is not replaceable due to type mismatch*/ - public static final int EC_RESULT_TYPE_MISMATCH_IRREPLACEABLE = -10074, - /**Failed to load the PDF library.*/ - public static final int EC_PDF_LIBRARY_LOAD_FAILED = -10075, - /*The license is initialized successfully but detected invalid content in your key.*/ - public static final int EC_LICENSE_WARNING = -10076, - /** -20000~-29999: DLS license error code. */ - /** No license. */ - public static final int EC_NO_LICENSE = -20000, - /** The Handshake Code is invalid. */ - public static final int EC_HANDSHAKE_CODE_INVALID = -20001, - /** Failed to read or write license buffer. */ - public static final int EC_LICENSE_BUFFER_FAILED = -20002, - /** Failed to synchronize license info with license server. */ - public static final int EC_LICENSE_SYNC_FAILED = -20003, - /** Device dose not match with buffer. */ - public static final int EC_DEVICE_NOT_MATCH = -20004, - /** Failed to bind device. */ - public static final int EC_BIND_DEVICE_FAILED = -20005, - /** Instance count is over limit. */ - public static final int EC_INSTANCE_COUNT_OVER_LIMIT = -20008, - /** Trial License */ - public static final int EC_TRIAL_LICENSE = -20010, - /** Failed to reach License Server. */ - public static final int EC_FAILED_TO_REACH_DLS = -20200, - /** -30000~-39999: DBR error code. */ - /** The barcode format is invalid. */ - public static final int EC_BARCODE_FORMAT_INVALID = -30009, - /** The QR Code license is invalid. */ - public static final int EC_QR_LICENSE_INVALID = -30016, - /** The 1D Barcode license is invalid. */ - public static final int EC_1D_LICENSE_INVALID = -30017, - /** The PDF417 license is invalid. */ - public static final int EC_PDF417_LICENSE_INVALID = -30019, - /** The DATAMATRIX license is invalid. */ - public static final int EC_DATAMATRIX_LICENSE_INVALID = -30020, - /** The custom module size is invalid. */ - public static final int EC_CUSTOM_MODULESIZE_INVALID = -30025, - /** The AZTEC license is invalid. */ - public static final int EC_AZTEC_LICENSE_INVALID = -30041, - /** The Patchcode license is invalid. */ - public static final int EC_PATCHCODE_LICENSE_INVALID = -30046, - /** The Postal code license is invalid. */ - public static final int EC_POSTALCODE_LICENSE_INVALID = -30047, - /** The DPM license is invalid. */ - public static final int EC_DPM_LICENSE_INVALID = -30048, - /** The frame decoding thread already exists. */ - public static final int EC_FRAME_DECODING_THREAD_EXISTS = -30049, - /** Failed to stop the frame decoding thread. */ - public static final int EC_STOP_DECODING_THREAD_FAILED = -30050, - /** The Maxicode license is invalid. */ - public static final int EC_MAXICODE_LICENSE_INVALID = -30057, - /** The GS1 Databar license is invalid. */ - public static final int EC_GS1_DATABAR_LICENSE_INVALID = -30058, - /** The GS1 Composite code license is invalid. */ - public static final int EC_GS1_COMPOSITE_LICENSE_INVALID = -30059, - /** The DotCode license is invalid. */ - public static final int EC_DOTCODE_LICENSE_INVALID = -30061, - /** The Pharmacode license is invalid. */ - public static final int EC_PHARMACODE_LICENSE_INVALID = -30062, - /*[Barcode Reader] No license found.*/ - public static final int EC_DBR_LICENSE_NOT_FOUND = -30063, - /** -40000~-49999: DLR error code */ - /** Character Model file is not found. */ - public static final int EC_CHARACTER_MODEL_FILE_NOT_FOUND = -40100, - /**There is a conflict in the layout of TextLineGroup. */ - public static final int EC_TEXT_LINE_GROUP_LAYOUT_CONFLICT = -40101, - /**There is a conflict in the regex of TextLineGroup. */ - public static final int EC_TEXT_LINE_GROUP_REGEX_CONFLICT = -40102, - /*[Label Recognizer] No license found.*/ - public static final int EC_DLR_LICENSE_NOT_FOUND = -40103, - /** -50000~-59999: DDN error code. */ - /**No content has been detected. */ - public static final int EC_CONTENT_NOT_FOUND = -50056, - /*The quadrilateral is invalid. */ - public static final int EC_QUADRILATERAL_INVALID = -50057, - /*[Document Normalizer] No license found.*/ - public static final int EC_DDN_LICENSE_NOT_FOUND = -50058, - /** -60000~-69999: DCE error code. */ - /**-60000~-69999: DCE error code*/ - /** The camera module is not exist. */ - public static final int EC_CAMERA_MODULE_NOT_EXIST = -60003; - /** The camera id does not exist. */ - public static final int EC_CAMERA_ID_NOT_EXIST = -60006; - /** The sensor does not exist. */ - public static final int EC_NO_SENSOR = -60045; - /**-70000~-79999: Panorama error code. */ - /**The panorama license is invalid. */ - public static final int EC_PANORAMA_LICENSE_INVALID = -70060, - /** -80000~-89999: Reserved error code. */ - /**-90000~-99999: DCP error code. */ - /** The resource path is not exist. */ - public static final int EC_RESOURCE_PATH_NOT_EXIST = -90001, - /** Failed to load resource. */ - public static final int EC_RESOURCE_LOAD_FAILED = -90002, - /** The code specification is not found. */ - public static final int EC_CODE_SPECIFICATION_NOT_FOUND = -90003, - /** The full code string is empty. */ - public static final int EC_FULL_CODE_EMPTY = -90004, - /** Failed to preprocess the full code string */ - public static final int EC_FULL_CODE_PREPROCESS_FAILED = -90005, - /** The license for parsing South Africa Driver License is invalid. */ - public static final int EC_ZA_DL_LICENSE_INVALID = -90006, - /** The license for parsing North America DL/ID is invalid. */ - public static final int EC_AAMVA_DL_ID_LICENSE_INVALID = -90007, - /** The license for parsing Aadhaar is invalid. */ - public static final int EC_AADHAAR_LICENSE_INVALID = -90008, - /** The license for parsing Machine Readable Travel Documents is invalid. */ - public static final int EC_MRTD_LICENSE_INVALID = -90009, - /** The license for parsing Vehicle Identification Number is invalid. */ - public static final int EC_VIN_LICENSE_INVALID = -90010, - /** The license for parsing customized code type is invalid. */ - public static final int EC_CUSTOMIZED_CODE_TYPE_LICENSE_INVALID = -90011, - /*[Code Parser] No license found.*/ - public static final int EC_DCP_LICENSE_NOT_FOUND = -90012 -} ErrorCode; -``` -> -```objc -typedef NS_ERROR_ENUM(DSErrorDomain, DSError) { - /**Successful. */ - DSErrorOK = 0, - /**Unknown error. */ - DSErrorUnknown = -10000, - /**Not enough memory to perform the operation. */ - DSErrorNoMemory = -10001, - /**Null pointer */ - DSErrorNullPointer = -10002, - /**License invalid*/ - DSErrorLicenseInvalid = -10003, - /**License expired*/ - DSErrorLicenseExpired = -10004, - /**File not found*/ - DSErrorFileNotFound = -10005, - /**The file type is not supported. */ - DSErrorFiletypeNotSupported = -10006, - /**The BPP (Bits Per Pixel) is not supported. */ - DSErrorBPPNotSupported = -10007, - /**Failed to read the image. */ - DSErrorImageReadFailed = -10012, - /**Failed to read the TIFF image. */ - DSErrorTiffReadFailed = -10013, - /**The DIB (Device-Independent Bitmaps) buffer is invalid. */ - DSErrorDIBBufferInvalid = -10018, - /**Failed to read the PDF image. */ - DSErrorPdfReadFailed = -10021, - /**The PDF DLL is missing. */ - DSErrorPdfDllMissing = -10022, - /**The page number is invalid. */ - DSErrorPageNumberInvalid = -10023, - /**The custom size is invalid. */ - DSErrorCustomSizeInvalid = -10024, - /** timeout. */ - DSErrorTimeout = -10026, - /**Json parse failed*/ - DSErrorJsonParseFailed = -10030, - /**Json type invalid*/ - DSErrorJsonTypeInvalid = -10031, - /**Json key invalid*/ - DSErrorJsonKeyInvalid = -10032, - /**Json value invalid*/ - DSErrorJsonValueInvalid = -10033, - /**Json name key missing*/ - DSErrorJsonNameKeyMissing = -10034, - /**The value of the key "Name" is duplicated.*/ - DSErrorJsonNameValueDuplicated = -10035, - /**Template name invalid*/ - DSErrorTemplateNameInvalid = -10036, - /**The name reference is invalid.*/ - DSErrorJsonNameReferenceInvalid = -10037, - /**Parameter value invalid*/ - DSErrorParameterValueInvalid = -10038, - /**The domain of your current site does not match the domain bound in the current product key.*/ - DSErrorDomainNotMatch = -10039, - /**The reserved info does not match the reserved info bound in the current product key.*/ - DSErrorReservedInfoNotMatch = -10040, - /**The license key does not match the license content.*/ - DSErrorLicenseKeyNotMatch = -10043, - /**Failed to request the license content.*/ - DSErrorRequestFailed = -10044, - /**Failed to init the license.*/ - DSErrorLicenseInitFailed = -10045, - /**Failed to set mode's argument.*/ - DSErrorSetModeArgumentError = -10051, - /**The license content is invalid.*/ - DSErrorLicenseContentInvalid = -10052, - /**The license key is invalid.*/ - DSErrorLicenseKeyInvalid = -10053, - /**The license key has no remaining quota.*/ - DSErrorLicenseDeviceRunsOut = -10054, - /**Failed to get mode's argument.*/ - DSErrorGetModeArgumentError = -10055, - /**The Intermediate Result Types license is invalid.*/ - DSErrorIrtLicenseInvalid = -10056, - /**Failed to save file.*/ - DSErrorFileSaveFailed = -10058, - /**The stage type is invalid.*/ - DSErrorStageTypeInvalid = -10059, - /**The image orientation is invalid.*/ - DSErrorImageOrientationInvalid = -10060, - /**Failed to convert complex tempalte to simplified settings.*/ - DSErrorConvertComplexTemplateError = -10061, - /**Reject function call while capturing in progress.*/ - DSErrorCallRejectedWhenCapturing = -10062, - /**The input image source was not found.*/ - DSErrorNoImageSource = -10063, - /**Failed to read directory.*/ - DSErrorReadDirectoryFailed = -10064, - /**[Name] Module not found.*/ - /**Name : */ - /**DynamsoftBarcodeReader*/ - /**DynamsoftLabelRecognizer*/ - /**DynamsoftDocumentNormalizer*/ - DSErrorModuleNotFound = -10065, - /**The file already exists but overwriting is disabled.*/ - DSErrorFileAlreadyExists = -10067, - /**The file path does not exist but cannot be created, or cannot be created for any other reason.*/ - DSErrorCreateFileFailed = -10068, - /**The input ImageData object contains invalid parameter(s).*/ - DSErrorImageDataInvalid = -10069, - /**The size of the input image does not meet the requirements.*/ - DSErrorImageSizeNotMatch = -10070, - /**The pixel format of the input image does not meet the requirements.*/ - DSErrorImagePixelFormatNotMatch = -10071, - /**The section level result is irreplaceable.*/ - DSErrorSectionLevelResultIrreplaceable = -10072, - /**The axis definition is incorrect.*/ - DSErrorAxisDefinitionIncorrect = -10073, - /**The result is not replaceable due to type mismatch*/ - DSErrorResultTypeMismatchIrreplaceable = -10074, - /**Failed to load the PDF library.*/ - DSErrorPDFLibraryLoadFailed = -10075, - /*The license is initialized successfully but detected invalid content in your key.*/ - DSErrorLicenseWarning = -10076, - /**No license.*/ - DSErrorNoLicense = -20000, - /**The handshake code is invalid. */ - DSErrorHandshakeCodeInvalid = -20001, - /**Failed to read or write license cache. */ - DSErrorLicenseBufferFailed = -20002, - /**Falied to synchronize license info wirh license tracking server. */ - DSErrorLicenseSyncFailed = -20003, - /**Device does not match with license buffer. */ - DSErrorDeviceNotMatch = -20004, - /**Falied to bind device. */ - DSErrorBindDeviceFailed = -20005, - /**Install.*/ - DSErrorInstanceCountOverLimit = -20008, - /**Trial License*/ - DSErrorTrialLicense = -20010, - /**The license is not valid for current version*/ - DSErrorLicenseVersionNotMatch = -20011, - /**Failed to reach License Tracking Server.*/ - DSErrorFailedToReachDLS = -20200 - /** -30000~-39999: DBR error code. */ - /** The barcode format is invalid. */ - DSErrorBarcodeFormatInvalid = -30009, - /** The QR Code license is invalid. */ - DSErrorQRLicenseInvalid = -30016, - /** The 1D Barcode license is invalid. */ - DSError1DLicenseInvalid = -30017, - /** The PDF417 license is invalid. */ - DSErrorPDF417LicenseInvalid = -30019, - /** The DATAMATRIX license is invalid. */ - DSErrorDATAMATRIXLicenseInvalid = -30020, - /** The custom module size is invalid. */ - DSErrorCustomModuleSizeInvalid = -30025, - /** The AZTEC license is invalid. */ - DSErrorAztecLicenseInvalid = -30041, - /** The Patchcode license is invalid. */ - DSErrorPatchCodeLicenseInvalid = -30046, - /** The Postal code license is invalid. */ - DSErrorPostalCodeLicenseInvalid = -30047, - /** The DPM license is invalid. */ - DSErrorDPMLicenseInvalid = -30048, - /** The frame decoding thread already exists. */ - DSErrorFrameDecodingThreadExists = -30049, - /** Failed to stop the frame decoding thread. */ - DSErrorStopDecodingThreadFailed = -30050, - /** The Maxicode license is invalid. */ - DSErrorMaxiCodeLicenseInvalid = -30057, - /** The GS1 Databar license is invalid. */ - DSErrorGS1DatabarLicenseInvalid = -30058, - /** The GS1 Composite code license is invalid. */ - DSErrorGS1CompositeLicenseInvalid = -30059, - /** The DotCode license is invalid. */ - DSErrorDotCodeLicenseInvalid = -30061, - /** The Pharmacode license is invalid. */ - DSErrorPharmaCodeLicenseInvalid = -30062, - /*[Barcode Reader] No license found.*/ - DSErrorDBRLicenseNotFound = -30063, - /** -40000~-49999: DLR error code */ - /** Character Model file is not found. */ - DSErrorCharacterModelFileNotFound = -40100, - /** There is a conflict in the layout of TextLineGroup. */ - DSErrorTextLineGroupLayoutConflict = -40101, - /** There is a conflict in the regex of TextLineGroup. */ - DSErrorTextLineGroupRegexConflict = -40102, - /*[Label Recognizer] No license found.*/ - DSErrorDLRLicenseNotFound = -40103, - /** -50000~-59999: DDN error code. */ - /**No content has been detected. */ - DSErrorContentNotFound = -50056, - /*The quadrilateral is invalid. */ - DSErrorQuardrilateralInvalid = -50057, - /*[Document Normalizer] No license found.*/ - DSErrorDDNLicenseNotFound = -50058, - /** -60000~-69999: DCE error code. */ - /** The camera module is not exist. */ - DSErrorCameraModelNotExist = -60003, - /** The camera id does not exist. */ - DSErrorCameraIDNotExist = -60006, - /** The sensor does not exist. */ - DSErrorNoSensor = -60045, - /** The camera type is not supported.*/ - DSErrorCameraTypeNotSupported = -60046; - /**-70000~-79999: Panorama error code. */ - /**The panorama license is invalid. */ - DSErrorPanoramaLicenseInvalid = -70060, - /** -80000~-89999: Reserved error code. */ - /**-90000~-99999: DCP error code. */ - /** The resource path is not exist. */ - DSErrorResourcePathNotExist = -90001, - /** Failed to load resource. */ - DSErrorResourceLoadFailed = -90002, - /** The code specification is not found. */ - DSErrorSpecificationNotFound = -90003, - /** The full code string is empty. */ - DSErrorFullCodeEmpty = -90004, - /** Failed to preprocess the full code string */ - DSErrorFullCodePreprocessFailed = -90005, - /** The license for parsing South Africa Driver License is invalid. */ - DSErrorZADLLicenseInvalid = -90006, - /** The license for parsing North America DL/ID is invalid. */ - DSErrorAAMVADLIDLicenseInvalid = -90007, - /** The license for parsing Aadhaar is invalid. */ - DSErrorAADHAARLicenseInvalid = -90008, - /** The license for parsing Machine Readable Travel Documents is invalid. */ - DSErrorMRTDLicenseInvalid = -90009, - /** The license for parsing Vehicle Identification Number is invalid. */ - DSErrorVINLicenseInvalid = -90010, - /** The license for parsing customized code type is invalid. */ - DSErrorCustomizedCodeTypeLicenseInvalid = -90011, - /*[Code Parser] No license found.*/ - DSErrorDCPLicenseNotFound = -90012 -}; -``` -> -```swift -public enum ErrorCode : Int -{ - /**Successful. */ - oK = 0 - /**Unknown error. */ - unknown = -10000 - /**Not enough memory to perform the operation. */ - noMemory = -10001 - /**Null pointer */ - nullPointer = -10002 - /**License invalid*/ - licenseInvalid = -10003 - /**License expired*/ - licenseExpired = -10004 - /**File not found*/ - fileNotFound = -10005 - /**The file type is not supported. */ - filetypeNotSupported = -10006 - /**The BPP (Bits Per Pixel) is not supported. */ - bppNotSupported = -10007 - /**Failed to read the image. */ - imageReadFailed = -10012 - /**Failed to read the TIFF image. */ - tiffReadFailed = -10013 - /**The DIB (Device-Independent Bitmaps) buffer is invalid. */ - dibBufferInvalid = -10018, - /**Failed to read the PDF image. */ - pdfReadFailed = -10021 - /**The PDF DLL is missing. */ - pdfDllMissing = -10022 - /**The page number is invalid. */ - pageNumberInvalid = -10023 - /**The custom size is invalid. */ - customSizeInvalid = -10024 - /** timeout. */ - timeout = -10026 - /**Json parse failed*/ - jsonParseFailed = -10030 - /**Json type invalid*/ - jsonTypeInvalid = -10031 - /**Json key invalid*/ - jsonKeyInvalid = -10032 - /**Json value invalid*/ - jsonValueInvalid = -10033 - /**Json name key missing*/ - jsonNameKeyMissing = -10034 - /**The value of the key "Name" is duplicated.*/ - jsonNameValueDuplicated = -10035 - /**Template name invalid*/ - templateNameInvalid = -10036 - /**The name reference is invalid.*/ - jsonNameReferenceInvalid = -10037 - /**Parameter value invalid*/ - parameterValueInvalid = -10038 - /**The domain of your current site does not match the domain bound in the current product key.*/ - domainNotMatch = -10039 - /**The reserved info does not match the reserved info bound in the current product key.*/ - reservedInfoNotMatch = -10040 - /**The license key does not match the license content.*/ - licenseKeyNotMatch = -10043 - /**Failed to request the license content.*/ - requestFailed = -10044 - /**Failed to init the license.*/ - licenseInitFailed = -10045 - /**Failed to set mode's argument.*/ - setModeArgumentError = -10051 - /**The license content is invalid.*/ - licenseContentInvalid = -10052 - /**The license key is invalid.*/ - licenseKeyInvalid = -10053 - /**The license key has no remaining quota.*/ - licenseDeviceRunsOut = -10054 - /**Failed to get mode's argument.*/ - getModeArgumentError = -10055 - /**The Intermediate Result Types license is invalid.*/ - irtLicenseInvalid = -10056 - /**Failed to save file.*/ - fileSaveFailed = -10058 - /**The stage type is invalid.*/ - stageTypeInvalid = -10059 - /**The image orientation is invalid.*/ - imageOrientationInvalid = -10060 - /**Failed to convert complex tempalte to simplified settings.*/ - convertComplexTemplateError = -10061 - /**Reject function call while capturing in progress.*/ - callRejectedWhenCapturing = -10062 - /**The input image source was not found.*/ - noImageSource = -10063 - /**Failed to read directory.*/ - readDirectoryFailed = -10064 - /**[Name] Module not found.*/ - /**Name : */ - /**DynamsoftBarcodeReader*/ - /**DynamsoftLabelRecognizer*/ - /**DynamsoftDocumentNormalizer*/ - moduleNotFound = -10065 - /**The file already exists but overwriting is disabled.*/ - fileAlreadyExists = -10067 - /**The file path does not exist but cannot be created, or cannot be created for any other reason.*/ - createFileFailed = -10068 - /**The input ImageData object contains invalid parameter(s).*/ - imageDataInvalid = -10069 - /**The size of the input image does not meet the requirements.*/ - imageSizeNotMatch = -10070 - /**The pixel format of the input image does not meet the requirements.*/ - imagePixelFormatNotMatch = -10071 - /**The section level result is irreplaceable.*/ - sectionLevelResultIrreplaceable = -10072 - /**The axis definition is incorrect.*/ - axisDefinitionIncorrect = -10073 - /**The result is not replaceable due to type mismatch*/ - resultTypeMismatchIrreplaceable = -10074 - /**Failed to load the PDF library.*/ - pdfLibraryLoadFailed = -10075 - /*The license is initialized successfully but detected invalid content in your key.*/ - licenseWarning = -10076 - /**No license.*/ - noLicense = -20000 - /**The handshake code is invalid. */ - handshakeCodeInvalid = -20001 - /**Failed to read or write license cache. */ - licenseBufferFailed = -20002 - /**Falied to synchronize license info wirh license tracking server. */ - licenseSyncFailed = -20003 - /**Device does not match with license buffer. */ - deviceNotMatch = -20004 - /**Falied to bind device. */ - bindDeviceFailed = -20005 - /**Install.*/ - instanceCountOverLimit = -20008 - /**Trial License*/ - trialLicense = -20010 - /**The license is not valid for current version*/ - licenseVersionNotMatch = -20011 - /**Failed to reach License Tracking Server.*/ - failedToReachDLS = -20200 - /** -30000~-39999: DBR error code. */ - /** The barcode format is invalid. */ - barcodeFormatInvalid = -30009 - /** The QR Code license is invalid. */ - qrLicenseInvalid = -30016 - /** The 1D Barcode license is invalid. */ - 1DLicenseInvalid = -30017 - /** The PDF417 license is invalid. */ - pdf417LicenseInvalid = -30019 - /** The DATAMATRIX license is invalid. */ - dataMatrixLicenseInvalid = -30020 - /** The custom module size is invalid. */ - customModuleSizeInvalid = -30025 - /** The AZTEC license is invalid. */ - aztecLicenseInvalid = -30041 - /** The Patchcode license is invalid. */ - patchCodeLicenseInvalid = -30046 - /** The Postal code license is invalid. */ - postalCodeLicenseInvalid = -30047 - /** The DPM license is invalid. */ - dpmLicenseInvalid = -30048 - /** The frame decoding thread already exists. */ - frameDecodingThreadExists = -30049 - /** Failed to stop the frame decoding thread. */ - stopDecodingThreadFailed = -30050 - /** The Maxicode license is invalid. */ - maxiCodeLicenseInvalid = -30057 - /** The GS1 Databar license is invalid. */ - gs1DatabarLicenseInvalid = -30058 - /** The GS1 Composite code license is invalid. */ - gs1CompositeLicenseInvalid = -30059 - /** The DotCode license is invalid. */ - dotCodeLicenseInvalid = -30061 - /** The Pharmacode license is invalid. */ - pharmaCodeLicenseInvalid = -30062 - /*[Barcode Reader] No license found.*/ - dbrLicenseNotFound = -30063 - /** -40000~-49999: DLR error code */ - /** Character Model file is not found. */ - characterModelFileNotFound = -40100 - /** There is a conflict in the layout of TextLineGroup. */ - textLineGroupLayoutConflict = -40101 - /** There is a conflict in the regex of TextLineGroup. */ - textLineGroupRegexConflict = -40102 - /*[Label Recognizer] No license found.*/ - dlrLicenseNotFound = -40103 - /** -50000~-59999: DDN error code. */ - /** No content has been detected. */ - contentNotFound = -50056 - /*The quadrilateral is invalid. */ - quardrilateralInvalid = -50057 - /*[Document Normalizer] No license found.*/ - ddnLicenseNotFound = -50058 - /** -60000~-69999: DCE error code. */ - /** The camera module is not exist. */ - cameraModelNotExist = -60003 - /** The camera id does not exist. */ - cameraIDNotExist = -60006 - /** The sensor does not exist. */ - noSensor = -60045 - /** The camera type is not supported.*/ - cameraTypeNotSupported = -60046; - /**-70000~-79999: Panorama error code. */ - /**The panorama license is invalid. */ - panoramaLicenseInvalid = -70060 - /** -80000~-89999: Reserved error code. */ - /**-90000~-99999: DCP error code. */ - /** The resource path is not exist. */ - resourcePathNotExist = -90001 - /** Failed to load resource. */ - resourceLoadFailed = -90002 - /** The code specification is not found. */ - codeSpecificationNotFound = -90003 - /** The full code string is empty. */ - fullCodeEmpty = -90004 - /** Failed to preprocess the full code string */ - fullCodePreprocessFailed = -90005 - /** The license for parsing South Africa Driver License is invalid. */ - zadlLicenseInvalid = -90006 - /** The license for parsing North America DL/ID is invalid. */ - aamvadlidLicenseInvalid = -90007 - /** The license for parsing Aadhaar is invalid. */ - aadhaarLicenseInvalid = -90008 - /** The license for parsing Machine Readable Travel Documents is invalid. */ - mrtdLicenseInvalid = -90009 - /** The license for parsing Vehicle Identification Number is invalid. */ - vinLicenseInvalid = -90010 - /** The license for parsing customized code type is invalid. */ - customizedCodeTypeLicenseInvalid = -90011 - /*[Code Parser] No license found.*/ - dcpLicenseNotFound = -90012 -} -``` -> -```cpp -typedef enum ErrorCode -{ - /** Successful. */ - EC_OK = 0, - /** -10000~-19999: Common error code. */ - /** Unknown error. */ - EC_UNKNOWN = -10000, - /**Not enough memory to perform the operation. */ - EC_NO_MEMORY = -10001, - /** Null pointer */ - EC_NULL_POINTER = -10002, - /** License invalid. */ - EC_LICENSE_INVALID = -10003, - /** License expired. */ - EC_LICENSE_EXPIRED = -10004, - /** File not found. */ - EC_FILE_NOT_FOUND = -10005, - /** The file type is not supported. */ - EC_FILE_TYPE_NOT_SUPPORTED = -10006, - /** The BPP (Bits Per Pixel) is not supported. */ - EC_BPP_NOT_SUPPORTED = -10007, - /** The index is invalid. */ - EC_INDEX_INVALID = -10008, - /** The input region value parameter is invalid. */ - EC_CUSTOM_REGION_INVALID = -10010, - /** Failed to read the image. */ - EC_IMAGE_READ_FAILED = -10012, - /** Failed to read the TIFF image. */ - EC_TIFF_READ_FAILED = -10013, - /** The DIB (Device-Independent Bitmaps) buffer is invalid. */ - EC_DIB_BUFFER_INVALID = -10018, - /** Failed to read the PDF image. */ - EC_PDF_READ_FAILED = -10021, - /** The PDF DLL is missing. */ - EC_PDF_DLL_MISSING = -10022, - /** The page number is invalid. */ - EC_PAGE_NUMBER_INVALID = -10023, - /** The custom size is invalid. */ - EC_CUSTOM_SIZE_INVALID = -10024, - /** timeout. */ - EC_TIMEOUT = -10026, - /** Json parse failed. */ - EC_JSON_PARSE_FAILED = -10030, - /** Json type invalid. */ - EC_JSON_TYPE_INVALID = -10031, - /** Json key invalid. */ - EC_JSON_KEY_INVALID = -10032, - /** Json value invalid. */ - EC_JSON_VALUE_INVALID = -10033, - /** Json name key missing. */ - EC_JSON_NAME_KEY_MISSING = -10034, - /** The value of the key "Name" is duplicated. */ - EC_JSON_NAME_VALUE_DUPLICATED = -10035, - /** Template name invalid. */ - EC_TEMPLATE_NAME_INVALID = -10036, - /** The name reference is invalid. */ - EC_JSON_NAME_REFERENCE_INVALID = -10037, - /** Parameter value invalid. */ - EC_PARAMETER_VALUE_INVALID = -10038, - /** The domain of your current site does not match the domain bound in the current product key. */ - EC_DOMAIN_NOT_MATCH = -10039, - /** The reserved info does not match the reserved info bound in the current product key. */ - EC_RESERVED_INFO_NOT_MATCH = -10040, - /** The license key does not match the license content. */ - EC_LICENSE_KEY_NOT_MATCH = -10043, - /** Failed to request the license content. */ - EC_REQUEST_FAILED = -10044, - /** Failed to init the license. */ - EC_LICENSE_INIT_FAILED = -10045, - /** Failed to set mode's argument. */ - EC_SET_MODE_ARGUMENT_ERROR = -10051, - /** The license content is invalid. */ - EC_LICENSE_CONTENT_INVALID = -10052, - /** The license key is invalid. */ - EC_LICENSE_KEY_INVALID = -10053, - /** The license key has no remaining quota. */ - EC_LICENSE_DEVICE_RUNS_OUT = -10054, - /** Failed to get mode's argument. */ - EC_GET_MODE_ARGUMENT_ERROR = -10055, - /** The Intermediate Result Types license is invalid. */ - EC_IRT_LICENSE_INVALID = -10056, - /** Failed to save file. */ - EC_FILE_SAVE_FAILED = -10058, - /** The stage type is invalid. */ - EC_STAGE_TYPE_INVALID = -10059, - /** The image orientation is invalid. */ - EC_IMAGE_ORIENTATION_INVALID = -10060, - /** Complex tempalte can't be converted to simplified settings. */ - EC_CONVERT_COMPLEX_TEMPLATE_ERROR = -10061, - /** Reject function call while capturing in progress.*/ - EC_CALL_REJECTED_WHEN_CAPTURING = -10062, - /**The input image source was not found.*/ - EC_NO_IMAGE_SOURCE = -10063, - /**Failed to read directory.*/ - EC_READ_DIRECTORY_FAILED = -10064, - /**[Name] Module not found.*/ - /**Name : */ - /**DynamsoftBarcodeReader*/ - /**DynamsoftLabelRecognizer*/ - /**DynamsoftDocumentNormalizer*/ - EC_MODULE_NOT_FOUND = -10065, - /**The file already exists but overwriting is disabled.*/ - EC_FILE_ALREADY_EXISTS = -10067, - /**The file path does not exist but cannot be created, or cannot be created for any other reason.*/ - EC_CREATE_FILE_FAILED = -10068, - /**The input ImageData object contains invalid parameter(s).*/ - EC_IMGAE_DATA_INVALID = -10069, - /**The size of the input image do not meet the requirements.*/ - EC_IMAGE_SIZE_NOT_MATCH = -10070, - /**The pixel format of the input image do not meet the requirements.*/ - EC_IMAGE_PIXEL_FORMAT_NOT_MATCH = -10071, - /**The section level result is irreplaceable.*/ - EC_SECTION_LEVEL_RESULT_IRREPLACEABLE = -10072, - /**The axis definition is incorrect.*/ - EC_AXIS_DEFINITION_INCORRECT = -10073, - /**The result is not replaceable due to type mismatch*/ - EC_RESULT_TYPE_MISMATCH_IRREPLACEABLE = -10074, - /**Failed to load the PDF library.*/ - EC_PDF_LIBRARY_LOAD_FAILED = -10075, - /**The license is initialized successfully but detected invalid content in your key.*/ - EC_LICENSE_WARNING = -10076, - /** -20000~-29999: DLS license error code. */ - /** No license. */ - EC_NO_LICENSE = -20000, - /** The Handshake Code is invalid. */ - EC_HANDSHAKE_CODE_INVALID = -20001, - /** Failed to read or write license buffer. */ - EC_LICENSE_BUFFER_FAILED = -20002, - /** Failed to synchronize license info with license server. */ - EC_LICENSE_SYNC_FAILED = -20003, - /** Device dose not match with buffer. */ - EC_DEVICE_NOT_MATCH = -20004, - /** Failed to bind device. */ - EC_BIND_DEVICE_FAILED = -20005, - /** Instance count is over limit. */ - EC_INSTANCE_COUNT_OVER_LIMIT = -20008, - /** Trial License */ - EC_TRIAL_LICENSE = -20010, - /**Online license validation failed due to network issues. Using cached license information for validation*/ - EC_LICENSE_CACHE_USED = -20012, - /** Failed to reach License Server. */ - EC_FAILED_TO_REACH_DLS = -20200, - /** -30000~-39999: DBR error code. */ - /** The barcode format is invalid. */ - EC_BARCODE_FORMAT_INVALID = -30009, - /** The QR Code license is invalid. */ - EC_QR_LICENSE_INVALID = -30016, - /** The 1D Barcode license is invalid. */ - EC_1D_LICENSE_INVALID = -30017, - /** The PDF417 license is invalid. */ - EC_PDF417_LICENSE_INVALID = -30019, - /** The DATAMATRIX license is invalid. */ - EC_DATAMATRIX_LICENSE_INVALID = -30020, - /** The custom module size is invalid. */ - EC_CUSTOM_MODULESIZE_INVALID = -30025, - /** The AZTEC license is invalid. */ - EC_AZTEC_LICENSE_INVALID = -30041, - /** The Patchcode license is invalid. */ - EC_PATCHCODE_LICENSE_INVALID = -30046, - /** The Postal code license is invalid. */ - EC_POSTALCODE_LICENSE_INVALID = -30047, - /** The DPM license is invalid. */ - EC_DPM_LICENSE_INVALID = -30048, - /** The frame decoding thread already exists. */ - EC_FRAME_DECODING_THREAD_EXISTS = -30049, - /** Failed to stop the frame decoding thread. */ - EC_STOP_DECODING_THREAD_FAILED = -30050, - /** The Maxicode license is invalid. */ - EC_MAXICODE_LICENSE_INVALID = -30057, - /** The GS1 Databar license is invalid. */ - EC_GS1_DATABAR_LICENSE_INVALID = -30058, - /** The GS1 Composite code license is invalid. */ - EC_GS1_COMPOSITE_LICENSE_INVALID = -30059, - /** The DotCode license is invalid. */ - EC_DOTCODE_LICENSE_INVALID = -30061, - /** The Pharmacode license is invalid. */ - EC_PHARMACODE_LICENSE_INVALID = -30062, - /**[Barcode Reader] No license found.*/ - EC_BARCODE_READER_LICENSE_NOT_FOUND = -30063, - /** -40000~-49999: DLR error code */ - /** Character Model file is not found. */ - EC_CHARACTER_MODEL_FILE_NOT_FOUND = -40100, - /**There is a conflict in the layout of TextLineGroup. */ - EC_TEXT_LINE_GROUP_LAYOUT_CONFLICT = -40101, - /**There is a conflict in the regex of TextLineGroup. */ - EC_TEXT_LINE_GROUP_REGEX_CONFLICT = -40102, - /**[Label Recognizer] No license found.*/ - EC_LABEL_RECOGNIZER_LICENSE_NOT_FOUND = -40103, - /** -50000~-59999: DDN error code. */ - /**No content has been detected. */ - EC_CONTENT_NOT_FOUND = -50056, - /*The quadrilateral is invalid. */ - EC_QUADRILATERAL_INVALID = -50057, - /*[Document Normalizer] No license found.*/ - EC_DOCUMENT_NORMALIZER_LICENSE_NOT_FOUND = -50058, - /** -60000~-69999: DCE error code. */ - /**-60000~-69999: DCE error code*/ - EC_CAMERA_MODULE_NOT_EXIST = -60003; - EC_CAMERA_ID_NOT_EXIST = -60006; - EC_NO_SENSOR = -60045; - /**-70000~-79999: Panorama error code. */ - /**The panorama license is invalid. */ - EC_PANORAMA_LICENSE_INVALID = -70060, - /** -80000~-89999: Reserved error code. */ - /**-90000~-99999: DCP error code. */ - /** The resource path is not exist. */ - EC_RESOURCE_PATH_NOT_EXIST = -90001, - /** Failed to load resource. */ - EC_RESOURCE_LOAD_FAILED = -90002, - /** The code specification is not found. */ - EC_CODE_SPECIFICATION_NOT_FOUND = -90003, - /** The full code string is empty. */ - EC_FULL_CODE_EMPTY = -90004, - /** Failed to preprocess the full code string */ - EC_FULL_CODE_PREPROCESS_FAILED = -90005, - /** The license for parsing South Africa Driver License is invalid. */ - EC_ZA_DL_LICENSE_INVALID = -90006, - /** The license for parsing North America DL/ID is invalid. */ - EC_AAMVA_DL_ID_LICENSE_INVALID = -90007, - /** The license for parsing Aadhaar is invalid. */ - EC_AADHAAR_LICENSE_INVALID = -90008, - /** The license for parsing Machine Readable Travel Documents is invalid. */ - EC_MRTD_LICENSE_INVALID = -90009, - /** The license for parsing Vehicle Identification Number is invalid. */ - EC_VIN_LICENSE_INVALID = -90010, - /** The license for parsing customized code type is invalid. */ - EC_CUSTOMIZED_CODE_TYPE_LICENSE_INVALID = -90011, - /*[Code Parser] No license found.*/ - EC_CODE_PARSER_LICENSE_NOT_FOUND = -90012 -} ErrorCode; -``` -> -```csharp -public enum EnumErrorCode -{ - /**Successful. */ - EC_OK = 0, - /** -10000~-19999: Common error code. */ - /**Unknown error. */ - EC_UNKNOWN = -10000, - /**Not enough memory to perform the operation. */ - EC_NO_MEMORY = -10001, - /**Null pointer */ - EC_NULL_POINTER = -10002, - /**License invalid*/ - EC_LICENSE_INVALID = -10003, - /**License expired*/ - EC_LICENSE_EXPIRED = -10004, - /**File not found*/ - EC_FILE_NOT_FOUND = -10005, - /**The file type is not supported. */ - EC_FILE_TYPE_NOT_SUPPORTED = -10006, - /**The BPP (Bits Per Pixel) is not supported. */ - EC_BPP_NOT_SUPPORTED = -10007, - /**The index is invalid.*/ - EC_INDEX_INVALID = -10008, - /**The input region value parameter is invalid.*/ - EC_CUSTOM_REGION_INVALID = -10010, - /**Failed to read the image. */ - EC_IMAGE_READ_FAILED = -10012, - /**Failed to read the TIFF image. */ - EC_TIFF_READ_FAILED = -10013, - /**The DIB (Device-Independent Bitmaps) buffer is invalid. */ - EC_DIB_BUFFER_INVALID = -10018, - /**Failed to read the PDF image. */ - EC_PDF_READ_FAILED = -10021, - /**The PDF DLL is missing. */ - EC_PDF_DLL_MISSING = -10022, - /**The page number is invalid. */ - EC_PAGE_NUMBER_INVALID = -10023, - /**The custom size is invalid. */ - EC_CUSTOM_SIZE_INVALID = -10024, - /** timeout. */ - EC_TIMEOUT = -10026, - /**Json parse failed*/ - EC_JSON_PARSE_FAILED = -10030, - /**Json type invalid*/ - EC_JSON_TYPE_INVALID = -10031, - /**Json key invalid*/ - EC_JSON_KEY_INVALID = -10032, - /**Json value invalid*/ - EC_JSON_VALUE_INVALID = -10033, - /**Json name key missing*/ - EC_JSON_NAME_KEY_MISSING = -10034, - /**The value of the key "Name" is duplicated.*/ - EC_JSON_NAME_VALUE_DUPLICATED = -10035, - /**Template name invalid*/ - EC_TEMPLATE_NAME_INVALID = -10036, - /**The name reference is invalid.*/ - EC_JSON_NAME_REFERENCE_INVALID = -10037, - /**Parameter value invalid*/ - EC_PARAMETER_VALUE_INVALID = -10038, - /**The domain of your current site does not match the domain bound in the current product key.*/ - EC_DOMAIN_NOT_MATCH = -10039, - /**The reserved info does not match the reserved info bound in the current product key.*/ - EC_RESERVED_INFO_NOT_MATCH = -10040, - /**The license key does not match the license content.*/ - EC_LICENSE_KEY_NOT_MATCH = -10043, - /**Failed to request the license content.*/ - EC_REQUEST_FAILED = -10044, - /**Failed to init the license.*/ - EC_LICENSE_INIT_FAILED = -10045, - /**Failed to set mode's argument.*/ - EC_SET_MODE_ARGUMENT_ERROR = -10051, - /**The license content is invalid.*/ - EC_LICENSE_CONTENT_INVALID = -10052, - /**The license key is invalid.*/ - EC_LICENSE_KEY_INVALID = -10053, - /**The license key has no remaining quota.*/ - EC_LICENSE_DEVICE_RUNS_OUT = -10054, - /**Failed to get mode's argument.*/ - EC_GET_MODE_ARGUMENT_ERROR = -10055, - /**The Intermediate Result Types license is invalid.*/ - EC_IRT_LICENSE_INVALID = -10056, - /**Failed to save file.*/ - EC_FILE_SAVE_FAILED = -10058, - /**The stage type is invalid.*/ - EC_STAGE_TYPE_INVALID = -10059, - /**The image orientation is invalid.*/ - EC_IMAGE_ORIENTATION_INVALID = -10060, - /**Complex template can't be converted to simplified settings.*/ - EC_CONVERT_COMPLEX_TEMPLATE_ERROR = -10061, - /**Reject function call while capturing in progress.*/ - EC_CALL_REJECTED_WHEN_CAPTURING = -10062, - /**The input image source was not found.*/ - EC_NO_IMAGE_SOURCE = -10063, - /**Failed to read directory.*/ - EC_READ_DIRECTORY_FAILED = -10064, - /**[Name] Module not found.*/ - /**Name: */ - /**DynamsoftBarcodeReader*/ - /**DynamsoftLabelRecognizer*/ - /**DynamsoftDocumentNormalizer*/ - EC_MODULE_NOT_FOUND = -10065, - /**The api does not support multi-page files. Please use FileFetcher instead.*/ - EC_MULTI_PAGES_NOT_SUPPORTED = -10066, - /**The file already exists but overwriting is disabled.*/ - EC_FILE_ALREADY_EXISTS = -10067, - /**The file path does not exist but cannot be created, or the file - cannot be created for any other reason.*/ - EC_CREATE_FILE_FAILED = -10068, - /**The input ImageData object contains invalid parameter(s).*/ - EC_IMAGE_DATA_INVALID = -10069, - /**The size of the input image does not meet the requirements.*/ - EC_IMAGE_SIZE_NOT_MATCH = -10070, - /**The pixel format of the input image does not meet the requirements.*/ - EC_IMAGE_PIXEL_FORMAT_NOT_MATCH = -10071, - /**The section level result is irreplaceable.*/ - EC_SECTION_LEVEL_RESULT_IRREPLACEABLE = -10072, - /**The axis definition is incorrect.*/ - EC_AXIS_DEFINITION_INCORRECT = -10073, - /**The result is not replaceable due to type mismatch.*/ - EC_RESULT_TYPE_MISMATCH_IRREPLACEABLE = -10074, - /*The license is initialized successfully but detected invalid content in your key.*/ - EC_LICENSE_WARNING = -10076, - /** -20000~-29999: DLS license error code. */ - /**No license.*/ - EC_NO_LICENSE = -20000, - /**The Handshake Code is invalid.*/ - EC_HANDSHAKE_CODE_INVALID = -20001, - /**Failed to read or write license buffer. */ - EC_LICENSE_BUFFER_FAILED = -20002, - /**Failed to synchronize license info with license server. */ - EC_LICENSE_SYNC_FAILED = -20003, - /**Device dose not match with buffer. */ - EC_DEVICE_NOT_MATCH = -20004, - /**Failed to bind device. */ - EC_BIND_DEVICE_FAILED = -20005, - /**License Client dll is missing.*/ - EC_LICENSE_CLIENT_DLL_MISSING = -20007, - /**Instance count is over limit.*/ - EC_INSTANCE_COUNT_OVER_LIMIT = -20008, - /**Interface InitLicense has to be called before creating any SDK objects.*/ - EC_LICENSE_INIT_SEQUENCE_FAILED = -20009, - /**Trial License*/ - EC_TRIAL_LICENSE = -20010, - /**The license is not valid for current version*/ - EC_LICENSE_VERSION_NOT_MATCH = -20011, - /**Online license validation failed due to network issues. Using cached license information for validation*/ - EC_LICENSE_CACHE_USED = -20012, - /**Failed to reach License Server.*/ - EC_FAILED_TO_REACH_DLS = -20200, - /**-30000~-39999: DBR error code*/ - /**The barcode format is invalid.*/ - EC_BARCODE_FORMAT_INVALID = -30009, - /**The QR Code license is invalid.*/ - EC_QR_LICENSE_INVALID = -30016, - /**The 1D Barcode license is invalid.*/ - EC_1D_LICENSE_INVALID = -30017, - /**The PDF417 license is invalid.*/ - EC_PDF417_LICENSE_INVALID = -30019, - /**The DATAMATRIX license is invalid. */ - EC_DATAMATRIX_LICENSE_INVALID = -30020, - /**The custom module size is invalid. */ - EC_CUSTOM_MODULESIZE_INVALID = -30025, - /**The AZTEC license is invalid.*/ - EC_AZTEC_LICENSE_INVALID = -30041, - /**The Patchcode license is invalid.*/ - EC_PATCHCODE_LICENSE_INVALID = -30046, - /**The Postal code license is invalid.*/ - EC_POSTALCODE_LICENSE_INVALID = -30047, - /**The DPM license is invalid.*/ - EC_DPM_LICENSE_INVALID = -30048, - /**The frame decoding thread already exists.*/ - EC_FRAME_DECODING_THREAD_EXISTS = -30049, - /**Failed to stop the frame decoding thread.*/ - EC_STOP_DECODING_THREAD_FAILED = -30050, - /**The Maxicode license is invalid.*/ - EC_MAXICODE_LICENSE_INVALID = -30057, - /**The GS1 Databar license is invalid.*/ - EC_GS1_DATABAR_LICENSE_INVALID = -30058, - /**The GS1 Composite code license is invalid.*/ - EC_GS1_COMPOSITE_LICENSE_INVALID = -30059, - /**The DotCode license is invalid.*/ - EC_DOTCODE_LICENSE_INVALID = -30061, - /**The Pharmacode license is invalid.*/ - EC_PHARMACODE_LICENSE_INVALID = -30062, - /**[Barcode Reader] No license found.*/ - EC_BARCODE_READER_LICENSE_NOT_FOUND = -30063, - /**-40000~-49999: DLR error code*/ - /**Character Model file is not found*/ - EC_CHARACTER_MODEL_FILE_NOT_FOUND = -40100, - /**There is a conflict in the layout of TextLineGroup. */ - EC_TEXT_LINE_GROUP_LAYOUT_CONFLICT = -40101, - /**There is a conflict in the regex of TextLineGroup. */ - EC_TEXT_LINE_GROUP_REGEX_CONFLICT = -40102, - /**[Label Recognizer] No license found.*/ - EC_LABEL_RECOGNIZER_LICENSE_NOT_FOUND = -40103, - /**-50000~-59999: DDN error code*/ - /*The quadrilateral is invalid*/ - EC_QUADRILATERAL_INVALID = -50057, - /**[Document Normalizer] No license found.*/ - EC_DOCUMENT_NORMALIZER_LICENSE_NOT_FOUND = -50058, - /**-60000~-69999: DCE error code*/ - /**-70000~-79999: Panorama error code*/ - /**The panorama license is invalid.*/ - EC_PANORAMA_LICENSE_INVALID = -70060, - /**-80000~-89999: Reserved error code*/ - /**-90000~-99999: DCP error code*/ - /*The resource path does not exist.*/ - EC_RESOURCE_PATH_NOT_EXIST = -90001, - /*Failed to load resource.*/ - EC_RESOURCE_LOAD_FAILED = -90002, - /*The code specification is not found.*/ - EC_CODE_SPECIFICATION_NOT_FOUND = -90003, - /*The full code string is empty.*/ - EC_FULL_CODE_EMPTY = -90004, - /*Failed to preprocess the full code string.*/ - EC_FULL_CODE_PREPROCESS_FAILED = -90005, - /*The license for parsing South Africa Driver License is invalid.*/ - EC_ZA_DL_LICENSE_INVALID = -90006, - /*The license for parsing North America DL/ID is invalid.*/ - EC_AAMVA_DL_ID_LICENSE_INVALID = -90007, - /*The license for parsing Aadhaar is invalid.*/ - EC_AADHAAR_LICENSE_INVALID = -90008, - /*The license for parsing Machine Readable Travel Documents is invalid.*/ - EC_MRTD_LICENSE_INVALID = -90009, - /*The license for parsing Vehicle Identification Number is invalid.*/ - EC_VIN_LICENSE_INVALID = -90010, - /*The license for parsing customized code type is invalid.*/ - EC_CUSTOMIZED_CODE_TYPE_LICENSE_INVALID = -90011, - /*[Code Parser] No license found.*/ - EC_CODE_PARSER_LICENSE_NOT_FOUND = -90012 -} -``` -> -```python -class EnumErrorCode(IntEnum): - #Successful. - EC_OK = 0 - # -10000~-19999: Common error code. - #Unknown error. - EC_UNKNOWN = -10000 - #Not enough memory to perform the operation. - EC_NO_MEMORY = -10001 - #Null pointer - EC_NULL_POINTER = -10002 - #License invalid - EC_LICENSE_INVALID = -10003 - #License expired - EC_LICENSE_EXPIRED = -10004 - #File not found - EC_FILE_NOT_FOUND = -10005 - #The file type is not supported. - EC_FILE_TYPE_NOT_SUPPORTED = -10006 - #The BPP (Bits Per Pixel) is not supported. - EC_BPP_NOT_SUPPORTED = -10007 - #The index is invalid. - EC_INDEX_INVALID = -10008 - #The input region value parameter is invalid. - EC_CUSTOM_REGION_INVALID = -10010 - #Failed to read the image. - EC_IMAGE_READ_FAILED = -10012 - #Failed to read the TIFF image. - EC_TIFF_READ_FAILED = -10013 - #The DIB (Device-Independent Bitmaps) buffer is invalid. - EC_DIB_BUFFER_INVALID = -10018 - #Failed to read the PDF image. - EC_PDF_READ_FAILED = -10021 - #The PDF DLL is missing. - EC_PDF_DLL_MISSING = -10022 - #The page number is invalid. - EC_PAGE_NUMBER_INVALID = -10023 - #The custom size is invalid. - EC_CUSTOM_SIZE_INVALID = -10024 - # timeout. - EC_TIMEOUT = -10026 - #Json parse failed - EC_JSON_PARSE_FAILED = -10030 - #Json type invalid - EC_JSON_TYPE_INVALID = -10031 - #Json key invalid - EC_JSON_KEY_INVALID = -10032 - #Json value invalid - EC_JSON_VALUE_INVALID = -10033 - #Json name key missing - EC_JSON_NAME_KEY_MISSING = -10034 - #The value of the key "Name" is duplicated. - EC_JSON_NAME_VALUE_DUPLICATED = -10035 - #Template name invalid - EC_TEMPLATE_NAME_INVALID = -10036 - #The name reference is invalid. - EC_JSON_NAME_REFERENCE_INVALID = -10037 - #Parameter value invalid - EC_PARAMETER_VALUE_INVALID = -10038 - #The domain of your current site does not match the domain bound in the current product key. - EC_DOMAIN_NOT_MATCH = -10039 - #The reserved info does not match the reserved info bound in the current product key. - EC_RESERVED_INFO_NOT_MATCH = -10040 - #The license key does not match the license content. - EC_LICENSE_KEY_NOT_MATCH = -10043 - #Failed to request the license content. - EC_REQUEST_FAILED = -10044 - #Failed to init the license. - EC_LICENSE_INIT_FAILED = -10045 - #Failed to set mode's argument. - EC_SET_MODE_ARGUMENT_ERROR = -10051 - #The license content is invalid. - EC_LICENSE_CONTENT_INVALID = -10052 - #The license key is invalid. - EC_LICENSE_KEY_INVALID = -10053 - #The license key has no remaining quota. - EC_LICENSE_DEVICE_RUNS_OUT = -10054 - #Failed to get mode's argument. - EC_GET_MODE_ARGUMENT_ERROR = -10055 - #The Intermediate Result Types license is invalid. - EC_IRT_LICENSE_INVALID = -10056 - #Failed to save file. - EC_FILE_SAVE_FAILED = -10058 - #The stage type is invalid. - EC_STAGE_TYPE_INVALID = -10059 - #The image orientation is invalid. - EC_IMAGE_ORIENTATION_INVALID = -10060 - #Complex template can't be converted to simplified settings. - EC_CONVERT_COMPLEX_TEMPLATE_ERROR = -10061 - #Reject function call while capturing in progress. - EC_CALL_REJECTED_WHEN_CAPTURING = -10062 - #The input image source was not found. - EC_NO_IMAGE_SOURCE = -10063 - #Failed to read directory. - EC_READ_DIRECTORY_FAILED = -10064 - #[Name] Module not found. - #Name: - #DynamsoftBarcodeReader - #DynamsoftLabelRecognizer - #DynamsoftDocumentNormalizer - EC_MODULE_NOT_FOUND = -10065 - #The api does not support multi-page files. Please use FileFetcher instead. - EC_MULTI_PAGES_NOT_SUPPORTED = -10066 - #The file already exists but overwriting is disabled. - EC_FILE_ALREADY_EXISTS = -10067 - #The file path does not exist but cannot be created, or the file - cannot be created for any other reason. - EC_CREATE_FILE_FAILED = -10068 - #The input ImageData object contains invalid parameter(s). - EC_IMAGE_DATA_INVALID = -10069 - #The size of the input image does not meet the requirements. - EC_IMAGE_SIZE_NOT_MATCH = -10070 - #The pixel format of the input image does not meet the requirements. - EC_IMAGE_PIXEL_FORMAT_NOT_MATCH = -10071 - #The section level result is irreplaceable. - EC_SECTION_LEVEL_RESULT_IRREPLACEABLE = -10072 - #The axis definition is incorrect. - EC_AXIS_DEFINITION_INCORRECT = -10073 - #The result is not replaceable due to type mismatch. - EC_RESULT_TYPE_MISMATCH_IRREPLACEABLE = -10074 - #The license is initialized successfully but detected invalid content in your key. - EC_LICENSE_WARNING = -10076 - # -20000~-29999: DLS license error code. - #No license. - EC_NO_LICENSE = -20000 - #The Handshake Code is invalid. - EC_HANDSHAKE_CODE_INVALID = -20001 - #Failed to read or write license buffer. - EC_LICENSE_BUFFER_FAILED = -20002 - #Failed to synchronize license info with license server. - EC_LICENSE_SYNC_FAILED = -20003 - #Device dose not match with buffer. - EC_DEVICE_NOT_MATCH = -20004 - #Failed to bind device. - EC_BIND_DEVICE_FAILED = -20005 - #License Client dll is missing. - EC_LICENSE_CLIENT_DLL_MISSING = -20007 - #Instance count is over limit. - EC_INSTANCE_COUNT_OVER_LIMIT = -20008 - #Interface InitLicense has to be called before creating any SDK objects. - EC_LICENSE_INIT_SEQUENCE_FAILED = -20009 - #Trial License - EC_TRIAL_LICENSE = -20010 - #The license is not valid for current version - EC_LICENSE_VERSION_NOT_MATCH = -20011 - #Online license validation failed due to network issues. Using cached license information for validation - EC_LICENSE_CACHE_USED = -20012 - #Failed to reach License Server. - EC_FAILED_TO_REACH_DLS = -20200 - #-30000~-39999: DBR error code - #The barcode format is invalid. - EC_BARCODE_FORMAT_INVALID = -30009 - #The QR Code license is invalid. - EC_QR_LICENSE_INVALID = -30016 - #The 1D Barcode license is invalid. - EC_1D_LICENSE_INVALID = -30017 - #The PDF417 license is invalid. - EC_PDF417_LICENSE_INVALID = -30019 - #The DATAMATRIX license is invalid. - EC_DATAMATRIX_LICENSE_INVALID = -30020 - #The custom module size is invalid. - EC_CUSTOM_MODULESIZE_INVALID = -30025 - #The AZTEC license is invalid. - EC_AZTEC_LICENSE_INVALID = -30041 - #The Patchcode license is invalid. - EC_PATCHCODE_LICENSE_INVALID = -30046 - #The Postal code license is invalid. - EC_POSTALCODE_LICENSE_INVALID = -30047 - #The DPM license is invalid. - EC_DPM_LICENSE_INVALID = -30048 - #The frame decoding thread already exists. - EC_FRAME_DECODING_THREAD_EXISTS = -30049 - #Failed to stop the frame decoding thread. - EC_STOP_DECODING_THREAD_FAILED = -30050 - #The Maxicode license is invalid. - EC_MAXICODE_LICENSE_INVALID = -30057 - #The GS1 Databar license is invalid. - EC_GS1_DATABAR_LICENSE_INVALID = -30058 - #The GS1 Composite code license is invalid. - EC_GS1_COMPOSITE_LICENSE_INVALID = -30059 - #The DotCode license is invalid. - EC_DOTCODE_LICENSE_INVALID = -30061 - #The Pharmacode license is invalid. - EC_PHARMACODE_LICENSE_INVALID = -30062 - #[Barcode Reader] No license found. - EC_BARCODE_READER_LICENSE_NOT_FOUND = -30063 - #-40000~-49999: DLR error code - #Character Model file is not found - EC_CHARACTER_MODEL_FILE_NOT_FOUND = -40100 - #There is a conflict in the layout of TextLineGroup. - EC_TEXT_LINE_GROUP_LAYOUT_CONFLICT = -40101 - #There is a conflict in the regex of TextLineGroup. - EC_TEXT_LINE_GROUP_REGEX_CONFLICT = -40102 - #[Label Recognizer] No license found. - EC_LABEL_RECOGNIZER_LICENSE_NOT_FOUND = -40103 - #-50000~-59999: DDN error code - #The quadrilateral is invalid - EC_QUADRILATERAL_INVALID = -50057 - #[Document Normalizer] No license found. - EC_DOCUMENT_NORMALIZER_LICENSE_NOT_FOUND = -50058 - #-60000~-69999: DCE error code - #-70000~-79999: Panorama error code - #The panorama license is invalid. - EC_PANORAMA_LICENSE_INVALID = -70060 - #-80000~-89999: Reserved error code - #-90000~-99999: DCP error code - #The resource path does not exist. - EC_RESOURCE_PATH_NOT_EXIST = -90001 - #Failed to load resource. - EC_RESOURCE_LOAD_FAILED = -90002 - #The code specification is not found. - EC_CODE_SPECIFICATION_NOT_FOUND = -90003 - #The full code string is empty. - EC_FULL_CODE_EMPTY = -90004 - #Failed to preprocess the full code string. - EC_FULL_CODE_PREPROCESS_FAILED = -90005 - #The license for parsing South Africa Driver License is invalid. - EC_ZA_DL_LICENSE_INVALID = -90006 - #The license for parsing North America DL/ID is invalid. - EC_AAMVA_DL_ID_LICENSE_INVALID = -90007 - #The license for parsing Aadhaar is invalid. - EC_AADHAAR_LICENSE_INVALID = -90008 - #The license for parsing Machine Readable Travel Documents is invalid. - EC_MRTD_LICENSE_INVALID = -90009 - #The license for parsing Vehicle Identification Number is invalid. - EC_VIN_LICENSE_INVALID = -90010 - #The license for parsing customized code type is invalid. - EC_CUSTOMIZED_CODE_TYPE_LICENSE_INVALID = -90011 - #[Code Parser] No license found. - EC_CODE_PARSER_LICENSE_NOT_FOUND = -90012 -``` diff --git a/enums/core/grayscale-enhancement-mode.md b/enums/core/grayscale-enhancement-mode.md deleted file mode 100644 index 570552c..0000000 --- a/enums/core/grayscale-enhancement-mode.md +++ /dev/null @@ -1,187 +0,0 @@ ---- -layout: default-layout -title: GrayscaleEnhancementMode - Dynamsoft Core Enumerations -description: The enumeration GrayscaleEnhancementMode of Dynamsoft Core describes all available grayscale enhancement modes. -keywords: Grayscale enhancement modes -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: GrayscaleEnhancementMode -codeAutoHeight: true ---- - -# Enumeration GrayscaleEnhancementMode - -`GrayscaleEnhancementMode` specifies the method employed to enhance images in grayscale. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - >- C# - >- Python - > -> -```javascript -enum EnumGrayscaleEnhancementMode -{ - /** - * Disables any grayscale image preprocessing. Selecting this mode skips the preprocessing step, - * passing the image through to subsequent operations without modification. - */ - GEM_SKIP = 0, - /** - * Automatic selection of grayscale enhancement mode. Currently, not supported. - * Future implementations may automatically choose the most suitable enhancement based on image analysis. - */ - GEM_AUTO = 1, - /** - * Uses the original, unprocessed image for subsequent operations. This mode is selected when no specific - * grayscale enhancement is required, maintaining the image in its natural state. - */ - GEM_GENERAL = 2, - /** - * Applies a grayscale equalization algorithm to the image, enhancing contrast and detail in gray level. - * Suitable for images with poor contrast. - */ - GEM_GRAY_EQUALIZE = 4, - /** - * Implements a grayscale smoothing algorithm to reduce noise and smooth the image. - * This can be beneficial for images with high levels of grain or noise. - */ - GEM_GRAY_SMOOTH = 8, - /** - * Enhances the image by applying both sharpening and smoothing algorithms. This mode aims to increase - * clarity and detail while reducing noise, offering a balanced approach to image preprocessing. - */ - GEM_SHARPEN_SMOOTH = 16, - /** - * Reserved for future use. This setting is part of the grayscale enhancement mode but is - * currently not defined for public use. It's reserved for internal development or future enhancements. - */ - GEM_REV = -2147483648 -} -``` -> -```java -@Retention(RetentionPolicy.CLASS)public @interface EnumGrayscaleEnhancementMode { - /**Not supported yet. */ - public static final int GEM_AUTO = 1; - /**Takes the unpreprocessed image for following operations.*/ - public static final int GEM_GENERAL = 2; - /**Preprocesses the image using the gray equalization algorithm. Check @ref IPM for available argument settings.*/ - public static final int GEM_GRAY_EQUALIZE = 4; - /**Preprocesses the image using the gray smoothing algorithm. Check @ref IPM for available argument settings.*/ - public static final int GEM_GRAY_SMOOTH = 8; - /**Preprocesses the image using the sharpening and smoothing algorithm. Check @ref IPM for available argument settings.*/ - public static final int GEM_SHARPEN_SMOOTH = 16; - /**Reserved setting for image preprocessing mode.*/ - public static final int GEM_REV = -2147483648; - /**Skips image preprocessing. */ - public static final int GEM_SKIP = 0; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSGrayscaleEnhancementMode) -{ - /**Not supported yet. */ - DSGrayscaleEnhancementModeAuto = 1, - /**Takes the unpreprocessed image for following operations.*/ - DSGrayscaleEnhancementModeGeneral = 2, - /**Preprocesses the image using the gray equalization algorithm. Check @ref IPM for available argument settings.*/ - DSGrayscaleEnhancementModeGrayEqualize = 4, - /**Preprocesses the image using the gray smoothing algorithm. Check @ref IPM for available argument settings.*/ - DSGrayscaleEnhancementModeGraySmooth = 8, - /**Preprocesses the image using the sharpening and smoothing algorithm. Check @ref IPM for available argument settings.*/ - DSGrayscaleEnhancementModeSharpenSmooth = 16, - /**Reserved setting for image preprocessing mode.*/ - DSGrayscaleEnhancementModeRev = -2147483648, - /**Skips image preprocessing. */ - DSGrayscaleEnhancementModeSkip = 0 -}; -``` -> -```swift -public enum GrayscaleEnhancementMode : Int -{ - /**Not supported yet. */ - auto = 1 - /**Takes the unpreprocessed image for following operations.*/ - general = 2 - /**Preprocesses the image using the gray equalization algorithm. Check @ref IPM for available argument settings.*/ - grayEqualize = 4 - /**Preprocesses the image using the gray smoothing algorithm. Check @ref IPM for available argument settings.*/ - graySmooth = 8 - /**Preprocesses the image using the sharpening and smoothing algorithm. Check @ref IPM for available argument settings.*/ - sharpenSmooth = 16 - /**Reserved setting for image preprocessing mode.*/ - rev = -2147483648 - /**Skips image preprocessing. */ - skip = 0 -} -``` -> -```cpp -typedef enum GrayscaleEnhancementMode -{ - /**Not supported yet. */ - GEM_AUTO = 0x01, - /**Takes the unpreprocessed image for following operations. */ - GEM_GENERAL = 0x02, - /**Preprocesses the image using the gray equalization algorithm. Check @ref IPM for available argument settings.*/ - GEM_GRAY_EQUALIZE = 0x04, - /**Preprocesses the image using the gray smoothing algorithm. Check @ref IPM for available argument settings.*/ - GEM_GRAY_SMOOTH = 0x08, - /**Preprocesses the image using the sharpening and smoothing algorithm. Check @ref IPM for available argument settings.*/ - GEM_SHARPEN_SMOOTH = 0x10, - /**Reserved setting for image preprocessing mode.*/ -#if defined(_WIN32) || defined(_WIN64) - GEM_REV = 0x80000000, -#else - GEM_REV = -2147483648, -#endif - /**Skips image preprocessing. */ - GEM_SKIP = 0x00 -}GrayscaleEnhancementMode; -``` -> -```csharp -public enum EnumGrayscaleEnhancementMode -{ - /**Not supported yet. */ - GEM_AUTO = 0x01, - /**Takes the unpreprocessed image for following operations. */ - GEM_GENERAL = 0x02, - /**Preprocesses the image using the gray equalization algorithm.*/ - GEM_GRAY_EQUALIZE = 0x04, - /**Preprocesses the image using the gray smoothing algorithm.*/ - GEM_GRAY_SMOOTH = 0x08, - /**Preprocesses the image using the sharpening and smoothing algorithm.*/ - GEM_SHARPEN_SMOOTH = 0x10, - /**Reserved setting for image preprocessing mode.*/ - GEM_REV = -2147483648, - /**Skips image preprocessing. */ - GEM_SKIP = 0x00 -} -``` -> -```python -class EnumGrayscaleEnhancementMode(IntEnum): - #Not supported yet. - GEM_AUTO = 0x01 - #Takes the unpreprocessed image for following operations. - GEM_GENERAL = 0x02 - #Preprocesses the image using the gray equalization algorithm. - GEM_GRAY_EQUALIZE = 0x04 - #Preprocesses the image using the gray smoothing algorithm. - GEM_GRAY_SMOOTH = 0x08 - #Preprocesses the image using the sharpening and smoothing algorithm. - GEM_SHARPEN_SMOOTH = 0x10 - #Reserved setting for image preprocessing mode. - GEM_REV = -2147483648 - #Skips image preprocessing. - GEM_SKIP = 0x00 -``` diff --git a/enums/core/grayscale-transformation-mode.md b/enums/core/grayscale-transformation-mode.md deleted file mode 100644 index e44cfb2..0000000 --- a/enums/core/grayscale-transformation-mode.md +++ /dev/null @@ -1,156 +0,0 @@ ---- -layout: default-layout -title: GrayscaleTransformationMode - Dynamsoft Core Enumerations -description: The enumeration GrayscaleTransformationMode of Dynamsoft Core describes all available grayscale transformation modes. -keywords: Grayscale transformation modes -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: GrayscaleTransformationMode -codeAutoHeight: true ---- - -# Enumeration GrayscaleTransformationMode - -`GrayscaleTransformationMode` specifies the method employed to transform images in grayscale. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - >- C# - >- Python - > -> -```javascript -enum EnumGrayscaleTransformationMode -{ - /** - * Bypasses grayscale transformation, leaving the image in its current state without any modification to its grayscale values. - * This mode is selected when no alteration of the grayscale data is desired, passing the image through to subsequent operations without modification. - */ - GTM_SKIP = 0, - /** - * Applies an inversion to the grayscale values of the image, effectively transforming light elements to dark and vice versa. - * This mode is particularly useful for images with light text on dark backgrounds, enhancing visibility for further processing. - */ - GTM_INVERTED = 1, - /** - * Maintains the original grayscale values of the image without any transformation. This mode is suited for images with - * dark elements on light backgrounds, ensuring the natural contrast and detail are preserved for subsequent analysis. - */ - GTM_ORIGINAL = 2, - /** - * Delegates the choice of grayscale transformation to the library's algorithm, which automatically determines the most - * suitable transformation based on the image's characteristics. This mode is beneficial when the optimal transformation - * is not known in advance or varies across different images. - */ - GTM_AUTO = 4, - /** - * Reserved for future expansion or internal use. This placeholder indicates a grayscale transformation mode that is - * not currently defined for public use but may be utilized for upcoming features or reserved for specific, undocumented adjustments. - */ - GTM_REV = -2147483648 -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumGrayscaleTransformationMode -{ - /** Transforms to the inverted grayscale for further reference. This value is recommended for light on dark images. */ - public static final int GTM_INVERTED = 1; - /** Keeps the original grayscale for further reference. This value is recommended for dark on light images. */ - public static final int GTM_ORIGINAL = 2; - /**Lets the library choose an algorithm automatically for grayscale transformation.*/ - public static final int GTM_AUTO = 4; - /** Skips grayscale transformation. */ - public static final int GTM_SKIP = 0; - /** Reserved setting for grayscale transformation mode. */ - public static final int GTM_REV = -2147483648; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSGrayscaleTransformationMode) -{ - /** Transforms to the inverted grayscale for further reference. This value is recommended for light on dark images. */ - DSGrayscaleTransformationModeInverted = 0x01, - /** Keeps the original grayscale for further reference. This value is recommended for dark on light images. */ - DSGrayscaleTransformationModeOriginal = 0x02, - /**Lets the library choose an algorithm automatically for grayscale transformation.*/ - DSGrayscaleTransformationModeAuto = 0x04, - /** Skips grayscale transformation. */ - DSGrayscaleTransformationModeSkip = 0x00, - /** Reserved setting for grayscale transformation mode. */ - DSGrayscaleTransformationModeRev = -2147483648 -}; -``` -> -```swift -public enum GrayscaleTransformationMode : Int -{ - /** Transforms to the inverted grayscale for further reference. This value is recommended for light on dark images. */ - inverted = 0x01 - /** Keeps the original grayscale for further reference. This value is recommended for dark on light images. */ - original = 0x02 - /**Lets the library choose an algorithm automatically for grayscale transformation.*/ - auto = 0x04 - /** Skips grayscale transformation. */ - skip = 0x00 - /** Reserved setting for grayscale transformation mode. */ - rev = -2147483648 -} -``` -> -```cpp -typedef enum GrayscaleTransformationMode -{ - /** Transforms to inverted grayscale. Recommended for light on dark images. */ - GTM_INVERTED = 0x01, - /** Keeps the original grayscale. Recommended for dark on light images. */ - GTM_ORIGINAL = 0x02, - /** Lets the library choose an algorithm automatically for grayscale transformation. */ - GTM_AUTO = 0x04, - /** Reserved setting for grayscale transformation mode. */ -#if defined(_WIN32) || defined(_WIN64) - GTM_REV = 0x80000000, -#else - GTM_REV = -2147483648, -#endif - /** Skips grayscale transformation. */ - GTM_SKIP = 0x00 -}GrayscaleTransformationMode; -``` -> -```csharp -public enum EnumGrayscaleTransformationMode -{ - /**Transforms to inverted grayscale. Recommended for light on dark images. */ - GTM_INVERTED = 0x01, - /**Keeps the original grayscale. Recommended for dark on light images. */ - GTM_ORIGINAL = 0x02, - /**Lets the library choose an algorithm automatically for grayscale transformation.*/ - GTM_AUTO = 0x04, - /**Reserved setting for grayscale transformation mode.*/ - GTM_REV = -2147483648, - /**Skips grayscale transformation. */ - GTM_SKIP = 0x00 -} -``` -> -```python -class EnumGrayscaleTransformationMode(IntEnum): - #Transforms to inverted grayscale. Recommended for light on dark images. - GTM_INVERTED = 0x01 - #Keeps the original grayscale. Recommended for dark on light images. - GTM_ORIGINAL = 0x02 - #Lets the library choose an algorithm automatically for grayscale transformation. - GTM_AUTO = 0x04 - #Reserved setting for grayscale transformation mode. - GTM_REV = -2147483648 - #Skips grayscale transformation. - GTM_SKIP = 0x00 -``` diff --git a/enums/core/image-capture-distance-mode.md b/enums/core/image-capture-distance-mode.md deleted file mode 100644 index 76bbc72..0000000 --- a/enums/core/image-capture-distance-mode.md +++ /dev/null @@ -1,94 +0,0 @@ ---- -layout: default-layout -title: ImageCaptureDistanceMode - Dynamsoft Core Enumerations -description: The enumeration ImageCaptureDistanceMode of Dynamsoft Core is used to distinguish the close-up images from the prospect images. -keywords: Image capture distance -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: ImageCaptureDistanceMode -codeAutoHeight: true ---- - -# Enumeration ImageCaptureDistanceMode - -`ImageCaptureDistanceMode` describes the shooting mode of the image. It is used in the `overlap` mode of `Panorama`. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - >- C# - >- Python - > -> -```javascript -enum ImageCaptureDistanceMode -{ - /** The image is taken by close-up shot camera. */ - ICDM_NEAR = 0, - /** The image is taken by long shot camera. */ - ICDM_FAR = 1 -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumImageCaptureDistanceMode -{ - /** The image is taken by close-up shot camera. */ - public static final int ICDM_NEAR = 0; - /** The image is taken by long shot camera. */ - public static final int ICDM_FAR = 1; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSImageCaptureDistanceMode) -{ - /** The image is taken by close-up shot camera. */ - DSImageCaptureDistanceModeNear, - /** The image is taken by long shot camera. */ - DSImageCaptureDistanceModeFar -}; -``` -> -```swift -public enum ImageCaptureDistanceMode : Int -{ - /** The image is taken by close-up shot camera. */ - near - /** The image is taken by long shot camera. */ - far -} -``` -> -```cpp -typedef enum ImageCaptureDistanceMode -{ - /** The image is taken by close-up shot camera. */ - ICDM_NEAR, - /** The image is taken by long shot camera. */ - ICDM_FAR -} CaptureDistanceMode; -``` -> -```csharp -public enum EnumImageCaptureDistanceMode -{ - /**The image is taken by close-up shot camera.*/ - ICDM_NEAR, - /**The image is taken by long shot camera.*/ - ICDM_FAR -} -``` -> -```python -class EnumImageCaptureDistanceMode(IntEnum): - #The image is taken by close-up shot camera. - ICDM_NEAR - #The image is taken by long shot camera. - ICDM_FAR -``` diff --git a/enums/core/image-pixel-format.md b/enums/core/image-pixel-format.md deleted file mode 100644 index 751d42e..0000000 --- a/enums/core/image-pixel-format.md +++ /dev/null @@ -1,277 +0,0 @@ ---- -layout: default-layout -title: ImagePixelFormat - Dynamsoft Core Enumerations -description: The enumeration ImagePixelFormat of Dynamsoft Core describes all supported image pixel formats. -keywords: Image pixel format -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: ImagePixelFormat -codeAutoHeight: true ---- - -# Enumeration ImagePixelFormat - -`ImagePixelFormat` defines the range of pixel formats that an image can have, specifying how color and transparency data are represented in each pixel of the image. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - >- C# - >- Python - > -> -```javascript -enum EnumImagePixelFormat { - /** 0:Black, 1:White. */ - IPF_BINARY = 0, - /** 0:White, 1:Black. */ - IPF_BINARYINVERTED = 1, - /** 8bit gray. */ - IPF_GRAYSCALED = 2, - /** NV21. */ - IPF_NV21 = 3, - /** 16bit with RGB channel order stored in memory from high to low address. */ - IPF_RGB_565 = 4, - /** 16bit with RGB channel order stored in memory from high to low address. */ - IPF_RGB_555 = 5, - /** 24bit with RGB channel order stored in memory from high to low address. */ - IPF_RGB_888 = 6, - /** 32bit with ARGB channel order stored in memory from high to low address. */ - IPF_ARGB_8888 = 7, - /** 48bit with RGB channel order stored in memory from high to low address. */ - IPF_RGB_161616 = 8, - /** 64bit with ARGB channel order stored in memory from high to low address. */ - IPF_ARGB_16161616 = 9, - /** 32bit with ABGR channel order stored in memory from high to low address. */ - IPF_ABGR_8888 = 10, - /** 64bit with ABGR channel order stored in memory from high to low address. */ - IPF_ABGR_16161616 = 11, - /** 24bit with BGR channel order stored in memory from high to low address. */ - IPF_BGR_888 = 12, - /** 0:Black, 255:White. */ - IPF_BINARY_8 = 13, - /**NV12 */ - IPF_NV12 = 14 -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumCapturedResultItemType -{ - /** 0:Black, 1:White. */ - public static final int IPF_BINARY = 0; - /** 0:White, 1:Black. */ - public static final int IPF_BINARYINVERTED = 1; - /** 8bit gray. */ - public static final int IPF_GRAYSCALED = 2; - /** NV21. */ - public static final int IPF_NV21 = 3; - /** 16bit with RGB channel order stored in memory from high to low address. */ - public static final int IPF_RGB_565 = 4; - /** 16bit with RGB channel order stored in memory from high to low address. */ - public static final int IPF_RGB_555 = 5; - /** 24bit with RGB channel order stored in memory from high to low address. */ - public static final int IPF_RGB_888 = 6; - /** 32bit with ARGB channel order stored in memory from high to low address. */ - public static final int IPF_ARGB_8888 = 7; - /** 48bit with RGB channel order stored in memory from high to low address. */ - public static final int IPF_RGB_161616 = 8; - /** 64bit with ARGB channel order stored in memory from high to low address. */ - public static final int IPF_ARGB_16161616 = 9; - /** 32bit with ABGR channel order stored in memory from high to low address. */ - public static final int IPF_ABGR_8888 = 10; - /** 64bit with ABGR channel order stored in memory from high to low address. */ - public static final int IPF_ABGR_16161616 = 11; - /** 24bit with BGR channel order stored in memory from high to low address. */ - public static final int IPF_BGR_888 = 12; - /** 0:Black, 255:White. */ - public static final int IPF_BINARY_8 = 13; - /**NV12 */ - public static final int IPF_NV12 = 14; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSImagePixelFormat) -{ - /** 0:black, 1:white */ - DSImagePixelFormatBinary, - /** 0:white, 1:black */ - DSImagePixelFormatBinaryInverted, - /** 8-bit gray */ - DSImagePixelFormatGrayScaled, - /** NV21 */ - DSImagePixelFormatNV21, - /** 16bit with RGB channel order stored in memory from high to low address*/ - DSImagePixelFormatRGB_565, - /** 16bit with RGB channel order stored in memory from high to low address*/ - DSImagePixelFormatRGB_555, - /** 24bit with RGB channel order stored in memory from high to low address*/ - DSImagePixelFormatRGB_888, - /** 32bit with ARGB channel order stored in memory from high to low address*/ - DSImagePixelFormatARGB_8888, - /** 48bit with RGB channel order stored in memory from high to low address*/ - DSImagePixelFormatRGB_161616, - /** 64bit with ARGB channel order stored in memory from high to low address*/ - DSImagePixelFormatARGB_16161616, - /** 32bit with ABGB channel order stored in memory from high to low address */ - DSImagePixelFormatABGR_8888, - /** 64bit with ABGR channel order stored in memory from high to low address*/ - DSImagePixelFormatABGR_16161616, - /** 24bit with BGR channel order stored in memory from high to low address*/ - DSImagePixelFormatBGR_888, - /** 0:black, 255:white */ - DSImagePixelFormatBinary_8, - /**NV12 */ - DSImagePixelFormatNV12 -}; -``` -> -```swift -public enum ImagePixelFormat : Int -{ - /** 0:black, 1:white */ - binary - /** 0:white, 1:black */ - binaryInverted - /** 8-bit gray */ - grayScaled - /** NV21 */ - NV21 - /** 16bit with RGB channel order stored in memory from high to low address*/ - RGB_565 - /** 16bit with RGB channel order stored in memory from high to low address*/ - RGB_555 - /** 24bit with RGB channel order stored in memory from high to low address*/ - RGB_888 - /** 32bit with ARGB channel order stored in memory from high to low address*/ - ARGB_8888 - /** 48bit with RGB channel order stored in memory from high to low address*/ - RGB_161616 - /** 64bit with ARGB channel order stored in memory from high to low address*/ - ARGB_16161616 - /** 32bit with ABGB channel order stored in memory from high to low address */ - ABGR_8888 - /** 64bit with ABGR channel order stored in memory from high to low address*/ - ABGR_16161616 - /** 24bit with BGR channel order stored in memory from high to low address*/ - BGR_888 - /** 0:black, 255:white */ - binary_8 - /**NV12 */ - NV12 -} -``` -> -```cpp -typedef enum ImagePixelFormat -{ - /** 0:Black, 1:White. */ - IPF_BINARY, - /** 0:White, 1:Black. */ - IPF_BINARYINVERTED, - /** 8bit gray. */ - IPF_GRAYSCALED, - /** NV21. */ - IPF_NV21, - /** 16bit with RGB channel order stored in memory from high to low address. */ - IPF_RGB_565, - /** 16bit with RGB channel order stored in memory from high to low address. */ - IPF_RGB_555, - /** 24bit with RGB channel order stored in memory from high to low address. */ - IPF_RGB_888, - /** 32bit with ARGB channel order stored in memory from high to low address. */ - IPF_ARGB_8888, - /** 48bit with RGB channel order stored in memory from high to low address. */ - IPF_RGB_161616, - /** 64bit with ARGB channel order stored in memory from high to low address. */ - IPF_ARGB_16161616, - /** 32bit with ABGR channel order stored in memory from high to low address. */ - IPF_ABGR_8888, - /** 64bit with ABGR channel order stored in memory from high to low address. */ - IPF_ABGR_16161616, - /** 24bit with BGR channel order stored in memory from high to low address. */ - IPF_BGR_888, - /** 0:Black, 255:White. */ - IPF_BINARY_8, - /**NV12 */ - IPF_NV12, - /**0:White, 255:Black */ - IPF_BINARY_8_INVERTED -}ImagePixelFormat; -``` -> -```csharp -public enum EnumImagePixelFormat -{ - /**0:Black, 1:White */ - IPF_BINARY, - /**0:White, 1:Black */ - IPF_BINARYINVERTED, - /**8bit gray */ - IPF_GRAYSCALED, - /**NV21 */ - IPF_NV21, - /**16bit with RGB channel order stored in memory from high to low address*/ - IPF_RGB_565, - /**16bit with RGB channel order stored in memory from high to low address*/ - IPF_RGB_555, - /**24bit with RGB channel order stored in memory from high to low address*/ - IPF_RGB_888, - /**32bit with ARGB channel order stored in memory from high to low address*/ - IPF_ARGB_8888, - /**48bit with RGB channel order stored in memory from high to low address*/ - IPF_RGB_161616, - /**64bit with ARGB channel order stored in memory from high to low address*/ - IPF_ARGB_16161616, - /**32bit with ABGR channel order stored in memory from high to low address*/ - IPF_ABGR_8888, - /**64bit with ABGR channel order stored in memory from high to low address*/ - IPF_ABGR_16161616, - /**24bit with BGR channel order stored in memory from high to low address*/ - IPF_BGR_888, - /**0:Black, 255:White */ - IPF_BINARY_8, - /**NV12 */ - IPF_NV12 -} -``` -> -```python -class EnumImagePixelFormat(IntEnum): - #0:Black, 1:White - IPF_BINARY - #0:White, 1:Black - IPF_BINARYINVERTED - #8bit gray - IPF_GRAYSCALED - #NV21 - IPF_NV21 - #16bit with RGB channel order stored in memory from high to low address - IPF_RGB_565 - #16bit with RGB channel order stored in memory from high to low address - IPF_RGB_555 - #24bit with RGB channel order stored in memory from high to low address - IPF_RGB_888 - #32bit with ARGB channel order stored in memory from high to low address - IPF_ARGB_8888 - #48bit with RGB channel order stored in memory from high to low address - IPF_RGB_161616 - #64bit with ARGB channel order stored in memory from high to low address - IPF_ARGB_16161616 - #32bit with ABGR channel order stored in memory from high to low address - IPF_ABGR_8888 - #64bit with ABGR channel order stored in memory from high to low address - IPF_ABGR_16161616 - #24bit with BGR channel order stored in memory from high to low address - IPF_BGR_888 - #0:Black, 255:White - IPF_BINARY_8 - #NV12 - IPF_NV12 -``` diff --git a/enums/core/image-source-state.md b/enums/core/image-source-state.md deleted file mode 100644 index e84b0e8..0000000 --- a/enums/core/image-source-state.md +++ /dev/null @@ -1,76 +0,0 @@ ---- -layout: default-layout -title: ImageSourceState - Dynamsoft Core Enumerations -description: The enumeration ImageSourceState of Dynamsoft Core describes the state of ImageSourceAdapter. -keywords: Image source state -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: ImageSourceState -codeAutoHeight: true -ignore: true ---- - - -# Enumeration ImageSourceState - -`ImageSourceState` describes the state of `ImageSourceAdapter`. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - > -> -```javascript -enum EnumImageSourceState -{ - /** The buffer of ImageSourceAdapter is temporarily empty. */ - ISS_BUFFER_EMPTY = 0, - /** The source of ImageSourceAdapter is empty. */ - ISS_EXHAUSTED = 1 -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumImageSourceState -{ - /** The buffer of ImageSourceAdapter is temporarily empty. */ - public static final int ISS_BUFFER_EMPTY = 0; - /** The source of ImageSourceAdapter is empty. */ - public static final int ISS_EXHAUSTED = 1; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSImageSourceState) -{ - /** The buffer of ImageSourceAdapter is temporarily empty. */ - DSImageSourceStateBufferEmpty = 0, - /** The source of ImageSourceAdapter is empty. */ - DSImageSourceStateExhausted = 1 -}; -``` -> -```swift -public enum ImageSourceState : Int -{ - /** The buffer of ImageSourceAdapter is temporarily empty. */ - bufferEmpty = 0 - /** The source of ImageSourceAdapter is empty. */ - exhausted = 1 -}; -``` -> -```cpp -typedef enum ImageSourceState -{ - /** The buffer of ImageSourceAdapter is temporarily empty. */ - ISS_BUFFER_EMPTY, - /** The source of ImageSourceAdapter is empty. */ - ISS_EXHAUSTED -} ImageSourceState; -``` diff --git a/enums/core/image-tag-type.md b/enums/core/image-tag-type.md deleted file mode 100644 index fdda15a..0000000 --- a/enums/core/image-tag-type.md +++ /dev/null @@ -1,92 +0,0 @@ ---- -layout: default-layout -title: ImageTagType - Dynamsoft Core Enumerations -description: The enumeration ImageTagType of Dynamsoft Core describes the types of image tags. -keywords: Image tag type -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: ImageTagType -codeAutoHeight: true ---- - -# Enumeration ImageTagType - -`ImageTagType` categorizes images based on their source, distinguishing between images extracted from video streams (video frame) and those loaded from static files (file image). - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - >- C# - >- Python - > -> -```javascript -enum EnumImageTagType -{ - /**Represents an image that has been sourced from a static file.*/ - ITT_FILE_IMAGE = 0, - /**Indicates that the image is a frame extracted from a video stream.*/ - ITT_VIDEO_FRAME = 1 -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumImageTagType -{ - public static final int ITT_FILE_IMAGE = 0; - public static final int ITT_VIDEO_FRAME = 1; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSImageTagType) -{ - /**The image tag is a DSFileImageTag.*/ - DSImageTagTypeFileImage = 0, - /**The image tag is a DSVideoFrameTag.*/ - DSImageTagTypeVideoFrame = 1, -}; -``` -> -```swift -public enum ImageTagType : Int -{ - /**The image tag is a DSFileImageTag.*/ - fileImage = 0, - /**The image tag is a DSVideoFrameTag.*/ - videoFrame = 1, -} -``` -> -```cpp -typedef enum ImageTagType -{ - /**Represents an image that has been sourced from a static file.*/ - ITT_FILE_IMAGE, - /**Indicates that the image is a frame extracted from a video stream.*/ - ITT_VIDEO_FRAME -} ImageTagType; -``` -> -```csharp -public enum EnumImageTagType -{ - /**The image is a file image.*/ - ITT_FILE_IMAGE, - /**The image is a video frame.*/ - ITT_VIDEO_FRAME -} -``` -> -```python -class EnumImageTagType(IntEnum): - #The image is a file image. - ITT_FILE_IMAGE - #The image is a video frame. - ITT_VIDEO_FRAME -``` diff --git a/enums/core/intermediate-result-unit-type-v3.0.30.md b/enums/core/intermediate-result-unit-type-v3.0.30.md deleted file mode 100644 index c386405..0000000 --- a/enums/core/intermediate-result-unit-type-v3.0.30.md +++ /dev/null @@ -1,339 +0,0 @@ ---- -layout: default-layout -title: IntermediateResultUnitType - Dynamsoft Core Enumerations -description: The enumeration IntermediateResultUnitType of Dynamsoft Core describes the type of the intermediate result unit. -keywords: Intermediate result unit type -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: IntermediateResultUnitType -codeAutoHeight: true ---- - -# Enumeration IntermediateResultUnitType - -`IntermediateResultUnitType` defines different types of intermediate results generated or expected to be generated during image processing. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - > -> -```javascript -enum EnumIntermediateResultUnitType { - /** No intermediate result. */ - IRUT_NULL = 0, - /** A full-color image. */ - IRUT_COLOUR_IMAGE = 1, - /** A color image that has been scaled down for efficiency. */ - IRUT_SCALED_DOWN_COLOUR_IMAGE = 1 << 1, - /** A grayscale image derived from the original input. */ - IRUT_GRAYSCALE_IMAGE = 1 << 2, - /** A grayscale image that has undergone transformation. */ - IRUT_TRANSOFORMED_GRAYSCALE_IMAGE = 1 << 3, - /** A grayscale image enhanced for further processing. */ - IRUT_ENHANCED_GRAYSCALE_IMAGE = 1 << 4, - /** Regions pre-detected as potentially relevant for further analysis. */ - IRUT_PREDETECTED_REGIONS = 1 << 5, - /** A binary (black and white) image. */ - IRUT_BINARY_IMAGE = 1 << 6, - /** Results from detecting textures within the image. */ - IRUT_TEXTURE_DETECTION_RESULT = 1 << 7, - /** A grayscale image with textures removed to enhance subject details like text or barcodes. */ - IRUT_TEXTURE_REMOVED_GRAYSCALE_IMAGE = 1 << 8, - /** A binary image with textures removed, useful for clear detection of subjects without background noise. */ - IRUT_TEXTURE_REMOVED_BINARY_IMAGE = 1 << 9, - /** Detected contours within the image, which can help in identifying shapes and objects. */ - IRUT_CONTOURS = 1 << 10, - /** Detected line segments, useful in structural analysis of the image content. */ - IRUT_LINE_SEGMENTS = 1 << 11, - /** Identified text zones, indicating areas with potential textual content. */ - IRUT_TEXT_ZONES = 1 << 12, - /** A binary image with text regions removed. */ - IRUT_TEXT_REMOVED_BINARY_IMAGE = 1 << 13, - /** Zones identified as potential barcode areas, aiding in focused barcode detection. */ - IRUT_CANDIDATE_BARCODE_ZONES = 1 << 14, - /** Barcodes that have been localized but not yet decoded. */ - IRUT_LOCALIZED_BARCODES = 1 << 15, - /** Barcode images scaled up for improved readability or decoding accuracy. */ - IRUT_SCALED_UP_BARCODE_IMAGE = 1 << 16, - /** Images of barcodes processed to resist deformation and improve decoding success. */ - IRUT_DEFORMATION_RESISTED_BARCODE_IMAGE = 1 << 17, - /** Barcode images that have been complemented. */ - IRUT_COMPLEMENTED_BARCODE_IMAGE = 1 << 18, - /** Successfully decoded barcodes. */ - IRUT_DECODED_BARCODES = 1 << 19, - /** Detected long lines. */ - IRUT_LONG_LINES = 1 << 20, - /** Detected corners within the image. */ - IRUT_CORNERS = 1 << 21, - /** Candidate edges identified as potential components of quadrilaterals. */ - IRUT_CANDIDATE_QUAD_EDGES = 1 << 22, - /** Successfully detected quadrilaterals. */ - IRUT_DETECTED_QUADS = 1 << 23, - /** Text lines that have been localized in preparation for recognition. */ - IRUT_LOCALIZED_TEXT_LINES = 1 << 24, - /** Successfully recognized text lines. */ - IRUT_RECOGNIZED_TEXT_LINES = 1 << 25, - /** Successfully normalized images. */ - IRUT_NORMALIZED_IMAGES = 1 << 26, - /** A mask to select all types of intermediate results. */ - IRUT_ALL = 0xFFFFFFF -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumIntermediateResultUnitType { - /** No intermediate result. */ - long IRUT_NULL = 0L; - /** A full-color image. */ - long IRUT_COLOUR_IMAGE = 1L; - /** A color image that has been scaled down for efficiency. */ - long IRUT_SCALED_DOWN_COLOUR_IMAGE = 1L << 1; - /** A grayscale image derived from the original input. */ - long IRUT_GRAYSCALE_IMAGE = 1L << 2; - /** A grayscale image that has undergone transformation. */ - long IRUT_TRANSOFORMED_GRAYSCALE_IMAGE = 1L << 3; - /** A grayscale image enhanced for further processing. */ - long IRUT_ENHANCED_GRAYSCALE_IMAGE = 1L << 4; - /** Regions pre-detected as potentially relevant for further analysis. */ - long IRUT_PREDETECTED_REGIONS = 1L << 5; - /** A binary (black and white) image. */ - long IRUT_BINARY_IMAGE = 1L << 6; - /** Results from detecting textures within the image. */ - long IRUT_TEXTURE_DETECTION_RESULT = 1L << 7; - /** A grayscale image with textures removed to enhance subject details like text or barcodes. */ - long IRUT_TEXTURE_REMOVED_GRAYSCALE_IMAGE = 1L << 8; - /** A binary image with textures removed, useful for clear detection of subjects without background noise. */ - long IRUT_TEXTURE_REMOVED_BINARY_IMAGE = 1L << 9; - /** Detected contours within the image, which can help in identifying shapes and objects. */ - long IRUT_CONTOURS = 1L << 10; - /** Detected line segments, useful in structural analysis of the image content. */ - long IRUT_LINE_SEGMENTS = 1L << 11; - /** Identified text zones, indicating areas with potential textual content. */ - long IRUT_TEXT_ZONES = 1L << 12; - /** A binary image with text regions removed. */ - long IRUT_TEXT_REMOVED_BINARY_IMAGE = 1L << 13; - /** Zones identified as potential barcode areas, aiding in focused barcode detection. */ - long IRUT_CANDIDATE_BARCODE_ZONES = 1L << 14; - /** Barcodes that have been localized but not yet decoded. */ - long IRUT_LOCALIZED_BARCODES = 1L << 15; - /** Barcode images scaled up for improved readability or decoding accuracy. */ - long IRUT_SCALED_UP_BARCODE_IMAGE = 1L << 16; - /** Images of barcodes processed to resist deformation and improve decoding success. */ - long IRUT_DEFORMATION_RESISTED_BARCODE_IMAGE = 1L << 17; - /** Barcode images that have been complemented. */ - long IRUT_COMPLEMENTED_BARCODE_IMAGE = 1L << 18; - /** Successfully decoded barcodes. */ - long IRUT_DECODED_BARCODES = 1L << 19; - /** Detected long lines. */ - long IRUT_LONG_LINES = 1L << 20; - /** Detected corners within the image. */ - long IRUT_CORNERS = 1L << 21; - /** Candidate edges identified as potential components of quadrilaterals. */ - long IRUT_CANDIDATE_QUAD_EDGES = 1L << 22; - /** Successfully detected quadrilaterals. */ - long IRUT_DETECTED_QUADS = 1L << 23; - /** Text lines that have been localized in preparation for recognition. */ - long IRUT_LOCALIZED_TEXT_LINES = 1L << 24; - /** Successfully recognized text lines. */ - long IRUT_RECOGNIZED_TEXT_LINES = 1L << 25; - /** Successfully normalized images. */ - long IRUT_NORMALIZED_IMAGES = 1L << 26; - /** A mask to select all types of intermediate results. */ - long IRUT_ALL = 0xFFFFFFFL; -} -``` -> -```objc -typedef NS_OPTIONS(NSUInteger, DSIntermediateResultUnitType) { - /** No intermediate result. */ - DSIntermediateResultUnitTypeNull = 0, - /** A full-color image. */ - DSIntermediateResultUnitTypeColourImage = 1, - /** A color image that has been scaled down for efficiency. */ - DSIntermediateResultUnitTypeScaledDownColourImage = 1 << 1, - /** A grayscale image derived from the original input. */ - DSIntermediateResultUnitTypeGrayscaleImage = 1 << 2, - /** A grayscale image that has undergone transformation. */ - DSIntermediateResultUnitTypeTransformedGrayscaleImage = 1 << 3, - /** A grayscale image enhanced for further processing. */ - DSIntermediateResultUnitTypeEnhancedGrayscaleImage = 1 << 4, - /** Regions pre-detected as potentially relevant for further analysis. */ - DSIntermediateResultUnitTypePredetectedRegions = 1 << 5, - /** A binary (black and white) image. */ - DSIntermediateResultUnitTypeBinaryImage = 1 << 6, - /** Results from detecting textures within the image. */ - DSIntermediateResultUnitTypeTextureDetectionResult = 1 << 7, - /** A grayscale image with textures removed to enhance subject details like text or barcodes. */ - DSIntermediateResultUnitTypeTextureRemovedGrayscaleImage = 1 << 8, - /** A binary image with textures removed, useful for clear detection of subjects without background noise. */ - DSIntermediateResultUnitTypeTextureRemovedBinaryImage = 1 << 9, - /** Detected contours within the image, which can help in identifying shapes and objects. */ - DSIntermediateResultUnitTypeContours = 1 << 10, - /** Detected line segments, useful in structural analysis of the image content. */ - DSIntermediateResultUnitTypeLineSegments = 1 << 11, - /** Identified text zones, indicating areas with potential textual content. */ - DSIntermediateResultUnitTypeTextZones = 1 << 12, - /** A binary image with text regions removed. */ - DSIntermediateResultUnitTypeTextRemovedBinaryImage = 1 << 13, - /** Zones identified as potential barcode areas, aiding in focused barcode detection. */ - DSIntermediateResultUnitTypeCandidateBarcodeZones = 1 << 14, - /** Barcodes that have been localized but not yet decoded. */ - DSIntermediateResultUnitTypeLocalizedBarcodes = 1 << 15, - /** Barcode images scaled up for improved readability or decoding accuracy. */ - DSIntermediateResultUnitTypeScaledUpBarcodeImage = 1 << 16, - /** Images of barcodes processed to resist deformation and improve decoding success. */ - DSIntermediateResultUnitTypeDeformationResistedBarcodeImage = 1 << 17, - /** Barcode images that have been complemented. */ - DSIntermediateResultUnitTypeComplementedBarcodeImage = 1 << 18, - /** Successfully decoded barcodes. */ - DSIntermediateResultUnitTypeDecodedBarcodes = 1 << 19, - /** Detected long lines. */ - DSIntermediateResultUnitTypeLongLines = 1 << 20, - /** Detected corners within the image. */ - DSIntermediateResultUnitTypeCorners = 1 << 21, - /** Candidate edges identified as potential components of quadrilaterals. */ - DSIntermediateResultUnitTypeCandidateQuadEdges = 1 << 22, - /** Successfully detected quadrilaterals. */ - DSIntermediateResultUnitTypeDetectedQuads = 1 << 23, - /** Text lines that have been localized in preparation for recognition. */ - DSIntermediateResultUnitTypeLocalizedTextLines = 1 << 24, - /** Successfully recognized text lines. */ - DSIntermediateResultUnitTypeRecognizedTextLines = 1 << 25, - /** Successfully normalized images. */ - DSIntermediateResultUnitTypeNormalizedImages = 1 << 26, - /** A mask to select all types of intermediate results. */ - DSIntermediateResultUnitTypeAll = 0xFFFFFFF -}; -``` -> -```swift -public enum IntermediateResultUnitType: Int { - /** No intermediate result. */ - case null = 0 - /** A full-color image. */ - case colourImage = 1 - /** A color image that has been scaled down for efficiency. */ - case scaledDownColourImage = 1 << 1 - /** A grayscale image derived from the original input. */ - case grayscaleImage = 1 << 2 - /** A grayscale image that has undergone transformation. */ - case transformedGrayscaleImage = 1 << 3 - /** A grayscale image enhanced for further processing. */ - case enhancedGrayscaleImage = 1 << 4 - /** Regions pre-detected as potentially relevant for further analysis. */ - case predetectedRegions = 1 << 5 - /** A binary (black and white) image. */ - case binaryImage = 1 << 6 - /** Results from detecting textures within the image. */ - case textureDetectionResult = 1 << 7 - /** A grayscale image with textures removed to enhance subject details like text or barcodes. */ - case textureRemovedGrayscaleImage = 1 << 8 - /** A binary image with textures removed, useful for clear detection of subjects without background noise. */ - case textureRemovedBinaryImage = 1 << 9 - /** Detected contours within the image, which can help in identifying shapes and objects. */ - case contours = 1 << 10 - /** Detected line segments, useful in structural analysis of the image content. */ - case lineSegments = 1 << 11 - /** Identified text zones, indicating areas with potential textual content. */ - case textZones = 1 << 12 - /** A binary image with text regions removed. */ - case textRemovedBinaryImage = 1 << 13 - /** Zones identified as potential barcode areas, aiding in focused barcode detection. */ - case candidateBarcodeZones = 1 << 14 - /** Barcodes that have been localized but not yet decoded. */ - case localizedBarcodes = 1 << 15 - /** Barcode images scaled up for improved readability or decoding accuracy. */ - case scaledUpBarcodeImage = 1 << 16 - /** Images of barcodes processed to resist deformation and improve decoding success. */ - case deformationResistedBarcodeImage = 1 << 17 - /** Barcode images that have been complemented. */ - case complementedBarcodeImage = 1 << 18 - /** Successfully decoded barcodes. */ - case decodedBarcodes = 1 << 19 - /** Detected long lines. */ - case longLines = 1 << 20 - /** Detected corners within the image. */ - case corners = 1 << 21 - /** Candidate edges identified as potential components of quadrilaterals. */ - case candidateQuadEdges = 1 << 22 - /** Successfully detected quadrilaterals. */ - case detectedQuads = 1 << 23 - /** Text lines that have been localized in preparation for recognition. */ - case localizedTextLines = 1 << 24 - /** Successfully recognized text lines. */ - case recognizedTextLines = 1 << 25 - /** Successfully normalized images. */ - case normalizedImages = 1 << 26 - /** A mask to select all types of intermediate results. */ - case all = 0xFFFFFFF -} -``` -> -```cpp -enum IntermediateResultUnitType : unsigned long long { - /** No intermediate result. */ - IRUT_NULL = 0, - /** A full-color image. */ - IRUT_COLOUR_IMAGE = 1, - /** A color image that has been scaled down for efficiency. */ - IRUT_SCALED_DOWN_COLOUR_IMAGE = 1 << 1, - /** A grayscale image derived from the original input. */ - IRUT_GRAYSCALE_IMAGE = 1 << 2, - /** A grayscale image that has undergone transformation. */ - IRUT_TRANSFORMED_GRAYSCALE_IMAGE = 1 << 3, - /** A grayscale image enhanced for further processing. */ - IRUT_ENHANCED_GRAYSCALE_IMAGE = 1 << 4, - /** Regions pre-detected as potentially relevant for further analysis. */ - IRUT_PREDETECTED_REGIONS = 1 << 5, - /** A binary (black and white) image. */ - IRUT_BINARY_IMAGE = 1 << 6, - /** Results from detecting textures within the image. */ - IRUT_TEXTURE_DETECTION_RESULT = 1 << 7, - /** A grayscale image with textures removed to enhance subject details like text or barcodes. */ - IRUT_TEXTURE_REMOVED_GRAYSCALE_IMAGE = 1 << 8, - /** A binary image with textures removed, useful for clear detection of subjects without background noise. */ - IRUT_TEXTURE_REMOVED_BINARY_IMAGE = 1 << 9, - /** Detected contours within the image, which can help in identifying shapes and objects. */ - IRUT_CONTOURS = 1 << 10, - /** Detected line segments, useful in structural analysis of the image content. */ - IRUT_LINE_SEGMENTS = 1 << 11, - /** Identified text zones, indicating areas with potential textual content. */ - IRUT_TEXT_ZONES = 1 << 12, - /** A binary image with text regions removed. */ - IRUT_TEXT_REMOVED_BINARY_IMAGE = 1 << 13, - /** Zones identified as potential barcode areas, aiding in focused barcode detection. */ - IRUT_CANDIDATE_BARCODE_ZONES = 1 << 14, - /** Barcodes that have been localized but not yet decoded. */ - IRUT_LOCALIZED_BARCODES = 1 << 15, - /** Barcode images scaled up for improved readability or decoding accuracy. */ - IRUT_SCALED_UP_BARCODE_IMAGE = 1 << 16, - /** Images of barcodes processed to resist deformation and improve decoding success. */ - IRUT_DEFORMATION_RESISTED_BARCODE_IMAGE = 1 << 17, - /** Barcode images that have been complemented. */ - IRUT_COMPLEMENTED_BARCODE_IMAGE = 1 << 18, - /** Successfully decoded barcodes. */ - IRUT_DECODED_BARCODES = 1 << 19, - /** Detected long lines. */ - IRUT_LONG_LINES = 1 << 20, - /** Detected corners within the image. */ - IRUT_CORNERS = 1 << 21, - /** Candidate edges identified as potential components of quadrilaterals. */ - IRUT_CANDIDATE_QUAD_EDGES = 1 << 22, - /** Successfully detected quadrilaterals. */ - IRUT_DETECTED_QUADS = 1 << 23, - /** Text lines that have been localized in preparation for recognition. */ - IRUT_LOCALIZED_TEXT_LINES = 1 << 24, - /** Successfully recognized text lines. */ - IRUT_RECOGNIZED_TEXT_LINES = 1 << 25, - /** Successfully normalized images. */ - IRUT_NORMALIZED_IMAGES = 1 << 26, - /** A mask to select all types of intermediate results. */ - IRUT_ALL = 0xFFFFFFF -}; -``` diff --git a/enums/core/intermediate-result-unit-type-v3.2.30.md b/enums/core/intermediate-result-unit-type-v3.2.30.md deleted file mode 100644 index 4a92edf..0000000 --- a/enums/core/intermediate-result-unit-type-v3.2.30.md +++ /dev/null @@ -1,349 +0,0 @@ ---- -layout: default-layout -title: IntermediateResultUnitType - Dynamsoft Core Enumerations -description: The enumeration IntermediateResultUnitType of Dynamsoft Core describes the type of the intermediate result unit. -keywords: Intermediate result unit type -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: IntermediateResultUnitType -codeAutoHeight: true ---- - -# Enumeration IntermediateResultUnitType - -`IntermediateResultUnitType` defines different types of intermediate results generated or expected to be generated during image processing. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - > -> -```javascript -enum EnumIntermediateResultUnitType { - /** No intermediate result. */ - IRUT_NULL = 0, - /** A full-color image. */ - IRUT_COLOUR_IMAGE = 1, - /** A color image that has been scaled down for efficiency. */ - IRUT_SCALED_DOWN_COLOUR_IMAGE = 1 << 1, - /** A grayscale image derived from the original input. */ - IRUT_GRAYSCALE_IMAGE = 1 << 2, - /** A grayscale image that has undergone transformation. */ - IRUT_TRANSOFORMED_GRAYSCALE_IMAGE = 1 << 3, - /** A grayscale image enhanced for further processing. */ - IRUT_ENHANCED_GRAYSCALE_IMAGE = 1 << 4, - /** Regions pre-detected as potentially relevant for further analysis. */ - IRUT_PREDETECTED_REGIONS = 1 << 5, - /** A binary (black and white) image. */ - IRUT_BINARY_IMAGE = 1 << 6, - /** Results from detecting textures within the image. */ - IRUT_TEXTURE_DETECTION_RESULT = 1 << 7, - /** A grayscale image with textures removed to enhance subject details like text or barcodes. */ - IRUT_TEXTURE_REMOVED_GRAYSCALE_IMAGE = 1 << 8, - /** A binary image with textures removed, useful for clear detection of subjects without background noise. */ - IRUT_TEXTURE_REMOVED_BINARY_IMAGE = 1 << 9, - /** Detected contours within the image, which can help in identifying shapes and objects. */ - IRUT_CONTOURS = 1 << 10, - /** Detected line segments, useful in structural analysis of the image content. */ - IRUT_LINE_SEGMENTS = 1 << 11, - /** Identified text zones, indicating areas with potential textual content. */ - IRUT_TEXT_ZONES = 1 << 12, - /** A binary image with text regions removed. */ - IRUT_TEXT_REMOVED_BINARY_IMAGE = 1 << 13, - /** Zones identified as potential barcode areas, aiding in focused barcode detection. */ - IRUT_CANDIDATE_BARCODE_ZONES = 1 << 14, - /** Barcodes that have been localized but not yet decoded. */ - IRUT_LOCALIZED_BARCODES = 1 << 15, - /** Barcode images scaled up for improved readability or decoding accuracy. */ - IRUT_SCALED_UP_BARCODE_IMAGE = 1 << 16, - /** Images of barcodes processed to resist deformation and improve decoding success. */ - IRUT_DEFORMATION_RESISTED_BARCODE_IMAGE = 1 << 17, - /** Barcode images that have been complemented. */ - IRUT_COMPLEMENTED_BARCODE_IMAGE = 1 << 18, - /** Successfully decoded barcodes. */ - IRUT_DECODED_BARCODES = 1 << 19, - /** Detected long lines. */ - IRUT_LONG_LINES = 1 << 20, - /** Detected corners within the image. */ - IRUT_CORNERS = 1 << 21, - /** Candidate edges identified as potential components of quadrilaterals. */ - IRUT_CANDIDATE_QUAD_EDGES = 1 << 22, - /** Successfully detected quadrilaterals. */ - IRUT_DETECTED_QUADS = 1 << 23, - /** Text lines that have been localized in preparation for recognition. */ - IRUT_LOCALIZED_TEXT_LINES = 1 << 24, - /** Successfully recognized text lines. */ - IRUT_RECOGNIZED_TEXT_LINES = 1 << 25, - /** Successfully normalized images. */ - IRUT_NORMALIZED_IMAGES = 1 << 26, - /**Detected short lines.*/ - IRUT_SHORT_LINES = 1 << 27, - /** A mask to select all types of intermediate results. */ - IRUT_ALL = 0xFFFFFFF -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumIntermediateResultUnitType { - /** No intermediate result. */ - long IRUT_NULL = 0L; - /** A full-color image. */ - long IRUT_COLOUR_IMAGE = 1L; - /** A color image that has been scaled down for efficiency. */ - long IRUT_SCALED_DOWN_COLOUR_IMAGE = 1L << 1; - /** A grayscale image derived from the original input. */ - long IRUT_GRAYSCALE_IMAGE = 1L << 2; - /** A grayscale image that has undergone transformation. */ - long IRUT_TRANSOFORMED_GRAYSCALE_IMAGE = 1L << 3; - /** A grayscale image enhanced for further processing. */ - long IRUT_ENHANCED_GRAYSCALE_IMAGE = 1L << 4; - /** Regions pre-detected as potentially relevant for further analysis. */ - long IRUT_PREDETECTED_REGIONS = 1L << 5; - /** A binary (black and white) image. */ - long IRUT_BINARY_IMAGE = 1L << 6; - /** Results from detecting textures within the image. */ - long IRUT_TEXTURE_DETECTION_RESULT = 1L << 7; - /** A grayscale image with textures removed to enhance subject details like text or barcodes. */ - long IRUT_TEXTURE_REMOVED_GRAYSCALE_IMAGE = 1L << 8; - /** A binary image with textures removed, useful for clear detection of subjects without background noise. */ - long IRUT_TEXTURE_REMOVED_BINARY_IMAGE = 1L << 9; - /** Detected contours within the image, which can help in identifying shapes and objects. */ - long IRUT_CONTOURS = 1L << 10; - /** Detected line segments, useful in structural analysis of the image content. */ - long IRUT_LINE_SEGMENTS = 1L << 11; - /** Identified text zones, indicating areas with potential textual content. */ - long IRUT_TEXT_ZONES = 1L << 12; - /** A binary image with text regions removed. */ - long IRUT_TEXT_REMOVED_BINARY_IMAGE = 1L << 13; - /** Zones identified as potential barcode areas, aiding in focused barcode detection. */ - long IRUT_CANDIDATE_BARCODE_ZONES = 1L << 14; - /** Barcodes that have been localized but not yet decoded. */ - long IRUT_LOCALIZED_BARCODES = 1L << 15; - /** Barcode images scaled up for improved readability or decoding accuracy. */ - long IRUT_SCALED_UP_BARCODE_IMAGE = 1L << 16; - /** Images of barcodes processed to resist deformation and improve decoding success. */ - long IRUT_DEFORMATION_RESISTED_BARCODE_IMAGE = 1L << 17; - /** Barcode images that have been complemented. */ - long IRUT_COMPLEMENTED_BARCODE_IMAGE = 1L << 18; - /** Successfully decoded barcodes. */ - long IRUT_DECODED_BARCODES = 1L << 19; - /** Detected long lines. */ - long IRUT_LONG_LINES = 1L << 20; - /** Detected corners within the image. */ - long IRUT_CORNERS = 1L << 21; - /** Candidate edges identified as potential components of quadrilaterals. */ - long IRUT_CANDIDATE_QUAD_EDGES = 1L << 22; - /** Successfully detected quadrilaterals. */ - long IRUT_DETECTED_QUADS = 1L << 23; - /** Text lines that have been localized in preparation for recognition. */ - long IRUT_LOCALIZED_TEXT_LINES = 1L << 24; - /** Successfully recognized text lines. */ - long IRUT_RECOGNIZED_TEXT_LINES = 1L << 25; - /** Successfully normalized images. */ - long IRUT_NORMALIZED_IMAGES = 1L << 26; - /** Detected short lines. */ - long IRUT_SHORT_LINES = 1L << 27; - /** A mask to select all types of intermediate results. */ - long IRUT_ALL = 0xFFFFFFFL; -} -``` -> -```objc -typedef NS_OPTIONS(NSUInteger, DSIntermediateResultUnitType) { - /** No intermediate result. */ - DSIntermediateResultUnitTypeNull = 0, - /** A full-color image. */ - DSIntermediateResultUnitTypeColourImage = 1, - /** A color image that has been scaled down for efficiency. */ - DSIntermediateResultUnitTypeScaledDownColourImage = 1 << 1, - /** A grayscale image derived from the original input. */ - DSIntermediateResultUnitTypeGrayscaleImage = 1 << 2, - /** A grayscale image that has undergone transformation. */ - DSIntermediateResultUnitTypeTransformedGrayscaleImage = 1 << 3, - /** A grayscale image enhanced for further processing. */ - DSIntermediateResultUnitTypeEnhancedGrayscaleImage = 1 << 4, - /** Regions pre-detected as potentially relevant for further analysis. */ - DSIntermediateResultUnitTypePredetectedRegions = 1 << 5, - /** A binary (black and white) image. */ - DSIntermediateResultUnitTypeBinaryImage = 1 << 6, - /** Results from detecting textures within the image. */ - DSIntermediateResultUnitTypeTextureDetectionResult = 1 << 7, - /** A grayscale image with textures removed to enhance subject details like text or barcodes. */ - DSIntermediateResultUnitTypeTextureRemovedGrayscaleImage = 1 << 8, - /** A binary image with textures removed, useful for clear detection of subjects without background noise. */ - DSIntermediateResultUnitTypeTextureRemovedBinaryImage = 1 << 9, - /** Detected contours within the image, which can help in identifying shapes and objects. */ - DSIntermediateResultUnitTypeContours = 1 << 10, - /** Detected line segments, useful in structural analysis of the image content. */ - DSIntermediateResultUnitTypeLineSegments = 1 << 11, - /** Identified text zones, indicating areas with potential textual content. */ - DSIntermediateResultUnitTypeTextZones = 1 << 12, - /** A binary image with text regions removed. */ - DSIntermediateResultUnitTypeTextRemovedBinaryImage = 1 << 13, - /** Zones identified as potential barcode areas, aiding in focused barcode detection. */ - DSIntermediateResultUnitTypeCandidateBarcodeZones = 1 << 14, - /** Barcodes that have been localized but not yet decoded. */ - DSIntermediateResultUnitTypeLocalizedBarcodes = 1 << 15, - /** Barcode images scaled up for improved readability or decoding accuracy. */ - DSIntermediateResultUnitTypeScaledUpBarcodeImage = 1 << 16, - /** Images of barcodes processed to resist deformation and improve decoding success. */ - DSIntermediateResultUnitTypeDeformationResistedBarcodeImage = 1 << 17, - /** Barcode images that have been complemented. */ - DSIntermediateResultUnitTypeComplementedBarcodeImage = 1 << 18, - /** Successfully decoded barcodes. */ - DSIntermediateResultUnitTypeDecodedBarcodes = 1 << 19, - /** Detected long lines. */ - DSIntermediateResultUnitTypeLongLines = 1 << 20, - /** Detected corners within the image. */ - DSIntermediateResultUnitTypeCorners = 1 << 21, - /** Candidate edges identified as potential components of quadrilaterals. */ - DSIntermediateResultUnitTypeCandidateQuadEdges = 1 << 22, - /** Successfully detected quadrilaterals. */ - DSIntermediateResultUnitTypeDetectedQuads = 1 << 23, - /** Text lines that have been localized in preparation for recognition. */ - DSIntermediateResultUnitTypeLocalizedTextLines = 1 << 24, - /** Successfully recognized text lines. */ - DSIntermediateResultUnitTypeRecognizedTextLines = 1 << 25, - /** Successfully normalized images. */ - DSIntermediateResultUnitTypeNormalizedImages = 1 << 26, - /** Detected short lines. */ - DSIntermediateResultUnitTypeShortLines = 1 << 27, - /** A mask to select all types of intermediate results. */ - DSIntermediateResultUnitTypeAll = 0xFFFFFFF -}; -``` -> -```swift -public enum IntermediateResultUnitType: Int { - /** No intermediate result. */ - case null = 0 - /** A full-color image. */ - case colourImage = 1 - /** A color image that has been scaled down for efficiency. */ - case scaledDownColourImage = 1 << 1 - /** A grayscale image derived from the original input. */ - case grayscaleImage = 1 << 2 - /** A grayscale image that has undergone transformation. */ - case transformedGrayscaleImage = 1 << 3 - /** A grayscale image enhanced for further processing. */ - case enhancedGrayscaleImage = 1 << 4 - /** Regions pre-detected as potentially relevant for further analysis. */ - case predetectedRegions = 1 << 5 - /** A binary (black and white) image. */ - case binaryImage = 1 << 6 - /** Results from detecting textures within the image. */ - case textureDetectionResult = 1 << 7 - /** A grayscale image with textures removed to enhance subject details like text or barcodes. */ - case textureRemovedGrayscaleImage = 1 << 8 - /** A binary image with textures removed, useful for clear detection of subjects without background noise. */ - case textureRemovedBinaryImage = 1 << 9 - /** Detected contours within the image, which can help in identifying shapes and objects. */ - case contours = 1 << 10 - /** Detected line segments, useful in structural analysis of the image content. */ - case lineSegments = 1 << 11 - /** Identified text zones, indicating areas with potential textual content. */ - case textZones = 1 << 12 - /** A binary image with text regions removed. */ - case textRemovedBinaryImage = 1 << 13 - /** Zones identified as potential barcode areas, aiding in focused barcode detection. */ - case candidateBarcodeZones = 1 << 14 - /** Barcodes that have been localized but not yet decoded. */ - case localizedBarcodes = 1 << 15 - /** Barcode images scaled up for improved readability or decoding accuracy. */ - case scaledUpBarcodeImage = 1 << 16 - /** Images of barcodes processed to resist deformation and improve decoding success. */ - case deformationResistedBarcodeImage = 1 << 17 - /** Barcode images that have been complemented. */ - case complementedBarcodeImage = 1 << 18 - /** Successfully decoded barcodes. */ - case decodedBarcodes = 1 << 19 - /** Detected long lines. */ - case longLines = 1 << 20 - /** Detected corners within the image. */ - case corners = 1 << 21 - /** Candidate edges identified as potential components of quadrilaterals. */ - case candidateQuadEdges = 1 << 22 - /** Successfully detected quadrilaterals. */ - case detectedQuads = 1 << 23 - /** Text lines that have been localized in preparation for recognition. */ - case localizedTextLines = 1 << 24 - /** Successfully recognized text lines. */ - case recognizedTextLines = 1 << 25 - /** Successfully normalized images. */ - case normalizedImages = 1 << 26 - /** Detected short lines. */ - case shortLines = 1 << 27 - /** A mask to select all types of intermediate results. */ - case all = 0xFFFFFFF -} -``` -> -```cpp -enum IntermediateResultUnitType : unsigned long long { - /** No intermediate result. */ - IRUT_NULL = 0, - /** A full-color image. */ - IRUT_COLOUR_IMAGE = 1, - /** A color image that has been scaled down for efficiency. */ - IRUT_SCALED_DOWN_COLOUR_IMAGE = 1 << 1, - /** A grayscale image derived from the original input. */ - IRUT_GRAYSCALE_IMAGE = 1 << 2, - /** A grayscale image that has undergone transformation. */ - IRUT_TRANSFORMED_GRAYSCALE_IMAGE = 1 << 3, - /** A grayscale image enhanced for further processing. */ - IRUT_ENHANCED_GRAYSCALE_IMAGE = 1 << 4, - /** Regions pre-detected as potentially relevant for further analysis. */ - IRUT_PREDETECTED_REGIONS = 1 << 5, - /** A binary (black and white) image. */ - IRUT_BINARY_IMAGE = 1 << 6, - /** Results from detecting textures within the image. */ - IRUT_TEXTURE_DETECTION_RESULT = 1 << 7, - /** A grayscale image with textures removed to enhance subject details like text or barcodes. */ - IRUT_TEXTURE_REMOVED_GRAYSCALE_IMAGE = 1 << 8, - /** A binary image with textures removed, useful for clear detection of subjects without background noise. */ - IRUT_TEXTURE_REMOVED_BINARY_IMAGE = 1 << 9, - /** Detected contours within the image, which can help in identifying shapes and objects. */ - IRUT_CONTOURS = 1 << 10, - /** Detected line segments, useful in structural analysis of the image content. */ - IRUT_LINE_SEGMENTS = 1 << 11, - /** Identified text zones, indicating areas with potential textual content. */ - IRUT_TEXT_ZONES = 1 << 12, - /** A binary image with text regions removed. */ - IRUT_TEXT_REMOVED_BINARY_IMAGE = 1 << 13, - /** Zones identified as potential barcode areas, aiding in focused barcode detection. */ - IRUT_CANDIDATE_BARCODE_ZONES = 1 << 14, - /** Barcodes that have been localized but not yet decoded. */ - IRUT_LOCALIZED_BARCODES = 1 << 15, - /** Barcode images scaled up for improved readability or decoding accuracy. */ - IRUT_SCALED_UP_BARCODE_IMAGE = 1 << 16, - /** Images of barcodes processed to resist deformation and improve decoding success. */ - IRUT_DEFORMATION_RESISTED_BARCODE_IMAGE = 1 << 17, - /** Barcode images that have been complemented. */ - IRUT_COMPLEMENTED_BARCODE_IMAGE = 1 << 18, - /** Successfully decoded barcodes. */ - IRUT_DECODED_BARCODES = 1 << 19, - /** Detected long lines. */ - IRUT_LONG_LINES = 1 << 20, - /** Detected corners within the image. */ - IRUT_CORNERS = 1 << 21, - /** Candidate edges identified as potential components of quadrilaterals. */ - IRUT_CANDIDATE_QUAD_EDGES = 1 << 22, - /** Successfully detected quadrilaterals. */ - IRUT_DETECTED_QUADS = 1 << 23, - /** Text lines that have been localized in preparation for recognition. */ - IRUT_LOCALIZED_TEXT_LINES = 1 << 24, - /** Successfully recognized text lines. */ - IRUT_RECOGNIZED_TEXT_LINES = 1 << 25, - /** Successfully normalized images. */ - IRUT_NORMALIZED_IMAGES = 1 << 26, - /** Detected short lines. */ - IRUT_SHORT_LINES = 1 << 27, - /** A mask to select all types of intermediate results. */ - IRUT_ALL = 0xFFFFFFF -}; -``` diff --git a/enums/core/intermediate-result-unit-type.md b/enums/core/intermediate-result-unit-type.md deleted file mode 100644 index 3d0beb5..0000000 --- a/enums/core/intermediate-result-unit-type.md +++ /dev/null @@ -1,370 +0,0 @@ ---- -layout: default-layout -title: IntermediateResultUnitType - Dynamsoft Core Enumerations -description: The enumeration IntermediateResultUnitType of Dynamsoft Core describes the type of the intermediate result unit. -keywords: Intermediate result unit type -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: IntermediateResultUnitType -codeAutoHeight: true ---- - -# Enumeration IntermediateResultUnitType - -`IntermediateResultUnitType` defines different types of intermediate results generated or expected to be generated during image processing. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - > -> -```javascript -enum EnumIntermediateResultUnitType { - /** No intermediate result. */ - IRUT_NULL = 0, - /** A full-color image. */ - IRUT_COLOUR_IMAGE = 1, - /** A color image that has been scaled down for efficiency. */ - IRUT_SCALED_DOWN_COLOUR_IMAGE = 1 << 1, - /** A grayscale image derived from the original input. */ - IRUT_GRAYSCALE_IMAGE = 1 << 2, - /** A grayscale image that has undergone transformation. */ - IRUT_TRANSOFORMED_GRAYSCALE_IMAGE = 1 << 3, - /** A grayscale image enhanced for further processing. */ - IRUT_ENHANCED_GRAYSCALE_IMAGE = 1 << 4, - /** Regions pre-detected as potentially relevant for further analysis. */ - IRUT_PREDETECTED_REGIONS = 1 << 5, - /** A binary (black and white) image. */ - IRUT_BINARY_IMAGE = 1 << 6, - /** Results from detecting textures within the image. */ - IRUT_TEXTURE_DETECTION_RESULT = 1 << 7, - /** A grayscale image with textures removed to enhance subject details like text or barcodes. */ - IRUT_TEXTURE_REMOVED_GRAYSCALE_IMAGE = 1 << 8, - /** A binary image with textures removed, useful for clear detection of subjects without background noise. */ - IRUT_TEXTURE_REMOVED_BINARY_IMAGE = 1 << 9, - /** Detected contours within the image, which can help in identifying shapes and objects. */ - IRUT_CONTOURS = 1 << 10, - /** Detected line segments, useful in structural analysis of the image content. */ - IRUT_LINE_SEGMENTS = 1 << 11, - /** Identified text zones, indicating areas with potential textual content. */ - IRUT_TEXT_ZONES = 1 << 12, - /** A binary image with text regions removed. */ - IRUT_TEXT_REMOVED_BINARY_IMAGE = 1 << 13, - /** Zones identified as potential barcode areas, aiding in focused barcode detection. */ - IRUT_CANDIDATE_BARCODE_ZONES = 1 << 14, - /** Barcodes that have been localized but not yet decoded. */ - IRUT_LOCALIZED_BARCODES = 1 << 15, - /** Barcode images scaled up for improved readability or decoding accuracy. */ - IRUT_SCALED_UP_BARCODE_IMAGE = 1 << 16, - /** Images of barcodes processed to resist deformation and improve decoding success. */ - IRUT_DEFORMATION_RESISTED_BARCODE_IMAGE = 1 << 17, - /** Barcode images that have been complemented. */ - IRUT_COMPLEMENTED_BARCODE_IMAGE = 1 << 18, - /** Successfully decoded barcodes. */ - IRUT_DECODED_BARCODES = 1 << 19, - /** Detected long lines. */ - IRUT_LONG_LINES = 1 << 20, - /** Detected corners within the image. */ - IRUT_CORNERS = 1 << 21, - /** Candidate edges identified as potential components of quadrilaterals. */ - IRUT_CANDIDATE_QUAD_EDGES = 1 << 22, - /** Successfully detected quadrilaterals. */ - IRUT_DETECTED_QUADS = 1 << 23, - /** Text lines that have been localized in preparation for recognition. */ - IRUT_LOCALIZED_TEXT_LINES = 1 << 24, - /** Successfully recognized text lines. */ - IRUT_RECOGNIZED_TEXT_LINES = 1 << 25, - /** Successfully normalized images. */ - IRUT_NORMALIZED_IMAGES = 1 << 26, - /**Detected short lines.*/ - IRUT_SHORT_LINES = 1 << 27, - /**grouped lines of text.*/ - IRUT_TEXT_LINE_GROUPS = 1 << 28, - /** Detected logic lines. */ - IRUT_LOGIC_LINES = 1 << 29, - /** A mask to select all types of intermediate results. */ - IRUT_ALL = 0xFFFFFFFFFFFFFFFF -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumIntermediateResultUnitType { - /** No intermediate result. */ - long IRUT_NULL = 0L; - /** A full-color image. */ - long IRUT_COLOUR_IMAGE = 1L; - /** A color image that has been scaled down for efficiency. */ - long IRUT_SCALED_DOWN_COLOUR_IMAGE = 1L << 1; - /** A grayscale image derived from the original input. */ - long IRUT_GRAYSCALE_IMAGE = 1L << 2; - /** A grayscale image that has undergone transformation. */ - long IRUT_TRANSOFORMED_GRAYSCALE_IMAGE = 1L << 3; - /** A grayscale image enhanced for further processing. */ - long IRUT_ENHANCED_GRAYSCALE_IMAGE = 1L << 4; - /** Regions pre-detected as potentially relevant for further analysis. */ - long IRUT_PREDETECTED_REGIONS = 1L << 5; - /** A binary (black and white) image. */ - long IRUT_BINARY_IMAGE = 1L << 6; - /** Results from detecting textures within the image. */ - long IRUT_TEXTURE_DETECTION_RESULT = 1L << 7; - /** A grayscale image with textures removed to enhance subject details like text or barcodes. */ - long IRUT_TEXTURE_REMOVED_GRAYSCALE_IMAGE = 1L << 8; - /** A binary image with textures removed, useful for clear detection of subjects without background noise. */ - long IRUT_TEXTURE_REMOVED_BINARY_IMAGE = 1L << 9; - /** Detected contours within the image, which can help in identifying shapes and objects. */ - long IRUT_CONTOURS = 1L << 10; - /** Detected line segments, useful in structural analysis of the image content. */ - long IRUT_LINE_SEGMENTS = 1L << 11; - /** Identified text zones, indicating areas with potential textual content. */ - long IRUT_TEXT_ZONES = 1L << 12; - /** A binary image with text regions removed. */ - long IRUT_TEXT_REMOVED_BINARY_IMAGE = 1L << 13; - /** Zones identified as potential barcode areas, aiding in focused barcode detection. */ - long IRUT_CANDIDATE_BARCODE_ZONES = 1L << 14; - /** Barcodes that have been localized but not yet decoded. */ - long IRUT_LOCALIZED_BARCODES = 1L << 15; - /** Barcode images scaled up for improved readability or decoding accuracy. */ - long IRUT_SCALED_UP_BARCODE_IMAGE = 1L << 16; - /** Images of barcodes processed to resist deformation and improve decoding success. */ - long IRUT_DEFORMATION_RESISTED_BARCODE_IMAGE = 1L << 17; - /** Barcode images that have been complemented. */ - long IRUT_COMPLEMENTED_BARCODE_IMAGE = 1L << 18; - /** Successfully decoded barcodes. */ - long IRUT_DECODED_BARCODES = 1L << 19; - /** Detected long lines. */ - long IRUT_LONG_LINES = 1L << 20; - /** Detected corners within the image. */ - long IRUT_CORNERS = 1L << 21; - /** Candidate edges identified as potential components of quadrilaterals. */ - long IRUT_CANDIDATE_QUAD_EDGES = 1L << 22; - /** Successfully detected quadrilaterals. */ - long IRUT_DETECTED_QUADS = 1L << 23; - /** Text lines that have been localized in preparation for recognition. */ - long IRUT_LOCALIZED_TEXT_LINES = 1L << 24; - /** Successfully recognized text lines. */ - long IRUT_RECOGNIZED_TEXT_LINES = 1L << 25; - /** Successfully normalized images. */ - long IRUT_NORMALIZED_IMAGES = 1L << 26; - /** Detected short lines. */ - long IRUT_SHORT_LINES = 1L << 27; - /** Recognized raw text lines. */ - public static final long IRUT_RAW_TEXT_LINES = 1L << 28; - /**Detected logic lines.*/ - public static final long IRUT_LOGIC_LINES = 1L << 29; - /** A mask to select all types of intermediate results. */ - long IRUT_ALL = 0xFFFFFFFFFFFFFFFF; -} -``` -> -```objc -typedef NS_OPTIONS(NSUInteger, DSIntermediateResultUnitType) { - /** No intermediate result. */ - DSIntermediateResultUnitTypeNull = 0, - /** A full-color image. */ - DSIntermediateResultUnitTypeColourImage = 1, - /** A color image that has been scaled down for efficiency. */ - DSIntermediateResultUnitTypeScaledDownColourImage = 1 << 1, - /** A grayscale image derived from the original input. */ - DSIntermediateResultUnitTypeGrayscaleImage = 1 << 2, - /** A grayscale image that has undergone transformation. */ - DSIntermediateResultUnitTypeTransformedGrayscaleImage = 1 << 3, - /** A grayscale image enhanced for further processing. */ - DSIntermediateResultUnitTypeEnhancedGrayscaleImage = 1 << 4, - /** Regions pre-detected as potentially relevant for further analysis. */ - DSIntermediateResultUnitTypePredetectedRegions = 1 << 5, - /** A binary (black and white) image. */ - DSIntermediateResultUnitTypeBinaryImage = 1 << 6, - /** Results from detecting textures within the image. */ - DSIntermediateResultUnitTypeTextureDetectionResult = 1 << 7, - /** A grayscale image with textures removed to enhance subject details like text or barcodes. */ - DSIntermediateResultUnitTypeTextureRemovedGrayscaleImage = 1 << 8, - /** A binary image with textures removed, useful for clear detection of subjects without background noise. */ - DSIntermediateResultUnitTypeTextureRemovedBinaryImage = 1 << 9, - /** Detected contours within the image, which can help in identifying shapes and objects. */ - DSIntermediateResultUnitTypeContours = 1 << 10, - /** Detected line segments, useful in structural analysis of the image content. */ - DSIntermediateResultUnitTypeLineSegments = 1 << 11, - /** Identified text zones, indicating areas with potential textual content. */ - DSIntermediateResultUnitTypeTextZones = 1 << 12, - /** A binary image with text regions removed. */ - DSIntermediateResultUnitTypeTextRemovedBinaryImage = 1 << 13, - /** Zones identified as potential barcode areas, aiding in focused barcode detection. */ - DSIntermediateResultUnitTypeCandidateBarcodeZones = 1 << 14, - /** Barcodes that have been localized but not yet decoded. */ - DSIntermediateResultUnitTypeLocalizedBarcodes = 1 << 15, - /** Barcode images scaled up for improved readability or decoding accuracy. */ - DSIntermediateResultUnitTypeScaledUpBarcodeImage = 1 << 16, - /** Images of barcodes processed to resist deformation and improve decoding success. */ - DSIntermediateResultUnitTypeDeformationResistedBarcodeImage = 1 << 17, - /** Barcode images that have been complemented. */ - DSIntermediateResultUnitTypeComplementedBarcodeImage = 1 << 18, - /** Successfully decoded barcodes. */ - DSIntermediateResultUnitTypeDecodedBarcodes = 1 << 19, - /** Detected long lines. */ - DSIntermediateResultUnitTypeLongLines = 1 << 20, - /** Detected corners within the image. */ - DSIntermediateResultUnitTypeCorners = 1 << 21, - /** Candidate edges identified as potential components of quadrilaterals. */ - DSIntermediateResultUnitTypeCandidateQuadEdges = 1 << 22, - /** Successfully detected quadrilaterals. */ - DSIntermediateResultUnitTypeDetectedQuads = 1 << 23, - /** Text lines that have been localized in preparation for recognition. */ - DSIntermediateResultUnitTypeLocalizedTextLines = 1 << 24, - /** Successfully recognized text lines. */ - DSIntermediateResultUnitTypeRecognizedTextLines = 1 << 25, - /** Successfully normalized images. */ - DSIntermediateResultUnitTypeNormalizedImages = 1 << 26, - /** Detected short lines. */ - DSIntermediateResultUnitTypeShortLines = 1 << 27, - /** Recognized raw text lines. */ - DSIntermediateResultUnitTypeRawTextLines = 1 << 28, - /**Detected logic lines.*/ - DSIntermediateResultUnitTypeLogicLines = 1 << 29, - /** A mask to select all types of intermediate results. */ - DSIntermediateResultUnitTypeAll = 0xFFFFFFFFFFFFFFFF -}; -``` -> -```swift -public enum IntermediateResultUnitType: Int { - /** No intermediate result. */ - case null = 0 - /** A full-color image. */ - case colourImage = 1 - /** A color image that has been scaled down for efficiency. */ - case scaledDownColourImage = 1 << 1 - /** A grayscale image derived from the original input. */ - case grayscaleImage = 1 << 2 - /** A grayscale image that has undergone transformation. */ - case transformedGrayscaleImage = 1 << 3 - /** A grayscale image enhanced for further processing. */ - case enhancedGrayscaleImage = 1 << 4 - /** Regions pre-detected as potentially relevant for further analysis. */ - case predetectedRegions = 1 << 5 - /** A binary (black and white) image. */ - case binaryImage = 1 << 6 - /** Results from detecting textures within the image. */ - case textureDetectionResult = 1 << 7 - /** A grayscale image with textures removed to enhance subject details like text or barcodes. */ - case textureRemovedGrayscaleImage = 1 << 8 - /** A binary image with textures removed, useful for clear detection of subjects without background noise. */ - case textureRemovedBinaryImage = 1 << 9 - /** Detected contours within the image, which can help in identifying shapes and objects. */ - case contours = 1 << 10 - /** Detected line segments, useful in structural analysis of the image content. */ - case lineSegments = 1 << 11 - /** Identified text zones, indicating areas with potential textual content. */ - case textZones = 1 << 12 - /** A binary image with text regions removed. */ - case textRemovedBinaryImage = 1 << 13 - /** Zones identified as potential barcode areas, aiding in focused barcode detection. */ - case candidateBarcodeZones = 1 << 14 - /** Barcodes that have been localized but not yet decoded. */ - case localizedBarcodes = 1 << 15 - /** Barcode images scaled up for improved readability or decoding accuracy. */ - case scaledUpBarcodeImage = 1 << 16 - /** Images of barcodes processed to resist deformation and improve decoding success. */ - case deformationResistedBarcodeImage = 1 << 17 - /** Barcode images that have been complemented. */ - case complementedBarcodeImage = 1 << 18 - /** Successfully decoded barcodes. */ - case decodedBarcodes = 1 << 19 - /** Detected long lines. */ - case longLines = 1 << 20 - /** Detected corners within the image. */ - case corners = 1 << 21 - /** Candidate edges identified as potential components of quadrilaterals. */ - case candidateQuadEdges = 1 << 22 - /** Successfully detected quadrilaterals. */ - case detectedQuads = 1 << 23 - /** Text lines that have been localized in preparation for recognition. */ - case localizedTextLines = 1 << 24 - /** Successfully recognized text lines. */ - case recognizedTextLines = 1 << 25 - /** Successfully normalized images. */ - case normalizedImages = 1 << 26 - /** Detected short lines. */ - case shortLines = 1 << 27 - /** Recognized raw text lines. */ - rawTextLines = 1 << 28 - /**Detected logic lines.*/ - logicLines = 1 << 29 - /** A mask to select all types of intermediate results. */ - case all = 0xFFFFFFFFFFFFFFFF -} -``` -> -```cpp -enum IntermediateResultUnitType : unsigned long long -{ - /**No IntermediateResult type is specified.*/ - IRUT_NULL = 0, - /**The type of the IntermediateResult is "colour image".*/ - IRUT_COLOUR_IMAGE = 1, - /**The type of the IntermediateResult is "scaled down colour image".*/ - IRUT_SCALED_DOWN_COLOUR_IMAGE = 1 << 1, - /**The type of the IntermediateResult is "grayscale image".*/ - IRUT_GRAYSCALE_IMAGE = 1 << 2, - /**The type of the IntermediateResult is "transformed grayscale image".*/ - IRUT_TRANSFORMED_GRAYSCALE_IMAGE = 1 << 3, - /**The type of the IntermediateResult is "enhanced grayscale image".*/ - IRUT_ENHANCED_GRAYSCALE_IMAGE = 1 << 4, - /**The type of the IntermediateResult is "predected regions".*/ - IRUT_PREDETECTED_REGIONS = 1 << 5, - /**The type of the IntermediateResult is "binary image".*/ - IRUT_BINARY_IMAGE = 1 << 6, - /**The type of the IntermediateResult is "texture detection result".*/ - IRUT_TEXTURE_DETECTION_RESULT = 1 << 7, - /**The type of the IntermediateResult is "texture removed grayscale image".*/ - IRUT_TEXTURE_REMOVED_GRAYSCALE_IMAGE = 1 << 8, - /**The type of the IntermediateResult is "texture removed binary image".*/ - IRUT_TEXTURE_REMOVED_BINARY_IMAGE = 1 << 9, - /**The type of the IntermediateResult is "contours".*/ - IRUT_CONTOURS = 1 << 10, - /**The type of the IntermediateResult is "line segments".*/ - IRUT_LINE_SEGMENTS = 1 << 11, - /**The type of the IntermediateResult is "text zones".*/ - IRUT_TEXT_ZONES = 1 << 12, - /**The type of the IntermediateResult is "text removed binary image".*/ - IRUT_TEXT_REMOVED_BINARY_IMAGE = 1 << 13, - /**The type of the IntermediateResult is "candidate barcode zones".*/ - IRUT_CANDIDATE_BARCODE_ZONES = 1 << 14, - /**The type of the IntermediateResult is "localized barcodes".*/ - IRUT_LOCALIZED_BARCODES = 1 << 15, - /**The type of the IntermediateResult is "scaled up barcode image".*/ - IRUT_SCALED_UP_BARCODE_IMAGE = 1 << 16, - /**The type of the IntermediateResult is "deformation resisted barcode image".*/ - IRUT_DEFORMATION_RESISTED_BARCODE_IMAGE = 1 << 17, - /**The type of the IntermediateResult is "complemented barcode image".*/ - IRUT_COMPLEMENTED_BARCODE_IMAGE = 1 << 18, - /**The type of the IntermediateResult is "decoded barcodes".*/ - IRUT_DECODED_BARCODES = 1 << 19, - /**The type of the IntermediateResult is "long lines".*/ - IRUT_LONG_LINES = 1 << 20, - /**The type of the IntermediateResult is "corners".*/ - IRUT_CORNERS = 1 << 21, - /**The type of the IntermediateResult is "candidate quad edges".*/ - IRUT_CANDIDATE_QUAD_EDGES = 1 << 22, - /**The type of the IntermediateResult is "detected quads".*/ - IRUT_DETECTED_QUADS = 1 << 23, - /**The type of the IntermediateResult is "localized text lines".*/ - IRUT_LOCALIZED_TEXT_LINES = 1 << 24, - /**The type of the IntermediateResult is "recognized text lines".*/ - IRUT_RECOGNIZED_TEXT_LINES = 1 << 25, - /**The type of the IntermediateResult is "normalized image".*/ - IRUT_NORMALIZED_IMAGES = 1 << 26, - /**The type of the IntermediateResult is "short lines".*/ - IRUT_SHORT_LINES = 1 << 27, - /**The type of the IntermediateResult is "text line groups".*/ - IRUT_RAW_TEXT_LINES = 1LL << 28, - /**Detected logic lines.*/ - IRUT_LOGIC_LINES = 1LL << 29, - /**The type of the IntermediateResult is "all".*/ - IRUT_ALL = 0xFFFFFFFFFFFFFFFF -}; -``` diff --git a/enums/core/log-mode.md b/enums/core/log-mode.md deleted file mode 100644 index 58ee997..0000000 --- a/enums/core/log-mode.md +++ /dev/null @@ -1,57 +0,0 @@ ---- -layout: default-layout -title: LogMode - Dynamsoft Core Enumerations -description: The enumeration LogMode of Dynamsoft Core describes the logging mode of the library. -keywords: logging mode -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: LogMode -codeAutoHeight: true ---- - -# Enumeration LogMode - -`LogMode` describes the logging modes. - -
    - >- Android - >- Objective-C - >- Swift - > -> -```java -public @interface EnumLogMode -{ - public static final int LGM_CONSOLE = 1; - public static final int LGM_FILE = 2; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSLogMode) -{ - /** - * Output the log information in the console. - */ - DSLogModeConsole = 1, - /** - * Output the log information to a log file. - */ - DSLogModeFile = 2, -}; -``` -> -```swift -public enum LogMode : Int -{ - /** - * Output the log information in the console. - */ - console = 0x01 - /** - * Output the log information to a log file. - */ - file = 0x02 -}; -``` diff --git a/enums/core/pdf-reading-mode.md b/enums/core/pdf-reading-mode.md deleted file mode 100644 index 5c33878..0000000 --- a/enums/core/pdf-reading-mode.md +++ /dev/null @@ -1,122 +0,0 @@ ---- -layout: default-layout -title: PDFReadingMode - Dynamsoft Core Enumerations -description: The enumeration PDFReadingMode of Dynamsoft Core describes all available PDF reading modes. -keywords: PDF Reading Mode -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: PDFReadingMode -codeAutoHeight: true ---- - -# Enumeration PDFReadingMode - -`PDFReadingMode` describes the PDF reading modes. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - >- C# - >- Python - > -> -```javascript -enum EnumPDFReadingMode -{ - /** Outputs vector data found in the PDFs.*/ - PDFRM_VECTOR = 1, - /** The default value. - * Outputs raster data found in the PDFs. - * Depending on the argument Resolution, - * the SDK may rasterize the PDF pages. - * Check the template for available argument settings.*/ - PDFRM_RASTER = 2, - /** Reserved setting for PDF reading mode.*/ - PDFRM_REV = -2147483648 -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumPDFReadingMode -{ - /** Capture content from vector data in PDF file. */ - public static final int PDFRM_VECTOR = 1; - /** The default value. - * Outputs raster data found in the PDFs. - * Depending on the argument Resolution, the SDK may rasterize the PDF pages. - * Check the template for available argument settings. */ - public static final int PDFRM_RASTER = 2; - /** Reserved setting for PDF reading mode.*/ - public static final int PDFRM_REV = -2147483648; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSPDFReadingMode) -{ - /** Capture content from vector data in PDF file. */ - DSPDFReadingModeVector = 0x01, - /** The default value. - * Outputs raster data found in the PDFs. - * Depending on the argument Resolution, the SDK may rasterize the PDF pages. - * Check the template for available argument settings. */ - DSPDFReadingModeRaster = 0x02, - /** Reserved setting for PDF reading mode.*/ - DSPDFReadingModeRev = -2147483648 -}; -``` -> -```swift -public enum PDFReadingMode : Int -{ - /** Capture content from vector data in PDF file. */ - vector = 0x01, - /** The default value. - * Outputs raster data found in the PDFs. - * Depending on the argument Resolution, the SDK may rasterize the PDF pages. - * Check the template for available argument settings. */ - raster = 0x02, - /** Reserved setting for PDF reading mode.*/ - rev = -2147483648 -}; -``` -> -```cpp -typedef enum PDFReadingMode -{ - /** Outputs vector data found in the PDFs. */ - PDFRM_VECTOR = 0x01, - /** The default value. - * Outputs raster data found in the PDFs. - * Depending on the argument Resolution, the SDK may rasterize the PDF pages. - * Check the template for available argument settings. */ - PDFRM_RASTER = 0x02, - /** Reserved setting for PDF reading mode.*/ -#if defined(_WIN32) || defined(_WIN64) - PDFRM_REV = 0x80000000, -#else - PDFRM_REV = -2147483648, -#endif -} PDFReadingMode; -``` -> -```csharp -public enum EnumPDFReadingMode -{ - PDFRM_VECTOR = 0x01, - PDFRM_RASTER = 0x02, - PDFRM_REV = -2147483648, -} -``` -> -```python -class EnumPDFReadingMode(IntEnum): - PDFRM_VECTOR = 0x01 - PDFRM_RASTER = 0x02 - PDFRM_REV = -2147483648 -``` diff --git a/enums/core/raster-data-source.md b/enums/core/raster-data-source.md deleted file mode 100644 index 8e8b404..0000000 --- a/enums/core/raster-data-source.md +++ /dev/null @@ -1,87 +0,0 @@ ---- -layout: default-layout -title: RasterDataSource - Dynamsoft Core Enumerations -description: The enumeration RasterDataSource of Dynamsoft Core describes raster data source types. -keywords: Target type -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: RasterDataSource ---- - -# Enumeration RasterDataSource - -`RasterDataSource` describes the target types. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - >- C# - >- Python - > -> -```javascript -export enum EnumRasterDataSource -{ - /**The raster data source type of the PDF file is "pages". Only available for PDFReadingMode PDFRM_RASTER.*/ - RDS_RASTERIZED_PAGES = 0, - /**The raster data source type of the PDF file is "images".*/ - RDS_EXTRACTED_IMAGES = 1 -} -``` -> -```java -public @interface EnumRasterDataSource { - /**The raster data source type of the PDF file is "pages". Only available for PDFReadingMode raster.*/ - public static final int RDS_RASTERIZED_PAGES = 0; - /**The raster data source type of the PDF file is "images".*/ - public static final int RDS_EXTRACTED_IMAGES = 1; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSRasterDataSource) -{ - /**The raster data source type of the PDF file is "pages". Only available for PDFReadingMode raster.*/ - DSRasterDataSourceRasterizedPages = 0, - /**The raster data source type of the PDF file is "images".*/ - DSRasterDataSourceExtractedImages = 1 -}NS_SWIFT_NAME(RasterDataSource); -``` -> -```swift -public enum RasterDataSource : Int -{ - /**The raster data source type of the PDF file is "pages". Only available for PDFReadingMode raster.*/ - rasterizedPages = 0, - /**The raster data source type of the PDF file is "images".*/ - extractedImages = 1 -} -``` -> -```cpp -typedef enum RasterDataSource -{ - /**The raster data source type of the PDF file is "pages". Only available for PDFReadingMode PDFRM_RASTER.*/ - RDS_RASTERIZED_PAGES, - /**The raster data source type of the PDF file is "images".*/ - RDS_EXTRACTED_IMAGES -} RasterDataSource; -``` -> -```csharp -public enum EnumRasterDataSource -{ - RDS_RASTERIZED_PAGES, - RDS_EXTRACTED_IMAGES -} -``` -> -```python -class EnumRasterDataSource(IntEnum): - RDS_RASTERIZED_PAGES - RDS_EXTRACTED_IMAGES -``` diff --git a/enums/core/region-object-element-type.md b/enums/core/region-object-element-type.md deleted file mode 100644 index 84758e8..0000000 --- a/enums/core/region-object-element-type.md +++ /dev/null @@ -1,153 +0,0 @@ ---- -layout: default-layout -title: RegionObjectElementType - Dynamsoft Core Enumerations -description: The enumeration RegionObjectElementType of Dynamsoft Core describes the types of RegionObjectElement. -keywords: Region object element type -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: RegionObjectElementType -codeAutoHeight: true ---- - -# Enumeration RegionObjectElementType - -`RegionObjectElementType` specifies the exact subclass type within the `RegionObjectElement` hierarchy. This enumeration facilitates the identification and differentiation of various processed elements in an image. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - >- Python - > -> -```javascript -enum EnumRegionObjectElementType { - /** - * Corresponds to the `PredetectedRegionElement` subclass, representing areas within the image identified as potentially significant - * for further analysis before detailed processing. - */ - ROET_PREDETECTED_REGION = 0, - /** Corresponds to the `LocalizedBarcodeElement` subclass, indicating areas where barcodes have been localized within the image.*/ - ROET_LOCALIZED_BARCODE = 1, - /** Corresponds to the `DecodedBarcodeElement` subclass, signifying barcodes that have not only been localized but also successfully decoded. */ - ROET_DECODED_BARCODE = 2, - /** Corresponds to the `LocalizedTextLineElement` subclass, indicating lines of text that have been localized within the image. */ - ROET_LOCALIZED_TEXT_LINE = 3, - /** Corresponds to the `RecognizedTextLineElement` subclass, referring to text lines that have been recognized. */ - ROET_RECOGNIZED_TEXT_LINE = 4, - /** Corresponds to the `DetectedQuadElement` subclass, representing quadrilateral shapes detected within the image. */ - ROET_DETECTED_QUAD = 5, - /** Corresponds to the `NormalizedImageElement` subclass, referring to images that have been normalized. */ - ROET_NORMALIZED_IMAGE = 6 -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumRegionObjectElementType -{ - /**The type of subclass PredetectedRegionElement.*/ - public static final int ROET_PREDETECTED_REGION = 0; - /**The type of subclass LocalizedBarcodeElement.*/ - public static final int ROET_LOCALIZED_BARCODE = 1; - /**The type of subclass DecodedBarcodeElement.*/ - public static final int ROET_DECODED_BARCODE = 2; - /**The type of subclass LocalizedTextLineElement.*/ - public static final int ROET_LOCALIZED_TEXT_LINE = 3; - /**The type of subclass RecognizedTextLineElement.*/ - public static final int ROET_RECOGNIZED_TEXT_LINE = 4; - /**The type of subclass DetectedQuadElement.*/ - public static final int ROET_DETECTED_QUAD = 5; - /**The type of subclass NormalizedImageElement.*/ - public static final int ROET_NORMALIZED_IMAGE = 6; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSRegionObjectElementType) -{ - /**The type of subclass PredetectedRegionElement.*/ - DSRegionObjectElementTypePredetectedRegion = 0, - /**The type of subclass LocalizedBarcodeElement.*/ - DSRegionObjectElementTypeLocalizedBarcode = 1, - /**The type of subclass DecodedBarcodeElement.*/ - DSRegionObjectElementTypeDecodedBarcode = 2, - /**The type of subclass LocalizedTextLineElement.*/ - DSRegionObjectElementTypeLocalizedTextLine = 3, - /**The type of subclass RecognizedTextLineElement.*/ - DSRegionObjectElementTypeRecognizedTextLine = 4, - /**The type of subclass DetectedQuadElement.*/ - DSRegionObjectElementTypeDetectedQuad = 5, - /**The type of subclass NormalizedImageElement.*/ - DSRegionObjectElementTypeNormalizedImage = 6 -}; -``` -> -```swift -public enum RegionObjectElementType : Int -{ - /**The type of subclass PredetectedRegionElement.*/ - predetectedRegion = 0, - /**The type of subclass LocalizedBarcodeElement.*/ - localizedBarcode = 1, - /**The type of subclass DecodedBarcodeElement.*/ - decodedBarcode = 2, - /**The type of subclass LocalizedTextLineElement.*/ - localizedTextLine = 3, - /**The type of subclass RecognizedTextLineElement.*/ - recognizedTextLine = 4, - /**The type of subclass DetectedQuadElement.*/ - detectedQuad = 5, - /**The type of subclass NormalizedImageElement.*/ - normalizedImage = 6 -} -``` -> -```cpp -typedef enum RegionObjectElementType -{ - /**The type of subclass PredetectedRegionElement.*/ - ROET_PREDETECTED_REGION, - /**The type of subclass LocalizedBarcodeElement.*/ - ROET_LOCALIZED_BARCODE, - /**The type of subclass DecodedBarcodeElement.*/ - ROET_DECODED_BARCODE, - /**The type of subclass LocalizedTextLineElement.*/ - ROET_LOCALIZED_TEXT_LINE, - /**The type of subclass RecognizedTextLineElement.*/ - ROET_RECOGNIZED_TEXT_LINE, - /**The type of subclass DetectedQuadElement.*/ - ROET_DETECTED_QUAD, - /**The type of subclass NormalizedImageElement.*/ - ROET_NORMALIZED_IMAGE, - /**The type of subclass SourceImageElement.*/ - ROET_SOURCE_IMAGE, - /**The type of subclass TargetROIElement.*/ - ROET_TARGET_ROI -} RegionObjectElementType; -``` -> -```python -class EnumRegionObjectElementType(IntEnum): - # The type of subclass PredetectedRegionElement. - ROET_PREDETECTED_REGION - # The type of subclass LocalizedBarcodeElement. - ROET_LOCALIZED_BARCODE - # The type of subclass DecodedBarcodeElement. - ROET_DECODED_BARCODE - # The type of subclass LocalizedTextLineElement. - ROET_LOCALIZED_TEXT_LINE - # The type of subclass RecognizedTextLineElement. - ROET_RECOGNIZED_TEXT_LINE - # The type of subclass DetectedQuadElement. - ROET_DETECTED_QUAD - # The type of subclass NormalizedImageElement. - ROET_NORMALIZED_IMAGE - # The type of subclass SourceImageElement. - ROET_SOURCE_IMAGE - # The type of subclass TargetROIElement. - ROET_TARGET_ROI -``` diff --git a/enums/core/section-type.md b/enums/core/section-type.md deleted file mode 100644 index 45fdc27..0000000 --- a/enums/core/section-type.md +++ /dev/null @@ -1,155 +0,0 @@ ---- -layout: default-layout -title: SectionType - Dynamsoft Core Enumerations -description: The enumeration SectionType of Dynamsoft Core describes the section of the algorithm. -keywords: Section type -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: SectionType -codeAutoHeight: true ---- - -# Enumeration SectionType - -`SectionType` categorizes the distinct segments within the image processing algorithm, pinpointing the exact phase responsible for generating a specific `IntermediateResult`. - - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - >- Python - > -> -```javascript -enum EnumSectionType { - /** Indicates that no specific section type has been specified. */ - ST_NULL = 0, - /** Corresponds to results generated in the "region prediction" section. */ - ST_REGION_PREDETECTION = 1, - /** Corresponds to results generated in the "barcode localization" section. */ - ST_BARCODE_LOCALIZATION = 2, - /** Corresponds to results generated in the "barcode decoding" section. */ - ST_BARCODE_DECODING = 3, - /** Corresponds to results generated in the "text line localization" section. */ - ST_TEXT_LINE_LOCALIZATION = 4, - /** Corresponds to results generated in the "text line recognition" section. */ - ST_TEXT_LINE_RECOGNITION = 5, - /** Corresponds to results generated in the "document detection" section. */ - ST_DOCUMENT_DETECTION = 6, - /** Corresponds to results generated in the "document normalization" section. */ - ST_DOCUMENT_NORMALIZATION = 7 -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumSectionType -{ - /**No section type is specified.*/ - public static final int ST_NULL = 0; - /**The result is output by "region prediction" section.*/ - public static final int ST_REGION_PREDETECTION = 1; - /**The result is output by "barcode localization" section.*/ - public static final int ST_BARCODE_LOCALIZATION = 2; - /**The result is output by "barcode decoding" section.*/ - public static final int ST_BARCODE_DECODING = 3; - /**The result is output by "text line localization" section.*/ - public static final int ST_TEXT_LINE_LOCALIZATION = 4; - /**The result is output by "text line recognition" section.*/ - public static final int ST_TEXT_LINE_RECOGNITION = 5; - /**The result is output by "document detection" section.*/ - public static final int ST_DOCUMENT_DETECTION = 6; - /**The result is output by "document normalization" section.*/ - public static final int ST_DOCUMENT_NORMALIZATION = 7; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSSectionType) -{ - /**No section type is specified.*/ - DSSectionTypeNull = 0, - /**The result is output by "region prediction" section.*/ - DSSectionTypeRegionPredection = 1, - /**The result is output by "barcode localization" section.*/ - DSSectionTypeBarcodeLocalization = 2, - /**The result is output by "barcode decoding" section.*/ - DSSectionTypeBarcodeDecoding = 3, - /**The result is output by "text line localization" section.*/ - DSSectionTypeTextLineLocalization = 4, - /**The result is output by "text line recognition" section.*/ - DSSectionTypeTextLineRecognition = 5, - /**The result is output by "document detection" section.*/ - DSSectionTypeDocumentDetection = 6, - /**The result is output by "document normalization" section.*/ - DSSectionTypeDocumentNormalization = 7 -}; -``` -> -```swift -public enum SectionType : Int -{ - /**No section type is specified.*/ - null = 0, - /**The result is output by "region prediction" section.*/ - regionPredection = 1, - /**The result is output by "barcode localization" section.*/ - barcodeLocalization = 2, - /**The result is output by "barcode decoding" section.*/ - barcodeDecoding = 3, - /**The result is output by "text line localization" section.*/ - textLineLocalization = 4, - /**The result is output by "text line recognition" section.*/ - textLineRecognition = 5, - /**The result is output by "document detection" section.*/ - documentDetection = 6, - /**The result is output by "document normalization" section.*/ - documentNormalization = 7 -} -``` -> -```cpp -typedef enum SectionType -{ - /**No section type is specified.*/ - ST_NULL, - /**The result is output by "region prediction" section.*/ - ST_REGION_PREDETECTION, - /**The result is output by "barcode localization" section.*/ - ST_BARCODE_LOCALIZATION, - /**The result is output by "barcode decoding" section.*/ - ST_BARCODE_DECODING, - /**The result is output by "text line localization" section.*/ - ST_TEXT_LINE_LOCALIZATION, - /**The result is output by "text line recognition" section.*/ - ST_TEXT_LINE_RECOGNITION, - /**The result is output by "document detection" section.*/ - ST_DOCUMENT_DETECTION, - /**The result is output by "document normalization" section.*/ - ST_DOCUMENT_NORMALIZATION, -} SectionType; -``` -> -```python -class EnumSectionType(IntEnum): - # No section type is specified. - ST_NULL - # The result is output by "region prediction" section. - ST_REGION_PREDETECTION - # The result is output by "barcode localization" section. - ST_BARCODE_LOCALIZATION - # The result is output by "barcode decoding" section. - ST_BARCODE_DECODING - # The result is output by "text line localization" section. - ST_TEXT_LINE_LOCALIZATION - # The result is output by "text line recognition" section. - ST_TEXT_LINE_RECOGNITION - # The result is output by "document detection" section. - ST_DOCUMENT_DETECTION - # The result is output by "document normalization" section. - ST_DOCUMENT_NORMALIZATION -``` diff --git a/enums/core/target-type.md b/enums/core/target-type.md deleted file mode 100644 index bc3d9e9..0000000 --- a/enums/core/target-type.md +++ /dev/null @@ -1,73 +0,0 @@ ---- -layout: default-layout -title: TargetType - Dynamsoft Core Enumerations -description: The enumeration TargetType of Dynamsoft Core describes target types. -keywords: Target type -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: TargetType -codeAutoHeight: true ---- - -# Enumeration TargetType - -`TargetType` describes the target types. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - > -> -```javascript -enum EnumTargetType -{ - /**The target type of the PDF file is "page". Only available for PDFReadingMode PDFRM_RASTER.*/ - TT_PAGE = 0, - /**The target type of the PDF file is "image".*/ - TT_IMAGE = 1 -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumTargetType { - /**The target type of the PDF file is "page". Only available for PDFReadingMode raster.*/ - public static final int TT_PAGE = 0; - /**The target type of the PDF file is "image".*/ - public static final int TT_IMAGE = 1; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSTargetType) -{ - /**The target type of the PDF file is "page". Only available for PDFReadingMode raster.*/ - DSTargetTypePage = 0, - /**The target type of the PDF file is "image".*/ - DSTargetTypeImage = 1 -}; -``` -> -```swift -public enum TargetType : Int -{ - /**The target type of the PDF file is "page". Only available for PDFReadingMode raster.*/ - page = 0, - /**The target type of the PDF file is "image".*/ - image = 1 -} -``` -> -```cpp -typedef enum TargetType -{ - /**The target type of the PDF file is "page". Only available for PDFReadingMode PDFRM_RASTER.*/ - TT_PAGE, - /**The target type of the PDF file is "image".*/ - TT_IMAGE -} TargetType; -``` diff --git a/enums/core/transform-matrix-type.md b/enums/core/transform-matrix-type.md deleted file mode 100644 index ecc814e..0000000 --- a/enums/core/transform-matrix-type.md +++ /dev/null @@ -1,99 +0,0 @@ ---- -layout: default-layout -title: TransformMatrixType - Dynamsoft Core Enumerations -description: The enumeration TransformMatrixType of Dynamsoft Core describes transform matrix types. -keywords: Target type -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: TransformMatrixType ---- - -# Enumeration TransformMatrixType - -`TransformMatrixType` describes the transform matrix types. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - >- Python - > -> -```javascript -enum EnumTransformMatrixType { - /**Represents a transformation matrix that converts coordinates from the local image to the original image.*/ - TMT_LOCAL_TO_ORIGINAL_IMAGE, - /**Represents a transformation matrix that converts coordinates from the original image to the local image.*/ - TMT_ORIGINAL_TO_LOCAL_IMAGE -} -``` -> -```java -public @interface EnumTransformMatrixType { - /**Represents a transformation matrix that converts coordinates from the local image to the original image.*/ - int TMT_LOCAL_TO_ORIGINAL_IMAGE = 0; - /**Represents a transformation matrix that converts coordinates from the original image to the local image.*/ - int TMT_ORIGINAL_TO_LOCAL_IMAGE = 1; - /**Represents a transformation matrix that converts coordinates from the rotated image to the original image.*/ - int TMT_ROTATED_TO_ORIGINAL_IMAGE = 2; - /**Represents a transformation matrix that converts coordinates from the original image to the rotated image.*/ - int TMT_ORIGINAL_TO_ROTATED_IMAGE = 3; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSTransformMatrixType) -{ - /**Represents a transformation matrix that converts coordinates from the local image to the original image.*/ - DSTransformMatrixTypeLocalToOriginalImage = 0, - /**Represents a transformation matrix that converts coordinates from the original image to the local image.*/ - DSTransformMatrixTypeOriginalToLocalImage = 1, - /**Represents a transformation matrix that converts coordinates from the rotated image to the original image.*/ - DSTransformMatrixTypeRotatedToOriginalImage = 2, - /**Represents a transformation matrix that converts coordinates from the original image to the rotated image.*/ - DSTransformMatrixTypeOriginalToRotatedImage = 3 -}NS_SWIFT_NAME(TransformMatrixType); -``` -> -```swift -public enum TransformMatrixType : Int -{ - /**Represents a transformation matrix that converts coordinates from the local image to the original image.*/ - localToOriginalImage = 0, - /**Represents a transformation matrix that converts coordinates from the original image to the local image.*/ - originalToLocalImage = 1, - /**Represents a transformation matrix that converts coordinates from the rotated image to the original image.*/ - rotatedToOriginalImage = 2, - /**Represents a transformation matrix that converts coordinates from the original image to the rotated image.*/ - originalToRotatedImage = 3 -} -``` -> -```cpp -typedef enum TransformMatrixType -{ - /**Represents a transformation matrix that converts coordinates from the local image to the original image.*/ - TMT_LOCAL_TO_ORIGINAL_IMAGE, - /**Represents a transformation matrix that converts coordinates from the original image to the local image.*/ - TMT_ORIGINAL_TO_LOCAL_IMAGE, - /**Represents a transformation matrix that converts coordinates from the rotated image to the original image.*/ - TMT_ROTATED_TO_ORIGINAL_IMAGE, - /**Represents a transformation matrix that converts coordinates from the original image to the rotated image.*/ - TMT_ORIGINAL_TO_ROTATED_IMAGE -} TransformMatrixType; -``` -> -```python -class EnumTransformMatrixType(IntEnum): - # Represents a transformation matrix that converts coordinates from the local image to the original image. - TMT_LOCAL_TO_ORIGINAL_IMAGE - # Represents a transformation matrix that converts coordinates from the original image to the local image. - TMT_ORIGINAL_TO_LOCAL_IMAGE - # Represents a transformation matrix that converts coordinates from the rotated image to the original image. - TMT_ROTATED_TO_ORIGINAL_IMAGE - # Represents a transformation matrix that converts coordinates from the original image to the rotated image. - TMT_ORIGINAL_TO_ROTATED_IMAGE -``` diff --git a/enums/core/video-frame-quality.md b/enums/core/video-frame-quality.md deleted file mode 100644 index 7d7b5fa..0000000 --- a/enums/core/video-frame-quality.md +++ /dev/null @@ -1,105 +0,0 @@ ---- -layout: default-layout -title: VideoFrameQuality - Dynamsoft Core Enumerations -description: The enumeration VideoFrameQuality of Dynamsoft Core describes the quality of video frames. -keywords: Video frame quality -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: VideoFrameQuality -codeAutoHeight: true ---- - -# Enumeration VideoFrameQuality - -`VideoFrameQuality` describes the quality of video frames. - -
    - >- JavaScript - >- Android - >- Objective-C - >- Swift - >- C++ - >- C# - >- Python - > -> -```javascript -enum EnumVideoFrameQuality { - /**The frame quality is measured to be high.*/ - VFQ_HIGH = 0, - /**The frame quality is measured to be low.*/ - VFQ_LOW = 1, - /**The frame quality is unknown.*/ - VFQ_UNKNOWN = 2 -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumVideoFrameQuality { - /**The frame quality is measured to be high.*/ - public static final int VFQ_HIGH = 0; - /**The frame quality is measured to be low.*/ - public static final int VFQ_LOW = 1; - /**The frame quality is unknown.*/ - public static final int VFQ_UNKNOWN = 2; -} -``` -> -```objc -typedef NS_ENUM(NSInteger, DSVideoFrameQuality) -{ - /**The frame quality is measured to be high.*/ - VideoFrameQualityHigh, - /**The frame quality is measured to be low.*/ - VideoFrameQualityLow, - /**The frame quality is unknown.*/ - VideoFrameQualityUnknown -}; -``` -> -```swift -public enum VideoFrameQuality : Int -{ - /**The frame quality is measured to be high.*/ - high, - /**The frame quality is measured to be low.*/ - low, - /**The frame quality is unknown.*/ - unknown -} -``` -> -```cpp -typedef enum VideoFrameQuality { - /**The frame quality is measured to be high.*/ - VFQ_HIGH, - /**The frame quality is measured to be low.*/ - VFQ_LOW, - /**The frame quality is unknown.*/ - VFQ_UNKNOWN -} VideoFrameQuality; -``` -> -```csharp -public enum EnumVideoFrameQuality -{ - /**The frame quality is measured to be high.*/ - VFQ_HIGH, - /**The frame quality is measured to be low.*/ - VFQ_LOW, - /**The frame quality is unknown.*/ - VFQ_UNKNOWN -} -``` -> -```python -class EnumVideoFrameQuality(IntEnum): - #The frame quality is measured to be high. - VFQ_HIGH - #The frame quality is measured to be low. - VFQ_LOW - #The frame quality is unknown. - VFQ_UNKNOWN -``` diff --git a/enums/document-normalizer/image-colour-mode.md b/enums/document-normalizer/image-colour-mode.md deleted file mode 100644 index eec9fdc..0000000 --- a/enums/document-normalizer/image-colour-mode.md +++ /dev/null @@ -1,88 +0,0 @@ ---- -layout: default-layout -title: ImageColourMode - Dynamsoft Document Normalizer Enumerations -description: The enumeration ImageColourMode of Dynamsoft Document Normalizer describes the mapping status of a parsed field. -keywords: Mapping status -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: ImageColourMode ---- - -# Enumeration ImageColourMode - -`ImageColourMode` describes the output colour mode of the normalized image. - -
    - >- JavaScript - >- Android - >- Swift - >- C++ - >- C# - >- Python - > -> -```javascript -enum EnumImageColourMode { - /** Output image in colour mode. */ - ICM_COLOUR = 0, - /** Output image in grayscale mode. */ - ICM_GRAYSCALE = 1, - /** Output image in binary mode. */ - ICM_BINARY = 2 -} -``` -> -```java -@Retention(RetentionPolicy.CLASS) -public @interface EnumImageColourMode { - /** Output colour image.*/ - public static final int ICM_COLOUR = 0; - /** Output grayscale image.*/ - public static final int ICM_GRAYSCALE = 1; - /** Output binary image.*/ - public static final int ICM_BINARY = 2; - public EnumImageColourMode() { - } -} -``` -> -```swift -typedef NS_ENUM(NSInteger , DSImageColourMode) -{ - /** Output colour image.*/ - DSImageColourModeColour = 0x01, - /** Output grayscale image.*/ - DSImageColourModeGrayscale = 0x02, - /** Output binary image.*/ - DSImageColourModeBinary = 0x04 -}NS_SWIFT_NAME(ImageColourMode); -``` -> -```cpp -typedef enum ImageColourMode -{ - /** Output image in colour mode. */ - ICM_COLOUR = 0, - /** Output image in grayscale mode. */ - ICM_GRAYSCALE = 1, - /** Output image in binary mode. */ - ICM_BINARY = 2 -} ImageColourMode; -``` -> -```csharp -public enum EnumImageColourMode -{ - ICM_COLOUR = 0, - ICM_GRAYSCALE = 1, - ICM_BINARY = 2 -} -``` -> -```python -class EnumImageColourMode(IntEnum): - ICM_COLOUR = 0 - ICM_GRAYSCALE = 1 - ICM_BINARY = 2 -``` diff --git a/enums/index.md b/enums/index.md deleted file mode 100644 index 30f49fc..0000000 --- a/enums/index.md +++ /dev/null @@ -1,55 +0,0 @@ ---- -layout: default-layout -title: Enumerations - Dynamsoft Capture Vision -description: The index of enumeration page -keywords: Enumerations -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: Enumerations index ---- - -# Index of Enumerations - -## BarcodeReader Enumerations - -- [QRCodeErrorCorrectionLevel](barcode-reader/qr-code-error-correction-level.md) -- [LocalizationMode](barcode-reader/localization-mode.md) -- [ExtendedBarcodeResultType](barcode-reader/extended-barcode-result-type.md) -- [DeblurMode](barcode-reader/deblur-mode.md) -- [BarcodeFormat](barcode-reader/barcode-format.md) - -## CameraEnhancer Enumerations - -- [Resolution](camera-enhancer/resolution.md) -- [FocusMode](camera-enhancer/focus-mode.md) -- [EnhancerFeatures](camera-enhancer/enhancer-features.md) -- [CameraState](camera-enhancer/camera-state.md) -- [CameraPosition](camera-enhancer/camera-position.md) - -## CaptureVisionRouter Enumerations - -- [CaptureState](capture-vision-router/capture-state.md) -- [ImageSourceState](capture-vision-router/image-source-state.md) - -## CodeParser Enumerations - -- [MappingStatus](code-parser/mapping-status.md) -- [ValiadtionStatus](code-parser/valiadtion-status.md) - -## Core Enumerations - -- [BufferOverflowProtectionMode](core/buffer-overflow-protection-mode.md) -- [CapturedResultItemType](core/captured-result-item-type.md) -- [CornerType](core/corner-type.md) -- [ErrorCode](core/error-code.md) -- [GrayscaleTransformationMode](core/grayscale-transformation-mode.md) -- [ImageCaptureDistanceMode](core/image-capture-distance-mode.md) -- [ImagePixelFormat](core/image-pixel-format.md) -- [ImageTagType](core/image-tag-type.md) -- [IntermediateResultUnitType](core/intermediate-result-unit-type.md) -- [PDFReadingMode](core/pdf-reading-mode.md) -- [RegionObjectElementType](core/region-object-element-type.md) -- [SectionType](core/section-type.md) -- [TargetType](core/target-type.md) -- [VideoFrameQuality](core/video-frame-quality.md) diff --git a/enums/label-recognizer/raw-text-line-status.md b/enums/label-recognizer/raw-text-line-status.md deleted file mode 100644 index 4c79ea1..0000000 --- a/enums/label-recognizer/raw-text-line-status.md +++ /dev/null @@ -1,44 +0,0 @@ ---- -layout: default-layout -title: RawTextLineStatus - Dynamsoft LabelRecognizer Enumerations -description: The enumeration RawTextLineStatus of Dynamsoft LabelRecognizer describes the final status of a raw text line. -keywords: Raw Text Line Status -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -breadcrumbText: RawTextLineStatus -codeAutoHeight: true ---- - -# Enumeration RawTextLineStatus - -`RawTextLineStatus` enumerates the final status of a raw text line. - -
    - >- JavaScript - >- C++ - > -> -```javascript -enum EnumRawTextLineStatus -{ - /** Localized but recognition not performed. */ - RTLS_LOCALIZED = 0 , - /** Recognition failed. */ - RTLS_RECOGNITION_FAILED = 1, - /** Successfully recognized. */ - RTLS_RECOGNITION_SUCCEEDED = 2 -} -``` -> -```cpp -typedef enum RawTextLineStatus -{ - /** Localized but recognition not performed. */ - RTLS_LOCALIZED, - /** Recognition failed. */ - RTLS_RECOGNITION_FAILED, - /** Successfully recognized. */ - RTLS_RECOGNITION_SUCCEEDED -} RawTextLineStatus; -``` diff --git a/parameters/file/auxiliary/barcode-format-specification.md b/parameters/file/auxiliary/barcode-format-specification.md index 5c4e647..22cca8f 100644 --- a/parameters/file/auxiliary/barcode-format-specification.md +++ b/parameters/file/auxiliary/barcode-format-specification.md @@ -63,7 +63,7 @@ noTitleIndex: true "BarcodeZoneMinDistanceToImageBorders" : 1, "Code128Subset" : "A", "DataMatrixSizeOptions": ["DMS_DEFAULT"], - "DataMatrixModuleIsotropic": 1 + "DataMatrixModuleIsotropic": 1, "DeformationResistingModes" : [ { "Mode": "DRM_GENERAL", @@ -101,7 +101,7 @@ noTitleIndex: true **Set target barcode format** -Sets `BarcodeFormatIds` to specify which barcode format the current FormatSpecification configuration is applied to. View enumeration [BarcodeFormats]({{site.dcvb_enums}}barcode-reader/barcode-format.html) for all supported barcode formats. +Sets `BarcodeFormatIds` to specify which barcode format the current FormatSpecification configuration is applied to. **Set special configurations for target format** diff --git a/parameters/file/auxiliary/capture-vision-model.md b/parameters/file/auxiliary/capture-vision-model.md index 1285e04..0603444 100644 --- a/parameters/file/auxiliary/capture-vision-model.md +++ b/parameters/file/auxiliary/capture-vision-model.md @@ -33,7 +33,7 @@ A `CaptureVisionModel` object defines how the library find Convolutional Neural ### Name -The name of the CaptureVisionModel object. It will be used as a unique identifier for the model. +The name of the `CaptureVisionModel` object. It will be used as a unique identifier for the model. | Parameter Summary | | :------------------- | diff --git a/parameters/file/auxiliary/character-model.md b/parameters/file/auxiliary/character-model.md deleted file mode 100644 index 6060bc1..0000000 --- a/parameters/file/auxiliary/character-model.md +++ /dev/null @@ -1,91 +0,0 @@ ---- -layout: default-layout -title: CharacterModel - Dynamsoft Capture Vision Parameter File -description: The CharacterModel object in the Dynamsoft Capture Vision Parameter File defines how the charactor models are found. -keywords: Text line specification -needAutoGenerateSidebar: true -noTitleIndex: true ---- - -# CharacterModel Object - -A `CharacterModel` object defines how the library find Convolutional Neural Networks (CNN) models files that support the character recognition. - -```json -{ - "Name": "NumberLetter", - "DirectoryPath" : "D:\\CharacterModel\\", - "FilterFilePath" : "D:\\exclude.txt" -} -``` - -The character model files consist of - -- Primary model files (Required): The files that stores the major character recognition models. -- Auxiliary model files (Optional): Support the recognition when the result output by the major model doesn't match the RegEx. -- Filter files (Optional): Set which characters are included or excluded from the text line recognition. - -
    -

    character-model

    -

    Example of CharacterModel files

    -
    - -The data you input via the CharacterModel is to tell the library how it can find the character model files. - -## General Usage - -In the `CharacterModel` object, what you have to specify are: - -- `Name`: Find the model files by the name of the model. -- `DirectoryPath`: Where the model files are located. - -**Exapmle 1: Define a character model** - -```json -{ - "Name": "NumberLetter", - "DirectoryPath" : "D:\\CharacterModel\\" -} -``` - -The library will be able to find all the related files that match the name you input including both the major models and the assist models. - -## Include Filter File - -If you have requirements to exclude any characters, you can configure a filter file and add the file path to your `CharacterModel` object. An example of a exclude filter file is shown as follow: - -```txt -exclude -I Q O -``` - -**Example 2: Add a filter file to your character model** - -```json -{ - "Name" : "NumberUppercase", - "DirectoryPath" : "D:\\CharacterModel\\", - "FilterFilePath" : "D:\\CharacterModel\\Exclude.txt" // You can define the filter file in the same folder with the model files. -} -``` - -**Example 3: Define multiple character models** - -```json -{ - "Name" : "VINModel", - "DirectoryPath" : "D:\\VIN\\", - "FilterFilePath" : "D:\\VIN\\Exclude.txt" -}, -{ - "Name" : "MRZModel", - "DirectoryPath" : "D:\\MRZ\\", - "FilterFilePath" : "D:\\VIN\\Exclude.txt" // You can define a same filter file for different `CharacterModel` objects. -} -``` - -## As a Parameter of TextLineSpecification Object - -- In each `TargetROI`, you can allocate multiple `LabelRecognizer` tasks. -- In each `LabelRecognizer` task, you can add multiple `TextLineSpecification` settings. -- In each `TextLineSpecification` task, you can specify only one `CharacterModel` setting. diff --git a/parameters/file/auxiliary/index.md b/parameters/file/auxiliary/index.md deleted file mode 100644 index 8489cae..0000000 --- a/parameters/file/auxiliary/index.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -layout: default-layout -title: Auxiliary Settings - Dynamsoft Capture Vision Parameters -description: This article is the index of the auxiliary settings of the Dynamsoft Capture Vision Parameters. -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: false -permalink: /parameters/file/auxiliary/index.html ---- - -# Auxiliary Setting Objects - -The following objects are auxiliary settings that help define specific aspects of an image-processing workflow: - -1. [BarcodeFormatSpecification Object](barcode-format-specification.md) -2. [CharacterModel Object](character-model.md) -3. [TextLineSpecification Object](textline-specification.md) -4. [GlobalParameter Object](global-parameter.md) diff --git a/parameters/file/auxiliary/textline-specification.md b/parameters/file/auxiliary/textline-specification.md index a297017..8dd387a 100644 --- a/parameters/file/auxiliary/textline-specification.md +++ b/parameters/file/auxiliary/textline-specification.md @@ -11,33 +11,80 @@ noTitleIndex: true Set the `CharacterModel`, `TextLineRecModel`, `ImageProcessing` parameters and other configurations for the specified text lines. This is the parameter that defines how the algorithm extract characters from each text lines of a `LabelRecognizer` task. You can leave this area empty to use the default character recognizing settings. +## Parameters Summary + +| Parameter Name | Type | Description | +|---------------|------|-------------| +| [`Name`]({{ site.dcvb_parameters_reference }}text-line-specification/name.html) | *String* | Unique identifier for this specification | +| [`BaseTextLineSpecificationName`]({{ site.dcvb_parameters_reference }}text-line-specification/base-text-line-specification-name.html) | *String* | Inherit settings from another specification | +| [`CharacterModelName`]({{ site.dcvb_parameters_reference }}text-line-specification/character-model-name.html) | *String* | Name of the character recognition model | +| [`TextLineRecModelName`]({{ site.dcvb_parameters_reference }}text-line-specification/text-line-rec-model-name.html) | *String* | Name of the text line recognition model | +| [`ApplicableTextLineNumbers`]({{ site.dcvb_parameters_reference }}text-line-specification/applicable-text-line-numbers.html) | *String* | Specify which text lines use this specification | +| [`CharHeightRange`]({{ site.dcvb_parameters_reference }}text-line-specification/char-height-range.html) | *Array* | Valid character height range | +| [`StringLengthRange`]({{ site.dcvb_parameters_reference }}text-line-specification/string-length-range.html) | *Array* | Valid string length range | +| [`StringRegExPattern`]({{ site.dcvb_parameters_reference }}text-line-specification/string-regex-pattern.html) | *String* | Regular expression for result validation | +| [`GrayscaleEnhancementModes`]({{ site.dcvb_parameters_reference }}text-line-specification/grayscale-enhancement-modes.html) | *Array* | Grayscale image enhancement settings | +| [`BinarizationModes`]({{ site.dcvb_parameters_reference }}text-line-specification/binarization-modes.html) | *Array* | Binarization processing settings | +| [`CharacterNormalizationModes`]({{ site.dcvb_parameters_reference }}text-line-specification/character-normalization-modes.html) | *Array* | Character normalization settings | +| [`ConcatResults`]({{ site.dcvb_parameters_reference }}text-line-specification/concat-results.html) | *Int* | Enable/disable result concatenation | +| [`ConcatSeparator`]({{ site.dcvb_parameters_reference }}text-line-specification/concat-separator.html) | *String* | Separator for concatenated results | +| [`ConcatStringLengthRange`]({{ site.dcvb_parameters_reference }}text-line-specification/concat-string-length-range.html) | *Array* | Length range for concatenated results | +| [`ConcatStringRegExPattern`]({{ site.dcvb_parameters_reference }}text-line-specification/concat-string-regex-pattern.html) | *String* | Regex pattern for concatenated results | +| [`ConfusableCharactersCorrection`]({{ site.dcvb_parameters_reference }}text-line-specification/confusable-characters-correction.html) | *Object* | Confusable character correction settings | +| [`ExpectedGroupsCount`]({{ site.dcvb_parameters_reference }}text-line-specification/expected-groups-count.html) | *Int* | Expected number of text line groups | +| [`OutputResults`]({{ site.dcvb_parameters_reference }}text-line-specification/output-results.html) | *Int* | Control result output | +| [`ReferenceGroupName`]({{ site.dcvb_parameters_reference }}text-line-specification/reference-group-name.html) | *String* | Reference to another group | +| [`SubGroups`]({{ site.dcvb_parameters_reference }}text-line-specification/sub-groups.html) | *Array* | Sub-group definitions | +| [`TextLinesCount`]({{ site.dcvb_parameters_reference }}text-line-specification/text-lines-count.html) | *Int* | Expected number of text lines | +| [`FirstPoint`]({{ site.dcvb_parameters_reference }}text-line-specification/position.html#firstpoint) | *Array* | First corner of target area | +| [`SecondPoint`]({{ site.dcvb_parameters_reference }}text-line-specification/position.html#secondpoint) | *Array* | Second corner of target area | +| [`ThirdPoint`]({{ site.dcvb_parameters_reference }}text-line-specification/position.html#thirdpoint) | *Array* | Third corner of target area | +| [`FourthPoint`]({{ site.dcvb_parameters_reference }}text-line-specification/position.html#fourthpoint) | *Array* | Fourth corner of target area | + +## Example + ```json { - "Name":"LS_1", - "CharacterModelName" : "NumberLetter", - "TextLineRecModelName" : "", - "ApplicableTextLineNumbers":"", - "GrayscaleEnhancementModes" : [], - "BinarizationModes" : [], - "CharacterNormalizationModes" : [], - "BaseTextLineSpecificationName" : "LS_0", - "StringLengthRange" : [44,44], + "Name" : "tls_default", + "CharacterModelName" : "NumberLetterCharRecognition", + "ApplicableTextLineNumbers" : "1-3", + "CharHeightRange" : [20, 1000, 1], + "StringLengthRange" : [3, 50], "StringRegExPattern" : "", - "FirstPoint" : [ 0, 0 ], - "SecondPoint" : [ 100, 0 ], - "ThirdPoint" : [ 100, 20 ], - "FourthPoint" : [ 0, 20 ], - "CharHeightRange" : [ 800, 1000, 1 ] + "BinarizationModes" : [ + { + "Mode" : "BM_LOCAL_BLOCK", + "BlockSizeX" : 11, + "BlockSizeY" : 11, + "ThresholdCompensation" : 10 + } + ], + "GrayscaleEnhancementModes" : [ + { + "Mode" : "GEM_GENERAL", + "Sensitivity" : 5 + } + ], + "CharacterNormalizationModes" : [ + { + "Mode" : "CNM_AUTO", + "MorphOperation" : "Close", + "MorphArgument" : "3" + } + ], + "OutputResults" : 1 } ``` +For a complete list of all available parameters and their detailed descriptions, see the Parameters Summary table above. + ## Usage Instructions ### Parameter Configurations **Select CharacterModel** -Select one of the `CharacterModel` for the text line(s) by specifying the name of the model. View [`CharacterModel`](capture-vision-model.md) page for how to configure the models. +Select one of the `CharacterModel` for the text line(s) by specifying the name of the model. View [`CaptureVisionModel`](capture-vision-model.md) page for how to configure the models. **Select TextLineRecModel** @@ -114,6 +161,26 @@ Based on a existing `TextLineSpecification` object, you can use `BaseTextLineSpe } ``` -### Additional Annotations +### Result Concatenation + +When multiple text lines need to be combined into a single result, use the following parameters: + +- **`ConcatResults`**: Set to 1 to enable concatenation of multiple text line results into a single output. +- **`ConcatSeparator`**: Defines the separator string used between concatenated text lines (e.g., "\n" for newline). +- **`ConcatStringLengthRange`**: Specifies the valid length range [min, max] for the concatenated result. +- **`ConcatStringRegExPattern`**: Regular expression pattern that the concatenated result must match. + +### Grouping and Filtering + +- **`ExpectedGroupsCount`**: Specifies the expected number of text line groups to be recognized. +- **`ReferenceGroupName`**: References another group for relative positioning or filtering. +- **`SubGroups`**: Defines sub-groups within the text line specification for hierarchical organization. +- **`TextLinesCount`**: Specifies the expected number of text lines to be processed. + +### Output Control + +- **`OutputResults`**: Set to 1 to include this text line's results in the final output, or 0 to process internally without outputting. + +### Character Correction -`LabelRecognizerTaskSetting` determines how a label recognizer task works from initializing to finalizing. As a parameter of `LabelRecognizerTaskSetting`, `TextLineSpecification` decides how the text lines are processed when they are detected in the label recognizer task. A group of default settings has been allocated for the `TextLineSpecification` so that the `LabelRecognizerTaskSetting` still works without specifying `TextLineSpecification` parameters. +- **`ConfusableCharactersCorrection`**: Configuration for correcting commonly confused characters (e.g., 0 vs O, 1 vs I). diff --git a/parameters/file/capture-vision-template.md b/parameters/file/capture-vision-template.md index 8aa0761..edeb2f7 100644 --- a/parameters/file/capture-vision-template.md +++ b/parameters/file/capture-vision-template.md @@ -3,70 +3,59 @@ layout: default-layout title: CaptureVisionTemplate - Dynamsoft Capture Vision Parameters description: The CaptureVisionTemplate object in the Dynamsoft Capture Vision. keywords: CaptureVisionTemplate -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- -# Design of the CaptureVisionTemplate Object +# CaptureVisionTemplate Object -A `CaptureVisionTemplate` object is the entry object of a parameter template in Dynamsoft Capture Vision (DCV) SDK. +A `CaptureVisionTemplate` object is the entry point of a parameter template in Dynamsoft Capture Vision (DCV) SDK. + +## Example ```json { - "Name" : "CV_0", + "Name": "CV_0", "ImageSourceName": "ISA_0", - "ImageROIProcessingNameArray": ["TA_0" ], + "ImageROIProcessingNameArray": ["TA_0"], "SemanticProcessingNameArray": ["SP_0"], "OutputOriginalImage": 0, - "MaxParallelTasks" : 4, - "Timeout" : 500 + "MaxParallelTasks": 4, + "MinImageCaptureInterval": 0, + "Timeout": 500 } ``` -
    -

    Example 1 – Parameters of CaptureVisionTemplate

    -
    - -## Summary of CaptureVisionTemplate top-level parameters - -| Parameter Name | Description | -| -------------- | ----------- | -| [`Name`](../reference/capture-vision-template/name.md) | Represents the name of the parameter template, which serves as its unique identifier. | -| [`ImageSourceName`](../reference/capture-vision-template/image-source-name.md) | Indicates the input source name, used to refer to the `ImageSource` object. It is used to define the input image source of DCV. | -| [`ImageROIProcessingNameArray`](../reference/capture-vision-template/image-roi-processing-name-array.md) | Represents the collection of image ROI processing object names, used to refer to the `TargetROIDef` objects. It is used to define recognition tasks performed on ROIs of an image, including reading barcodes, recognizing labels, or detecting document quadrilaterals. | -| [`SemanticProcessingNameArray`](../reference/capture-vision-template/semantic-processing-name-array.md)| Represents the collection of semantic-processing object names, used to refer to the `SematicProcessing` objects. It is used to define post-processing code parsing tasks performed on input text/bytes.| -| [`OutputOriginalImage`](../reference/capture-vision-template/output-original-Image.md) | Indicates whether DCV finally outputs the original input image. | -| [`MaxParallelTasks`](../reference/capture-vision-template/max-parallel-tasks.md) | Indicates the maximum number of parallel tasks for the DCV runtime. | -| [`MinImageCaptureInterval`]({{ site.dcvb_parameters_reference }}capture-vision-template/min-image-capture-interval.html) | Specifies the minimum time interval (in milliseconds) allowed between consecutive image captures. | -| [`Timeout`](../reference/capture-vision-template/timeout.md) | Indicates the maximum amount of time (in milliseconds) that the recognition tasks should take per page.| +## Parameters -
    -

    Table 1 – Parameters Summary of CaptureVisionTemplate

    -
    +| Parameter Name | Type | Required/Optional | Description | +| -------------- | ---- | ----------------- | ----------- | +| [`Name`]({{site.dcvb_parameters_reference}}capture-vision-template/name.html) | String | Required | The unique identifier for this template. | +| [`ImageSourceName`]({{site.dcvb_parameters_reference}}capture-vision-template/image-source-name.html) | String | Optional | The name of the `ImageSource` object defining the input source. | +| [`ImageROIProcessingNameArray`]({{site.dcvb_parameters_reference}}capture-vision-template/image-roi-processing-name-array.html) | String Array | Optional | Array of `TargetROIDef` object names defining recognition tasks on image ROIs. | +| [`SemanticProcessingNameArray`]({{site.dcvb_parameters_reference}}capture-vision-template/semantic-processing-name-array.html) | String Array | Optional | Array of `SemanticProcessing` object names for post-processing tasks. | +| [`OutputOriginalImage`]({{site.dcvb_parameters_reference}}capture-vision-template/output-original-image.html) | Integer | Optional | Whether to output the original input image (0 or 1). | +| [`MaxParallelTasks`]({{site.dcvb_parameters_reference}}capture-vision-template/max-parallel-tasks.html) | Integer | Optional | Maximum number of parallel tasks for the DCV runtime. | +| [`MinImageCaptureInterval`]({{site.dcvb_parameters_reference}}capture-vision-template/min-image-capture-interval.html) | Integer | Optional | Minimum time interval (in milliseconds) between consecutive image captures. | +| [`Timeout`]({{site.dcvb_parameters_reference}}capture-vision-template/timeout.html) | Integer | Optional | Maximum processing time (in milliseconds) per image. | ## Input Source Configuration -In the parameter template, the `ImageSourceName` parameter refers to the `ImageSource` object, which defines the image input source of DCV. When DCV starts capturing, it will parse the `ImageSource` parameter, convert it into an [Image Source Adapter (ISA)](../../architecture/input.md#image-source-adapter) object, and then continuously obtain images from it. +The `ImageSourceName` parameter references an `ImageSource` object defining the image input source. When DCV starts capturing, it parses the `ImageSource` parameter, converts it into an [Image Source Adapter (ISA)]({{site.dcvb_architecture}}input.html#image-source-adapter) object, and continuously obtains images from it. ## Captured Output Configuration -`OuputOriginalImage`, `ImageROIProcessingNameArray` and `SemanticProcessingNameArray` are three different parameters that control the captured output, organized as a `CapturedResult` interface in DCV. `CapturedResult` represents a set of all captured result items on an image. Each type of result Item represents the output of different task types. The following figure lists the rough relationship between DCV output parameters and output results. +`OutputOriginalImage`, `ImageROIProcessingNameArray`, and `SemanticProcessingNameArray` control the captured output, organized as a `CapturedResult` interface in DCV. `CapturedResult` represents a set of all captured result items on an image. Each type of result item represents the output of different task types. The following figure lists the relationship between DCV output parameters and output results. -
    -

    Relationship between DCV parameters and output results

    -

    Figure 1 – Relationship between DCV parameters and output result item types

    -
    +![Relationship between DCV parameters and output result item types](assets/dcv-parameters-result-relationship.png) -As illustrated in figure 1, the left column represents the DCV output parameters, while the right column indicates the type of DCV output result item types. The dashed line between the two displays the rough relationship between parameters and result items types. - -The `ImageROIProcessingNameArray` parameter can produce results such as `BarcodeResultItem`, `TextLineResultItem`, `DetectedQuadResultItem`, and `NormalizedImageResultItem`, while the `SemanticProcessingNameArray` parameter can produce the result of `ParsedResultItem`. This is because the `ImageROIProcessingNameArray` parameter refers to one or more `TargetROIDef` objects, and the `SemanticProcessingNameArray` parameter refers to one or more `SemanticProcessing` objects. - -Next, we will focus on the core design of the `TargetROIDef` and `SemanticProcessing` object. +**Parameter and result relationships:** +- `ImageROIProcessingNameArray` produces `BarcodeResultItem`, `TextLineResultItem`, `DetectedQuadResultItem`, and `NormalizedImageResultItem` +- `SemanticProcessingNameArray` produces `ParsedResultItem` +- `ImageROIProcessingNameArray` references one or more `TargetROIDef` objects +- `SemanticProcessingNameArray` references one or more `SemanticProcessing` objects ## Core Design of TargetROIDef Object -The [`TargetROIDef`](./target-roi-definition/index.md) object is used to specify one or more recognition tasks to be performed on some regions of interest (ROIs) within an image. In simple terms, [`TargetROIDef`](./target-roi-definition/index.md) can be expressed using the following formula: +The [`TargetROIDef`]({{site.dcvb_parameters}}file/target-roi-definition/index.html) object specifies one or more recognition tasks to be performed on regions of interest (ROIs) within an image. In simple terms: ``` TargetROIDef = Recognition Task Definition + Spatial Location Definition @@ -74,83 +63,77 @@ TargetROIDef = Recognition Task Definition + Spatial Location Definition ### Key Concepts -The following figure and table briefly illustrates some key concepts involved. - -
    -

    An example showing the key concepts

    -

    Figure 2 – An example showing the key concepts

    -
    +![An example showing the key concepts](assets/roi-concept.png) -|Concept|Description|Explanation with example| -|:------|:----------|:-----------------------| -|**Recognition Tasks**| The tasks include barcode recognition, label recognition, document boundary detection, etc.| `ROI1` and `ROI2` are two `TargetROIDef` objects. A task named `barcode_task` is configured on `ROI1` and a task named `label_task` is configured on `ROI2`.| -|**Atomic Result**| Represents the atomic result of the recognition task output. It can be a color detection region, a barcode, a text line, a table cell, a detected quadrilateral etc.|`T1`, `T2`, `T3` are three atomic result objects of `TextLineResultItem` type, and B1 is one atomic object of `BarcodeResultItem` type.| -|**Spatial Location**| A `Location` configured on a `TargetROIDef` may generate zero or more target regions on which to perform a specific recognition task.| `ROI1.Location` is defined as `null` which means generate only one target regions. `ROI2.Location` is defined as an upward offset relative to the output regions of `ROI1`.| -|**Reference Region**|A reference region is a physical quadrilateral region. It includes two types: **entire image region** and **atomic result region**. The former refers to the quadrilateral extent of the original image, and the latter refers to the quadrilateral extent of each atomic result.| `ROI1` has only one reference region which is the entire image region. `ROI2` has three reference regions which generated from `T1`, `T2`, `T3`. | -|**Target Region**| A target region is a physical quadrilateral region, which is calculated from a reference region and offset.| `ROI1` has only one target region, which is equal to the reference region. `ROI2` has three target regions, which are calculated by offsets from quadrilateral regions of `T1`, `T2`, `T3`.| - -
    -

    Table 2 – Key Concepts of TargetROIDef

    -
    +| Concept | Description | Example Explanation | +| :------ | :---------- | :------------------ | +| **Recognition Tasks** | Tasks include barcode recognition, label recognition, document boundary detection, etc. | `ROI1` and `ROI2` are two `TargetROIDef` objects. Task `barcode_task` is configured on `ROI1` and task `label_task` is configured on `ROI2`. | +| **Atomic Result** | Atomic result of recognition task output. Can be a color detection region, barcode, text line, table cell, detected quadrilateral, etc. | `T1`, `T2`, `T3` are three `TextLineResultItem` objects, and `B1` is one `BarcodeResultItem` object. | +| **Spatial Location** | A `Location` configured on a `TargetROIDef` may generate zero or more target regions on which to perform recognition tasks. | `ROI1.Location` is `null`, generating one target region. `ROI2.Location` is an upward offset relative to `ROI1` output regions. | +| **Reference Region** | A physical quadrilateral region. Two types: **entire image region** and **atomic result region**. The former is the quadrilateral extent of the original image; the latter is the quadrilateral extent of each atomic result. | `ROI1` has one reference region (entire image). `ROI2` has three reference regions generated from `T1`, `T2`, `T3`. | +| **Target Region** | A physical quadrilateral region calculated from a reference region and offset. | `ROI1` has one target region equal to the reference region. `ROI2` has three target regions calculated by offsets from `T1`, `T2`, `T3` quadrilateral regions. | ### Workflow Design Based on Reference/Target Regions -Using the recursive definition of the reference relationship between different `TargetROIDef` objects, a complex workflow can be constructed to meet the requirements of complex scenarios. - -Let's consider the following example: a user wants to read barcodes below `P/N` and above `L/N` in the image below. Upon analysis, we find the following positional dependencies: +Using recursive definition of reference relationships between `TargetROIDef` objects, complex workflows can be constructed for complex scenarios. -- The rough location of the target barcode (blue box) can be calculated separately from the location of the text lines (`P/N` and `L/N`). -- The text lines (`P/N` and `L/N`) are on the first and fifth lines inside the label border (green box). +**Example:** Read barcodes below `P/N` and above `L/N` in the image. Positional dependencies: +- Target barcode location (blue box) can be calculated from text line locations (`P/N` and `L/N`) +- Text lines (`P/N` and `L/N`) are on the first and fifth lines inside the label border (green box) -
    -

    Basic concepts of TargetROIDef

    -

    Figure 3 – A sample image illustrating workflow design

    -
    +![Sample image illustrating workflow design](assets/example2.png) The following json is a parameter template fragment that configures ROI dependencies to solve the above problems. ```json { - "TargetROIDefOptions" : [ + "TargetROIDefOptions": [ { - "Name" : "ddn_roi", - "TaskSettingNameArray": [ "ddn_task" ], - "Location" : null - }, + "Name": "ddn_roi", + "TaskSettingNameArray": ["ddn_task"], + "Location": null + }, { - "Name" : "dlr_roi", - "TaskSettingNameArray": [ "dlr_task" ], - "Location": - { - "ReferenceObjectFilter" : { - "ReferenceTargetROIDefNameArray": ["ddn_roi"], + "Name": "dlr_roi", + "TaskSettingNameArray": ["dlr_task"], + "Location": { + "ReferenceObjectFilter": { + "ReferenceTargetROIDefNameArray": ["ddn_roi"] }, "Offset": null } }, { - "Name" : "dbr_roi1", - "TaskSettingNameArray": [ "dbr_task" ], - "Location": - { - "ReferenceObjectFilter" : { - "ReferenceTargetROIDefNameArray": ["dlr_roi"], + "Name": "dbr_roi1", + "TaskSettingNameArray": ["dbr_task"], + "Location": { + "ReferenceObjectFilter": { + "ReferenceTargetROIDefNameArray": ["dlr_roi"] }, - "Offset":{ - // offset downwards + "Offset": { + "MeasuredByPercentage": 0, + "ReferenceYAxis": {"AxisType": "AT_EDGE", "EdgeIndex": 2}, + "FirstPoint": [0, 10], + "SecondPoint": [100, 10], + "ThirdPoint": [100, 50], + "FourthPoint": [0, 50] } } }, { - "Name" : "dbr_roi2", - "TaskSettingNameArray": [ "dbr_task" ], - "Location": - { - "ReferenceObjectFilter" : { - "ReferenceTargetROIDefNameArray": ["dlr_roi"], + "Name": "dbr_roi2", + "TaskSettingNameArray": ["dbr_task"], + "Location": { + "ReferenceObjectFilter": { + "ReferenceTargetROIDefNameArray": ["dlr_roi"] }, - "Offset":{ - // offset upwards + "Offset": { + "MeasuredByPercentage": 0, + "ReferenceYAxis": {"AxisType": "AT_EDGE", "EdgeIndex": 0}, + "FirstPoint": [0, -50], + "SecondPoint": [100, -50], + "ThirdPoint": [100, -10], + "FourthPoint": [0, -10] } } } @@ -158,96 +141,85 @@ The following json is a parameter template fragment that configures ROI dependen } ``` -
    -

    Example 2 – DCV parameter template fragment illustrating workflow design

    -
    - -- It configures four `TargetROIDef` objects: `ddn_roi`, `dlr_roi`, `dbr_roi1`, and `dbr_roi2`. -- `ddn_roi` is configured to depend on the entire image region directly. -- `dlr_roi` is configured to depend on `ddn_roi` and has a `null` offset, which means it uses the same region as the output region of `ddn_roi`. -- `dbr_roi1` is configured to depend on `dlr_roi` and has an offset configured to be shifted downwards from the output region of `dlr_roi`. -- `dbr_roi2` is also configured to depend on `dlr_roi` and has an offset configured to be shifted upwards from the output region of `dlr_roi`. +**In this configuration:** +- Four `TargetROIDef` objects: `ddn_roi`, `dlr_roi`, `dbr_roi1`, and `dbr_roi2` +- `ddn_roi` depends on the entire image region +- `dlr_roi` depends on `ddn_roi` with null offset (same region) +- `dbr_roi1` depends on `dlr_roi` with downward offset +- `dbr_roi2` depends on `dlr_roi` with upward offset ### Construct a Dependency Graph -When DCV parses the `TargetROIDef` objects in the above parameter template, it constructs a directed dependency graph based on the configured dependencies between different `TargetROIDef` objects. During actual execution, the tasks are executed in the order specified by the dependency graph. The following figure illustrates the generated dependency graph after parsing the above template fragment. +When DCV parses `TargetROIDef` objects, it constructs a directed dependency graph based on configured dependencies. Tasks execute in the order specified by the dependency graph. -
    -

    Dependency Graph

    -

    Figure 4 – Dependency Graph

    -
    +![Dependency Graph](assets/dependency-graph.png) ### Filter Out the Desired Reference Regions -In practical applications, if a `TargetROIDef` depends on another `TargetROIDef` object named `roi1`, it may not want to depend unconditionally on all the reference regions generated by `roi1`. Instead, it may want to depend only on those regions that meet certain filtering conditions, such as the text meeting a specific regular expression or the barcode type meeting specific formatting requirements. +In practical applications, a `TargetROIDef` may want to depend only on reference regions from another `TargetROIDef` that meet specific filtering conditions, such as text matching a regular expression or barcodes meeting a specific format requirements. -Based on `Example 2`, regular expression filtering conditions are added to `dbr_roi1` and `dbr_roi2`: +Based on the previous example, regular expression filtering conditions can be added to `dbr_roi1` and `dbr_roi2`: ```json { - "TargetROIDefOptions" : [ - //...... + "TargetROIDefOptions": [ { - "Name" : "roi_dbr1", - //...... - "Location": - { - "ReferenceObjectFilter" : { - "ReferenceTargetROIDefNameArray": ["roi_dlr"], - "TextLineFilteringCondition": - { - "LineStringRegExPattern": "^P/N" + "Name": "roi_dbr1", + "TaskSettingNameArray": ["dbr_task"], + "Location": { + "ReferenceObjectFilter": { + "ReferenceTargetROIDefNameArray": ["roi_dlr"], + "TextLineFilteringCondition": { + "LineStringRegExPattern": "^P/N" } }, - //...... + "Offset": {} } }, { - "Name" : "roi_dbr2", - //...... - "Location": - { - "ReferenceObjectFilter" : { - "ReferenceTargetROIDefNameArray": ["roi_dlr"], - "TextLineFilteringCondition": - { - "LineStringRegExPattern": "^L/N" + "Name": "roi_dbr2", + "TaskSettingNameArray": ["dbr_task"], + "Location": { + "ReferenceObjectFilter": { + "ReferenceTargetROIDefNameArray": ["roi_dlr"], + "TextLineFilteringCondition": { + "LineStringRegExPattern": "^L/N" } }, - //...... + "Offset": {} } } ] } ``` -- `roi_dbr1` is configured to only depend on the reference region generated by `roi_dlr` that meet the regular expression "^P/N". -- `roi_dbr2` is configured to only depend on the reference region generated by `roi_dlr` that meet the regular expression "^L/N". - -At runtime, reference regions that do not meet the filtering conditions will be discarded and will not be passed as inputs to subsequent `TargetROIDef` for further processing. +**Filtering logic:** +- `roi_dbr1` depends only on regions from `roi_dlr` where text matches pattern `^P/N` +- `roi_dbr2` depends only on regions from `roi_dlr` where text matches pattern `^L/N` +- Reference regions not meeting filter criteria are discarded -For more details about filtering reference objects, please refer to [`ReferenceObjectFilter`]({{site.dcvb_parameters}}reference/target-roi-def/location.html#referenceobjectfilter) +For more details about filtering reference objects, refer to [`ReferenceObjectFilter`]({{site.dcvb_parameters_reference}}target-roi-def/location.html#referenceobjectfilter). ## Core Design of SemanticProcessing Object -The [`SemanticProcessing`](./semantic-processing/index.md) object is used to specify one or more tasks to analyze and extract information from image ROI processing results. The whole workflow typically involves following concepts. +The [`SemanticProcessing`]({{site.dcvb_parameters}}file/semantic-processing/index.html) object specifies tasks to analyze and extract information from image ROI processing results. The workflow involves the following concepts: ### Prerequisites -A `SemanticProcessing` object will take effect when its name is referenced in `CaptureVisionTemplate.SemanticProcessingNameArray`. +A `SemanticProcessing` object takes effect when its name is referenced in `CaptureVisionTemplate.SemanticProcessingNameArray`. ### Launch Timing -The semantic process is triggered only after all the recognition tasks referenced in `CaptureVisionTemplate.ImageROIProcessingNameArray` have been completed. +The semantic process triggers only after all recognition tasks referenced in `CaptureVisionTemplate.ImageROIProcessingNameArray` have been completed. ### Data Filtering -In many cases, the process may involve filtering data to select only the relevant sources, such as a label text meeting a specific regular expression or a barcode meeting a specific format. `ReferenceObjectFilter` is used to specify such data filtering criteria. +Data filtering selects relevant sources, such as label text matching a specific regular expression or barcodes meeting a specific format. Use `ReferenceObjectFilter` to specify data filtering criteria. ### Task Execution -This is the main part of the workflow where the actual tasks are defined. `TaskSettingNameArray` is used to specify such tasks by referencing the name of a [`CodeParserTaskSetting`]({{site.dcvb_parameters}}file/task-settings/code-parser-task-settings.html) object. +This is the main part of the workflow where actual tasks are defined. Use `TaskSettingNameArray` to specify tasks by referencing a [`CodeParserTaskSetting`]({{site.dcvb_parameters}}file/task-settings/code-parser-task-settings.html) object name. ### Results Reporting -Currently, semantic-processing supports code parsing tasks, so the result is returned with callback [`OnParsedResultsReceived`](). \ No newline at end of file +Currently, semantic-processing supports code parsing tasks. Results are returned with the `OnParsedResultsReceived` callback. \ No newline at end of file diff --git a/parameters/file/image-parameter.md b/parameters/file/image-parameter.md index 0a33568..79ec26e 100644 --- a/parameters/file/image-parameter.md +++ b/parameters/file/image-parameter.md @@ -3,73 +3,55 @@ layout: default-layout title: ImageParameter - Dynamsoft Capture Vision Parameter File description: ImageParameter in the Dynamsoft Capture Vision Parameter File is an object for configuring common image processing steps. keywords: image parameter, image processing, setting -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: false --- # ImageParameter Object -The ImageParameter object is designed to configure and organize parameters for image processing stages, including but not limited to convert color-to-grayscale stage, enhance grayscale image stage, binarize image stage, detect text zone stage, and detect texture stage. You can configure detailed parameters for each stage. +The `ImageParameter` object is designed to configure and organize parameters for image processing stages, including convert color-to-grayscale, enhance grayscale, binarize image, detect text zones, and detect texture stages. You can configure detailed parameters for each stage. + +## Example ```json -"ImageParameterOptions": [ - { - "Name" : "ip_default", - "BaseImageParameterName": "ip_base", - "ApplicableStages":[ - { "Stage": "SST_SCALE_IMAGE", "ImageScaleSetting" : {} }, - { "Stage": "SST_CONVERT_TO_GRAYSCALE", "ColourConversionModes" : [] }, - { "Stage": "SST_TRANSFORM_GRAYSCALE", "GrayscaleTransformationModes" : [] }, - { "Stage": "SST_ENHANCE_GRAYSCALE", "GrayscaleEnhancementModes" : [] }, - { "Stage": "SST_BINARIZE_IMAGE", "BinarizationModes" : [] }, - { "Stage": "SST_DETECT_TEXTURE", "TextureDetectionModes" : [] }, - { "Stage": "SST_REMOVE_TEXTURE_FROM_GRAYSCALE" }, - { "Stage": "SST_BINARIZE_TEXTURE_REMOVED_GRAYSCALE" }, - { "Stage": "SST_FIND_CONTOURS" }, - { "Stage": "SST_DETECT_SHORTLINES", "ShortlineDetectionMode": {} }, - { "Stage": "SST_ASSEMBLE_LINES", "LineAssemblyMode": {} }, - { "Stage": "SST_DETECT_TEXT_ZONES", "TextDetectionMode": {} }, - { "Stage": "SST_REMOVE_TEXT_ZONES_FROM_BINARY", "IfEraseTextZone": 0 } - ] - } -], +{ + "ImageParameterOptions": [ + { + "Name": "ip_default", + "BaseImageParameterName": "ip_base", + "ApplicableStages": [ + {"Stage": "SST_SCALE_IMAGE", "ImageScaleSetting": {}}, + {"Stage": "SST_CONVERT_TO_GRAYSCALE", "ColourConversionModes": []}, + {"Stage": "SST_TRANSFORM_GRAYSCALE", "GrayscaleTransformationModes": []}, + {"Stage": "SST_ENHANCE_GRAYSCALE", "GrayscaleEnhancementModes": []}, + {"Stage": "SST_BINARIZE_IMAGE", "BinarizationModes": []}, + {"Stage": "SST_DETECT_TEXTURE", "TextureDetectionModes": []}, + {"Stage": "SST_REMOVE_TEXTURE_FROM_GRAYSCALE"}, + {"Stage": "SST_BINARIZE_TEXTURE_REMOVED_GRAYSCALE"}, + {"Stage": "SST_FIND_CONTOURS"}, + {"Stage": "SST_DETECT_SHORTLINES", "ShortlineDetectionMode": {}}, + {"Stage": "SST_ASSEMBLE_LINES", "LineAssemblyMode": {}}, + {"Stage": "SST_DETECT_TEXT_ZONES", "TextDetectionMode": {}}, + {"Stage": "SST_REMOVE_TEXT_ZONES_FROM_BINARY", "IfEraseTextZone": 0} + ] + } + ] +} ``` -- [Name]({{ site.dcvb_parameters_reference }}image-parameter/name.html) -- [BaseImageParameterName]({{ site.dcvb_parameters_reference }}image-parameter/base-image-parameter-name.html) -- [ApplicableStages]({{ site.dcvb_parameters_reference }}image-parameter/applicable-stages.html) - - [Scale Image Stage]({{ site.dcvb_parameters_reference }}image-parameter/stage-scale-image.html) - - [ImageScaleSetting]({{ site.dcvb_parameters_reference }}image-parameter/image-scale-settings.html) - - [Convert to Grayscale Stage]({{ site.dcvb_parameters_reference }}image-parameter/stage-convert-to-grayscale.html) - - [ColourConversionModes]({{ site.dcvb_parameters_reference }}image-parameter/colour-conversion-modes.html) - - [Transform Grayscale Stage]({{ site.dcvb_parameters_reference }}image-parameter/stage-transform-grayscale.html) - - [GrayscaleTransformationModes]({{ site.dcvb_parameters_reference }}image-parameter/grayscale-transformation-modes.html) - - [Enhance Grayscale Stage]({{ site.dcvb_parameters_reference }}image-parameter/stage-enhance-grayscale.html) - - [GrayscaleEnhancementModes]({{ site.dcvb_parameters_reference }}image-parameter/grayscale-enhancement-modes.html) - - [Binarize Image Stage]({{ site.dcvb_parameters_reference }}image-parameter/stage-binarize-image.html) - - [BinarizationModes]({{ site.dcvb_parameters_reference }}image-parameter/binarization-modes.html) - - [Detect Texture Stage]({{ site.dcvb_parameters_reference }}image-parameter/stage-detect-texture.html) - - [TextureDetectionModes]({{ site.dcvb_parameters_reference }}image-parameter/texture-detection-modes.html) - - [Remove Texture From Grayscale Stage]({{ site.dcvb_parameters_reference }}image-parameter/stage-remove-texture-from-grayscale.html) - - [Binarize Texture Removed Grayscale Stage]({{ site.dcvb_parameters_reference }}image-parameter/stage-binarize-texture-removed-grayscale.html) - - [Find Contours Stage]({{ site.dcvb_parameters_reference }}image-parameter/stage-find-contours.html) - - [Detect Shortlines Stage]({{ site.dcvb_parameters_reference }}image-parameter/stage-detect-shortlines.html) - - [ShortlineDetectionMode]({{ site.dcvb_parameters_reference }}image-parameter/shortline-detection-mode.html) - - [Assemble Lines Stage]({{ site.dcvb_parameters_reference }}image-parameter/stage-assemble-lines.html) - - [LineAssemblyMode]({{ site.dcvb_parameters_reference }}image-parameter/line-assembly-mode.html) - - [Detect Text Zones Stage]({{ site.dcvb_parameters_reference }}image-parameter/stage-detect-text-zones.html) - - [TextDetectionMode]({{ site.dcvb_parameters_reference }}image-parameter/text-detection-mode.html) - - [Remove Text Zones From Binary Stage]({{ site.dcvb_parameters_reference }}image-parameter/stage-remove-text-zones-from-binary.html) - - [IfEraseTextZone]({{ site.dcvb_parameters_reference }}image-parameter/if-erase-text-zone.html) - -## Definition and Reference - -Each algorithm section of the funtional products has a default `ImageParameter` settings. You can either skip the ImageParameter settings to implement the default settings or define your own `ImageParameter` objects and specify them in the sections you want to customize. - -### Define an ImageParameter Object - -`ImageParameter` objects are configured under `ImageParameterOptions` and each object has a unique name as its identifier. +## Parameters + +| Parameter Name | Type | Required/Optional | Description | +| -------------- | ---- | ----------------- | ----------- | +| [`Name`]({{site.dcvb_parameters_reference}}image-parameter/name.html) | String | Required | The unique identifier for this `ImageParameter` object. | +| [`BaseImageParameterName`]({{site.dcvb_parameters_reference}}image-parameter/base-image-parameter-name.html) | String | Optional | The name of another `ImageParameter` object to inherit settings from. | +| [`ApplicableStages`]({{site.dcvb_parameters_reference}}image-parameter/applicable-stages.html) | Array | Optional | An array of stage objects defining the image processing pipeline. | + +## Usage + +Each functional product has default `ImageParameter` settings. You can either use the defaults or define custom `ImageParameter` objects for specific sections. + +### Defining ImageParameter Objects + +`ImageParameter` objects are configured under `ImageParameterOptions`, each with a unique name: ```json { @@ -84,7 +66,7 @@ Each algorithm section of the funtional products has a default `ImageParameter` } ``` -You can define a new `ImageParameter` object based on an existing `ImageParameter` object. For example: +You can create a new `ImageParameter` based on an existing one using inheritance: ```json { @@ -94,20 +76,19 @@ You can define a new `ImageParameter` object based on an existing `ImageParamete }, { "Name": "IP_1", - "BaseImageParameterName" : "IP_0" + "BaseImageParameterName": "IP_0" } ] } ``` -### Specify an ImageParameter for Task Sections +### Referencing in Task Settings -`ImageParameter` is referenced in task settings under `SectionImageParameterArray` with their names. For example: +Reference `ImageParameter` objects in task settings by name: ```json { - "SectionArray": - [ + "SectionArray": [ { "Section": "ST_REGION_PREDETECTION", "ImageParameterName": "IP_0" @@ -124,30 +105,35 @@ You can define a new `ImageParameter` object based on an existing `ImageParamete } ``` -## Summary of ImageParameter Top-level Parameters - -View the parameter references for the details of each `ImageParameter` parameters. - -| Parameter Name | Description | -| ---------------------------------- | ----------- | -| [`BaseImageParameterName`](../reference/image-parameter/base-image-parameter-name.md) | Represents the name of another `ImageParameter` object to inherit from. | -| [`Name`](../reference/image-parameter/name.md) | Defines the name of a `ImageParameter` object, which serves as its unique identifier. | -| [`ApplicableStages`](../reference/image-parameter/applicable-stages.md) | Defines the applicable stage parameters with an array of stage objects. | - ## Available Stages | Stage Name | Description | | ---------- | ----------- | -| [`SST_SCALE_IMAGE`](../reference/image-parameter/stage-scale-image.md) | The stage for scaling up or down the image. | -| [`SST_CONVERT_TO_GRAYSCALE`](../reference/image-parameter/stage-convert-to-grayscale.md) | The stage for converting a colour image to a grayscale image. | -| [`SST_TRANSFORM_GRAYSCALE`](../reference/image-parameter/stage-transform-grayscale.md) | The stage for transforming the grayscale image. Generally used when processing inverted barcodes or text lines. | -| [`SST_ENHANCE_GRAYSCALE`](../reference/image-parameter/stage-enhance-grayscale.md) | The stage for enhancing the quality of the grayscale image. | -| [`SST_BINARIZE_IMAGE`](../reference/image-parameter/stage-binarize-image.md) | The stage for binarizing the image. | -| [`SST_DETECT_TEXTURE`](../reference/image-parameter/stage-detect-texture.md) | The stage for detecting texture on the image. | -| [`SST_REMOVE_TEXTURE_FROM_GRAYSCALE`](../reference/image-parameter/stage-remove-texture-from-grayscale.md) | The stage for removing texture from the grayscale image. | -| [`SST_BINARIZE_TEXTURE_REMOVED_GRAYSCALE`](../reference/image-parameter/stage-binarize-texture-removed-grayscale.md) | The stage for binarizing the texture removed grayscale image. | -| [`SST_FIND_CONTOURS`](../reference/image-parameter/stage-find-contours.md) | The stage for finding contours in the image. | -| [`SST_DETECT_SHORTLINES`](../reference/image-parameter/stage-detect-shortlines.md) | The stage for detecting short lines for document boundary detection. | -| [`SST_ASSEMBLE_LINES`](../reference/image-parameter/stage-assemble-lines.md) | The stage for assembling lines. | -| [`SST_DETECT_TEXT_ZONES`](../reference/image-parameter/stage-detect-text-zones.md) | The stage for detecting text zones on the image. | -| [`SST_REMOVE_TEXT_ZONES_FROM_BINARY`](../reference/image-parameter/stage-remove-text-zones-from-binary.md) | The stage for removing text zones from the binary image. | +| [`SST_SCALE_IMAGE`]({{site.dcvb_parameters_reference}}image-parameter/stage-scale-image.html) | Scales the image up or down. | +| [`SST_CONVERT_TO_GRAYSCALE`]({{site.dcvb_parameters_reference}}image-parameter/stage-convert-to-grayscale.html) | Converts a color image to grayscale. | +| [`SST_TRANSFORM_GRAYSCALE`]({{site.dcvb_parameters_reference}}image-parameter/stage-transform-grayscale.html) | Transforms the grayscale image (e.g., for inverted barcodes). | +| [`SST_ENHANCE_GRAYSCALE`]({{site.dcvb_parameters_reference}}image-parameter/stage-enhance-grayscale.html) | Enhances grayscale image quality. | +| [`SST_BINARIZE_IMAGE`]({{site.dcvb_parameters_reference}}image-parameter/stage-binarize-image.html) | Converts grayscale to binary image. | +| [`SST_DETECT_TEXTURE`]({{site.dcvb_parameters_reference}}image-parameter/stage-detect-texture.html) | Detects texture patterns in the image. | +| [`SST_REMOVE_TEXTURE_FROM_GRAYSCALE`]({{site.dcvb_parameters_reference}}image-parameter/stage-remove-texture-from-grayscale.html) | Removes texture from grayscale image. | +| [`SST_BINARIZE_TEXTURE_REMOVED_GRAYSCALE`]({{site.dcvb_parameters_reference}}image-parameter/stage-binarize-texture-removed-grayscale.html) | Binarizes the texture-removed grayscale image. | +| [`SST_FIND_CONTOURS`]({{site.dcvb_parameters_reference}}image-parameter/stage-find-contours.html) | Finds contours in the image. | +| [`SST_DETECT_SHORTLINES`]({{site.dcvb_parameters_reference}}image-parameter/stage-detect-shortlines.html) | Detects short lines for document boundary detection. | +| [`SST_ASSEMBLE_LINES`]({{site.dcvb_parameters_reference}}image-parameter/stage-assemble-lines.html) | Assembles detected lines. | +| [`SST_DETECT_TEXT_ZONES`]({{site.dcvb_parameters_reference}}image-parameter/stage-detect-text-zones.html) | Detects text zones in the image. | +| [`SST_REMOVE_TEXT_ZONES_FROM_BINARY`]({{site.dcvb_parameters_reference}}image-parameter/stage-remove-text-zones-from-binary.html) | Removes text zones from binary image. | + +## Stage Parameters + +Each stage can have associated parameters for fine-tuning: + +- **SST_SCALE_IMAGE**: [`ImageScaleSetting`]({{site.dcvb_parameters_reference}}image-parameter/image-scale-settings.html) +- **SST_CONVERT_TO_GRAYSCALE**: [`ColourConversionModes`]({{site.dcvb_parameters_reference}}image-parameter/colour-conversion-modes.html) +- **SST_TRANSFORM_GRAYSCALE**: [`GrayscaleTransformationModes`]({{site.dcvb_parameters_reference}}image-parameter/grayscale-transformation-modes.html) +- **SST_ENHANCE_GRAYSCALE**: [`GrayscaleEnhancementModes`]({{site.dcvb_parameters_reference}}image-parameter/grayscale-enhancement-modes.html) +- **SST_BINARIZE_IMAGE**: [`BinarizationModes`]({{site.dcvb_parameters_reference}}image-parameter/binarization-modes.html) +- **SST_DETECT_TEXTURE**: [`TextureDetectionModes`]({{site.dcvb_parameters_reference}}image-parameter/texture-detection-modes.html) +- **SST_DETECT_SHORTLINES**: [`ShortlineDetectionMode`]({{site.dcvb_parameters_reference}}image-parameter/shortline-detection-mode.html) +- **SST_ASSEMBLE_LINES**: [`LineAssemblyMode`]({{site.dcvb_parameters_reference}}image-parameter/line-assembly-mode.html) +- **SST_DETECT_TEXT_ZONES**: [`TextDetectionMode`]({{site.dcvb_parameters_reference}}image-parameter/text-detection-mode.html) +- **SST_REMOVE_TEXT_ZONES_FROM_BINARY**: [`IfEraseTextZone`]({{site.dcvb_parameters_reference}}image-parameter/if-erase-text-zone.html) diff --git a/parameters/file/image-source.md b/parameters/file/image-source.md index d808abf..eee3117 100644 --- a/parameters/file/image-source.md +++ b/parameters/file/image-source.md @@ -28,30 +28,16 @@ An `ImageSource` object defines an image source to be created and maintained by } ``` -
    -

    Example 1 – Parameters of ImageSource

    -
    ## Summary of ImageSource top-level parameters | Parameter Name | Description | | ---------------- | -------------------------------------------------------------------------------------------------------- | -| `Name` | Represents the name of the ImageSource object, which serves as its unique identifier. | -| `Type` | Indicates the type of the `ImageSource` object, which helps CVR create the correct type of image source. | -| `DirectoryPath` | Specifies a local directory, the files within which are fetched as images to process. | -| `FileFilter` | Specifies a file name filter string, which determines which files are fetched. | -| `Recursive` | Indicates whether to fetch files recursively. | -| `PDFReadingMode` | Defines how to handle PDF files. | -| `Pages` | Sets the 0-based page indexes of a file (.tiff or .pdf) for barcode searching. | +| [`Name`]({{ site.dcvb_parameters_reference }}image-source-options/name.html) | Represents the name of the `ImageSource` object, which serves as its unique identifier. | +| [`Type`]({{ site.dcvb_parameters_reference }}image-source-options/type.html) | Indicates the type of the `ImageSource` object, which helps CVR create the correct type of image source. | +| [`DirectoryPath`]({{ site.dcvb_parameters_reference }}image-source-options/directory-path.html) | Specifies a local directory, the files within which are fetched as images to process. | +| [`FileFilter`]({{ site.dcvb_parameters_reference }}image-source-options/file-filter.html) | Specifies a file name filter string, which determines which files are fetched. | +| [`Recursive`]({{ site.dcvb_parameters_reference }}image-source-options/recursive.html) | Indicates whether to fetch files recursively. | +| [`PDFReadingMode`]({{ site.dcvb_parameters_reference }}image-source-options/pdf-reading-mode.html) | Defines how to handle PDF files. | +| [`Pages`]({{ site.dcvb_parameters_reference }}image-source-options/pages.html) | Sets the 0-based page indexes of a file (.tiff or .pdf) for barcode searching. | -
    -

    Table 1 – Parameters Summary of ImageSource

    -
    - -### Sub Parameters of PDFReadingMode - -| Parameter Name | Description | -| -------------- | ----------------------------------------------------------------------------------------------------- | -| `Mode` | Specifies the operation mode. Read more about [PDFReadingMode](../../enums/core/pdf-reading-mode.md). | -| `DPI` | Specifies the DPI used when rasterizing a PDF into images. | -| `TargetType` | Specifies a the target type. Read more about [TargetType](../../enums/core/target-type.md). | \ No newline at end of file diff --git a/parameters/file/index.md b/parameters/file/index.md index d91d929..9cc472d 100644 --- a/parameters/file/index.md +++ b/parameters/file/index.md @@ -16,18 +16,50 @@ Dynamsoft Capture Vision (DCV) is designed for high scalability and flexibility, In order to eliminate ambiguity, we first define several key terms. -1. **Parameter** -A parameter is designed to represent a particular aspect of the behavior of the SDK, and each parameter has its own name. For instance, the `ExpectedBarcodesCount` parameter is used to control the expected number of recognized barcodes in the image or frame. Parameters can be configured with specific values or a range of values, which can be adjusted as required. +- **Parameter** - A parameter is designed to represent a particular aspect of the behavior of the SDK, and each parameter has its own name. For instance, the `ExpectedBarcodesCount` parameter is used to control the expected number of recognized barcodes in the image or frame. Parameters can be configured with specific values or a range of values, which can be adjusted as required. -1. **Parameter template** -A parameter template is a collection of parameters organized in a structured manner, expressed in JSON format. The name of the `CaptureVisionTemplate` object is also called "template name", which is a unique identifier assigned to each parameter template. In the DCV SDK, this name is used to load the relevant configurations and control runtime behavior. +- **Parameter template** - A parameter template is a collection of parameters organized in a structured manner, expressed in JSON format. The name of the `CaptureVisionTemplate` object is also called "template name", which is a unique identifier assigned to each parameter template. In the DCV SDK, this name is used to load the relevant configurations and control runtime behavior. -1. **Parameter template file** -A parameter template file is a JSON file that contains one or multiple parameter templates. - -## Structure of a Parameter Template File - -As shown in the example below, the organizational structure of a parameter template file consists of several top-level objects such as `CaptureVisionTemplates`, `ImageSourceOptions`,`TargetROIDefOptions` etc. +- **Parameter template file** - A parameter template file is a JSON file that contains one or multiple parameter templates. + +## Organization of a Parameter Template File + +With the exception of `GlobalParameter`, all top-level keys in the parameter template file are arrays of the corresponding object. For example,`CaptureVisionTemplates` is an array of `CaptureVisionTemplate` objects, and `TargetROIDefOptions` is an array of `TargetROIDef` objects, and so on. + +> [!NOTE] +> **For Dynamsoft Barcode Reader SDK Users:** +> +> When using Dynamsoft Barcode Reader SDK standalone (without other DCV functional products), the following objects and their parameters are not applicable: +> - `LabelRecognizerTaskSettingOptions` +> - `DocumentNormalizerTaskSettingOptions` +> - `CodeParserTaskSettingOptions` +> - `OutputTaskSettingOptions` +> - `TextLineSpecificationOptions` +> - `SemanticProcessingOptions` + +The following table list all the top-level keys. + +| Key Name | Description | +| :--------------------------| :----------- | +| `CaptureVisionTemplates` | Array of [CaptureVisionTemplate]({{site.dcvb_parameters}}file/capture-vision-template.html) objects. `CaptureVisionTemplate` is the entry object of a parameter template in DCV. The `Name` parameter represents the name of the parameter template, which serves as its unique identifier.| +| `ImageSourceOptions` | Array of [ImageSource]({{site.dcvb_parameters}}file/image-source.html) objects. `ImageSource` defines the input for DCV responsible for providing images to DCV. It can be defined as different image sources, including but not limited to, image directories, scanners, cameras, etc.| +| `TargetROIDefOptions` | Array of [TargetROIDef]({{site.dcvb_parameters}}file/target-roi-definition/index.html) objects. `TargetROIDef` specifies one or more recognition tasks to be performed on some regions of interest (ROIs) within an image.| +| `BarcodeReaderTaskSettingOptions` | Array of [BarcodeReaderTaskSetting]({{site.dcvb_parameters}}file/task-settings/barcode-reader-task-settings.html) objects. `BarcodeReaderTaskSetting` configures the settings for barcode reading tasks performed on images in DCV. | +| `LabelRecognizerTaskSettingOptions` | Array of [LabelRecognizerTaskSetting]({{site.dcvb_parameters}}file/task-settings/label-recognizer-task-settings.html) objects. `LabelRecognizerTaskSetting` configures the settings for label recognition tasks performed on images in DCV.| +| `DocumentNormalizerTaskSettingOptions` | Array of [DocumentNormalizerTaskSetting]({{site.dcvb_parameters}}file/task-settings/document-normalizer-task-settings.html) objects. `DocumentNormalizerTaskSetting` configures the settings for the document detection or normalization process of an image in DCV. | +| `CodeParserTaskSettingOptions` | Array of [CodeParserTaskSetting]({{site.dcvb_parameters}}file/task-settings/code-parser-task-settings.html) objects. `CodeParserTaskSetting` configures the code parsing tasks such as passport MRZ, driving license and other user specific tasks in DCV etc.| +| `OutputTaskSettingOptions` | Array of [OutputTaskSetting]({{site.dcvb_parameters}}file/task-settings/output-task-setting.html) objects. `OutputTaskSetting` configures how to output the expected results of the ancestor `TargetROIDef` by filtering the results of the descendant `TargetROIDef` object. | +| `ImageParameterOptions` | Array of [ImageParameter]({{site.dcvb_parameters}}file/image-parameter.html) objects. `ImageParameter` provides various image-processing features to adjust and enhance the input image for better recognition results.| +| `BarcodeFormatSpecificationOptions` | Array of [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/capture-vision-model.html) objects. `BarcodeFormatSpecification` sets configurations for specified barcode formats.| +| `TextLineSpecificationOptions` | Array of [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/textline-specification.html) objects. `TextLineSpecification` defines configurations for the specified text lines.| +| `CaptureVisionModelOptions` | Array of [CaptureVisionModel]({{ site.dcvb_parameters }}file/auxiliary/capture-vision-model.html) objects. `CaptureVisionModel` defines how the library find Convolutional Neural Networks (CNN) model files.| +| [GlobalParameter]({{ site.dcvb_parameters }}file/auxiliary/global-parameter.html) | Defines the global parameters.| +| `SemanticProcessingOptions` | Array of [SemanticProcessing]({{site.dcvb_parameters}}file/semantic-processing/index.html) objects. `SemanticProcessing` specifies one or more code parsing tasks to be performed on text/byte results to help extract human readable information. | + + +### Full JSON Structure + +The following example shows the full JSON structure used by Dynamsoft Capture Vision. ```json { @@ -36,56 +68,96 @@ As shown in the example below, the organizational structure of a parameter templ "Name" : "CV_0", "ImageSourceName": "ISA_0", "ImageROIProcessingNameArray": ["TA_0" ], - "SemanticProcessingNameArray": ["SP_0"] - } + "SemanticProcessingNameArray": ["SP_0"] + // ...other optional parameters + }, + { + // another CaptureVisionTemplate object + } ], "ImageSourceOptions": [ { "Name": "ISA_0" + // ...other optional parameters + }, + { + // another ImageSource object } ], "TargetROIDefOptions" : [ { "Name" : "TA_0", "TaskSettingNameArray": [ "LR_0", "BR_0", "DN_0" ] + // ...other optional parameters + }, + { + // another TargetROIDef object } ], "ImageParameterOptions": [ { "Name": "IP_0" + // ...other optional parameters + }, + { + // another ImageParameter object } ], "BarcodeReaderTaskSettingOptions": [ { "Name" : "BR_0", "BarcodeFormatSpecificationNameArray" : ["FS_0"] + // ...other optional parameters + }, + { + // another BarcodeReaderTaskSetting object } ], "BarcodeFormatSpecificationOptions": [ { "Name": "FS_0" + // ...other optional parameters + }, + { + // another BarcodeFormatSpecification object } ], "LabelRecognizerTaskSettingOptions": [ { "Name" : "LR_0", "TextLineSpecificationNameArray" : [ "LS_0" ] + // ...other optional parameters + }, + { + // another LabelRecognizerTaskSetting object } ], "TextLineSpecificationOptions" : [ { "Name" : "LS_0", "CharacterModelName" : "NumberLetterCharRecognition" + // ...other optional parameters + }, + { + // another TextLineSpecification object } ], "CaptureVisionModelOptions" : [ { "Name" : "NumberLetterCharRecognition" + // ...other optional parameters + }, + { + // another CaptureVisionModel object } ], "DocumentNormalizerTaskSettingOptions": [ { "Name" : "DN_0" + // ...other optional parameters + }, + { + // another DocumentNormalizerTaskSetting object } ], "SemanticProcessingOptions": [ @@ -94,95 +166,104 @@ As shown in the example below, the organizational structure of a parameter templ "TaskSettingNameArray": [ "CP_0" ] + // ...other optional parameters + }, + { + // another SemanticProcessing object } ], "CodeParserTaskSettingOptions": [ { "Name": "CP_0" + // ...other optional parameters + }, + { + // another CodeParserTaskSetting object } ], "GlobalParameter":{ - "MaxTotalImageDimension":0 + "MaxTotalImageDimension": 0 + // ...other optional parameters }, "OutputTaskSettingOptions":[ { - "Name" : "output_task", - "OutputCondition": { - "TaskResultArray": [ - { - "TargetROIDefName": "B", - "TaskSettingNameArray": ["B_task"], - "Operator": "AND", - - "BackwardReferenceOutput": { - "ReferenceTaskNameArray": ["A_task"], - "ReferenceResultTypeArray":[ "ART_TEXT_LINE","ART_BARCODE","ART_FRAME", "ART_TABLE_CELL", "ART_COLOUR_REGION" ] - } - } - ], - "Operator": "AND" - } + "Name" : "output_task" + // ...other optional parameters + }, + { + // another OutputTaskSetting object } ] } ``` -With the exception of `GlobalParameter`, all top-level objects in the parameter template file are arrays of the corresponding object. For example,`CaptureVisionTemplates` is an array of `CaptureVisionTemplate` objects, and `TargetROIDefOptions` is an array of `TargetROIDef` objects, and so on. - -Furthermore, you will notice that some of the parameters' definitions are reused across the parameter template file. This helps reduce the size of the parameter template file and simplify the parameter configuration hierarchy, making it easier for you to understand and create your own template. For example, the value of the `ImageSourceName` parameter for the first object in `CaptureVisionTemplates` is `ISA_0`, which refers to the first object in `ImageSourceOptions`. - -Therefore, a parameter template starts with an object in `CaptureVisionTemplates` and recursively searches for the objects that are directly or indirectly referenced by it, and then combines them to form a specific set of parameters. Then, the parameter template may be applied to DCV through "template name" to control its internal execution logic. +> [!IMPORTANT] +> This example shows the complete JSON structure template. +> Most fields are optional and should be included only when needed. +> Do NOT copy this whole structure directly. +> For real usage, start with the Minimal Valid JSON example and add only the necessary sections. -Next, we will focus on introducing some main objects and their relationships in a parameter template. -## Structure of a Parameter Template +### Minimal Valid JSON Example -The diagram below illustrates the objects included in a complete parameter template, as well as the reference relationships between them. +The following example includes only the minimum required fields needed to create a functional configuration. +You can use it as a starting point and expand it based on your scenario. -- A solid blue line indicates a one-to-zero or one-to-one correspondence between the two objects. -- A solid black line indicates a one-to-zero or one-to-n correspondence between the two objects. -- The dash line indicates that these objects may be associated with one-to-n `ImageParameter` objects, which may take effect at different stages of the algorithm. - -
    -

    Top level objects of DCV template file

    -

    Figure 2 – Object reference relationships in a parameter template

    -
    - -The following table list the main objects type and description of a complete parameter template: - -| Object Type | Description | -| :------------------------------| :----------- | -| [CaptureVisionTemplate]({{site.dcvb_parameters}}file/capture-vision-template.html) | This is the entry object of a parameter template in DCV. The `Name` parameter represents the name of the parameter template, which serves as its unique identifier.| -| [ImageSource]({{site.dcvb_parameters}}file/image-source.html) | Defines the input for DCV responsible for providing images to DCV. It can be defined as different image sources, including but not limited to, image directories, scanners, cameras, etc.| -| [TargetROIDef]({{site.dcvb_parameters}}file/target-roi-definition/index.html) | Used to specify one or more recognition tasks to be performed on some regions of interest (ROIs) within an image.| -| [SemanticProcessing]({{site.dcvb_parameters}}file/semantic-processing/index.html) | Used to specify one or more code parsing tasks to be performed on text/byte results to help extract human readable information. | -| [BarcodeReaderTaskSetting]({{site.dcvb_parameters}}file/task-settings/barcode-reader-task-settings.html) | Configures the settings for barcode reading tasks performed on images in DCV. | -| [LabelRecognizerTaskSetting]({{site.dcvb_parameters}}file/task-settings/label-recognizer-task-settings.html) | Configures the settings for label recognition tasks performed on images in DCV.| -| [DocumentNormalizerTaskSetting]({{site.dcvb_parameters}}file/task-settings/document-normalizer-task-settings.html) | Configures the settings for the document detection or normalization process of an image in DCV. | -| [CodeParserTaskSetting]({{site.dcvb_parameters}}file/task-settings/code-parser-task-settings.html) | Configures the code parsing tasks such as passport MRZ, driving license and other user specific tasks in DCV etc.| -| [OutputTaskSetting]({{site.dcvb_parameters}}file/task-settings/output-task-setting.html) | Configure how to output the expected results of the ancestor `TargetROIDef` by filtering the results of the descendant `TargetROIDef` object. | -| [ImageParameter]({{site.dcvb_parameters}}file/image-parameter.html) | Provides various image-processing features to adjust and enhance the input image for better recognition results.| -| [CaptureVisionModel]({{ site.dcvb_parameters }}file/auxiliary/capture-vision-model.html) | Defines how the library find Convolutional Neural Networks (CNN) model files.| -| [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/capture-vision-model.html) | Sets configurations for specified barcode formats.| -| [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/textline-specification.html) | Defines configurations for the specified text lines.| +```json +{ + "CaptureVisionTemplates": [ + { + "Name" : "CV_0", + "ImageROIProcessingNameArray": ["TA_0" ], + } + ], + "TargetROIDefOptions" : [ + { + "Name" : "TA_0", + "TaskSettingNameArray": [ "BR_0" ] + } + ], + "BarcodeReaderTaskSettingOptions": [ + { + "Name" : "BR_0", + "BarcodeFormatIds": ["BF_DEFAULT"] + } + ] +} +``` -For more details, please refer to [introduction of the capture vision template](capture-vision-template.md) +> [!NOTE] +> This minimal example is intentionally simple. +> In real-world scenarios, additional sections such as `ImageParameter`, `LabelRecognizerTaskSetting`, or `SemanticProcessing` options may be required depending on the features you use. ## How to Apply DCV Parameters -There are two ways in which the parameters can be implemented in Dynamsoft Capture Vision (DCV): - -- `SimplifiedCaptureVisionSettings`: It is a structure that contains commonly used DCV parameters. To update DCV parameters using `SimplifiedCaptureVisionSettings`, you can follow these steps: - - 1. Call the `GetSimplifiedSettings` API to get the `SimplifiedCaptureVisionSettings` object named `dcv_settings` associated with the Dynamsoft Capture Vision Router instance. - 2. Modify the attributes of `dcv_settings`. - 3. Call the `UpdateSettings` API to apply the modified `dcv_settings`. - -- `JSON parameter template file/string` - It supports all DCV parameters. The related parameter setting APIs are: - - 1. `InitSettings/InitSettingsFromFile` - after calling this interface, each parameter template in the file/string will be converted into a single parameter template object. They will replace the previously associated parameter template objects on the Capture Vision Router instance. - - 2. `ResetSettings` - after calling this API, the internal associated parameter template objects are reset to the factory state. +To use custom parameters in Dynamsoft Capture Vision, follow these steps: + +1. **Load Parameter Template** + + Use one of the following APIs to load your parameter template: + - `InitSettings(jsonString)` - Load parameter template from a JSON string + - `InitSettingsFromFile(filePath)` - Load parameter template from a JSON file + + > [!NOTE] + > These APIs will replace all existing parameter templates with the ones from the loaded content. + +2. **Start Capturing** + + Pass the template name to one of the capturing APIs: + - `Capture(..., templateName)` - Processes a single-page image. + - `CaptureMultiPages(..., templateName)` - Processes a multiple-page image. + - `StartCapturing(..., templateName)` - Starts continuous capturing to process multiple images. + + The `templateName` parameter should match the `Name` field in your `CaptureVisionTemplate` object. + +3. **Reset to Default (Optional)** + + If you need to discard custom settings and restore factory defaults: + - `ResetSettings()` - Resets all parameter templates to their original factory state + + This is useful when you want to start fresh or switch between different configuration modes. ## Special Rules for DCV Parameter Configuration diff --git a/parameters/file/semantic-processing/index.md b/parameters/file/semantic-processing/index.md index a0bf9ed..50c3be3 100644 --- a/parameters/file/semantic-processing/index.md +++ b/parameters/file/semantic-processing/index.md @@ -2,25 +2,13 @@ layout: default-layout title: SemanticProcessing - Dynamsoft Capture Vision Parameter File description: This page shows the SemanticProcessing object in the Dynamsoft Capture Vision Parameter File. -needAutoGenerateSidebar: true -needGenerateH3Content: false -noTitleIndex: true -permalink: /parameters/file/semantic-processing/index.html --- # SemanticProcessing Object -## Parameter Organization +The `SemanticProcessing` object specifies tasks to analyze and extract information from image ROI processing results. -A `SemanticProcessing` object is defined as below: - -| Key Name | Value Type | Required or Optional | Description | -|---|---|---|---| -| [Name]({{site.dcvb_parameters_reference}}semantic-processing/name.html) | string | Mandatory | Sets the name of current `SemanticProcessing` object. The value must be unique between all `SemanticProcessing` objects. | -| [ReferenceObjectFilter]({{site.dcvb_parameters_reference}}semantic-processing/reference-object-filter.html) | JSON object | Optional | Sets a [ReferenceObjectFilter](#referenceobjectfilter) object to define the filter conditions. | -| [TaskSettingNameArray]({{site.dcvb_parameters_reference}}semantic-processing/task-setting-name-array.html) | string array | Optional | Represents the collection of task setting object names, used to refer to the `CodeParserTaskSetting` objects. | - -Here is a sample: +## Example ```json { @@ -28,65 +16,40 @@ Here is a sample: "ReferenceObjectFilter": { "AtomicResultTypeArray": [ "ART_BARCODE" - ], - }, - "TaskSettingNameArray": ["CPT1_PARSE_VIN"] + ] + }, + "TaskSettingNameArray": ["CPT1_PARSE_VIN"] } ``` -### ReferenceObjectFilter - -A `ReferenceObjectFilter` object is defined as below: - -| Key Name | Value Type | Required or Optional | Description | -|---|---|---|---| -| ReferenceTargetROIDefNameArray | string array | Optional | A string array while each element is a string that represents the name of a `TargetROIDef` object. | -| AtomicResultTypeArray | string array | Optional | A string array while each element is a string that represents a type of atomic result that needs to be filtered | -| TextLineFilteringCondition | JSON object | Optional | An object used to specify the conditions for filtering text lines. | -| BarcodeFilteringCondition | JSON object | Optional | An object used to specify the conditions for filtering barcodes. | - -Here is a sample: +## Parameters -```json -{ - "ReferenceObjectFilter" : - { - "ReferenceTargetROIDefNameArray": ["TR_0", "TR_1"], - "AtomicResultTypeArray" : ["ART_TEXT_LINE","ART_BARCODE"], - "BarcodeFilteringCondition": - { - "BarcodeFormatIds": ["BF_CODE39"], - "BarcodeTextRegExPattern": ".*b.*b.*b.*" - }, - "TextLineFilteringCondition": - { - "LineNumbers": "1,3-5", - "LineStringRegExPattern": "P -

    Example 1 – Parameters of TargetROIDef

    - +## Parameters -## Summary of TargetROIDef top-level parameters +| Parameter Name | Type | Required/Optional | Description | +| -------------- | ---- | ----------------- | ----------- | +| [`Name`]({{site.dcvb_parameters_reference}}target-roi-def/name.html) | String | Required | The unique identifier for this `TargetROIDef` object. | +| [`TaskSettingNameArray`]({{site.dcvb_parameters_reference}}target-roi-def/task-setting-name-array.html) | String Array | Optional | Array of task setting object names (`BarcodeReaderTaskSetting`, `LabelRecognizerTaskSetting`, `DocumentNormalizerTaskSetting`) defining recognition tasks. | +| [`Location`]({{site.dcvb_parameters_reference}}target-roi-def/location.html) | Object | Optional | Defines the spatial location where recognition tasks are performed. Consists of `ReferenceObjectFilter` and `Offset` parameters. | +| [`BaseTargetROIDefName`]({{site.dcvb_parameters_reference}}target-roi-def/base-target-roidef-name.html) | String | Optional | Name of another `TargetROIDef` object to inherit parameters from. Parameters defined in this object override inherited ones. | +| [`EnableResultsDeduplication`]({{site.dcvb_parameters_reference}}target-roi-def/enable-results-deduplication.html) | Integer | Optional | Whether to enable result deduplication (0 or 1). | -| Parameter Name | Description | -| -------------- | ----------- | -| [`Name`]({{site.dcvb_parameters_reference}}target-roi-def/name.html) | Represents the name of the `TargetROIDef` object, which serves as its unique identifier. | -| [`TaskSettingNameArray`]({{site.dcvb_parameters_reference}}target-roi-def/task-setting-name-array.html) | Represents the collection of task setting object names, used to refer to the `BarcodeReaderTaskSetting`,`LabelRecognizerTaskSetting`,`DocumentNormalizerTaskSetting` objects. It is used to define recognition tasks such as reading barcodes, recognizing labels, or detecting document quads. | -| [`Location`]({{site.dcvb_parameters_reference}}target-roi-def/location.html) | Define the spatial location where the recognition tasks are performed. It consists of `ReferenceObjectFilter` and `Offset` parameter. | -| [`BaseTargetROIDefName`]({{site.dcvb_parameters_reference}}target-roi-def/base-target-roidef-name.html) | Represents the name of another `TargetROIDef` object. It is used to inherit the parameters defined in its parent `TargetROIDef` object. If a parameter has already been defined in this object, the parameter with the same name will not be inherited from the parent object.| -| [`EnableResultsDeduplication`]({{site.dcvb_parameters_reference}}target-roi-def/enable-results-deduplication.html) | Represents whether to enable the result deduplication. | - -In simple terms, `TargetROIDef` can be expressed using the following formula: +**In simple terms:** ``` TargetROIDef = Recognition Task Definition + Spatial Location Definition @@ -67,159 +59,129 @@ TargetROIDef = Recognition Task Definition + Spatial Location Definition ## Recognition Tasks -The recognition tasks configured on the `TargetROIDef` object include barcode recognition, label recognition, document boundary detection, etc. -The atomic result of each task type is the smallest output item, which can be a barcode, text line, table cell, detected quadrilateral, etc. `CapturedResult` represents a set of all captured atomic result items on an image. The following table lists the task types and corresponding atomic result item types. - -| Task Type | Performed By | Atomic Result Type | -| :------------------- | :----------- | :--------------------- | -| Read Barcodes | Dynamsoft Barcode Reader SDK | BarcodeResultItem | -| Recognize Text Lines | Dynamsoft Label Recognizer SDK | TextResultItem | -| Detect Document Borders | Dynamsoft Document Normalizer SDK | DetectedQuadResultItem | -| Deskew a Document | Dynamsoft Document Normalizer SDK | DeskewedImageResultItem | -| Enhance an Image | Dynamsoft Document Normalizer SDK | EnhancedImageResultItem | +Recognition tasks configured on a `TargetROIDef` object include barcode recognition, label recognition, document boundary detection, etc. The atomic result of each task type is the smallest output item: a barcode, text line, table cell, detected quadrilateral, etc. `CapturedResult` represents a set of all captured atomic result items on an image. -If you want to learn more about the design details of recognition task settings, please refer to the following links: +| Task Type | Performed By | Atomic Result Type | +| :-------- | :----------- | :----------------- | +| Read Barcodes | Dynamsoft Barcode Reader SDK | BarcodeResultItem | +| Recognize Text Lines | Dynamsoft Label Recognizer SDK | TextResultItem | +| Detect Document Borders | Dynamsoft Document Normalizer SDK | DetectedQuadResultItem | +| Deskew a Document | Dynamsoft Document Normalizer SDK | DeskewedImageResultItem | +| Enhance an Image | Dynamsoft Document Normalizer SDK | EnhancedImageResultItem | -- [Design of barcode reader task settings](../task-settings/barcode-reader-task-settings.md) -- [Design of label recognizer task settings](../task-settings/label-recognizer-task-settings.md) -- [Design of document normalizer task settings](../task-settings/document-normalizer-task-settings.md) +**For more details:** +- [Barcode reader task settings]({{site.dcvb_parameters}}file/task-settings/barcode-reader-task-settings.html) +- [Label recognizer task settings]({{site.dcvb_parameters}}file/task-settings/label-recognizer-task-settings.html) +- [Document normalizer task settings]({{site.dcvb_parameters}}file/task-settings/document-normalizer-task-settings.html) ## Spatial Location -Parameter `Location` defines the spatial location where the recognition tasks are performed. It consists of `ReferenceObjectFilter` parameter and `Offset` parameter. The former is used to filter out the desired reference regions, and the latter defines a uniform offset relative to the reference regions. -Next, we focus on explaining some key concepts based on the example diagram below: +The `Location` parameter defines the spatial location where recognition tasks are performed. It consists of `ReferenceObjectFilter` and `Offset` parameters. The former filters out desired reference regions, and the latter defines a uniform offset relative to the reference regions. -
    -

    An example showing the key concepts

    -

    Figure 1 – An example showing the key concepts

    -
    +![An example showing the key concepts](../assets/roi-concept.png) -|Concept|Description|Explanation with example| -|:------|:----------|:-----------------------| -|**Atomic Result**| Represents the atomic result of the recognition task output. It can be a color detection region, a barcode, a text line, a table cell, a detected quadrilateral etc.|`T1`, `T2`, `T3` are three atomic result objects of `TextLineResultItem` type, and B1 is one atomic object of `BarcodeResultItem` type.| -|**Reference Region**|A reference region is a physical quadrilateral region. It includes two types: **entire image region** and **atomic result region**. The former refers to the quadrilateral extent of the original image, and the latter refers to the quadrilateral extent of each atomic result.| `ROI1` has only one reference region which is the entire image region. `ROI2` has three reference regions which generated from `T1`, `T2`, `T3`. | -|**Target Region**| A target region is a physical quadrilateral region, which is calculated from a reference region and offset.| `ROI1` has only one target region, which is equal to the reference region. `ROI2` has three target regions, which are calculated by offsets from quadrilateral regions of `T1`, `T2`, `T3`.| +| Concept | Description | Example Explanation | +| :------ | :---------- | :------------------ | +| **Atomic Result** | Atomic result of recognition task output. Can be a colour detection region, barcode, text line, table cell, detected quadrilateral, etc. | `T1`, `T2`, `T3` are three `TextLineResultItem` objects, and `B1` is one `BarcodeResultItem` object. | +| **Reference Region** | A physical quadrilateral region. Two types: **entire image region** and **atomic result region**. The former is the quadrilateral extent of the original image; the latter is the quadrilateral extent of each atomic result. | `ROI1` has one reference region (entire image). `ROI2` has three reference regions generated from `T1`, `T2`, `T3`. | +| **Target Region** | A physical quadrilateral region calculated from a reference region and offset. | `ROI1` has one target region equal to the reference region. `ROI2` has three target regions calculated by offsets from `T1`, `T2`, `T3` quadrilateral regions. | -### Reference Object Filter +### ReferenceObjectFilter -Defines the filter conditions of the reference objects. You can filter the reference objects by the `TargetROIDefName`, the type of the atomic results and even the further details of the atomic results. There might exist multiple objects that fit the filter conditions. As a result, the more appropriate the filter conditions are, the more accurate reference regions you receive. +Defines filter conditions for reference objects. You can filter reference objects by `TargetROIDefName`, atomic result type, and specific atomic result details. Multiple objects may fit the filter conditions. More precise filter conditions yield more accurate reference regions. -#### Summary of ReferenceObjectFilter top-level parameters - -| Parameter Name | Description | -| -------------------------------- | ----------- | -| [`ReferenceTargetROIDefNameArray`]({{site.dcvb_parameters_reference}}target-roi-def/location/reference-object-filter/reference-object-filter-parameter-details.html#referencetargetroidefnamearray) | Reference the atomic object generated by other `TargetROIDef` objects by specifying its name. This parameter will intersect with the `AtomicResultTypeArray` parameter to determine the final referenced `TargetROIDef` objects. | -| [`AtomicResultTypeArray`]({{site.dcvb_parameters_reference}}target-roi-def/location/reference-object-filter/reference-object-filter-parameter-details.html#referencetasknamearray) | Set atomic result types that can be used as reference objects. This parameter will intersect with the `ReferenceTargetROIDefNameArray` parameter to determine the final referenced `TargetROIDef` objects. | -| [`BarcodeFilteringCondition`]({{site.dcvb_parameters_reference}}target-roi-def/location/reference-object-filter/barcode-filtering-condition.html) | Set barcode conditions that can be used as reference objects. | -| [`FrameFilteringCondition`]({{site.dcvb_parameters_reference}}target-roi-def/location/reference-object-filter/frame-filtering-condition.html) | Set frame conditions that can be used as reference objects. | -| [`TextLineFilteringCondition`]({{site.dcvb_parameters_reference}}target-roi-def/location/reference-object-filter/text-line-filtering-condition.html) | Set text line conditions that can be used as reference objects | -| [`RegionFilteringCondition`]({{site.dcvb_parameters_reference}}target-roi-def/location/reference-object-filter/region-filtering-condition.html) | Set colour region conditions that can be used as reference *objects* | +| Parameter Name | Type | Required/Optional | Description | +| -------------- | ---- | ----------------- | ----------- | +| [`ReferenceTargetROIDefNameArray`]({{site.dcvb_parameters_reference}}target-roi-def/location/reference-object-filter/reference-object-filter-parameter-details.html#referencetargetroidefnamearray) | String Array | Optional | References atomic objects generated by other `TargetROIDef` objects by name. Intersects with `AtomicResultTypeArray` to determine final referenced objects. | +| [`AtomicResultTypeArray`]({{site.dcvb_parameters_reference}}target-roi-def/location/reference-object-filter/reference-object-filter-parameter-details.html#referencetasknamearray) | String Array | Optional | Atomic result types that can be used as reference objects. Intersects with `ReferenceTargetROIDefNameArray` to determine final referenced objects. | +| [`BarcodeFilteringCondition`]({{site.dcvb_parameters_reference}}target-roi-def/location/reference-object-filter/barcode-filtering-condition.html) | Object | Optional | Barcode conditions that can be used as reference objects. | +| [`FrameFilteringCondition`]({{site.dcvb_parameters_reference}}target-roi-def/location/reference-object-filter/frame-filtering-condition.html) | Object | Optional | Frame conditions that can be used as reference objects. | +| [`TextLineFilteringCondition`]({{site.dcvb_parameters_reference}}target-roi-def/location/reference-object-filter/text-line-filtering-condition.html) | Object | Optional | Text line conditions that can be used as reference objects. | +| [`RegionFilteringCondition`]({{site.dcvb_parameters_reference}}target-roi-def/location/reference-object-filter/region-filtering-condition.html) | Object | Optional | Colour region conditions that can be used as reference objects. | ### Offset -Defines the offset of the target region from the reference object. If there is no reference object defined, the origin will be set to the top-left vertex of the original image. - -
    -

    Offset example

    -

    Figure 2 – Offset example

    -
    +Defines the offset of the target region from the reference object. If no reference object is defined, the origin is set to the top-left vertex of the original image. -#### Summary of Offset top-level parameters +![Offset example](../assets/location-offset.png) -| Parameter Name | Description | -| -------------------------------- | ----------- | -| [`ReferenceObjectOriginIndex`]({{site.dcvb_parameters_reference}}target-roi-def/location/offset/offset-parameter-details.html#referenceobjectoriginindex) | Defines which point of the reference object will be set as the origin of the coordinate system. | -| [`ReferenceObjectType`]({{site.dcvb_parameters_reference}}target-roi-def/location/offset/offset-parameter-details.html#referenceobjecttype) | Defines which coordinate system to use when configuring offset parameters basd on the reference objects. | -| [`ReferenceXAxis`]({{site.dcvb_parameters_reference}}target-roi-def/location/offset/reference-x-axis.html) | Defines the x-axis of the coordinate system to use when configuring offset parameters basd on the reference objects. | -| [`ReferenceYAxis`]({{site.dcvb_parameters_reference}}target-roi-def/location/offset/reference-y-axis.html) | Defines the y-axis of the coordinate system to use when configuring offset parameters basd on the reference objects. | -| [`MeasuredByPercentage`]({{site.dcvb_parameters_reference}}target-roi-def/location/offset/offset-parameter-details.html#measuredbypercentage) | Sets whether or not to use percentage to measure the points' coordinates. | -| [`FirstPoint`]({{site.dcvb_parameters_reference}}target-roi-def/location/offset/offset-parameter-details.html#firstpoint) | The first point of the target region, which defines the offset from the origin. | -| [`SecondPoint`]({{site.dcvb_parameters_reference}}target-roi-def/location/offset/offset-parameter-details.html#secondpoint) | The second point of the target region, which defines the offset from the origin. | -| [`ThirdPoint`]({{site.dcvb_parameters_reference}}target-roi-def/location/offset/offset-parameter-details.html#thirdpoint) | The third point of the target region, which defines the offset from the origin. | -| [`FourthPoint`]({{site.dcvb_parameters_reference}}target-roi-def/location/offset/offset-parameter-details.html#fourthpoint) | The fourth point of the target region, which defines the offset from the origin. | +| Parameter Name | Type | Required/Optional | Description | +| -------------- | ---- | ----------------- | ----------- | +| [`ReferenceObjectOriginIndex`]({{site.dcvb_parameters_reference}}target-roi-def/location/offset/offset-parameter-details.html#referenceobjectoriginindex) | Integer | Optional | Which point of the reference object will be set as the origin of the coordinate system. | +| [`ReferenceObjectType`]({{site.dcvb_parameters_reference}}target-roi-def/location/offset/offset-parameter-details.html#referenceobjecttype) | String | Optional | Which coordinate system to use when configuring offset parameters based on the reference objects. | +| [`ReferenceXAxis`]({{site.dcvb_parameters_reference}}target-roi-def/location/offset/reference-x-axis.html) | Object | Optional | The x-axis of the coordinate system to use when configuring offset parameters based on the reference objects. | +| [`ReferenceYAxis`]({{site.dcvb_parameters_reference}}target-roi-def/location/offset/reference-y-axis.html) | Object | Optional | The y-axis of the coordinate system to use when configuring offset parameters based on the reference objects. | +| [`MeasuredByPercentage`]({{site.dcvb_parameters_reference}}target-roi-def/location/offset/offset-parameter-details.html#measuredbypercentage) | Integer | Optional | Whether to use percentage to measure the points' coordinates (0 or 1). | +| [`FirstPoint`]({{site.dcvb_parameters_reference}}target-roi-def/location/offset/offset-parameter-details.html#firstpoint) | Integer Array | Required | The first point of the target region, defining the offset from the origin. | +| [`SecondPoint`]({{site.dcvb_parameters_reference}}target-roi-def/location/offset/offset-parameter-details.html#secondpoint) | Integer Array | Required | The second point of the target region, defining the offset from the origin. | +| [`ThirdPoint`]({{site.dcvb_parameters_reference}}target-roi-def/location/offset/offset-parameter-details.html#thirdpoint) | Integer Array | Required | The third point of the target region, defining the offset from the origin. | +| [`FourthPoint`]({{site.dcvb_parameters_reference}}target-roi-def/location/offset/offset-parameter-details.html#fourthpoint) | Integer Array | Required | The fourth point of the target region, defining the offset from the origin. | -## How to Configure Target/Reference Relationships +## Usage Examples ### Reference the Original Image -Even if you don't have any reference object, you can still set a offset based on the original image to localize the ROI. - -The following parameter template snippet shows how to define ROI from the original image and perform barcode recognition. +You can set an offset based on the original image to localize the ROI without any reference object. -- Step 1: Name your `TargetROI` "ROI_0". -- Step 2: Set the `ReferenceObjectFilter` of the "ROI_0" to `null`. -- Step 3: Define the Offset. Here it is assumed that barcode recognition is performed on the upper part(50%) of the image. +**Example:** Define ROI from the original image and perform barcode recognition on the upper 50% of the image. ```json { - "TargetROIDefOptions": - [ + "TargetROIDefOptions": [ { "Name": "ROI_0", - "TaskSettingNameArray":["barcode_task"], - "Location": - { + "TaskSettingNameArray": ["barcode_task"], + "Location": { "ReferenceObjectFilter": null, - "Offset": - { + "Offset": { "MeasuredByPercentage": 1, - "FirstPoint": [ 0, 0 ], - "SecondPoint": [ 100, 0 ], - "ThirdPoint": [ 100, 50 ], - "FourthPoint": [ 0, 50 ] + "FirstPoint": [0, 0], + "SecondPoint": [100, 0], + "ThirdPoint": [100, 50], + "FourthPoint": [0, 50] } - }, + } } ] } ``` -### Reference Another TargetObjectDef +### Reference Another TargetROIDef -If the there exists significant objects that can help you localizing the targeting content, you can define filter conditions to localize the reference objects first and then capture the targeting content. +If significant objects can help localize the targeting content, define filter conditions to localize reference objects first, then capture the targeting content. -The following example shows how to configure the `ReferenceObjectFilter` to use the barcode location to extract the certain text line information: +**Example:** Use barcode location to extract text line information. -
    -

    set-reference-object

    -

    Figure 3 – How to reference another TargetObjectDef

    -
    +![How to reference another TargetROIDef](../assets/define-location-with-reference-object.png) ```json { - "TargetROIDefOptions": - [ + "TargetROIDefOptions": [ { "Name": "ROI_0", - "TaskSettingNameArray":["barcode_task"], + "TaskSettingNameArray": ["barcode_task"], "Location": null - }, + }, { "Name": "ROI_1", - "TaskSettingNameArray":["text_task"], - "Location": - { - "ReferenceObjectFilter" : - { - "ReferenceTargetROIDefNameArray": ["ROI_0"], // The ROI that you decoded the barcodes. - "AtomicResultTypeArray" : ["ART_BARCODE"], // Set the AtomicResult type to barcode. - - // Set BarcodeFilteringCondition. Otherwise, all the barcodes will become ReferenceObject. - "BarcodeFilteringCondition": - { - "BarcodeFormatIds": ["BF_CODE_128"], // Use Code 128 only. - "BarcodeTextRegExPattern": "ReferenceObject" // Find the Code 128 whose text has "ReferenceObject" + "TaskSettingNameArray": ["text_task"], + "Location": { + "ReferenceObjectFilter": { + "ReferenceTargetROIDefNameArray": ["ROI_0"], + "AtomicResultTypeArray": ["ART_BARCODE"], + "BarcodeFilteringCondition": { + "BarcodeFormatIds": ["BF_CODE_128"], + "BarcodeTextRegExPattern": "ReferenceObject" } }, - "Offset" : - { - "MeasuredByPercentage" : 1, - "FirstPoint" : [ 20, 140 ], - "SecondPoint" : [ 60, 140 ], - "ThirdPoint" : [ 60, 170 ], - "FourthPoint" : [ 20, 170 ] + "Offset": { + "MeasuredByPercentage": 1, + "FirstPoint": [20, 140], + "SecondPoint": [60, 140], + "ThirdPoint": [60, 170], + "FourthPoint": [20, 170] } - }, + } } ] } diff --git a/parameters/file/task-settings/barcode-reader-task-settings.md b/parameters/file/task-settings/barcode-reader-task-settings.md index ff93536..6639f70 100644 --- a/parameters/file/task-settings/barcode-reader-task-settings.md +++ b/parameters/file/task-settings/barcode-reader-task-settings.md @@ -8,39 +8,20 @@ needAutoGenerateSidebar: false # BarcodeReaderTaskSetting Object -In Dynamsoft Capture Vision(DCV), we use Json files to configure and organize the process tasks. The `BarcodeReaderTaskSetting` described in this chapter is one of the configurable tasks. If you have more strict requirements for speed or accuracy, it is highly recommended that you start by trying the barcode reader task settings. +The `BarcodeReaderTaskSetting` object configures the barcode reading process in Dynamsoft Capture Vision (DCV). Use this object to optimize speed or accuracy for your specific barcode reading requirements. - -## Available Settings - -All available parameters related to barcode decoding are listed here, along with a brief description. - - | Parameter Name | Description | - | -------------- | ----------- | - | [`BarcodeFormatIds`]({{site.dcvb_parameters_reference}}barcode-reader-task-settings/barcode-format-ids.html) | Sets which barcode format the current FormatSpecification configuration is applied to. | - | [`BarcodeFormatSpecificationNameArray`]({{site.dcvb_parameters_reference}}barcode-reader-task-settings/barcode-format-specification-name-array.html) | The names of the referenced BarcodeFormatSpecification object(s). | - | [`DPMCodeReadingModes`]({{site.dcvb_parameters_reference}}barcode-reader-task-settings/dpm-code-reading-modes.html) | Sets the mode and priority for DPM code reading. | - | [`ExpectedBarcodesCount`]({{site.dcvb_parameters_reference}}barcode-reader-task-settings/expected-barcodes-count.html) | Sets the number of barcodes expected to be detected for each image. | - | [`MaxThreadsInOneTask`]({{site.dcvb_parameters_reference}}barcode-reader-task-settings/max-threads-in-one-task.html) | Represents the maximum number of parallel threads that can be used on a single task.| - | [`Name`]({{site.dcvb_parameters_reference}}barcode-reader-task-settings/name.html) | The name of the BarcodeReaderTaskSetting object. | - | [`SectionArray`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-array.html) | Defines which sections exist under the `BarcodeReaderTaskSetting`. | - | [`TextResultOrderModes`]({{site.dcvb_parameters_reference}}barcode-reader-task-settings/text-result-order-modes.html) | Sets the mode and priority for the order of the text results returned. | - | [`BaseBarcodeReaderTaskSettingName`]({{site.dcvb_parameters_reference}}barcode-reader-task-settings/base-barcode-reader-task-setting-name.html) | Sets the name of a BarcodeReaderTaskSetting object to be Inheritanced.| - -When DCV executes tasks related to barcode reading, it will process them according to the settings in the `BarcodeReaderTaskSetting`. Here is a sample: - -## Barcode Reader Task Setting Example +## Example ```json - { +{ "Name": "BR_0", - "MaxThreadsInOneTask":4, - "ExpectedBarcodesCount" : 512, - "BarcodeFormatIds" : [ "BF_ALL" ], - "BarcodeFormatSpecificationNameArray" : null, - "DPMCodeReadingModes" : [ + "MaxThreadsInOneTask": 4, + "ExpectedBarcodesCount": 512, + "BarcodeFormatIds": ["BF_ALL"], + "BarcodeFormatSpecificationNameArray": null, + "DPMCodeReadingModes": [ { - "Mode" : "DPMCRM_SKIP" + "Mode": "DPMCRM_SKIP" } ], "SectionArray": [ @@ -86,16 +67,30 @@ When DCV executes tasks related to barcode reading, it will process them accordi { "Stage": "SST_DECODE_BARCODES", "DeblurModes": [], - "ReturnBarcodeZoneClarity" : 0 + "ReturnBarcodeZoneClarity": 0 } ] } ], - "TextResultOrderModes" : [ + "TextResultOrderModes": [ { - "Mode" : "TROM_CONFIDENCE" + "Mode": "TROM_CONFIDENCE" } ], "BaseBarcodeReaderTaskSettingName": "" } ``` + +## Parameters + +| Parameter Name | Type | Required/Optional | Description | +| -------------- | ---- | ----------------- | ----------- | +| [`Name`]({{site.dcvb_parameters_reference}}barcode-reader-task-settings/name.html) | String | Required | The unique identifier for this `BarcodeReaderTaskSetting` object. | +| [`BarcodeFormatIds`]({{site.dcvb_parameters_reference}}barcode-reader-task-settings/barcode-format-ids.html) | String Array | Optional | Specifies which barcode formats to read. | +| [`BarcodeFormatSpecificationNameArray`]({{site.dcvb_parameters_reference}}barcode-reader-task-settings/barcode-format-specification-name-array.html) | String Array | Optional | Names of referenced `BarcodeFormatSpecification` objects for format-specific settings. | +| [`ExpectedBarcodesCount`]({{site.dcvb_parameters_reference}}barcode-reader-task-settings/expected-barcodes-count.html) | Integer | Optional | Expected number of barcodes to detect per image. | +| [`MaxThreadsInOneTask`]({{site.dcvb_parameters_reference}}barcode-reader-task-settings/max-threads-in-one-task.html) | Integer | Optional | Maximum number of parallel threads for this task. | +| [`SectionArray`]({{site.dcvb_parameters_reference}}barcode-reader-task-settings/section-array.html) | Object Array | Optional | Defines processing sections (region predetection, localization, decoding) and their stages. | +| [`DPMCodeReadingModes`]({{site.dcvb_parameters_reference}}barcode-reader-task-settings/dpm-code-reading-modes.html) | Object Array | Optional | Modes and priority for reading Direct Part Mark (DPM) codes. | +| [`TextResultOrderModes`]({{site.dcvb_parameters_reference}}barcode-reader-task-settings/text-result-order-modes.html) | Object Array | Optional | Order in which barcode results are returned. | +| [`BaseBarcodeReaderTaskSettingName`]({{site.dcvb_parameters_reference}}barcode-reader-task-settings/base-barcode-reader-task-setting-name.html) | String | Optional | Name of another `BarcodeReaderTaskSetting` object to inherit parameters from. | diff --git a/parameters/file/task-settings/code-parser-task-settings.md b/parameters/file/task-settings/code-parser-task-settings.md index da9fb4e..602bc93 100644 --- a/parameters/file/task-settings/code-parser-task-settings.md +++ b/parameters/file/task-settings/code-parser-task-settings.md @@ -2,30 +2,29 @@ layout: default-layout title: CodeParserTaskSetting - Dynamsoft Capture Vision Parameter File description: The CodeParserTaskSetting object in the Dynamsoft Capture Vision Parameter File. -needAutoGenerateSidebar: true -needGenerateH3Content: false -noTitleIndex: true -permalink: /parameters/file/task-settings/code-parser-task-settings.html +needAutoGenerateSidebar: false --- # CodeParserTaskSetting Object -## Parameter Organization +The `CodeParserTaskSetting` object defines configurations for parsing barcode text into structured data fields. It specifies which code specification files to use and where to find the parsing resources. -A `CodeParserTaskSetting` object is defined as below: - -| Key Name | Value Type | Required or Optional | Description | -|---|---|---|---| -| Name | string | Mandatory | Sets the name of current `CodeParserTaskSetting` object. The value must be unique between all `task-setting` objects. | -| CodeSpecifications | string array | Optional | Sets the value for parameter [CodeSpecifications]({{site.dcvb_parameters_reference}}code-parser-task-settings/code-specifications.html) to define an array of specification file name objects that determine how to parse the code string | -| ResourcesPath | string | Optional | Sets the value for parameter [ResourcesPath]({{site.dcvb_parameters_reference}}code-parser-task-settings/resources-path.html) to define the directory path that contains the resources needed for the code parser. | - -Here is a sample: +## Example ```json { "Name": "CPT1_PARSE_VIN", - "CodeSpecifications": ["VIN"], + "CodeSpecifications": ["VIN"], "ResourcesPath": "../VIN/" } ``` + +## Parameters + +A `CodeParserTaskSetting` object contains the following parameters: + +| Parameter Name | Type | Required/Optional | Description | +|---|---|---|---| +| [`Name`]({{site.dcvb_parameters_reference}}code-parser-task-settings/name.html) | String | Required | The unique identifier for this `CodeParserTaskSetting` object. Must be unique among all task setting objects. | +| [`CodeSpecifications`]({{site.dcvb_parameters_reference}}code-parser-task-settings/code-specifications.html) | String Array | Optional | An array of code specification file names that define how to parse the barcode text into structured fields. | +| [`ResourcesPath`]({{site.dcvb_parameters_reference}}code-parser-task-settings/resources-path.html) | String | Optional | The directory path containing the resources needed for code parsing (e.g., specification files, models). | diff --git a/parameters/file/task-settings/document-normalizer-task-settings.md b/parameters/file/task-settings/document-normalizer-task-settings.md index 26eea46..514d33a 100644 --- a/parameters/file/task-settings/document-normalizer-task-settings.md +++ b/parameters/file/task-settings/document-normalizer-task-settings.md @@ -2,107 +2,99 @@ layout: default-layout title: DocumentNormalizerTaskSetting - Dynamsoft Capture Vision Parameter File description: The DocumentNormalizerTaskSetting object in the Dynamsoft Capture Vision Parameter File. -needAutoGenerateSidebar: true -needGenerateH3Content: false -noTitleIndex: true +needAutoGenerateSidebar: false --- # DocumentNormalizerTaskSetting Object The `DocumentNormalizerTaskSetting` object is used to configure settings for a document normalizer task to be performed on certain regions of interest (ROIs) in an image. +## Example + ```json { "Name": "ddn_task_default", "MaxThreadsInOneTask": 4, - "ExpectedDocumentsCount": 1, + "ExpectedDocumentsCount": 1, "BaseDocumentNormalizerTaskSettingName": "", "SectionArray": [ { "Section": "ST_REGION_PREDETECTION", "ImageParameterName": "ip_default", - "StageArray": [ - { - "Stage": "SST_PREDETECT_REGIONS", - "RegionPredetectionModes": [ - ] - } - ] + "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" - } - ] - } - ] + "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 - ] - } - ] + "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 - } - ] + "StageArray": [ + { + "Stage": "SST_ENHANCE_IMAGE", + "ColourMode": "ICM_COLOUR", + "Brightness": 0, + "Contrast": 0 + } + ] } ] } ``` -
    -

    Example 1 – Parameters of DocumentNormalizerTaskSetting

    -
    - -## Summary of DocumentNormalizerTaskSetting top-level parameters +## Parameters -| Parameter Name | Description | -| -------------- | ----------- | -| [`Name`]({{site.dcvb_parameters_reference}}document-normalizer-task-settings/name.html) | Defines the name of a `DocumentNormalizerTaskSetting` object, which serves as its unique identifier. | -| [`BaseDocumentNormalizerTaskSettingName`]({{site.dcvb_parameters_reference}}document-normalizer-task-settings/base-document-normalizer-task-setting-name.html) | Represents the name of another `DocumentNormalizerTaskSetting` object to inherit from. | -| [`MaxThreadsInOneTask`]({{site.dcvb_parameters_reference}}document-normalizer-task-settings/max-threads-in-one-task.html) | Defines the maximum threads that can be consumed in one task. | -| [`ExpectedDocumentsCount`]({{site.dcvb_parameters_reference}}document-normalizer-task-settings/expected-documents-count.html) | Defines the number of documents expected to be detected. | -| [`SectionArray`]({{site.dcvb_parameters_reference}}document-normalizer-task-settings/section-array.html) | Defines which sections exist under the `DocumentNormalizerTaskSetting`. | +| Parameter Name | Type | Required/Optional | Description | +| -------------- | ---- | ----------------- | ----------- | +| [`Name`]({{site.dcvb_parameters_reference}}document-normalizer-task-settings/name.html) | String | Required | The unique identifier for this `DocumentNormalizerTaskSetting` object. | +| [`BaseDocumentNormalizerTaskSettingName`]({{site.dcvb_parameters_reference}}document-normalizer-task-settings/base-document-normalizer-task-setting-name.html) | String | Optional | The name of another `DocumentNormalizerTaskSetting` object to inherit settings from. | +| [`MaxThreadsInOneTask`]({{site.dcvb_parameters_reference}}document-normalizer-task-settings/max-threads-in-one-task.html) | Integer | Optional | The maximum number of threads that can be used for this task. | +| [`ExpectedDocumentsCount`]({{site.dcvb_parameters_reference}}document-normalizer-task-settings/expected-documents-count.html) | Integer | Optional | The expected number of documents to be detected in the image. | +| [`SectionArray`]({{site.dcvb_parameters_reference}}document-normalizer-task-settings/section-array.html) | Array | Optional | An array of section objects that define the processing workflow for document normalization. | diff --git a/parameters/file/task-settings/index.md b/parameters/file/task-settings/index.md deleted file mode 100644 index ef491e1..0000000 --- a/parameters/file/task-settings/index.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -layout: default-layout -title: Task Settings Index - Dynamsoft Capture Vision Parameters -description: This is the index page of he task setting objects of the Dynamsoft Capture Vision Parameters. -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: false -permalink: /parameters/file/task-settings/index.html ---- - -# Task Setting Objects - -Each functional product can perform its own individual task. These tasks are configured with the following objects: - -| Settings Object | Task Type | Performed By | Category | -| :----------------------------------------------------------------------------- | :------------------------- | :---------------------------- | :------------------ | -| [`BarcodeReaderTaskSetting Object`](barcode-reader-task-settings.md) | Read Barcodes | Dynamsoft Barcode Reader | Image-Processing | -| [`LabelRecognizerTaskSetting Object`](label-recognizer-task-settings.md) | Recognize Text Lines | Dynamsoft Label Recognizer | Image-Processing | -| [`DocumentNormalizerTaskSetting Object`](document-normalizer-task-settings.md) | Detect Document Boundaries and Normalize a Document | Dynamsoft Document Normalizer | Image-Processing | -| [`CodeParserTaskSetting Object`](code-parser-task-settings.md) | Parse a string | Dynamsoft Code Parser | Semantic-Processing | -| [`OutputTaskSetting Object`](output-task-setting.md) | Output definition | Dynamsoft Image Processing | Image-Processing | diff --git a/parameters/file/task-settings/label-recognizer-task-settings.md b/parameters/file/task-settings/label-recognizer-task-settings.md index 2c3ac43..8bf0849 100644 --- a/parameters/file/task-settings/label-recognizer-task-settings.md +++ b/parameters/file/task-settings/label-recognizer-task-settings.md @@ -1,22 +1,22 @@ --- layout: default-layout -title: Label Recognizer Task Setting - Dynamsoft Capture Vision Parameter File -description: Label Recognizer Task Setting object in the Dynamsoft Capture Vision Parameter File is an object for configuring and organizing the process of label recognition task. +title: LabelRecognizerTaskSetting - Dynamsoft Capture Vision Parameter File +description: The LabelRecognizerTaskSetting object in the Dynamsoft Capture Vision Parameter File. keywords: label recognition, task, setting -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: false +needAutoGenerateSidebar: false --- # LabelRecognizerTaskSetting Object The `LabelRecognizerTaskSetting` object is used to configure settings for a label recognition task to be performed on certain regions of interest (ROIs) in an image. +## Example + ```json { "Name": "dlr_task_default", "MaxThreadsInOneTask": 4, - "TextLineSpecificationNameArray": [ "tls_default" ], + "TextLineSpecificationNameArray": ["tls_default"], "BaseLabelRecognizerTaskSettingName": "", "SectionArray": [ { @@ -25,8 +25,7 @@ The `LabelRecognizerTaskSetting` object is used to configure settings for a labe "StageArray": [ { "Stage": "SST_PREDETECT_REGIONS", - "RegionPredetectionModes": [ - ] + "RegionPredetectionModes": [] } ] }, @@ -55,34 +54,26 @@ The `LabelRecognizerTaskSetting` object is used to configure settings for a labe ], "ConfusableCharactersPath": "ConfusableChars.data", "ClusterSamplesCountThreshold": 0, - "OverlappingCharactersPath": "OverlappingChars.data", + "OverlappingCharactersPath": "OverlappingChars.data", "EnableRegexForceCorrection": 1 }, { "Stage": "SST_ASSEMBLE_TEXT_LINES", - "StringLengthRange": [ - 3, - 200 - ], + "StringLengthRange": [3, 200], "StringRegExPattern": "" } ] - } ] } ``` -
    -

    Example 1 – Parameters of LabelRecognizerTaskSetting

    -
    - -## Summary of LabelRecognizerTaskSetting top-level parameters +## Parameters -| Parameter Name | Description | -| -------------- | ----------- | -| [`Name`]({{site.dcvb_parameters_reference}}label-recognizer-task-settings/name.html) | Defines the name of a `LabelRecognizerTaskSetting` object, which serves as its unique identifier. | -| [`BaseLabelRecognizerTaskSettingName`]({{site.dcvb_parameters_reference}}label-recognizer-task-settings/base-label-recognizer-task-setting-name.html) | Represents the name of another `LabelRecognizerTaskSetting` object to inherit from. | -| [`MaxThreadsInOneTask`]({{site.dcvb_parameters_reference}}label-recognizer-task-settings/max-threads-in-one-task.html) | Defines the maximum threads that can be consumed in one task. | -| [`TextLineSpecificationNameArray`]({{site.dcvb_parameters_reference}}label-recognizer-task-settings/text-line-specification-name-array.html) | Defines the collection of text line specification object names. | -| [`SectionArray`]({{site.dcvb_parameters_reference}}label-recognizer-task-settings/section-array.html) | Defines which sections exist under the `LabelRecognizerTaskSetting`. | +| Parameter Name | Type | Required/Optional | Description | +| -------------- | ---- | ----------------- | ----------- | +| [`Name`]({{site.dcvb_parameters_reference}}label-recognizer-task-settings/name.html) | String | Required | The unique identifier for this `LabelRecognizerTaskSetting` object. | +| [`BaseLabelRecognizerTaskSettingName`]({{site.dcvb_parameters_reference}}label-recognizer-task-settings/base-label-recognizer-task-setting-name.html) | String | Optional | The name of another `LabelRecognizerTaskSetting` object to inherit settings from. | +| [`MaxThreadsInOneTask`]({{site.dcvb_parameters_reference}}label-recognizer-task-settings/max-threads-in-one-task.html) | Integer | Optional | The maximum number of threads that can be used for this task. | +| [`TextLineSpecificationNameArray`]({{site.dcvb_parameters_reference}}label-recognizer-task-settings/text-line-specification-name-array.html) | String Array | Optional | An array of text line specification object names that define how to recognize text lines. | +| [`SectionArray`]({{site.dcvb_parameters_reference}}label-recognizer-task-settings/section-array.html) | Array | Optional | An array of section objects that define the processing workflow for label recognition. | diff --git a/parameters/file/task-settings/output-task-setting.md b/parameters/file/task-settings/output-task-setting.md index fce8743..e261f9b 100644 --- a/parameters/file/task-settings/output-task-setting.md +++ b/parameters/file/task-settings/output-task-setting.md @@ -2,30 +2,27 @@ layout: default-layout title: OutputTaskSetting - Dynamsoft Capture Vision Parameter File description: The OutputTaskSetting object in the Dynamsoft Capture Vision Parameter File. -needAutoGenerateSidebar: true -needGenerateH3Content: false -noTitleIndex: true -permalink: /parameters/file/task-settings/output-task-setting.html +needAutoGenerateSidebar: false --- # OutputTaskSetting Object -The `OutputTaskSetting` object is used to configure how to output the expected results of the ancestor `TargetROIDef` by filtering the results of the descendant `TargetROIDef` object. +The `OutputTaskSetting` object is used to configure how to output the expected results of the ancestor `TargetROIDef` by filtering the results of the descendant `TargetROIDef` objects. + +## Example ```json { - "Name" : "output_task", - + "Name": "output_task", "OutputCondition": { "TaskResultArray": [ { - "TargetROIDefName": "B", + "TargetROIDefName": "B", "TaskSettingNameArray": ["B_task"], "Operator": "AND", - "BackwardReferenceOutput": { - "ReferenceTaskNameArray": ["A_task"], - "ReferenceResultTypeArray":[ "ART_TEXT_LINE","ART_BARCODE","ART_FRAME", "ART_TABLE_CELL", "ART_COLOUR_REGION" ] + "ReferenceTaskNameArray": ["A_task"], + "ReferenceResultTypeArray": ["ART_TEXT_LINE", "ART_BARCODE", "ART_FRAME", "ART_TABLE_CELL", "ART_COLOUR_REGION"] } } ], @@ -34,58 +31,48 @@ The `OutputTaskSetting` object is used to configure how to output the expected r } ``` -
    -

    Example 1 – Parameters of OutputTaskSetting

    -
    - -## Summary of OutputTaskSetting top-level parameters +## Parameters -| Parameter Name | Value Type | Required or Optional | Description | +| Parameter Name | Type | Required/Optional | Description | |---|---|---|---| -| Name | string | Mandatory | Sets the name of current `OutputTaskSetting` object. The value must be unique between all `task-setting` objects. | -| [OutputCondition]({{site.dcvb_parameters_reference}}output-task-setting/output-condition.html) | JSON Object | Optional | Sets how the current `OutputTaskSetting` object outputs results that meet multiple filter conditions across products.| +| [`Name`]({{site.dcvb_parameters_reference}}output-task-setting/name.html) | String | Required | The unique identifier for this `OutputTaskSetting` object. | +| [`OutputCondition`]({{site.dcvb_parameters_reference}}output-task-setting/output-condition.html) | Object | Optional | Defines how to filter and output results based on multiple conditions across descendant ROIs. | + +## OutputCondition Design -## Design of the OutputCondition object +### Key Concepts -|Concept|Description| -|:------|:----------| -|**Reference TargetROIDef object**| Represents the `TargetROIDef` object where the output task is located. It may be the reference `TargetROIDef` of other descendant `TargetROIDef` objects.| -|**Descendant TargetROIDef objects**| Represents descendant `TargetROIDef` objects. The task results of descendant `TargetROIDef` objects can be navigated to the task results of the reference `TargetROIDef` object through the reference item. | +| Concept | Description | +|:--------|:------------| +| **Reference TargetROIDef** | The parent `TargetROIDef` object where the output task is located. It serves as the reference point for descendant ROIs. | +| **Descendant TargetROIDef** | Child `TargetROIDef` objects whose task results can be linked back to the reference `TargetROIDef` for filtering. | -The following example shows how to set the `OutputCondition` object. +### Complete Example + +The following example demonstrates a complete `OutputCondition` configuration: ```json { - ...... - "TargetROIDefOptions" : [ + "TargetROIDefOptions": [ { - "Name" : "A_roi", - "TaskSettingNameArray": [ - "ddn_task", - "output_task" - ] - }, + "Name": "A_roi", + "TaskSettingNameArray": ["ddn_task", "output_task"] + }, { - "Name" : "B_roi", - "TaskSettingNameArray": [ - "dbr_task" - ], - "Location": - { - "ReferenceObjectFilter" : { + "Name": "B_roi", + "TaskSettingNameArray": ["dbr_task"], + "Location": { + "ReferenceObjectFilter": { "ReferenceTargetROIDefNameArray": ["A_roi"], "ReferenceTaskNameArray": ["ddn_task"] } } }, { - "Name" : "C_roi", - "TaskSettingNameArray": [ - "dlr_task" - ], - "Location": - { - "ReferenceObjectFilter" : { + "Name": "C_roi", + "TaskSettingNameArray": ["dlr_task"], + "Location": { + "ReferenceObjectFilter": { "ReferenceTargetROIDefNameArray": ["A_roi"], "ReferenceTaskNameArray": ["ddn_task"] } @@ -94,7 +81,7 @@ The following example shows how to set the `OutputCondition` object. ], "OutputTaskSettingOptions": [ { - "Name" : "output_task", + "Name": "output_task", "OutputCondition": { "TaskResultArray": [ { @@ -107,14 +94,13 @@ The following example shows how to set the `OutputCondition` object. "TargetROIDefName": "C_roi", "BackwardReferenceOutput": { "ReferenceTaskNameArray": ["ddn_task"] - } + } } ], "Operator": "AND" } } ] - ...... } ``` @@ -122,6 +108,7 @@ The following example shows how to set the `OutputCondition` object.

    OutputTaskSetting example

    -There is a parent `TargetROIDef` object named `A_roi` which contains two tasks named `ddn_task` and `output_task`. There are two descendant `TargetROIDef` objects named `B_roi` and `C_roi`, and there is a task named `dbr_task` and `dlr_task` on each `TargetROIDef` respectively. - -The `output_task` works as follows: After processing `B_roi` and `C_roi`, retrieve the task results from `dbr_task` and `dlr_task`, navigate to the reference result generated by `ddn_task`, and execute logical AND combinations to obtain the filtered results. +**In this example:** +- **Parent ROI:** `A_roi` contains tasks `ddn_task` and `output_task` +- **Descendant ROIs:** `B_roi` (with `dbr_task`) and `C_roi` (with `dlr_task`) +- **Workflow:** `output_task` retrieves results from `B_roi` and `C_roi`, references `ddn_task` results, and applies AND logic for filtering diff --git a/parameters/index.md b/parameters/index.md deleted file mode 100644 index ceee670..0000000 --- a/parameters/index.md +++ /dev/null @@ -1,54 +0,0 @@ ---- -layout: default-layout -title: Parameters Introduction - Dynamsoft Capture Vision -description: This article introduces Dynamsoft Capture Vision Parameters. -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: false -permalink: /parameters/index.html ---- - -# Introduction to Dynamsoft Capture Vision Parameters - -[Dynamsoft Capture Vision Architecture](../architecture/index.md) is designed to accommodate both entry-level needs and sophisticated business logic. While [Capture Vision Router](../architecture/index.md#capture-vision-router) allows developers to get started with image-processing in their applications within hours, the Dynamsoft Capture Vision (DCV) parameters are what make it possible for the applications to be able to handle all sorts of image-processing scenarios without changing the code much. - -Simply put, DCV parameters are used to configure how different functional products work in the Dynamsoft Capture Vision architecture. - -These docs help you learn and use the DCV parameters. - -## Parameter File - -### File Overview - -The following topics are covered in the [Parameter File Overview](file/index.md): - -| Topic | Description | -| :------------------------------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------- | -| [Organization of a Parameter Template File](file/index.md#organization-of-a-parameter-template-file). | A template file contains one or multiple templates. | -| [Structure of a Parameter Template](file/index.md#structure-of-a-parameter-template). | A template is a predefined configuration of parameters. | -| [How to Apply DCV Parameters](file/index.md#how-to-apply-dcv-parameters). | This topic discusses how to interact with DCV to import or update templates. | -| [Special Rules for DCV Parameter Configuration](file/index.md#special-rules-for-dcv-parameter-configuration). | This topic talks about special rules to note when defining templates. | - -### File Component Objects - -Each of the objects that make up a Parameter File is introduced in detail: - -| Item Name | Corresponding Object in a Parameter File | -| :-------------------------------------------------------------------------------------- | :--------------------------------------- | -| [CaptureVisionTemplate](file/capture-vision-template.md). | `CaptureVisionTemplates` | -| [ImageSource](file/image-source.md). | `ImageSourceOptions` | -| [TargetROIDefinition](file/target-roi-definition/index.md) | `TargetROIDefOptions` | -| [SemanticProcessingDefinition](file/semantic-processing/index.md) | `SemanticProcessingOptions` | -| [BarcodeReaderTaskSetting](file/task-settings/barcode-reader-task-settings.md) | `BarcodeReaderTaskSettingOptions` | -| [DocumentNormalizerTaskSetting](file/task-settings/document-normalizer-task-settings.md) | `DocumentNormalizerTaskSettingOptions` | -| [LabelRecognizerTaskSetting](file/task-settings/label-recognizer-task-settings.md) | `LabelRecognizerTaskSettingOptions` | -| [CodeParserTaskSetting](file/task-settings/code-parser-task-settings.md) | `CodeParserTaskSettingOptions` | -| [ImageParameter](file/image-parameter.md) | `ImageParameterOptions` | -| [BarcodeFormatSpecification](file/auxiliary/barcode-format-specification.md) | `BarcodeFormatSpecificationOptions` | -| [TextLineSpecification](file/auxiliary/textline-specification.md) | `TextLineSpecificationOptions` | -| [CharacterModel](file/auxiliary/character-model.md) | `CharacterModelOptions` | -| [GlobalParameter](file/auxiliary/global-parameter.md) | `GlobalParameter` | - -## Parameter Reference - -Parameters that make up the items mentioned in [File Component Objects](#file-component-objects) are explained in details in the reference pages. Check out the [reference index](reference/index.md) for a full list of parameters. \ No newline at end of file diff --git a/parameters/reference/barcode-format-specification/all-module-deviation.md b/parameters/reference/barcode-format-specification/all-module-deviation.md index 5274340..378e8c5 100644 --- a/parameters/reference/barcode-format-specification/all-module-deviation.md +++ b/parameters/reference/barcode-format-specification/all-module-deviation.md @@ -3,17 +3,23 @@ layout: default-layout title: AllModuleDeviation - Dynamsoft Barcode Reader Parameters description: The parameter AllModuleDeviation of Dynamsoft Barcode Reader specifies the width deviation value (in moduleSize) of a non-standard 1D barcode type relative to the standard barcode width. keywords: AllModuleDeviation, parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/barcode-format-specification/all-module-deviation.html --- # AllModuleDeviation Parameter `AllModuleDeviation` specifies the width deviation value (in moduleSize) of a non-standard 1D barcode type relative to the standard barcode width. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── AllModuleDeviation +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -21,11 +27,18 @@ Parameter `AllModuleDeviation` specifies the width deviation value (in moduleSiz } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `AllModuleDeviation` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 The unit defined in Parameter `AllModuleDeviation` is barcode module size. For example, if the standard barcode module size is 2px and `AllModuleDeviation` is 1, then the non-standard barcode module size is 4px. The structure of the `AllModuleDeviation` is shown as follow: -| AllModuleDeviation Parameter Summary | +| AllModuleDeviation Parameter Details | | :--------------------------------- | | **Type**
    *int* | | **Range**
    [0, 0x7fffffff] | diff --git a/parameters/reference/barcode-format-specification/australian-post-encoding-table.md b/parameters/reference/barcode-format-specification/australian-post-encoding-table.md index 369db56..4db66bb 100644 --- a/parameters/reference/barcode-format-specification/australian-post-encoding-table.md +++ b/parameters/reference/barcode-format-specification/australian-post-encoding-table.md @@ -3,17 +3,23 @@ layout: default-layout title: AustralianPostEncodingTable - Dynamsoft Barcode Reader Parameters description: The parameter AustralianPostEncodingTable of Dynamsoft Barcode Reader helps specify the encoding table used to code the Customer Information Field of Australian Post Customer Barcode. keywords: AustralianPostEncodingTable, parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/barcode-format-specification/australian-post-encoding-table.html --- # AustralianPostEncodingTable Parameter `AustralianPostEncodingTable` helps specify the encoding table used to code the Customer Information Field of Australian Post Customer Barcode. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── AustralianPostEncodingTable +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -21,11 +27,18 @@ Parameter `AustralianPostEncodingTable` helps specify the encoding table used to } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `AustralianPostEncodingTable` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 The structure of the `AustralianPostEncodingTable` is shown as follow: -| AustralianPostEncodingTable Parameter Summary | +| AustralianPostEncodingTable Parameter Details | | :--------------------------------- | | **Type**
    *String* | | **Range**
    "C" or "N" | diff --git a/parameters/reference/barcode-format-specification/barcode-angle-range-array.md b/parameters/reference/barcode-format-specification/barcode-angle-range-array.md index fea64ef..cf12577 100644 --- a/parameters/reference/barcode-format-specification/barcode-angle-range-array.md +++ b/parameters/reference/barcode-format-specification/barcode-angle-range-array.md @@ -3,16 +3,23 @@ layout: default-layout title: BarcodeAngleRangeArray - Dynamsoft Barcode Reader Parameters description: The parameter BarcodeAngleRangeArray of Dynamsoft Barcode Reader helps specify the encoding table used to code the Customer Information Field of Australian Post Customer Barcode. keywords: BarcodeAngleRangeArray , parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true --- # BarcodeAngleRangeArray Parameter `BarcodeAngleRangeArray` defines the range of angles (in degrees) for barcodes searching and result filtering. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── BarcodeAngleRangeArray +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -26,7 +33,14 @@ Parameter `BarcodeAngleRangeArray` defines the range of angles (in degrees) for } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `BarcodeAngleRangeArray` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 `BarcodeAngleRangeArray` consist of a group of barcode rotation angle range objects. Each object includes the maximum and minimum value of the barcode rotation angle range. diff --git a/parameters/reference/barcode-format-specification/barcode-bytes-length-range-array.md b/parameters/reference/barcode-format-specification/barcode-bytes-length-range-array.md index 1f4837e..e1d9039 100644 --- a/parameters/reference/barcode-format-specification/barcode-bytes-length-range-array.md +++ b/parameters/reference/barcode-format-specification/barcode-bytes-length-range-array.md @@ -3,16 +3,23 @@ layout: default-layout title: BarcodeBytesLengthRangeArray - Dynamsoft Barcode Reader Parameters description: The parameter BarcodeBytesLengthRangeArray of Dynamsoft Barcode Reader defines the range of barcode bytes length for barcodes searching and result filtering. keywords: BarcodeBytesLengthRangeArray , parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true --- # BarcodeBytesLengthRangeArray Parameter `BarcodeBytesLengthRangeArray` defines the range of barcode bytes length for barcodes searching and result filtering. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── BarcodeBytesLengthRangeArray +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -26,7 +33,14 @@ Parameter `BarcodeBytesLengthRangeArray` defines the range of barcode bytes leng } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `BarcodeBytesLengthRangeArray` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 `BarcodeBytesLengthRangeArray` consist of a group of barcode bytes length range objects. Each object includes the maximum and minimum value of the barcode bytes length range. diff --git a/parameters/reference/barcode-format-specification/barcode-format-ids.md b/parameters/reference/barcode-format-specification/barcode-format-ids.md new file mode 100644 index 0000000..3b7db0c --- /dev/null +++ b/parameters/reference/barcode-format-specification/barcode-format-ids.md @@ -0,0 +1,49 @@ +--- +layout: default-layout +title: BarcodeFormatIds - Dynamsoft Barcode Reader Parameters +description: The parameter BarcodeFormatIds defines which barcode formats a BarcodeFormatSpecification configuration applies to. +keywords: Barcode format IDs +--- + +# BarcodeFormatIds + +Parameter `BarcodeFormatIds` specifies which barcode formats the current `BarcodeFormatSpecification` configuration applies to. You can specify multiple barcode formats at one time. + +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── BarcodeFormatIds +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** + +```json +{ + "BarcodeFormatIds": ["BF_ONED", "BF_DATAMATRIX"] +} +``` + +> [!NOTE] +> - This snippet shows only the `BarcodeFormatIds` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 + +| BarcodeFormatIds Parameter Details | +| :--------------------------------- | +| **Type**
    *String[]* | +| **Range**
    Each array element should be a string value from the `BarcodeFormat` enumeration. | +| **Default Value**
    `["BF_ALL"]` | + +**Remarks** + +`BarcodeFormat` enumeration for all supported barcode formats: + +{%- include barcode-format.md -%} diff --git a/parameters/reference/barcode-format-specification/barcode-height-range-array.md b/parameters/reference/barcode-format-specification/barcode-height-range-array.md index 07f4472..a2be839 100644 --- a/parameters/reference/barcode-format-specification/barcode-height-range-array.md +++ b/parameters/reference/barcode-format-specification/barcode-height-range-array.md @@ -2,21 +2,28 @@ layout: default-layout title: BarcodeHeightRangeArray - Dynamsoft Barcode Reader Parameters description: The parameter BarcodeHeightRangeArray of Dynamsoft Barcode Reader defines the range of heights (in pixels) for barcodes searching and result filtering. -keywords: BarcodeHeightRangeArray , parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true +keywords: BarcodeHeightRangeArray, parameter reference, parameter --- # BarcodeHeightRangeArray Parameter `BarcodeHeightRangeArray` defines the range of heights (in pixels) for barcodes searching and result filtering. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── BarcodeHeightRangeArray +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { - "BarcodeHeightRangeArray": + "BarcodeHeightRangeArray": [ { "MinValue": 100, @@ -26,7 +33,14 @@ Parameter `BarcodeHeightRangeArray` defines the range of heights (in pixels) for } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `BarcodeHeightRangeArray` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 `BarcodeHeightRangeArray` consist of a group of barcode height range objects. Each object includes the maximum and minimum value of the barcode height range. diff --git a/parameters/reference/barcode-format-specification/barcode-text-length-range-array.md b/parameters/reference/barcode-format-specification/barcode-text-length-range-array.md index 005ebc6..87a25f0 100644 --- a/parameters/reference/barcode-format-specification/barcode-text-length-range-array.md +++ b/parameters/reference/barcode-format-specification/barcode-text-length-range-array.md @@ -3,16 +3,23 @@ layout: default-layout title: BarcodeTextLengthRangeArray - Dynamsoft Barcode Reader Parameters description: The parameter BarcodeTextLengthRangeArray of Dynamsoft Barcode Reader defines the range of barcode text length for barcodes searching and result filtering. keywords: BarcodeTextLengthRangeArray , parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true --- # BarcodeTextLengthRangeArray Parameter `BarcodeTextLengthRangeArray` defines the range of barcode text length for barcodes searching and result filtering. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── BarcodeTextLengthRangeArray +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -26,7 +33,14 @@ Parameter `BarcodeTextLengthRangeArray` defines the range of barcode text length } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `BarcodeTextLengthRangeArray` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 `BarcodeTextLengthRangeArray` consist of a group of barcode text length range objects. Each object includes the maximum and minimum value of the barcode text length range. diff --git a/parameters/reference/barcode-format-specification/barcode-text-regex-pattern.md b/parameters/reference/barcode-format-specification/barcode-text-regex-pattern.md index acec5e0..1daf811 100644 --- a/parameters/reference/barcode-format-specification/barcode-text-regex-pattern.md +++ b/parameters/reference/barcode-format-specification/barcode-text-regex-pattern.md @@ -3,17 +3,23 @@ layout: default-layout title: BarcodeTextRegExPattern - Dynamsoft Barcode Reader Parameters description: The parameter BarcodeTextRegExPattern of Dynamsoft Barcode Reader defines the regular expression pattern of barcode text characters for barcodes searching and result filtering. keywords: BarcodeTextRegExPattern, parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/barcode-format-specification/barcode-text-regex-pattern.html --- # BarcodeTextRegExPattern Parameter `BarcodeTextRegExPattern` defines the regular expression pattern of barcode text characters for barcodes searching and result filtering. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── BarcodeTextRegExPattern +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -21,11 +27,18 @@ Parameter `BarcodeTextRegExPattern` defines the regular expression pattern of ba } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `BarcodeTextRegExPattern` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 `BarcodeTextRegExPattern` is set to an empty string by default which means there is no limitation on the barcode text characters. The structure of the `BarcodeTextRegExPattern` is shown as follow: -| BarcodeTextRegExPattern Parameter Summary | +| BarcodeTextRegExPattern Parameter Details | | :--------------------------------- | | **Type**
    *string* | | **Range**
    N/A | diff --git a/parameters/reference/barcode-format-specification/barcode-width-range-array.md b/parameters/reference/barcode-format-specification/barcode-width-range-array.md index 5e18435..b6b5500 100644 --- a/parameters/reference/barcode-format-specification/barcode-width-range-array.md +++ b/parameters/reference/barcode-format-specification/barcode-width-range-array.md @@ -3,16 +3,23 @@ layout: default-layout title: BarcodeWidthRangeArray - Dynamsoft Barcode Reader Parameters description: The parameter BarcodeWidthRangeArray of Dynamsoft Barcode Reader defines the range of widths (in pixels) for barcodes searching and result filtering. keywords: BarcodeWidthRangeArray , parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true --- # BarcodeWidthRangeArray Parameter `BarcodeWidthRangeArray` defines the range of widths (in pixels) for barcodes searching and result filtering. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── BarcodeWidthRangeArray +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -26,7 +33,14 @@ Parameter `BarcodeWidthRangeArray` defines the range of widths (in pixels) for b } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `BarcodeWidthRangeArray` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 `BarcodeWidthRangeArray` consist of a group of barcode width range objects. Each object includes the maximum and minimum value of the barcode width range. diff --git a/parameters/reference/barcode-format-specification/barcode-zone-bar-count-range-array.md b/parameters/reference/barcode-format-specification/barcode-zone-bar-count-range-array.md index 1cb91c9..64ee8e4 100644 --- a/parameters/reference/barcode-format-specification/barcode-zone-bar-count-range-array.md +++ b/parameters/reference/barcode-format-specification/barcode-zone-bar-count-range-array.md @@ -3,16 +3,23 @@ layout: default-layout title: BarcodeZoneBarCountRangeArray - Dynamsoft Barcode Reader Parameters description: The parameter BarcodeZoneBarCountRangeArray of Dynamsoft Barcode Reader defines the range of bar count of the barcode zone for barcodes searching. keywords: BarcodeZoneBarCountRangeArray , parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true --- # BarcodeZoneBarCountRangeArray Parameter `BarcodeZoneBarCountRangeArray` defines the range of bar count of the barcode zone for barcodes searching. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── BarcodeZoneBarCountRangeArray +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -25,7 +32,14 @@ Parameter `BarcodeZoneBarCountRangeArray` defines the range of bar count of the } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `BarcodeZoneBarCountRangeArray` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 `BarcodeZoneBarCountRangeArray` consist of a group of barcode zone bar count range objects. Each object includes the maximum and minimum value of the barcode zone bar count range. diff --git a/parameters/reference/barcode-format-specification/barcode-zone-min-distance-to-image-borders.md b/parameters/reference/barcode-format-specification/barcode-zone-min-distance-to-image-borders.md index fdd1dca..1c095e3 100644 --- a/parameters/reference/barcode-format-specification/barcode-zone-min-distance-to-image-borders.md +++ b/parameters/reference/barcode-format-specification/barcode-zone-min-distance-to-image-borders.md @@ -3,17 +3,23 @@ layout: default-layout title: BarcodeZoneMinDistanceToImageBorders - Dynamsoft Barcode Reader Parameters description: The parameter BarcodeZoneMinDistanceToImageBorders of Dynamsoft Barcode Reader defines the minimum distance (in pixels) between the barcode zone and image borders. keywords: BarcodeZoneMinDistanceToImageBorders , parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/barcode-format-specification/barcode-zone-min-distance-to-image-borders.html --- # BarcodeZoneMinDistanceToImageBorders Parameter `BarcodeZoneMinDistanceToImageBorders` defines the minimum distance (in pixels) between the barcode zone and image borders. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── BarcodeZoneMinDistanceToImageBorders +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -21,11 +27,18 @@ Parameter `BarcodeZoneMinDistanceToImageBorders` defines the minimum distance (i } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `BarcodeZoneMinDistanceToImageBorders` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 The structure of the `BarcodeZoneMinDistanceToImageBorders` is shown as follow: -| BarcodeZoneMinDistanceToImageBorders Parameter Summary | +| BarcodeZoneMinDistanceToImageBorders Parameter Details | | :--------------------------------- | | **Type**
    *int* | | **Range**
    [0, 0x7fffffff] | diff --git a/parameters/reference/barcode-format-specification/code128-subset.md b/parameters/reference/barcode-format-specification/code128-subset.md index ad5f994..90a0704 100644 --- a/parameters/reference/barcode-format-specification/code128-subset.md +++ b/parameters/reference/barcode-format-specification/code128-subset.md @@ -3,17 +3,23 @@ layout: default-layout title: Code128Subset - Dynamsoft Barcode Reader Parameters description: The parameter Code128Subset of Dynamsoft Barcode Reader defines the subset of Code 128. keywords: Code128Subset , parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/barcode-format-specification/code128-subset.html --- # Code128Subset Parameter `Code128Subset` defines the subset of Code 128. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── Code128Subset +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -21,11 +27,18 @@ Parameter `Code128Subset` defines the subset of Code 128. } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `Code128Subset` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 The structure of the `Code128Subset` is shown as follow: -| Code128Subset Parameter Summary | +| Code128Subset Parameter Details | | :--------------------------------- | | **Type**
    *string* | | **Range**
    "A"
    "B"
    "C" | diff --git a/parameters/reference/barcode-format-specification/data-matrix-module-isotropic.md b/parameters/reference/barcode-format-specification/data-matrix-module-isotropic.md index 89a39f9..3f407e0 100644 --- a/parameters/reference/barcode-format-specification/data-matrix-module-isotropic.md +++ b/parameters/reference/barcode-format-specification/data-matrix-module-isotropic.md @@ -9,7 +9,17 @@ keywords: DataMatrixModuleIsotropic, parameter reference, parameter Parameter `DataMatrixModuleIsotropic` specifies whether the Data Matrix modules are isotropic, meaning they have equal scaling in all directions. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── DataMatrixModuleIsotropic +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -17,11 +27,18 @@ Parameter `DataMatrixModuleIsotropic` specifies whether the Data Matrix modules } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `DataMatrixModuleIsotropic` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 The structure of the `DataMatrixModuleIsotropic` is shown as follow: -| DataMatrixModuleIsotropic Parameter Summary | +| DataMatrixModuleIsotropic Parameter Details | | :--------------------------------- | | **Type**
    *int* | | **Range**
    [0, 1] | diff --git a/parameters/reference/barcode-format-specification/data-matrix-size-options.md b/parameters/reference/barcode-format-specification/data-matrix-size-options.md index 6e44cfe..ea6554a 100644 --- a/parameters/reference/barcode-format-specification/data-matrix-size-options.md +++ b/parameters/reference/barcode-format-specification/data-matrix-size-options.md @@ -9,7 +9,17 @@ keywords: DataMatrixSizeOptions, parameter reference, parameter Parameter `DataMatrixSizeOptions` defines expected size of the DataMatrix to be decoded. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── DataMatrixSizeOptions +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -17,11 +27,18 @@ Parameter `DataMatrixSizeOptions` defines expected size of the DataMatrix to be } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `DataMatrixSizeOptions` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 The structure of the `DataMatrixSizeOptions` is shown as follow: -| DataMatrixSizeOptions Parameter Summary | +| DataMatrixSizeOptions Parameter Details | | :--------------------------------- | | **Type**
    *string[]* | | **Range**
    ["DMS_DEFAULT","DMS_ALL","DMS_SQUARE","DMS_RECTANGLE","DMS_DMRE","DMS_SQUARE_10_10","DMS_SQUARE_12_12","DMS_SQUARE_14_14","DMS_SQUARE_16_16","DMS_SQUARE_18_18","DMS_SQUARE_20_20","DMS_SQUARE_22_22","DMS_SQUARE_24_24","DMS_SQUARE_26_26","DMS_SQUARE_32_32","DMS_SQUARE_36_36","DMS_SQUARE_40_40","DMS_SQUARE_44_44","DMS_SQUARE_48_48","DMS_SQUARE_52_52","DMS_SQUARE_64_64","DMS_SQUARE_72_72","DMS_SQUARE_80_80","DMS_SQUARE_88_88","DMS_SQUARE_96_96","DMS_SQUARE_104_104","DMS_SQUARE_120_120","DMS_SQUARE_132_132","DMS_SQUARE_144_144","DMS_RECTANGLE_8_18","DMS_RECTANGLE_8_32","DMS_RECTANGLE_12_26","DMS_RECTANGLE_12_36","DMS_RECTANGLE_16_36","DMS_RECTANGLE_16_48","DMS_DMRE_8_48","DMS_DMRE_8_64","DMS_DMRE_8_80","DMS_DMRE_8_96","DMS_DMRE_8_120","DMS_DMRE_8_144","DMS_DMRE_12_64","DMS_DMRE_12_88","DMS_DMRE_16_64","DMS_DMRE_20_36","DMS_DMRE_20_44","DMS_DMRE_20_64","DMS_DMRE_22_48","DMS_DMRE_24_48","DMS_DMRE_24_64","DMS_DMRE_26_40","DMS_DMRE_26_48","DMS_DMRE_26_64"] | diff --git a/parameters/reference/barcode-format-specification/enable-addon-code.md b/parameters/reference/barcode-format-specification/enable-addon-code.md index b50d2b8..daf7bb9 100644 --- a/parameters/reference/barcode-format-specification/enable-addon-code.md +++ b/parameters/reference/barcode-format-specification/enable-addon-code.md @@ -3,17 +3,23 @@ layout: default-layout title: EnableAddOnCode - Dynamsoft Barcode Reader Parameters description: The parameter EnableAddOnCode of Dynamsoft Barcode Reader defines whether to identify addon code. keywords: EnableAddOnCode , parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/barcode-format-specification/enable-addon-code.html --- # EnableAddOnCode Parameter `EnableAddOnCode` defines whether to identify addon code. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── EnableAddOnCode +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -21,11 +27,18 @@ Parameter `EnableAddOnCode` defines whether to identify addon code. } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `EnableAddOnCode` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 The structure of the `EnableAddOnCode` is shown as follow: -| EnableAddOnCode Parameter Summary | +| EnableAddOnCode Parameter Details | | :--------------------------------- | | **Type**
    *int* | | **Range**
    [0, 1] | diff --git a/parameters/reference/barcode-format-specification/enable-data-matrix-ecc000-140.md b/parameters/reference/barcode-format-specification/enable-data-matrix-ecc000-140.md index fe6e405..2e304fb 100644 --- a/parameters/reference/barcode-format-specification/enable-data-matrix-ecc000-140.md +++ b/parameters/reference/barcode-format-specification/enable-data-matrix-ecc000-140.md @@ -3,17 +3,23 @@ layout: default-layout title: EnableDataMatrixECC000-140 - Dynamsoft Barcode Reader Parameters description: The parameter EnableDataMatrixECC000-140 of Dynamsoft Barcode Reader defines whether to read Data Matrix ECC000-140 barcode. keywords: Enable Data Matrix ECC000-140 , parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/barcode-format-specification/enable-data-matrix-ecc000-140.html --- # EnableDataMatrixECC000-140 Parameter `EnableDataMatrixECC000-140` defines whether to read Data Matrix ECC000-140 barcode. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── EnableDataMatrixECC000-140 +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -21,11 +27,18 @@ Parameter `EnableDataMatrixECC000-140` defines whether to read Data Matrix ECC00 } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `EnableDataMatrixECC000-140` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 The structure of the `EnableDataMatrixECC000-140` is shown as follow: -| EnableDataMatrixECC000-140 Parameter Summary | +| EnableDataMatrixECC000-140 Parameter Details | | :--------------------------------- | | **Type**
    *int* | | **Range**
    [0, 1] | diff --git a/parameters/reference/barcode-format-specification/enable-qr-code-model-1.md b/parameters/reference/barcode-format-specification/enable-qr-code-model-1.md index 1d9d070..b64ba4c 100644 --- a/parameters/reference/barcode-format-specification/enable-qr-code-model-1.md +++ b/parameters/reference/barcode-format-specification/enable-qr-code-model-1.md @@ -3,17 +3,23 @@ layout: default-layout title: EnableQRCodeModel1 - Dynamsoft Barcode Reader Parameters description: The parameter EnableQRCodeModel1 of Dynamsoft Barcode Reader defines whether to read QR code model 1. keywords: EnableQRCodeModel1 , parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/barcode-format-specification/enable-qr-code-model-1.html --- # EnableQRCodeModel1 Parameter `EnableQRCodeModel1` defines whether to read QR code model 1. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── EnableQRCodeModel1 +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -21,11 +27,18 @@ Parameter `EnableQRCodeModel1` defines whether to read QR code model 1. } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `EnableQRCodeModel1` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 The structure of the `EnableQRCodeModel1` is shown as follow: -| EnableQRCodeModel1 Parameter Summary | +| EnableQRCodeModel1 Parameter Details | | :--------------------------------- | | **Type**
    *int* | | **Range**
    [0, 1] | diff --git a/parameters/reference/barcode-format-specification/expected-barcodes-count.md b/parameters/reference/barcode-format-specification/expected-barcodes-count.md index 85328e6..f17edc9 100644 --- a/parameters/reference/barcode-format-specification/expected-barcodes-count.md +++ b/parameters/reference/barcode-format-specification/expected-barcodes-count.md @@ -13,7 +13,17 @@ Parameter `ExpectedBarcodesCount` of `BarcodeFormatSpecification` defines the ex - Introduced in version 11.2.1000. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── ExpectedBarcodesCount +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -21,9 +31,16 @@ Parameter `ExpectedBarcodesCount` of `BarcodeFormatSpecification` defines the ex } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `ExpectedBarcodesCount` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 -| ExpectedBarcodesCount Parameter Summary | +| ExpectedBarcodesCount Parameter Details | | :--------------------------------- | | **Type**
    *int* | | **Range**
    [1, 0x7fffffff] | diff --git a/parameters/reference/barcode-format-specification/find-uneven-module-barcode.md b/parameters/reference/barcode-format-specification/find-uneven-module-barcode.md index dc776a3..fdae872 100644 --- a/parameters/reference/barcode-format-specification/find-uneven-module-barcode.md +++ b/parameters/reference/barcode-format-specification/find-uneven-module-barcode.md @@ -3,17 +3,23 @@ layout: default-layout title: FindUnevenModuleBarcode - Dynamsoft Barcode Reader Parameters description: The parameter Code128Subset of Dynamsoft Barcode Reader defines whether to find barcodes with uneven barcode modules. keywords: FindUnevenModuleBarcode , parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/barcode-format-specification/find-uneven-module-barcode.html --- # FindUnevenModuleBarcode Parameter `FindUnevenModuleBarcode` defines whether to find barcodes with uneven barcode modules. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── FindUnevenModuleBarcode +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -21,11 +27,18 @@ Parameter `FindUnevenModuleBarcode` defines whether to find barcodes with uneven } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `FindUnevenModuleBarcode` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 The structure of the `FindUnevenModuleBarcode` is shown as follow: -| FindUnevenModuleBarcode Parameter Summary | +| FindUnevenModuleBarcode Parameter Details | | :--------------------------------- | | **Type**
    *int* | | **Range**
    [0, 1] | diff --git a/parameters/reference/barcode-format-specification/has-vertical-quietzone.md b/parameters/reference/barcode-format-specification/has-vertical-quietzone.md index a3a6db5..75661e3 100644 --- a/parameters/reference/barcode-format-specification/has-vertical-quietzone.md +++ b/parameters/reference/barcode-format-specification/has-vertical-quietzone.md @@ -13,7 +13,17 @@ Parameter `HasVerticalQuietZone` defines whether there is a sufficient vertical - Introduced in version 11.2.1000. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── HasVerticalQuietzone +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -21,11 +31,18 @@ Parameter `HasVerticalQuietZone` defines whether there is a sufficient vertical } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `HasVerticalQuietzone` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 The structure of the `HasVerticalQuietZone` is shown as follow: -| HasVerticalQuietZone Parameter Summary | +| HasVerticalQuietZone Parameter Details | | :--------------------------------- | | **Type**
    *int* | | **Range**
    [0, 1] | diff --git a/parameters/reference/barcode-format-specification/head-module-ratio.md b/parameters/reference/barcode-format-specification/head-module-ratio.md index f037993..68cb9d3 100644 --- a/parameters/reference/barcode-format-specification/head-module-ratio.md +++ b/parameters/reference/barcode-format-specification/head-module-ratio.md @@ -3,17 +3,23 @@ layout: default-layout title: HeadModuleRatio - Dynamsoft Barcode Reader Parameters description: The parameter HeadModuleRatio of Dynamsoft Barcode Reader defines the module count and module size ratio of the barcode head section. keywords: HeadModuleRatio , parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/barcode-format-specification/head-module-ratio.html --- # HeadModuleRatio `HeadModuleRatio` defines the module count and module size ratio of the barcode head section. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── HeadModuleRatio +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -21,11 +27,18 @@ permalink: /parameters/reference/barcode-format-specification/head-module-ratio. } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `HeadModuleRatio` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 The structure of the `HeadModuleRatio` is shown as follow: -| HeadModuleRatio Parameter Summary | +| HeadModuleRatio Parameter Details | | :--------------------------------- | | **Type**
    *string* | | **Range**
    N/A | diff --git a/parameters/reference/barcode-format-specification/include-implied-ai01.md b/parameters/reference/barcode-format-specification/include-implied-ai01.md index 6d2d47f..181dca7 100644 --- a/parameters/reference/barcode-format-specification/include-implied-ai01.md +++ b/parameters/reference/barcode-format-specification/include-implied-ai01.md @@ -9,7 +9,17 @@ keywords: IncludeImpliedAI01, parameter reference, parameter Parameter `IncludeImpliedAI01` defines whether to prepend the implied "01" at the beginning of the result bytes/text. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── IncludeImpliedAi01 +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -17,11 +27,18 @@ Parameter `IncludeImpliedAI01` defines whether to prepend the implied "01" at th } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `IncludeImpliedAi01` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 The structure of the `IncludeImpliedAI01` is shown as follow: -| IncludeImpliedAI01 Parameter Summary | +| IncludeImpliedAI01 Parameter Details | | :--------------------------------- | | **Type**
    *int* | | **Range**
    [0, 1] | diff --git a/parameters/reference/barcode-format-specification/include-trailing-check-digit.md b/parameters/reference/barcode-format-specification/include-trailing-check-digit.md index d83a3fc..3248a05 100644 --- a/parameters/reference/barcode-format-specification/include-trailing-check-digit.md +++ b/parameters/reference/barcode-format-specification/include-trailing-check-digit.md @@ -9,7 +9,17 @@ keywords: IncludeTrailingCheckDigit, parameter reference, parameter Parameter `IncludeTrailingCheckDigit` defines whether to include the trailing check digit in the byte result. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── IncludeTrailingCheckDigit +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -17,11 +27,18 @@ Parameter `IncludeTrailingCheckDigit` defines whether to include the trailing ch } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `IncludeTrailingCheckDigit` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 The structure of the `IncludeTrailingCheckDigit` is shown as follow: -| IncludeTrailingCheckDigit Parameter Summary | +| IncludeTrailingCheckDigit Parameter Details | | :--------------------------------- | | **Type**
    *int* | | **Range**
    [0, 1] | diff --git a/parameters/reference/barcode-format-specification/min-quiet-zone-width.md b/parameters/reference/barcode-format-specification/min-quiet-zone-width.md index d3f5497..9351e82 100644 --- a/parameters/reference/barcode-format-specification/min-quiet-zone-width.md +++ b/parameters/reference/barcode-format-specification/min-quiet-zone-width.md @@ -3,17 +3,23 @@ layout: default-layout title: MinQuietZoneWidth - Dynamsoft Barcode Reader Parameters description: The parameter MinQuietZoneWidth of Dynamsoft Barcode Reader defines the minimum width (in moduleSize) of the barcode quiet zone. keywords: MinQuietZoneWidth , parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/barcode-format-specification/min-quiet-zone-width.html --- # MinQuietZoneWidth `MinQuietZoneWidth` defines the minimum width (in moduleSize) of the barcode quiet zone. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── MinQuietZoneWidth +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -21,11 +27,18 @@ permalink: /parameters/reference/barcode-format-specification/min-quiet-zone-wid } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `MinQuietZoneWidth` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 The structure of the `MinQuietZoneWidth` is shown as follow: -| MinQuietZoneWidth Parameter Summary | +| MinQuietZoneWidth Parameter Details | | :--------------------------------- | | **Type**
    *int* | | **Range**
    [0, 0x7fffffff] | diff --git a/parameters/reference/barcode-format-specification/min-ratio-of-barcode-zone-width-to-height.md b/parameters/reference/barcode-format-specification/min-ratio-of-barcode-zone-width-to-height.md index 376ed32..de09299 100644 --- a/parameters/reference/barcode-format-specification/min-ratio-of-barcode-zone-width-to-height.md +++ b/parameters/reference/barcode-format-specification/min-ratio-of-barcode-zone-width-to-height.md @@ -3,17 +3,23 @@ layout: default-layout title: MinRatioOfBarcodeZoneWidthToHeight - Dynamsoft Barcode Reader Parameters description: The parameter MinQuietZoneWidth of Dynamsoft Barcode Reader defines the minimum ratio (width/height as a percentage) of the barcode zone. keywords: MinRatioOfBarcodeZoneWidthToHeight , parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/barcode-format-specification/min-ratio-of-barcode-zone-width-to-height.html --- # MinRatioOfBarcodeZoneWidthToHeight Parameter `MinRatioOfBarcodeZoneWidthToHeight` defines the minimum ratio (width/height as a percentage) of the barcode zone. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── MinRatioOfBarcodeZoneWidthToHeight +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -21,11 +27,18 @@ Parameter `MinRatioOfBarcodeZoneWidthToHeight` defines the minimum ratio (width/ } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `MinRatioOfBarcodeZoneWidthToHeight` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 The structure of the `MinRatioOfBarcodeZoneWidthToHeight` is shown as follow: -| MinRatioOfBarcodeZoneWidthToHeight Parameter Summary | +| MinRatioOfBarcodeZoneWidthToHeight Parameter Details | | :--------------------------------- | | **Type**
    *int* | | **Range**
    [0, 10000] | diff --git a/parameters/reference/barcode-format-specification/min-result-confidence.md b/parameters/reference/barcode-format-specification/min-result-confidence.md index b53b468..11f6e46 100644 --- a/parameters/reference/barcode-format-specification/min-result-confidence.md +++ b/parameters/reference/barcode-format-specification/min-result-confidence.md @@ -3,17 +3,23 @@ layout: default-layout title: MinResultConfidence - Dynamsoft Barcode Reader Parameters description: The parameter MinResultConfidence of Dynamsoft Barcode Reader defines the minimum confidence of the result. keywords: MinResultConfidence , parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/barcode-format-specification/min-result-confidence.html --- # MinResultConfidence `MinResultConfidence` defines the minimum confidence of the result. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── MinResultConfidence +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -21,11 +27,18 @@ permalink: /parameters/reference/barcode-format-specification/min-result-confide } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `MinResultConfidence` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 The structure of the `MinResultConfidence` is shown as follow: -| MinResultConfidence Parameter Summary | +| MinResultConfidence Parameter Details | | :--------------------------------- | | **Type**
    *int* | | **Range**
    [0, 100] | diff --git a/parameters/reference/barcode-format-specification/mirror-mode.md b/parameters/reference/barcode-format-specification/mirror-mode.md index 688599e..a997328 100644 --- a/parameters/reference/barcode-format-specification/mirror-mode.md +++ b/parameters/reference/barcode-format-specification/mirror-mode.md @@ -3,17 +3,23 @@ layout: default-layout title: MirrorMode - Dynamsoft Barcode Reader Parameters description: The parameter MirrorMode of Dynamsoft Barcode Reader defines whether to decode mirrored barcodes. keywords: MirrorMode , parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/barcode-format-specification/mirror-mode.html --- # MirrorMode `MirrorMode` defines whether to decode mirrored barcodes. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── MirrorMode +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -21,11 +27,18 @@ permalink: /parameters/reference/barcode-format-specification/mirror-mode.html } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `MirrorMode` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 The structure of the`MirrorMode` is shown as follow: -| MirrorMode Parameter Summary | +| MirrorMode Parameter Details | | :--------------------------------- | | **Type**
    *String* | | **Candidate Mode List**
    MM_NORMAL
    MM_MIRROR
    MM_BOTH | @@ -37,7 +50,7 @@ Different barcode formats have different default MirrorMode settings: - MM_BOTH: QRCode, DataMatrix, PDF417, AZTEC, Micro QR Code, Micro PDF417 and DotCode. - MM_NORMAL: Other barcode formats -## Candidate Modes Introduction +## Candidate Mode Introductions ### MM_MIRROR diff --git a/parameters/reference/barcode-format-specification/module-size-range-array.md b/parameters/reference/barcode-format-specification/module-size-range-array.md index 072b048..bdf76c7 100644 --- a/parameters/reference/barcode-format-specification/module-size-range-array.md +++ b/parameters/reference/barcode-format-specification/module-size-range-array.md @@ -3,16 +3,23 @@ layout: default-layout title: ModuleSizeRangeArray - Dynamsoft Barcode Reader Parameters description: The parameter ModuleSizeRangeArray of Dynamsoft Barcode Reader defines the range of module size (in pixels) while barcode searching and result filtering. keywords: ModuleSizeRangeArray , parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true --- # ModuleSizeRangeArray Parameter `ModuleSizeRangeArray` defines the range of module size (in pixels) while barcode searching and result filtering. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── ModuleSizeRangeArray +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -26,7 +33,14 @@ Parameter `ModuleSizeRangeArray` defines the range of module size (in pixels) wh } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `ModuleSizeRangeArray` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 `ModuleSizeRangeArray` consist of a group of barcode module size range objects. Each object includes the maximum and minimum value of the barcode module size range. diff --git a/parameters/reference/barcode-format-specification/msi-code-check-digit-calculation.md b/parameters/reference/barcode-format-specification/msi-code-check-digit-calculation.md index 8358ae2..d29c0fa 100644 --- a/parameters/reference/barcode-format-specification/msi-code-check-digit-calculation.md +++ b/parameters/reference/barcode-format-specification/msi-code-check-digit-calculation.md @@ -3,17 +3,23 @@ layout: default-layout title: MSICodeCheckDigitCalculation - Dynamsoft Barcode Reader Parameters description: The parameter ModuleSizeRangeArray of Dynamsoft Barcode Reader defines the scheme used for calculating a check digit of an MSI barcode. keywords: MSICodeCheckDigitCalculation , parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/barcode-format-specification/msi-code-check-digit-calculation.html --- # MSICodeCheckDigitCalculation Parameter `MSICodeCheckDigitCalculation` defines the scheme used for calculating a check digit of an MSI barcode. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── MsiCodeCheckDigitCalculation +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -21,11 +27,18 @@ Parameter `MSICodeCheckDigitCalculation` defines the scheme used for calculating } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `MsiCodeCheckDigitCalculation` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 The structure of the `MSICodeCheckDigitCalculation` is shown as follow: -| MSICodeCheckDigitCalculation Parameter Summary | +| MSICodeCheckDigitCalculation Parameter Details | | :--------------------------------- | | **Type**
    *string* | | **Range**
    MSICCDC_NO_CHECK_DIGIT
    MSICCDC_MOD_10
    MSICCDC_MOD_11
    MSICCDC_MOD_1110
    MSICCDC_MOD_1010 | diff --git a/parameters/reference/barcode-format-specification/name.md b/parameters/reference/barcode-format-specification/name.md index 64ec8ac..3c4da57 100644 --- a/parameters/reference/barcode-format-specification/name.md +++ b/parameters/reference/barcode-format-specification/name.md @@ -3,17 +3,23 @@ layout: default-layout title: Name - Dynamsoft Capture Vision Parameter Reference BarcodeFormatSpecification Object. description: The parameter Name defines the unique identifier of BarcodeFormatSpecification object. keywords: top-level object, name, unique identifier -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true -permalink: /parameters/reference/barcode-format-specification/name.html --- # Name Parameter `Name` represents the name of a `BarcodeFormatSpecification` object, which serves as its unique identifier. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── Name +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -21,7 +27,14 @@ Parameter `Name` represents the name of a `BarcodeFormatSpecification` object, w } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `Name` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 Details | | :----------------------------------- | diff --git a/parameters/reference/barcode-format-specification/partition-modes.md b/parameters/reference/barcode-format-specification/partition-modes.md index 78af2a6..e380666 100644 --- a/parameters/reference/barcode-format-specification/partition-modes.md +++ b/parameters/reference/barcode-format-specification/partition-modes.md @@ -3,17 +3,23 @@ layout: default-layout title: PartitionModes - Dynamsoft Barcode Reader Parameters description: The parameter PartitionModes of Dynamsoft Barcode Reader is used to select the mode used to apply partition process when decoding QRCode and DataMatrix. keywords: PartitionModes , parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/barcode-format-specification/partition-modes.html --- # PartitionModes Parameter `PartitionModes` is used to select the mode used to apply partition process when decoding QRCode and DataMatrix. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── PartitionModes +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -21,11 +27,18 @@ Parameter `PartitionModes` is used to select the mode used to apply partition pr } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `PartitionModes` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 The structure of the `PartitionModes` is shown as follow: -| PartitionModes Parameter Summary | +| PartitionModes Parameter Details | | :--------------------------------- | | **Type**
    *string array* | | **Candidate Mode List**
    PM_WHOLE_BARCODE
    PM_ALIGNMENT_PARTITION | diff --git a/parameters/reference/barcode-format-specification/patch-code-searching-margins.md b/parameters/reference/barcode-format-specification/patch-code-searching-margins.md index 6dca6a8..f7f1e01 100644 --- a/parameters/reference/barcode-format-specification/patch-code-searching-margins.md +++ b/parameters/reference/barcode-format-specification/patch-code-searching-margins.md @@ -3,17 +3,23 @@ layout: default-layout title: PatchCodeSearchingMargins - Dynamsoft Barcode Reader Parameters description: The parameter PatchCodeSearchingMargins of Dynamsoft Barcode Reader defines the patch code searching margins. keywords: PatchCodeSearchingMargins , parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/barcode-format-specification/patch-code-searching-margins.html --- # PatchCodeSearchingMargins Parameter `PatchCodeSearchingMargins` defines the patch code searching margins. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── PatchCodeSearchingMargins +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -28,7 +34,14 @@ Parameter `PatchCodeSearchingMargins` defines the patch code searching margins. } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `PatchCodeSearchingMargins` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 `PatchCodeSearchingMargins` is set by a patch code searching margins object. The patch code searching margins object includes a series of child parameters to define the top, bottom, left, right margins and how they are measured. diff --git a/parameters/reference/barcode-format-specification/require-start-stop-chars.md b/parameters/reference/barcode-format-specification/require-start-stop-chars.md index 9c28c75..1d21ea4 100644 --- a/parameters/reference/barcode-format-specification/require-start-stop-chars.md +++ b/parameters/reference/barcode-format-specification/require-start-stop-chars.md @@ -3,17 +3,23 @@ layout: default-layout title: RequireStartStopChars - Dynamsoft Barcode Reader Parameters description: The parameter RequireStartStopChars of Dynamsoft Barcode Reader defines whether the start and/or stop characters are required when searching for common 1D barcodes. keywords: RequireStartStopChars , parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/barcode-format-specification/require-start-stop-chars.html --- # RequireStartStopChars Parameter `RequireStartStopChars` defines whether the start and/or stop characters are required when searching for common 1D barcodes. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── RequireStartStopChars +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -21,11 +27,18 @@ Parameter `RequireStartStopChars` defines whether the start and/or stop characte } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `RequireStartStopChars` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 The structure of the`RequireStartStopChars` is shown as follow: -| RequireStartStopChars Parameter Summary | +| RequireStartStopChars Parameter Details | | :--------------------------------- | | **Type**
    *int* | | **Range**
    [0, 1] | diff --git a/parameters/reference/barcode-format-specification/return-partial-barcode-value.md b/parameters/reference/barcode-format-specification/return-partial-barcode-value.md index f5874b6..a750435 100644 --- a/parameters/reference/barcode-format-specification/return-partial-barcode-value.md +++ b/parameters/reference/barcode-format-specification/return-partial-barcode-value.md @@ -3,17 +3,23 @@ layout: default-layout title: ReturnPartialBarcodeValue - Dynamsoft Barcode Reader Parameters description: The parameter ReturnPartialBarcodeValue of Dynamsoft Barcode Reader defines whether to return partial barcode value(s). keywords: ReturnPartialBarcodeValue , parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/barcode-format-specification/return-partial-barcode-value.html --- # ReturnPartialBarcodeValue `ReturnPartialBarcodeValue` defines whether to return partial barcode value(s). -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── ReturnPartialBarcodeValue +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -21,11 +27,18 @@ permalink: /parameters/reference/barcode-format-specification/return-partial-bar } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `ReturnPartialBarcodeValue` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 The structure of the`ReturnPartialBarcodeValue` is shown as follow: -| ReturnPartialBarcodeValue Parameter Summary | +| ReturnPartialBarcodeValue Parameter Details | | :--------------------------------- | | **Type**
    *int* | | **Range**
    [0, 1] | diff --git a/parameters/reference/barcode-format-specification/standard-format.md b/parameters/reference/barcode-format-specification/standard-format.md index 103c33a..f6ef2d1 100644 --- a/parameters/reference/barcode-format-specification/standard-format.md +++ b/parameters/reference/barcode-format-specification/standard-format.md @@ -3,17 +3,23 @@ layout: default-layout title: StandardFormat - Dynamsoft Barcode Reader Parameters description: The parameter StandardFormat of Dynamsoft Barcode Reader defines the standard barcode format. keywords: StandardFormat , parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/barcode-format-specification/standard-format.html --- # StandardFormat `StandardFormat` defines the standard barcode format. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── StandardFormat +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -21,12 +27,25 @@ permalink: /parameters/reference/barcode-format-specification/standard-format.ht } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `StandardFormat` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 The structure of the`StandardFormat` is shown as follow: -| StandardFormat Parameter Summary | +| StandardFormat Parameter Details | | :--------------------------------- | | **Type**
    *string* | -| **Range**
    [BarcodeFormat]({{ site.dcvb_enums }}barcode-reader/barcode-format.html#barcodeformat) | +| **Range**
    A string value from the `BarcodeFormat` enumeration, excluding combined values (BF_ALL, BF_DEFAULT, BF_ONED, BF_GS1_DATABAR, BF_POSTALCODE, BF_PHARMACODE). | | **Default Value**
    ""| + +**Remarks** + +`BarcodeFormat` enumeration for all supported barcode formats: + +{%- include barcode-format.md -%} \ No newline at end of file diff --git a/parameters/reference/barcode-format-specification/tail-module-ratio.md b/parameters/reference/barcode-format-specification/tail-module-ratio.md index 226c02c..c754436 100644 --- a/parameters/reference/barcode-format-specification/tail-module-ratio.md +++ b/parameters/reference/barcode-format-specification/tail-module-ratio.md @@ -3,16 +3,22 @@ layout: default-layout title: TailModuleRatio - Dynamsoft Barcode Reader Parameters description: The parameter TailModuleRatio of Dynamsoft Barcode Reader defines the module count and module size ratio of the barcode tail section. keywords: TailModuleRatio , parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/barcode-format-specification/tail-module-ratio.html --- # TailModuleRatio `TailModuleRatio` defines the module count and module size ratio of the barcode tail section. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── TailModuleRatio +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -20,11 +26,18 @@ permalink: /parameters/reference/barcode-format-specification/tail-module-ratio. } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `TailModuleRatio` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 The structure of the`TailModuleRatio` is shown as follow: -| TailModuleRatio Parameter Summary | +| TailModuleRatio Parameter Details | | :--------------------------------- | | **Type**
    *string* | | **Range**
    N/A | diff --git a/parameters/reference/barcode-format-specification/verify-check-digit.md b/parameters/reference/barcode-format-specification/verify-check-digit.md index 83d39e1..87d8589 100644 --- a/parameters/reference/barcode-format-specification/verify-check-digit.md +++ b/parameters/reference/barcode-format-specification/verify-check-digit.md @@ -3,17 +3,23 @@ layout: default-layout title: VerifyCheckDigit - Dynamsoft Barcode Reader Parameters description: The parameter VerifyCheckDigit of Dynamsoft Barcode Reader specifies whether to verify the check digit in barcodes where this check digit is optional. keywords: VerifyCheckDigit, parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/barcode-format-specification/verify-check-digit.html --- # VerifyCheckDigit Parameter `VerifyCheckDigit` specifies whether to verify the check digit in barcodes where this check digit is optional. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeFormatSpecificationOptions[i] + └── VerifyCheckDigit +``` + +**Parent object:** [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) object + +**Example:** ```json { @@ -21,11 +27,18 @@ Parameter `VerifyCheckDigit` specifies whether to verify the check digit in barc } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `VerifyCheckDigit` parameter. +> - To use it, embed this parameter within a [BarcodeFormatSpecification]({{ site.dcvb_parameters }}file/auxiliary/barcode-format-specification.html) 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 The structure of the `VerifyCheckDigit` is shown as follow: -| VerifyCheckDigit Parameter Summary | +| VerifyCheckDigit Parameter Details | | :--------------------------------- | | **Type**
    *int* | | **Range**
    [0, 1] | diff --git a/parameters/reference/barcode-reader-task-settings/barcode-colour-modes.md b/parameters/reference/barcode-reader-task-settings/barcode-colour-modes.md deleted file mode 100644 index 8f10ff1..0000000 --- a/parameters/reference/barcode-reader-task-settings/barcode-colour-modes.md +++ /dev/null @@ -1,178 +0,0 @@ ---- -layout: default-layout -title: BarcodeColourModes - Dynamsoft Barcode Reader Parameters -description: The parameter BarcodeColourModes of Dynamsoft Barcode Reader defines the barcode colour modes. -keywords: Barcode colour modes -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/barcode-reader-task-settings/barcode-colour-modes.html ---- - -# BarcodeColourModes - -Parameter `BarcodeColourModes` defines the barcode colour modes. It consists of one or more modes, with each representing a different colour environment. - -## Example - -```json -"BarcodeColourModes" : -[ - { - "LightReflection" : 1, - "Mode" : "BICM_DARK_ON_LIGHT" - } -] -``` - -## Parameter Summary - -Parameter `BarcodeColourModes` consist of a group of barcode colour mode objects. Each barcode colour mode object includes a candidate mode and a series of auxiliary mode arguments. - -### Mode Arguments - -The mode arguments of the barcode colour mode object are shown as follow: - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    Mode Argument NameMode Argument Summary
    Mode
    (Required)
    Description
    Specifies a target barcode colour mode. -
    Type
    String -
    Candidate Mode List
    BICM_DARK_ON_LIGHT -
    BICM_LIGHT_ON_DARK -
    BICM_DARK_ON_DARK -
    BICM_LIGHT_ON_LIGHT -
    BICM_DARK_LIGHT_MIXED -
    BICM_DARK_ON_LIGHT_DARK_SURROUNDING -
    BICM_SKIP -
    Default Value
    BICM_DARK_ON_LIGHT -
    LightReflection
    (Optional)
    Description
    A number from value range of LightReflection. -
    Type
    int -
    Range
    [0,1] -
    Default Value
    1 -
    Remarks
    0: no light reflection. -
    1: has light reflection. -
    LibraryFileName
    (Optional)
    Description
    Sets the file name of the library to load dynamically. -
    Type
    String -
    Range
    A string value representing file name. -
    Default Value
    "" -
    Valid For
    All modes. -
    LibraryParameters
    (Optional)
    Description
    The library must be in the same place with Dynamsoft Barcode Reader Library. -
    Type
    String -
    Range
    A string value representing parameters. -
    Default Value
    "" -
    Valid For
    All modes. -
    - -### Default Setting - -If the `BarcodeColourModes` is not configured in your template file, the following setting will be used as the default setting. - -```json -{ - "BarcodeColourModes" : null -} -``` - -## Candidate Modes Introduction - -### BICM_DARK_ON_LIGHT - -The target barcode is a dark item on a light background. This mode has the following arguments for further customizing. - -**Available Mode Arguments:** - -- LightReflection -- LibraryFileName -- LibraryParameters - -### BICM_DARK_ON_LIGHT_DARK_SURROUNDING - -The target barcode is a dark item on a light background surrounded by dark. This mode has the following arguments for further customizing. - -**Available Mode Arguments:** - -- LightReflection -- LibraryFileName -- LibraryParameters - -### BICM_LIGHT_ON_DARK - -The target barcode is a light item on a dark background. Not supported yet. - -### BICM_DARK_ON_DARK - -The target barcode is a dark item on a dark background. Not supported yet. - -### BICM_LIGHT_ON_LIGHT - -The target barcode is a light item on a light background. Not supported yet. - -### BICM_DARK_LIGHT_MIXED - -The target barcode is on background which is mixed by dark and light. Not supported yet \ No newline at end of file diff --git a/parameters/reference/barcode-reader-task-settings/barcode-complement-modes.md b/parameters/reference/barcode-reader-task-settings/barcode-complement-modes.md index af942f8..b71bcc2 100644 --- a/parameters/reference/barcode-reader-task-settings/barcode-complement-modes.md +++ b/parameters/reference/barcode-reader-task-settings/barcode-complement-modes.md @@ -1,19 +1,27 @@ --- layout: default-layout title: BarcodeComplementModes - Dynamsoft Barcode Reader Parameters -description: The parameter BarcodeComplementModes of Dynamsoft Barcode Reader defines the barcode colour modes. +description: The parameter BarcodeComplementModes of Dynamsoft Barcode Reader defines how to complement the missing parts of a barcode. keywords: Barcode complement modes -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/barcode-reader-task-settings/barcode-complement-modes.html --- # BarcodeComplementModes Parameter `BarcodeComplementModes` defines how to complement the missing parts of a barcode. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeReaderTaskSettingOptions[i] + ├── SectionArray[j] + │ └── StageArray[k] (Stage object) + │ └── BarcodeComplementModes +``` + +**Parent object:** [ComplementBarcodeStage]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/stage-complement-barcode.html) object + +**Example:** ```json { @@ -25,13 +33,19 @@ Parameter `BarcodeComplementModes` defines how to complement the missing parts o } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `BarcodeComplementModes` parameter. +> - To use it, embed this parameter within a 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 `BarcodeComplementModes` consist of a group of barcode complement mode objects. Each barcode complement mode object includes a candidate mode and a series of auxiliary mode arguments. +Parameter `BarcodeComplementModes` consists of a group of barcode complement mode objects. Each barcode complement mode object includes a candidate mode and a series of auxiliary mode arguments. ### Mode Arguments -The mode arguments of the barcode complement mode object are shown as follow: +The mode arguments of the barcode complement mode object are shown as follows: @@ -41,7 +55,7 @@ The mode arguments of the barcode complement mode object are shown as follow: - + @@ -55,80 +69,28 @@ The mode arguments of the barcode complement mode object are shown as follow:
    BCM_SKIP - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    Mode
    (Required)
    Mode
    (Required)
    Description
    Specifies a barcode complement mode.
    Default Value
    BCM_SKIP -
    LibraryFileName
    (Optional)
    Description
    Sets the file name of the library to load dynamically. -
    Type
    String -
    Range
    A string value representing file name. -
    Default Value
    "" -
    Valid For
    All modes. -
    LibraryParameters
    (Optional)
    Description
    The library must be in the same place with Dynamsoft Barcode Reader Library. -
    Type
    String -
    Range
    A string value representing parameters. -
    Default Value
    "" -
    Valid For
    All modes. -
    -### Default Settings +### Default Setting -Barcode complement mode is not implemented by default +By default, barcode complement mode is not implemented. ```json { - "BarcodeComplementModes" : - [ + "BarcodeComplementModes": [ { - "Mode" : "BCM_SKIP" + "Mode": "BCM_SKIP" } - ] + ] } ``` -## Candidate Modes Introduction +## Candidate Mode Introductions ### BCM_GENERAL -Complements the barcode using the general algorithm. This mode has the following arguments for further customizing. - -**Available Mode Arguments:** - -- LibraryFileName -- LibraryParameters +Complements the barcode using the general algorithm. This mode has the following arguments for further customization. ### BCM_AUTO -Lets the library choose a mode automatically. Not supported yet +Lets the library choose a mode automatically. Not supported yet. diff --git a/parameters/reference/barcode-reader-task-settings/barcode-format-ids.md b/parameters/reference/barcode-reader-task-settings/barcode-format-ids.md index 1eba53f..7eeb4be 100644 --- a/parameters/reference/barcode-reader-task-settings/barcode-format-ids.md +++ b/parameters/reference/barcode-reader-task-settings/barcode-format-ids.md @@ -1,19 +1,25 @@ --- layout: default-layout title: BarcodeFormatIds - Dynamsoft Barcode Reader Parameters -description: The parameter BarcodeFormatIds of Dynamsoft Barcode Reader defines the barcode formats to process. +description: The parameter BarcodeFormatIds defines the barcode formats to read in a task. keywords: Barcode format IDs -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/barcode-reader-task-settings/barcode-format-ids.html --- # BarcodeFormatIds -Parameter `BarcodeFormatIds` defines the formats of the barcode to process. You can specify multiple barcode formats at one time. View enumeration [BarcodeFormats]({{site.dcvb_enums}}barcode-reader/barcode-format.html) for all supported barcode formats. +`BarcodeFormatIds` defines which barcode formats to read in a barcode reader task. You can specify multiple barcode formats at one time. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeReaderTaskSettingOptions[i] + └── BarcodeFormatIds +``` + +**Parent object:** [BarcodeReaderTaskSetting]({{ site.dcvb_parameters }}file/task-settings/barcode-reader-task-settings.html) + +**Example:** ```json { @@ -21,10 +27,23 @@ Parameter `BarcodeFormatIds` defines the formats of the barcode to process. You } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `BarcodeFormatIds` parameter. +> - To use it, embed this parameter within a [BarcodeReaderTaskSetting]({{ site.dcvb_parameters }}file/task-settings/barcode-reader-task-settings.html) object in the complete JSON structure. +> - 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) -| BarcodeFormatIds Parameter Summary | +## Parameter Details + +| BarcodeFormatIds Parameter Details | | :--------------------------------- | | **Type**
    *String[]* | -| **Range**
    Each member of the array should be one of the BarcodeFormat enumeration member as a string. | -| **Default Value**
    [ "BF_DEFAULT" ] | +| **Range**
    Each array element should be a string value from the `BarcodeFormat` enumeration. | +| **Default Value**
    `["BF_DEFAULT"]` | + +**Remarks** + +`BarcodeFormat` enumeration for all supported barcode formats: + +{%- include barcode-format.md -%} \ No newline at end of file diff --git a/parameters/reference/barcode-reader-task-settings/barcode-format-specification-name-array.md b/parameters/reference/barcode-reader-task-settings/barcode-format-specification-name-array.md index e970317..153b481 100644 --- a/parameters/reference/barcode-reader-task-settings/barcode-format-specification-name-array.md +++ b/parameters/reference/barcode-reader-task-settings/barcode-format-specification-name-array.md @@ -1,18 +1,25 @@ --- layout: default-layout title: BarcodeFormatSpecificationNameArray - Dynamsoft Barcode Reader Parameters -description: The parameter BarcodeFormatSpecificationNameArray of Dynamsoft Barcode Reader defines the collection of BarcodeFormatSpecification object names +description: The parameter BarcodeFormatSpecificationNameArray defines the collection of BarcodeFormatSpecification object names. keywords: BarcodeFormatSpecification, BarcodeReaderTaskSetting -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true --- # BarcodeFormatSpecificationNameArray -Parameter `BarcodeFormatSpecificationNameArray` defines the collection of BarcodeFormatSpecification object names, used to refer to the `BarcodeFormatSpecification` objects +`BarcodeFormatSpecificationNameArray` defines the collection of `BarcodeFormatSpecification` object names, used to refer to the `BarcodeFormatSpecification` objects. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeReaderTaskSettingOptions[i] + └── BarcodeFormatSpecificationNameArray +``` + +**Parent object:** [BarcodeReaderTaskSetting]({{ site.dcvb_parameters }}file/task-settings/barcode-reader-task-settings.html) + +**Example:** ```json { @@ -20,9 +27,16 @@ Parameter `BarcodeFormatSpecificationNameArray` defines the collection of Barcod } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `BarcodeFormatSpecificationNameArray` parameter. +> - To use it, embed this parameter within a [BarcodeReaderTaskSetting]({{ site.dcvb_parameters }}file/task-settings/barcode-reader-task-settings.html) object in the complete JSON structure. +> - 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 -| BarcodeFormatSpecificationNameArray Parameter Summary | +| BarcodeFormatSpecificationNameArray Parameter Details | | :----------------------------------- | | **Type**
    *String[]* | | **Range**
    Each element is the name of a `BarcodeFormatSpecification` object. | diff --git a/parameters/reference/barcode-reader-task-settings/barcode-scale-modes.md b/parameters/reference/barcode-reader-task-settings/barcode-scale-modes.md index c1b8235..06f84f5 100644 --- a/parameters/reference/barcode-reader-task-settings/barcode-scale-modes.md +++ b/parameters/reference/barcode-reader-task-settings/barcode-scale-modes.md @@ -1,33 +1,58 @@ --- layout: default-layout title: BarcodeScaleModes - Dynamsoft Barcode Reader Parameters -description: The parameter BarcodeScaleModes of Dynamsoft Barcode Reader defines scaling mode applied during barcode recognition. -keywords: barcode scale +description: The parameter BarcodeScaleModes of Dynamsoft Barcode Reader defines the scaling mode applied during barcode recognition. +keywords: barcode scale modes +needGenerateH3Content: true +needAutoGenerateSidebar: true +noTitleIndex: true --- # BarcodeScaleModes Parameter `BarcodeScaleModes` defines the scaling mode applied during barcode recognition. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeReaderTaskSettingOptions[i] + ├── SectionArray[j] + │ └── StageArray[k] (Stage object) + │ └── BarcodeScaleModes +``` + +**Parent object:** [ScaleBarcodeImageStage]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/stage-scale-barcode-image.html) object + +**Example:** ```json { - "BarcodeScaleModes": - [ + "BarcodeScaleModes": [ { - "Mode": "BSM_LINEAR_INTERPOLATION", - "ModuleSizeThreshold": 4, - "TargetModuleSize": 8, + "Mode": "BSM_AUTO", + "ModuleSizeThreshold": 0, + "TargetModuleSize": 0, "AcuteAngleWithXThreshold": -1 - }, + } ] } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `BarcodeScaleModes` parameter. +> - To use it, embed this parameter within a Stage object at the `SST_SCALE_BARCODE_IMAGE` stage. +> - 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 `BarcodeScaleModes` consist of a group of scale mode objects. Each scale mode object includes a candidate mode and a series of mode arguments. The mode arguments of the scale mode object is shown as follow: +## Parameter Details + +Parameter `BarcodeScaleModes` consists of a group of barcode scale mode objects. Each barcode scale mode object includes a candidate mode and a series of auxiliary mode arguments. + +### Mode Arguments + +The mode arguments of the barcode scale mode object are shown as follows: ### Mode Arguments @@ -39,7 +64,7 @@ Parameter `BarcodeScaleModes` consist of a group of scale mode objects. Each sca - Mode
    (Required) + Mode
    (Required) Description
    Any one in Candidate Mode List as string @@ -49,11 +74,7 @@ Parameter `BarcodeScaleModes` consist of a group of scale mode objects. Each sca Candidate Mode List
    BSM_LINEAR_INTERPOLATION - - - - Default Value
    -
    BSM_LINEAR_INTERPOLATION +
    BSM_AUTO @@ -117,27 +138,36 @@ Parameter `BarcodeScaleModes` consist of a group of scale mode objects. Each sca ### Default Setting -If the `BarcodeScaleModes` is not configured in your template file, the following setting will be used as the default setting. - ```json { - "BarcodeScaleModes" : - [ + "BarcodeScaleModes": [ { - "Mode" : "BSM_LINEAR_INTERPOLATION", - "ModuleSizeThreshold" : 0, - "TargetModuleSize" : 0, - "AcuteAngleWithXThreshold" : -1 + "Mode": "BSM_AUTO", + "ModuleSizeThreshold": 0, + "TargetModuleSize": 0, + "AcuteAngleWithXThreshold": -1 } ] } ``` -## Candidate Modes Introduction +## Candidate Mode Introductions + +### BSM_AUTO + +Lets the library choose a mode automatically. This mode has the following arguments for further customization: + +**Available Mode Arguments:** + +- AcuteAngleWithXThreshold +- ModuleSizeThreshold +- TargetModuleSize ### BSM_LINEAR_INTERPOLATION -Scales image using the linear interpolation method. This mode has the following arguments for further customizing: +Scales image using the linear interpolation method. This mode has the following arguments for further customization: + +**Available Mode Arguments:** - AcuteAngleWithXThreshold - ModuleSizeThreshold diff --git a/parameters/reference/barcode-reader-task-settings/base-barcode-reader-task-setting-name.md b/parameters/reference/barcode-reader-task-settings/base-barcode-reader-task-setting-name.md index 1330cea..52c56bc 100644 --- a/parameters/reference/barcode-reader-task-settings/base-barcode-reader-task-setting-name.md +++ b/parameters/reference/barcode-reader-task-settings/base-barcode-reader-task-setting-name.md @@ -1,19 +1,25 @@ --- layout: default-layout title: BaseBarcodeReaderTaskSettingName - Dynamsoft Barcode Reader Parameters -description: The parameter BaseBarcodeReaderTaskSettingName of Dynamsoft Barcode Reader defines the name of base BarcodeReaderTaskSetting. +description: The parameter BaseBarcodeReaderTaskSettingName defines the name of base BarcodeReaderTaskSetting. keywords: Base barcode reader task setting name -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/barcode-reader-task-settings/base-barcode-reader-task-setting-name.html --- -# BaseBarcodeReaderTaskSettingName +# BaseBarcodeReaderTaskSettingName -Parameter `BaseBarcodeReaderTaskSettingName` represents the name of another `BarcodeReaderTaskSetting` object. It is used to inherit the parameters defined in its parent `BarcodeReaderTaskSetting` object. If a parameter has already been defined in this object, the parameter with the same name will not be inherited from the parent object. +`BaseBarcodeReaderTaskSettingName` represents the name of another `BarcodeReaderTaskSetting` object. It is used to inherit the parameters defined in its parent `BarcodeReaderTaskSetting` object. If a parameter has already been defined in this object, the parameter with the same name will not be inherited from the parent object. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeReaderTaskSettingOptions[i] + └── BaseBarcodeReaderTaskSettingName +``` + +**Parent object:** [BarcodeReaderTaskSetting]({{ site.dcvb_parameters }}file/task-settings/barcode-reader-task-settings.html) + +**Example:** ```json { @@ -21,9 +27,16 @@ Parameter `BaseBarcodeReaderTaskSettingName` represents the name of another `Bar } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `BaseBarcodeReaderTaskSettingName` parameter. +> - To use it, embed this parameter within a [BarcodeReaderTaskSetting]({{ site.dcvb_parameters }}file/task-settings/barcode-reader-task-settings.html) object in the complete JSON structure. +> - 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 -| BaseBarcodeReaderTaskSettingName Parameter Summary | +| BaseBarcodeReaderTaskSettingName Parameter Details | | :----------------------------------------- | | **Type**
    *String* | | **Range**
    One of the existing `BarcodeReaderTaskSetting` object name. | diff --git a/parameters/reference/barcode-reader-task-settings/deblur-modes.md b/parameters/reference/barcode-reader-task-settings/deblur-modes.md index c50c27e..0e46a06 100644 --- a/parameters/reference/barcode-reader-task-settings/deblur-modes.md +++ b/parameters/reference/barcode-reader-task-settings/deblur-modes.md @@ -12,12 +12,23 @@ noTitleIndex: true Parameter `DeblurModes` defines the mode and priority for deblurring. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeReaderTaskSettingOptions[i] + ├── SectionArray[j] + │ └── StageArray[k] (Stage object) + │ └── DeblurModes +``` + +**Parent object:** [DecodeBarcodesStage]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/stage-decode-barcodes.html) object + +**Example:** ```json { - "DeblurModes": - [ + "DeblurModes": [ { "Mode": "DM_BASED_ON_LOC_BIN" }, @@ -28,13 +39,20 @@ Parameter `DeblurModes` defines the mode and priority for deblurring. } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `DeblurModes` parameter. +> - To use it, embed this parameter within a Stage object at the `SST_DECODE_BARCODES` stage. +> - 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 `DeblurModes` consist of a group of deblur mode objects. Each deblur mode object includes a candidate mode and a series of auxiliary mode arguments. +Parameter `DeblurModes` consists of a group of deblur mode objects. Each deblur mode object includes a candidate mode and a series of auxiliary mode arguments. ### Mode Arguments -The mode arguments of the deblur mode object are shown as follow: +The mode arguments of the deblur mode object are shown as follows: @@ -167,7 +185,7 @@ The mode arguments of the deblur mode object are shown as follow: ### Default Setting -If the `DeblurModes` is not configured in your template file, the following settings will be used as the default settings. +By default, deblur modes are not configured and set to null. ```json { @@ -175,22 +193,21 @@ If the `DeblurModes` is not configured in your template file, the following sett } ``` -**Remarks** - -The actual deblur modes used are: -- For Barcode Format PDF417 +**Remarks:** -[DM_BASED_ON_LOC_BIN,DM_THRESHOLD_BINARIZATION,DM_DIRECT_BINARIZATION,DM_SMOOTHING,DM_GRAY_EQUALIZATION,DM_MORPHING,DM_DEEP_ANALYSIS] +When `DeblurModes` is null, the actual deblur modes used depend on the barcode format: -- For Barcode Format OneD +- **For PDF417 format:** + [DM_BASED_ON_LOC_BIN, DM_THRESHOLD_BINARIZATION, DM_DIRECT_BINARIZATION, DM_SMOOTHING, DM_GRAY_EQUALIZATION, DM_MORPHING, DM_DEEP_ANALYSIS] -[DM_BASED_ON_LOC_BIN,DM_THRESHOLD_BINARIZATION,DM_THRESHOLD_BINARIZATION,DM_DIRECT_BINARIZATION,**DM_NEURAL_NETWORK(with EAN13Decoder and Code128Decoder)**,DM_DEEP_ANALYSIS,DM_SMOOTHING,DM_GRAY_EQUALIZATION,DM_MORPHING] +- **For OneD formats:** + [DM_BASED_ON_LOC_BIN, DM_THRESHOLD_BINARIZATION, DM_DIRECT_BINARIZATION, **DM_NEURAL_NETWORK (with EAN13Decoder and Code128Decoder)**, DM_DEEP_ANALYSIS, DM_SMOOTHING, DM_GRAY_EQUALIZATION, DM_MORPHING] -- For other formats +- **For other formats** -[DM_BASED_ON_LOC_BIN,DM_THRESHOLD_BINARIZATION,DM_DIRECT_BINARIZATION,DM_DEEP_ANALYSIS,DM_SMOOTHING,DM_GRAY_EQUALIZATION,DM_MORPHING] + [DM_BASED_ON_LOC_BIN,DM_THRESHOLD_BINARIZATION,DM_DIRECT_BINARIZATION,DM_DEEP_ANALYSIS,DM_SMOOTHING,DM_GRAY_EQUALIZATION,DM_MORPHING] -## Candidate Modes Introduction +## Candidate Mode Introductions ### DM_DIRECT_BINARIZATION diff --git a/parameters/reference/barcode-reader-task-settings/deformation-resisting-modes.md b/parameters/reference/barcode-reader-task-settings/deformation-resisting-modes.md index 88afc4d..1ff11d0 100644 --- a/parameters/reference/barcode-reader-task-settings/deformation-resisting-modes.md +++ b/parameters/reference/barcode-reader-task-settings/deformation-resisting-modes.md @@ -2,37 +2,54 @@ layout: default-layout title: DeformationResistingModes - Dynamsoft Barcode Reader Parameters description: The parameter DeformationResistingModes of Dynamsoft Barcode Reader defines how to handle distorted and deformed barcodes. -keywords: Deblur modes +keywords: Deformation resisting modes needGenerateH3Content: true needAutoGenerateSidebar: true noTitleIndex: true -permalink: /parameters/reference/barcode-reader-task-settings/deformation-resisting-modes.html --- # DeformationResistingModes Parameter `DeformationResistingModes` defines how to handle distorted and deformed barcodes. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeReaderTaskSettingOptions[i] + ├── SectionArray[j] + │ └── StageArray[k] (Stage object) + │ └── DeformationResistingModes +``` + +**Parent object:** [ResistDeformationStage]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/stage-resist-deformation.html) object + +**Example:** ```json { - "DeformationResistingModes" : - [ + "DeformationResistingModes": [ { - "Mode" : "DRM_SKIP" + "Mode": "DRM_SKIP" } ] } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `DeformationResistingModes` parameter. +> - To use it, embed this parameter within a Stage object at the `SST_RESIST_DEFORMATION` stage. +> - 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 `DeformationResistingModes` consist of a group of deformation resisting mode objects. Each deformation resisting mode object includes a candidate mode and a series of auxiliary mode arguments. +## Parameter Details + +Parameter `DeformationResistingModes` consists of a group of deformation resisting mode objects. Each deformation resisting mode object includes a candidate mode and a series of auxiliary mode arguments. ### Mode Arguments -The mode arguments of the deformation resisting mode object are shown as follow: +The mode arguments of the deformation resisting mode object are shown as follows:
    @@ -42,7 +59,7 @@ The mode arguments of the deformation resisting mode object are shown as follow: - + @@ -59,10 +76,6 @@ The mode arguments of the deformation resisting mode object are shown as follow:
    DRM_SKIP - - -
    Mode
    (Required)
    Mode
    (Required)
    Description
    Specifies a mode for deformation resisting.
    Default Value
    -
    Level
    (Optional)
    Description
    Sets the Argument Level. @@ -153,15 +166,16 @@ The mode arguments of the deformation resisting mode object are shown as follow: ### Default Settings ```json -"DeformationResistingModes" : -[ - { - "Mode" : "DRM_SKIP" - } -] +{ + "DeformationResistingModes": [ + { + "Mode" : "DRM_SKIP" + } + ] +} ``` -## Candidate Modes Introduction +## Candidate Mode Introductions ### DRM_GENERAL diff --git a/parameters/reference/barcode-reader-task-settings/dpm-code-reading-modes.md b/parameters/reference/barcode-reader-task-settings/dpm-code-reading-modes.md index 56ad21c..bcc91d2 100644 --- a/parameters/reference/barcode-reader-task-settings/dpm-code-reading-modes.md +++ b/parameters/reference/barcode-reader-task-settings/dpm-code-reading-modes.md @@ -12,26 +12,43 @@ noTitleIndex: true Parameter `DPMCodeReadingModes` defines how to read direct part mark (DPM) barcodes. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeReaderTaskSettingOptions[i] + └── DPMCodeReadingModes +``` + +**Parent object:** [BarcodeReaderTaskSetting]({{ site.dcvb_parameters }}file/task-settings/barcode-reader-task-settings.html) + +**Example:** ```json { - "DPMCodeReadingModes": - [ + "DPMCodeReadingModes": [ { - "Mode": "DPMCRM_GENERAL" + "Mode": "DPMCRM_GENERAL", + "BarcodeFormat": "BF_DATAMATRIX" } ] } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `DPMCodeReadingModes` parameter. +> - To use it, embed this parameter within a `BarcodeReaderTaskSetting` 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 `DPMCodeReadingModes` consist of a group of DPM code reading mode objects. Each object includes a candidate mode and a series of auxiliary mode arguments. +Parameter `DPMCodeReadingModes` consists of a group of DPM code reading mode objects. Each DPM code reading mode object includes a candidate mode and a series of auxiliary mode arguments. ### Mode Arguments -The mode arguments of the DPM code reading mode object are shown as follow: +The mode arguments of the DPM code reading mode object are shown as follows: @@ -116,14 +133,13 @@ The mode arguments of the DPM code reading mode object are shown as follow:
    -### Default Settings +### Default Setting If the `DPMCodeReadingModes` is not configured in your template file, the following setting will be used as the default setting. ```json { - "DPMCodeReadingModes" : - [ + "DPMCodeReadingModes": [ { "Mode" : "DPMCRM_SKIP" } @@ -131,7 +147,7 @@ If the `DPMCodeReadingModes` is not configured in your template file, the follow } ``` -## Candidate Modes Introduction +## Candidate Mode Introductions ### DPMCRM_GENERAL diff --git a/parameters/reference/barcode-reader-task-settings/expected-barcodes-count.md b/parameters/reference/barcode-reader-task-settings/expected-barcodes-count.md index f64da4b..ff61828 100644 --- a/parameters/reference/barcode-reader-task-settings/expected-barcodes-count.md +++ b/parameters/reference/barcode-reader-task-settings/expected-barcodes-count.md @@ -1,19 +1,25 @@ --- layout: default-layout title: ExpectedBarcodesCount - Dynamsoft Barcode Reader Parameters -description: The parameter ExpectedBarcodesCount of Dynamsoft Barcode Reader defines the number of barcodes expected to be detected. +description: The parameter ExpectedBarcodesCount defines the number of barcodes expected to be detected. keywords: Expected barcodes count -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/barcode-reader-task-settings/expected-barcodes-count.html --- # ExpectedBarcodesCount -Parameter `ExpectedBarcodesCount` defines the number of barcodes expected to be detected. +`ExpectedBarcodesCount` defines the number of barcodes expected to be detected. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeReaderTaskSettingOptions[i] + └── ExpectedBarcodesCount +``` + +**Parent object:** [BarcodeReaderTaskSetting]({{ site.dcvb_parameters }}file/task-settings/barcode-reader-task-settings.html) + +**Example:** ```json { @@ -21,9 +27,16 @@ Parameter `ExpectedBarcodesCount` defines the number of barcodes expected to be } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `ExpectedBarcodesCount` parameter. +> - To use it, embed this parameter within a [BarcodeReaderTaskSetting]({{ site.dcvb_parameters }}file/task-settings/barcode-reader-task-settings.html) object in the complete JSON structure. +> - 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 -| ExpectedBarcodesCount Parameter Summary | +| ExpectedBarcodesCount Parameter Details | | :--------------------------------- | | **Type**
    *int* | | **Range**
    [0, 0x7fffffff] | diff --git a/parameters/reference/barcode-reader-task-settings/line-assembly-mode.md b/parameters/reference/barcode-reader-task-settings/line-assembly-mode.md deleted file mode 100644 index 2ee75cd..0000000 --- a/parameters/reference/barcode-reader-task-settings/line-assembly-mode.md +++ /dev/null @@ -1,102 +0,0 @@ ---- -layout: default-layout -title: LineAssemblyMode - Dynamsoft Capture Vision Parameters -description: The parameter LineAssemblyMode of Dynamsoft Capture Vision is for assembling short lines. -keywords: LineAssemblyMode, parameter reference, parameter -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true ---- - - -# LineAssemblyMode - -Parameter `LineAssemblyMode` determines how to assemble the short lines. For tasks like document detection, short line is very important and usually requires a stronger assembling sensitivity to ensure enough lines are captured. - -## Example - -```json -{ - "LineAssemblyMode": - { - "Mode": "LAM_GENERAL", - "Sensitivity": 3 - } -} -``` - -## Parameter Summary - -Parameter `LineAssemblyMode` includes a mode arguments shown as follow: - -### Mode Arguments - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    Mode Argument NameMode Argument Summary
    Mode
    (Required)
    Description
    Any one in Candidate Mode List as string -
    Type
    String -
    Candidate Mode List
    LAM_GENERAL -
    Default Value
    LAM_GENERAL -
    Sensitivity
    (Optional)
    Description
    Sets the sensitivity used for short line assembling. A larger value means the library will take more effort to assemble short lines. -
    Type
    int -
    Range
    [1, 9] -
    Valid For
    -
    LAM_GENERAL -
    - -### Default Setting - -If the `LineAssemblyMode` is not configured in your template file, the following setting will be used as the default setting. - -```json -{ - "LineAssemblyMode": - [ - { - "Mode": "LAM_GENERAL", - "Sensitivity": 3 - } - ] -} -``` - -## Candidate Modes Introduction - -### LAM_GENERAL - -Assemble short lines using the general algorithm. This mode has the following arguments for further customization. - -**Available Mode Arguments:** - -- Sensitivity diff --git a/parameters/reference/barcode-reader-task-settings/localization-modes.md b/parameters/reference/barcode-reader-task-settings/localization-modes.md index 9de5c0c..dd4a8e4 100644 --- a/parameters/reference/barcode-reader-task-settings/localization-modes.md +++ b/parameters/reference/barcode-reader-task-settings/localization-modes.md @@ -10,27 +10,51 @@ noTitleIndex: true # LocalizationModes -Determines how to localize barcodes. It consists of one or more modes, each mode representing a different localization process. +Parameter `LocalizationModes` determines how to localize barcodes. It consists of one or more modes, each mode representing a different localization process. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeReaderTaskSettingOptions[i] + ├── SectionArray[j] + │ └── StageArray[k] (Stage object) + │ └── LocalizationModes +``` + +**Parent object:** [LocalizeCandidateBarcodesStage]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/stage-localize-candidate-barcodes.html) object + +**Example:** ```json -"LocalizationModes" : -[ - { - "Mode" : "LM_CONNECTED_BLOCKS" - }, - { - "Mode" : "LM_SCAN_DIRECTLY", - "ScanDirection" : 0, - "ScanStride" : 0 - } -] +{ + "LocalizationModes": [ + { + "Mode": "LM_CONNECTED_BLOCKS" + }, + { + "Mode": "LM_SCAN_DIRECTLY", + "ScanDirection": 0, + "ScanStride": 0 + } + ] +} ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `LocalizationModes` parameter. +> - To use it, embed this parameter within a Stage object at the `SST_LOCALIZE_CANDIDATE_BARCODES` stage. +> - 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 `LocalizationModes` consists of a group of localization mode objects. Each localization mode object includes a candidate mode and a series of auxiliary mode arguments. + +### Mode Arguments -Parameter `LocalizationModes` consist of a group of localization mode objects. Each localization mode object includes a candidate mode and a series of auxiliary mode arguments. The structure of the localization mode object is shown as follow: +The mode arguments of the localization mode object are shown as follows: ### Mode Arguments @@ -207,36 +231,35 @@ Parameter `LocalizationModes` consist of a group of localization mode objects. E
    -### Default Settings +### Default Setting If the `LocalizationModes` is not configured in your template file, the following settings will be used as the default settings. ```json { - "LocalizationModes" : - [ + "LocalizationModes": [ { - "Mode" : "LM_CONNECTED_BLOCKS" + "Mode": "LM_CONNECTED_BLOCKS" }, { - "IsOneDStacked" : 0, - "Mode" : "LM_SCAN_DIRECTLY", - "ScanDirection" : 0, - "ScanStride" : 0 + "Mode": "LM_SCAN_DIRECTLY", + "IsOneDStacked": 0, + "ScanDirection": 0, + "ScanStride": 0 }, { - "Mode" : "LM_STATISTICS", + "Mode": "LM_STATISTICS" }, { - "Mode" : "LM_LINES", + "Mode": "LM_LINES" } ] } ``` -If you specified an localization mode object with Mode Argument "Mode" only, the default values of the other mode arguments will used. +If you specify a localization mode object with the Mode Argument "Mode" only, the default values of the other mode arguments will be used. -## Candidate Modes Descriptions +## Candidate Mode Introductions ### LM_CONNECTED_BLOCKS diff --git a/parameters/reference/barcode-reader-task-settings/max-threads-in-one-task.md b/parameters/reference/barcode-reader-task-settings/max-threads-in-one-task.md index d4b2b20..182a3b8 100644 --- a/parameters/reference/barcode-reader-task-settings/max-threads-in-one-task.md +++ b/parameters/reference/barcode-reader-task-settings/max-threads-in-one-task.md @@ -7,19 +7,36 @@ keywords: Max threads # MaxThreadsInOneTask -Parameter `MaxThreadsInOneTask` defines the maximum threads that can be consumed in one task. +`MaxThreadsInOneTask` defines the maximum threads that can be consumed in one task. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeReaderTaskSettingOptions[i] + └── MaxThreadsInOneTask +``` + +**Parent object:** [BarcodeReaderTaskSetting]({{ site.dcvb_parameters }}file/task-settings/barcode-reader-task-settings.html) + +**Example:** ```json { - "MaxThreadsInOneTask":4 + "MaxThreadsInOneTask": 4 } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `MaxThreadsInOneTask` parameter. +> - To use it, embed this parameter within a [BarcodeReaderTaskSetting]({{ site.dcvb_parameters }}file/task-settings/barcode-reader-task-settings.html) object in the complete JSON structure. +> - 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 -| MaxThreadsInOneTask Parameter Summary | +| MaxThreadsInOneTask Parameter Details | | :------------- | | **Type**
    *int* | | **Range**
    [0, 256] | diff --git a/parameters/reference/barcode-reader-task-settings/name.md b/parameters/reference/barcode-reader-task-settings/name.md index 8b90f8b..fa9c3a0 100644 --- a/parameters/reference/barcode-reader-task-settings/name.md +++ b/parameters/reference/barcode-reader-task-settings/name.md @@ -1,27 +1,40 @@ --- layout: default-layout -title: BarcodeReaderTaskSetting Name - Dynamsoft Barcode Reader Parameters. +title: Name - Dynamsoft Barcode Reader BarcodeReaderTaskSetting Parameters description: The parameter Name defines the unique identifier of BarcodeReaderTaskSetting object. keywords: top-level object, name, unique identifier -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true -permalink: /parameters/reference/barcode-reader-task-settings/name.html --- # Name -Parameter `Name` represents the name of a `BarcodeReaderTaskSetting` object, which serves as its unique identifier. +`Name` represents the name of a `BarcodeReaderTaskSetting` object, which serves as its unique identifier. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeReaderTaskSettingOptions[i] + └── Name +``` + +**Parent object:** [BarcodeReaderTaskSetting]({{ site.dcvb_parameters }}file/task-settings/barcode-reader-task-settings.html) + +**Example:** ```json { - "Name" : "br_0" + "Name": "br_0" } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `Name` parameter. +> - To use it, embed this parameter within a [BarcodeReaderTaskSetting]({{ site.dcvb_parameters }}file/task-settings/barcode-reader-task-settings.html) object in the complete JSON structure. +> - 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 Details | | :----------------------------------- | diff --git a/parameters/reference/barcode-reader-task-settings/return-barcode-zone-clarity.md b/parameters/reference/barcode-reader-task-settings/return-barcode-zone-clarity.md index d7955aa..3dc5985 100644 --- a/parameters/reference/barcode-reader-task-settings/return-barcode-zone-clarity.md +++ b/parameters/reference/barcode-reader-task-settings/return-barcode-zone-clarity.md @@ -1,19 +1,27 @@ --- layout: default-layout title: ReturnBarcodeZoneClarity - Dynamsoft Barcode Reader Parameters -description: The parameter ReturnBarcodeZoneClarity of Dynamsoft Barcode Reader defines the returned coordinate type. +description: The parameter ReturnBarcodeZoneClarity defines whether to return the clarity of the barcode zone. keywords: Barcode zone clarity -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/barcode-reader-task-settings/return-barcode-zone-clarity.html --- # ReturnBarcodeZoneClarity -Parameter `ReturnBarcodeZoneClarity` defines whether to return the clarity of the barcode zone. +`ReturnBarcodeZoneClarity` defines whether to return the clarity of the barcode zone. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeReaderTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_DECODE_BARCODES") + └── ReturnBarcodeZoneClarity +``` + +**Parent object:** [DecodeBarcodesStage]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/stage-decode-barcodes.html) + +**Example:** ```json { @@ -21,9 +29,16 @@ Parameter `ReturnBarcodeZoneClarity` defines whether to return the clarity of th } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `ReturnBarcodeZoneClarity` parameter. +> - To use it, embed this parameter within a [DecodeBarcodesStage]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/stage-decode-barcodes.html) object in the complete JSON structure. +> - 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 -| ReturnBarcodeZoneClarity Parameter Summary | +| ReturnBarcodeZoneClarity Parameter Details | | :--------------------------------- | | **Type**
    *int* | | **Range**
    [0, 1] | diff --git a/parameters/reference/barcode-reader-task-settings/section-array.md b/parameters/reference/barcode-reader-task-settings/section-array.md index 2b2a783..54619fb 100644 --- a/parameters/reference/barcode-reader-task-settings/section-array.md +++ b/parameters/reference/barcode-reader-task-settings/section-array.md @@ -7,33 +7,50 @@ keywords: Section Array parameter # SectionArray -`SectionArray` is a parameter that defines which sections exist under the `BarcodeReaderTaskSetting`. A `Section` is a sequence of `Stages` that form a relatively complete processing unit, producing milestone results that include location information along with other details. +Parameter `SectionArray` defines which sections exist under the `BarcodeReaderTaskSetting`. A `Section` is a sequence of `Stages` that form a relatively complete processing unit, producing milestone results that include location information along with other details. -The `BarcodeReaderTaskSetting` includes the following sections: +## JSON Structure + +**Location in template:** +``` +BarcodeReaderTaskSettingOptions[i] + └── SectionArray +``` + +**Parent object:** [BarcodeReaderTaskSetting]({{ site.dcvb_parameters }}file/task-settings/barcode-reader-task-settings.html) object -* [RegionPredetectionSection]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-region-predetection.html) - * It is designed to find regions of interest (ROIs) and thus ignoring other parts of the image during subsequent processing. -* [BarcodeLocalizationSection]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-barcode-localization.html) - * It is designed to detect the exact locations of barcodes. -* [BarcodeDecodingSection]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-barcode-decoding.html) - * It is designed to decode the barcode from the locolized barcode areas identified in the previous `BarcodeLocalizationSection` section. +**Example:** ```json { - "SectionArray": - [ + "SectionArray": [ { - "Section": "ST_REGION_PREDETECTION", - // Other parameters... + "Section": "ST_REGION_PREDETECTION" }, { - "Section": "ST_BARCODE_LOCALIZATION", - // Other parameters... + "Section": "ST_BARCODE_LOCALIZATION" }, { - "Section": "ST_BARCODE_DECODING", - // Other parameters... + "Section": "ST_BARCODE_DECODING" } ] } ``` + +> [!NOTE] +> - This snippet shows only the `SectionArray` parameter. +> - To use it, embed this parameter within a [BarcodeReaderTaskSetting]({{ site.dcvb_parameters }}file/task-settings/barcode-reader-task-settings.html) 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 + +The `BarcodeReaderTaskSetting` includes the following sections: + +* [RegionPredetectionSection]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-region-predetection.html) (`ST_REGION_PREDETECTION`) + * Designed to find regions of interest (ROIs) and thus ignore other parts of the image during subsequent processing. +* [BarcodeLocalizationSection]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-barcode-localization.html) (`ST_BARCODE_LOCALIZATION`) + * Designed to detect the exact locations of barcodes. +* [BarcodeDecodingSection]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-barcode-decoding.html) (`ST_BARCODE_DECODING`) + * Designed to decode the barcode from the localized barcode areas identified in the previous `BarcodeLocalizationSection` section. diff --git a/parameters/reference/barcode-reader-task-settings/section-barcode-decoding.md b/parameters/reference/barcode-reader-task-settings/section-barcode-decoding.md index 76e7e9d..b11c746 100644 --- a/parameters/reference/barcode-reader-task-settings/section-barcode-decoding.md +++ b/parameters/reference/barcode-reader-task-settings/section-barcode-decoding.md @@ -1,49 +1,77 @@ --- layout: default-layout -title: BarcodeDecodingSection Object - Dynamsoft Barcode Reader Parameters -description: This page defines BarcodeDecodingSection Object under the BarcodeReaderTaskSetting. -keywords: BarcodeDecodingSection Object +title: BarcodeDecodingSection - Dynamsoft Barcode Reader Parameters +description: The BarcodeDecodingSection defines configuration settings for the barcode decoding process. +keywords: BarcodeDecodingSection --- -# BarcodeDecodingSection Object +# BarcodeDecodingSection -The `BarcodeDecodingSection` object is designed to define the configuration settings for the barcode decoding process. +`BarcodeDecodingSection` defines the configuration settings for the barcode decoding process. In JSON, it is represented as a Section object with `"Section": "ST_BARCODE_DECODING"`. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeReaderTaskSettingOptions[i] + └── SectionArray[j] (Section object where Section = "ST_BARCODE_DECODING") +``` + +**Parent object:** [SectionArray]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-array.html) + +**Example:** ```json { "Section": "ST_BARCODE_DECODING", "ImageParameterName": "ip_dbrDefault", - "StageArray": [] + "StageArray": [ + { + "Stage": "SST_RESIST_DEFORMATION" + }, + { + "Stage": "SST_DECODE_BARCODES" + } + ] } ``` -## Available Parameters +> [!NOTE] +> - This snippet shows a Section object configured for barcode decoding. +> - To use it, add this object to the [SectionArray]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-array.html) of a [BarcodeReaderTaskSetting]({{ site.dcvb_parameters }}file/task-settings/barcode-reader-task-settings.html). +> - 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) + +## Parameters ### Section -The name of the current section, whose value is a fixed value: `ST_BARCODE_DECODING`. +Specifies the section type. Fixed value: `ST_BARCODE_DECODING`. + +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"ST_BARCODE_DECODING"` | ### ImageParameterName -Specifies the name of an `ImageParameter` object to apply in the stages of this section. +Specifies the name of an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) object to apply in the stages of this section. -| Parameter Summary | +| Parameter Details | | :------------- | | **Type**
    *string* | -| **Range**
    *It must be the name of an `ImageParameter` object defined under `ImageParameterOptions`* | -| **Default Value**
    *""* | +| **Range**
    Must be the name of an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) object defined under `ImageParameterOptions` | +| **Default Value**
    `""` | ### StageArray -`StageArray` is a parameter that specifies the stage objects within current section. - -The `BarcodeDecodingSection` consists of following stages: +Specifies the stage objects within this section. The `BarcodeDecodingSection` consists of the following stages: -| Stage Name | Description | -|------------|-------------| -| [ResistDeformationStage]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/stage-resist-deformation.html) | It defines the stage that applies preprocessing techniques to reduce image deformation and improve barcode recognition accuracy. | -| [ComplementBarcodeStage]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/stage-complement-barcode.html) | It is designed at the stage level to define the configuration settings for the barcode complement process. | -| [ScaleBarcodeImageStage]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/stage-scale-barcode-image.html) | It defines the stage where the barcode image is scaled according to the specified scaling mode to optimize recognition. | -| [DecodeBarcodesStage]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/stage-decode-barcodes.html) | It defines the stage that extracts and interprets barcode data from the localized barcode regions). | +| Stage | Description | +|-------|-------------| +| [ResistDeformationStage]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/stage-resist-deformation.html) (`SST_RESIST_DEFORMATION`) | Applies preprocessing techniques to reduce image deformation and improve barcode recognition accuracy. | +| [ComplementBarcodeStage]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/stage-complement-barcode.html) (`SST_COMPLEMENT_BARCODE`) | Defines configuration settings for the barcode complement process. | +| [ScaleBarcodeImageStage]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/stage-scale-barcode-image.html) (`SST_SCALE_BARCODE_IMAGE`) | Scales the barcode image according to the specified scaling mode to optimize recognition. | +| [DecodeBarcodesStage]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/stage-decode-barcodes.html) (`SST_DECODE_BARCODES`) | Extracts and interprets barcode data from the localized barcode regions. | diff --git a/parameters/reference/barcode-reader-task-settings/section-barcode-localization.md b/parameters/reference/barcode-reader-task-settings/section-barcode-localization.md index 7887e3a..7c1ccf0 100644 --- a/parameters/reference/barcode-reader-task-settings/section-barcode-localization.md +++ b/parameters/reference/barcode-reader-task-settings/section-barcode-localization.md @@ -1,47 +1,75 @@ --- layout: default-layout -title: BarcodeLocalizationSection Object - Dynamsoft Barcode Reader Parameters -description: This page defines BarcodeLocalizationSection Object under the BarcodeReaderTaskSetting. -keywords: BarcodeLocalizationSection Object +title: BarcodeLocalizationSection - Dynamsoft Barcode Reader Parameters +description: The BarcodeLocalizationSection defines configuration settings for the barcode localization process. +keywords: BarcodeLocalizationSection --- -# BarcodeLocalizationSection Object +# BarcodeLocalizationSection -The `BarcodeLocalizationSection` object is designed to define the configuration settings for the barcode localization process. +`BarcodeLocalizationSection` defines the configuration settings for the barcode localization process. In JSON, it is represented as a Section object with `"Section": "ST_BARCODE_LOCALIZATION"`. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeReaderTaskSettingOptions[i] + └── SectionArray[j] (Section object where Section = "ST_BARCODE_LOCALIZATION") +``` + +**Parent object:** [SectionArray]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-array.html) + +**Example:** ```json { "Section": "ST_BARCODE_LOCALIZATION", "ImageParameterName": "ip_dbrDefault", - "StageArray": [] + "StageArray": [ + { + "Stage": "SST_LOCALIZE_CANDIDATE_BARCODES" + }, + { + "Stage": "SST_LOCALIZE_BARCODES" + } + ] } ``` -## Available Parameters +> [!NOTE] +> - This snippet shows a Section object configured for barcode localization. +> - To use it, add this object to the [SectionArray]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-array.html) of a [BarcodeReaderTaskSetting]({{ site.dcvb_parameters }}file/task-settings/barcode-reader-task-settings.html). +> - 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) + +## Parameters ### Section -The name of the current section, whose value is a fixed value: `ST_BARCODE_LOCALIZATION`. +Specifies the section type. Fixed value: `ST_BARCODE_LOCALIZATION`. + +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"ST_BARCODE_LOCALIZATION"` | ### ImageParameterName -Specifies the name of an `ImageParameter` object to apply in the stages of this section. +Specifies the name of an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) object to apply in the stages of this section. -| Parameter Summary | +| Parameter Details | | :------------- | | **Type**
    *string* | -| **Range**
    *It must be the name of an `ImageParameter` object defined under `ImageParameterOptions`* | -| **Default Value**
    *""* | +| **Range**
    Must be the name of an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) object defined under `ImageParameterOptions` | +| **Default Value**
    `""` | ### StageArray -`StageArray` is a parameter that specifies the stage objects within current section. - -The `BarcodeLocalizationSection` consists of following stages: +Specifies the stage objects within this section. The `BarcodeLocalizationSection` consists of the following stages: -| Stage Name | Description | -|------------|-------------| -| [LocalizeCandidateBarcodesStage]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/stage-localize-candidate-barcodes.html) | It defines the stage that detects and marks potential barcode locations within the image for further processing. | -| [LocalizeBarcodesStage]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/stage-localize-barcodes.html) | It defines the stage that accurately determines the positions of barcodes within the identified candidate regions. | +| Stage | Description | +|-------|-------------| +| [LocalizeCandidateBarcodesStage]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/stage-localize-candidate-barcodes.html) (`SST_LOCALIZE_CANDIDATE_BARCODES`) | Detects and marks potential barcode locations within the image for further processing. | +| [LocalizeBarcodesStage]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/stage-localize-barcodes.html) (`SST_LOCALIZE_BARCODES`) | Accurately determines the positions of barcodes within the identified candidate regions. | diff --git a/parameters/reference/barcode-reader-task-settings/section-image-parameter-array.md b/parameters/reference/barcode-reader-task-settings/section-image-parameter-array.md deleted file mode 100644 index b422b42..0000000 --- a/parameters/reference/barcode-reader-task-settings/section-image-parameter-array.md +++ /dev/null @@ -1,74 +0,0 @@ ---- -layout: default-layout -title: SectionImageParameterArray - Dynamsoft Barcode Reader Parameters -description: The parameter SectionImageParameterArray defines the image processing algorithms that implemented in the different sections of a barcode reader algorithm task. -keywords: Section image parameter -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true -permalink: /parameters/reference/barcode-reader-task-settings/section-image-parameter-array.html ---- - -# SectionImageParameterArray - -`SectionImageParameterArray` is a parameter that defines `ImageParameter` in section unit. Each `SectionImageParameterArray` element is a group of a section name and a `ImageParameter` name so that this section will use the ImageParameter you specified. If a section is not specified in the array, it will use the default `ImageParameter` configuration. - -The `BarcodeReaderTask` includes the following sections: - -* `ST_REGION_PREDETECTION` -* `ST_BARCODE_LOCALIZATION` -* `ST_BARCODE_DECODING` - -## Example - -```json -{ - "SectionImageParameterArray": - [ - { - "Section": "ST_REGION_PREDETECTION", - "ImageParameterName": "IP_0" - }, - { - "Section": "ST_BARCODE_LOCALIZATION", - "ImageParameterName": "IP_1" - }, - { - "Section": "ST_BARCODE_DECODING", - "ImageParameterName": "IP_1" - } - - ] -} -``` - -## Parameter Summary - - - - - - - - - - - - - - - - - - - - - - - - - -
    Child Parameter NameChild Parameter Summary
    Section
    Description
    Specifies an algorithm section.
    Type
    String
    Range
    One of the following SectionType as a string.
    ST_REGION_PREDETECTION -
    ST_BARCODE_LOCALIZATION -
    ST_BARCODE_DECODING -
    ImageParameterName
    Description
    Specifies the ImageParameter that you want to implement in this section. It must be one of the name that defined under ImageParameterOptions.
    Type
    String
    diff --git a/parameters/reference/barcode-reader-task-settings/section-region-predetection.md b/parameters/reference/barcode-reader-task-settings/section-region-predetection.md index 7e2f185..6a54c8e 100644 --- a/parameters/reference/barcode-reader-task-settings/section-region-predetection.md +++ b/parameters/reference/barcode-reader-task-settings/section-region-predetection.md @@ -1,46 +1,71 @@ --- layout: default-layout -title: RegionPredetectionSection Object - Dynamsoft Barcode Reader Parameters -description: This page defines RegionPredetectionSection Object under the BarcodeReaderTaskSetting. -keywords: RegionPredetectionSection Object +title: RegionPredetectionSection - Dynamsoft Barcode Reader Parameters +description: The RegionPredetectionSection identifies regions of interest (ROIs) for subsequent processing. +keywords: RegionPredetectionSection --- -# RegionPredetectionSection Object +# RegionPredetectionSection -The `RegionPredetectionSection` object is designed to identify region of interest (ROIs), allowing subsequent processing to ignore other parts of the image. The pre-detected region may be identified based on color features, grayscale features, or neural network localization. +`RegionPredetectionSection` identifies regions of interest (ROIs), allowing subsequent processing to ignore other parts of the image. In JSON, it is represented as a Section object with `"Section": "ST_REGION_PREDETECTION"`. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeReaderTaskSettingOptions[i] + └── SectionArray[j] (Section object where Section = "ST_REGION_PREDETECTION") +``` + +**Parent object:** [SectionArray]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-array.html) + +**Example:** ```json { "Section": "ST_REGION_PREDETECTION", "ImageParameterName": "ip_dbrDefault", - "StageArray": [] + "StageArray": [ + { + "Stage": "SST_PREDETECT_REGIONS" + } + ] } ``` -## Available Parameters +> [!NOTE] +> - This snippet shows a Section object configured for region predetection. +> - To use it, add this object to the [SectionArray]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-array.html) of a [BarcodeReaderTaskSetting]({{ site.dcvb_parameters }}file/task-settings/barcode-reader-task-settings.html). +> - 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) + +## Parameters ### Section -The name of the current section, whose value is a fixed value: `ST_REGION_PREDETECTION`. +Specifies the section type. Fixed value: `ST_REGION_PREDETECTION`. + +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"ST_REGION_PREDETECTION"` | ### ImageParameterName -Specifies the name of an `ImageParameter` object to apply in the stages of this section. +Specifies the name of an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) object to apply in the stages of this section. -| Parameter Summary | +| Parameter Details | | :------------- | | **Type**
    *string* | -| **Range**
    *It must be the name of an `ImageParameter` object defined under `ImageParameterOptions`* | -| **Default Value**
    *""* | +| **Range**
    Must be the name of an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) object defined under `ImageParameterOptions` | +| **Default Value**
    `""` | ### StageArray -`StageArray` is a parameter that specifies the stage objects within current section. - -The `RegionPredetectionSection` consists of following stages: +Specifies the stage objects within this section. The `RegionPredetectionSection` consists of the following stages: -| Stage Name | Description | -|------------|-------------| -| [PredetectRegionsStage]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/stage-predetect-regions.html) | It defines the stage that identifies potential barcode regions before the main detection process. | +| Stage | Description | +|-------|-------------| +| [PredetectRegionsStage]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/stage-predetect-regions.html) (`SST_PREDETECT_REGIONS`) | Identifies potential barcode regions before the main detection process. | diff --git a/parameters/reference/barcode-reader-task-settings/short-line-detection-mode.md b/parameters/reference/barcode-reader-task-settings/short-line-detection-mode.md deleted file mode 100644 index 903aded..0000000 --- a/parameters/reference/barcode-reader-task-settings/short-line-detection-mode.md +++ /dev/null @@ -1,102 +0,0 @@ ---- -layout: default-layout -title: ShortLineDetectionMode - Dynamsoft Capture Vision Parameters -description: The parameter ShortLineDetectionMode of Dynamsoft Capture Vision is for detecting short lines on an image. -keywords: ShortLineDetectionMode, parameter reference, parameter -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true ---- - - -# ShortLineDetectionMode - -Parameter `ShortLineDetectionMode` determines how to detect the short lines. For tasks like document detection, short line is very important and usually requires a stronger detection sensitivity to ensure enough short lines are captured. - -## Example - -```json -{ - "ShortlineDetectionMode": - { - "Mode": "SDM_GENERAL", - "Sensitivity": 3 - } -} -``` - -## Parameter Summary - -Parameter `ShortlineDetectionMode` includes a mode arguments shown as follow: - -### Mode Arguments - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    Mode Argument NameMode Argument Summary
    Mode
    (Required)
    Description
    Any one in Candidate Mode List as string -
    Type
    String -
    Candidate Mode List
    SDM_GENERAL -
    Default Value
    SDM_GENERAL -
    Sensitivity
    (Optional)
    Description
    Sets the sensitivity used for short line detection. A larger value means the library will take more effort to detect short lines. -
    Type
    int -
    Range
    [1, 9] -
    Valid For
    -
    SDM_GENERAL -
    - -### Default Setting - -If the `ShortlineDetectionMode` is not configured in your template file, the following setting will be used as the default setting. - -```json -{ - "ShortlineDetectionMode": - [ - { - "Mode": "SDM_GENERAL", - "Sensitivity": 3 - } - ] -} -``` - -## Candidate Modes Introduction - -### SDM_GENERAL - -Detects short lines using the general algorithm. This mode has the following arguments for further customization. - -**Available Mode Arguments:** - -- Sensitivity diff --git a/parameters/reference/barcode-reader-task-settings/stage-complement-barcode.md b/parameters/reference/barcode-reader-task-settings/stage-complement-barcode.md index ef60e6d..d238729 100644 --- a/parameters/reference/barcode-reader-task-settings/stage-complement-barcode.md +++ b/parameters/reference/barcode-reader-task-settings/stage-complement-barcode.md @@ -1,29 +1,57 @@ --- layout: default-layout title: ComplementBarcodeStage - Dynamsoft Barcode Reader Parameters -description: This page defines ComplementBarcodeStage object under the BarcodeDecodingSection. +description: The ComplementBarcodeStage complements missing parts of a barcode. keywords: ComplementBarcodeStage --- # ComplementBarcodeStage -The `ComplementBarcodeStage` is designed at the stage level to define the configuration settings for the barcode complement process. +`ComplementBarcodeStage` complements missing parts of a barcode. In JSON, it is represented as a Stage object with `"Stage": "SST_COMPLEMENT_BARCODE"`. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeReaderTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_COMPLEMENT_BARCODE") +``` + +**Parent object:** [StageArray]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-barcode-decoding.html#stagearray) within [BarcodeDecodingSection]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-barcode-decoding.html) + +**Example:** ```json { "Stage": "SST_COMPLEMENT_BARCODE", - "BarcodeComplementModes": [] + "BarcodeComplementModes": [ + { + "Mode": "BCM_SKIP" + } + ] } ``` -## Available Parameters +> [!NOTE] +> - This snippet shows a Stage object configured for barcode complement. +> - To use it, add this object to the `StageArray` within a [BarcodeDecodingSection]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-barcode-decoding.html). +> - 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) + +## Parameters ### Stage -The name of the current stage, whose value is a fixed value: `SST_COMPLEMENT_BARCODE`. +Specifies the stage type. Fixed value: `SST_COMPLEMENT_BARCODE`. + +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_COMPLEMENT_BARCODE"` | ### BarcodeComplementModes -Parameter [`BarcodeComplementModes`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/barcode-complement-modes.html) defines how to complement the missing parts of a barcode. +Defines how to complement the missing parts of a barcode. See [`BarcodeComplementModes`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/barcode-complement-modes.html) for details. diff --git a/parameters/reference/barcode-reader-task-settings/stage-decode-barcodes.md b/parameters/reference/barcode-reader-task-settings/stage-decode-barcodes.md index cb4ba30..4ff5527 100644 --- a/parameters/reference/barcode-reader-task-settings/stage-decode-barcodes.md +++ b/parameters/reference/barcode-reader-task-settings/stage-decode-barcodes.md @@ -1,29 +1,62 @@ --- layout: default-layout title: DecodeBarcodesStage - Dynamsoft Barcode Reader Parameters -description: This page defines DecodeBarcodesStage object under the BarcodeDecodingSection. +description: The DecodeBarcodesStage extracts and interprets barcode data from localized barcode regions. keywords: DecodeBarcodesStage --- # DecodeBarcodesStage -The `DecodeBarcodesStage` defines the stage that extracts and interprets barcode data from the localized barcode regions. +`DecodeBarcodesStage` extracts and interprets barcode data from localized barcode regions. In JSON, it is represented as a Stage object with `"Stage": "SST_DECODE_BARCODES"`. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeReaderTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_DECODE_BARCODES") +``` + +**Parent object:** [StageArray]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-barcode-decoding.html#stagearray) within [BarcodeDecodingSection]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-barcode-decoding.html) + +**Example:** ```json { "Stage": "SST_DECODE_BARCODES", - "DeblurModes": [] + "DeblurModes": [ + { + "Mode": "DM_DIRECT_BINARIZATION" + } + ], + "ReturnBarcodeZoneClarity": 0 } ``` -## Available Parameters +> [!NOTE] +> - This snippet shows a Stage object configured for barcode decoding. +> - To use it, add this object to the `StageArray` within a [BarcodeDecodingSection]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-barcode-decoding.html). +> - 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) + +## Parameters ### Stage -The name of the current stage, whose value is a fixed value: `ST_BARCODE_DECODING`. +Specifies the stage type. Fixed value: `SST_DECODE_BARCODES`. + +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_DECODE_BARCODES"` | ### DeblurModes -Parameter [`DeblurModes`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/deblur-modes.html) defines the mode and priority for deblurring. +Defines the mode and priority for deblurring. See [`DeblurModes`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/deblur-modes.html) for details. + +### ReturnBarcodeZoneClarity + +Specifies whether to return the clarity of the barcode zone. See [`ReturnBarcodeZoneClarity`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/return-barcode-zone-clarity.html) for details. diff --git a/parameters/reference/barcode-reader-task-settings/stage-localize-barcodes.md b/parameters/reference/barcode-reader-task-settings/stage-localize-barcodes.md index d37bab4..a9bad6a 100644 --- a/parameters/reference/barcode-reader-task-settings/stage-localize-barcodes.md +++ b/parameters/reference/barcode-reader-task-settings/stage-localize-barcodes.md @@ -1,15 +1,26 @@ --- layout: default-layout title: LocalizeBarcodesStage - Dynamsoft Barcode Reader Parameters -description: This page defines LocalizeBarcodesStage object under the BarcodeLocalizationSection. +description: The LocalizeBarcodesStage accurately determines the positions of barcodes within the identified candidate regions. keywords: LocalizeBarcodesStage --- # LocalizeBarcodesStage -The `LocalizeBarcodesStage` defines the stage that accurately determines the positions of barcodes within the identified candidate regions. +`LocalizeBarcodesStage` accurately determines the positions of barcodes within the identified candidate regions. In JSON, it is represented as a Stage object with `"Stage": "SST_LOCALIZE_BARCODES"`. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeReaderTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_LOCALIZE_BARCODES") +``` + +**Parent object:** [StageArray]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-barcode-localization.html#stagearray) within [BarcodeLocalizationSection]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-barcode-localization.html) + +**Example:** ```json { @@ -17,8 +28,21 @@ The `LocalizeBarcodesStage` defines the stage that accurately determines the pos } ``` -## Available Parameters +> [!NOTE] +> - This snippet shows a Stage object configured for localizing barcodes. +> - To use it, add this object to the `StageArray` within a [BarcodeLocalizationSection]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-barcode-localization.html). +> - 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) + +## Parameters ### Stage -The name of the current stage, whose value is a fixed value: `SST_LOCALIZE_BARCODES`. +Specifies the stage type. Fixed value: `SST_LOCALIZE_BARCODES`. + +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_LOCALIZE_BARCODES"` | diff --git a/parameters/reference/barcode-reader-task-settings/stage-localize-candidate-barcodes.md b/parameters/reference/barcode-reader-task-settings/stage-localize-candidate-barcodes.md index 4f84257..44fbc27 100644 --- a/parameters/reference/barcode-reader-task-settings/stage-localize-candidate-barcodes.md +++ b/parameters/reference/barcode-reader-task-settings/stage-localize-candidate-barcodes.md @@ -1,29 +1,57 @@ --- layout: default-layout title: LocalizeCandidateBarcodesStage - Dynamsoft Barcode Reader Parameters -description: This page defines LocalizeCandidateBarcodesStage object under the BarcodeLocalizationSection. +description: The LocalizeCandidateBarcodesStage detects and marks potential barcode locations within the image for further processing. keywords: LocalizeCandidateBarcodesStage --- # LocalizeCandidateBarcodesStage -The `LocalizeCandidateBarcodesStage` defines the stage that detects and marks potential barcode locations within the image for further processing. +`LocalizeCandidateBarcodesStage` detects and marks potential barcode locations within the image for further processing. In JSON, it is represented as a Stage object with `"Stage": "SST_LOCALIZE_CANDIDATE_BARCODES"`. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeReaderTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_LOCALIZE_CANDIDATE_BARCODES") +``` + +**Parent object:** [StageArray]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-barcode-localization.html#stagearray) within [BarcodeLocalizationSection]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-barcode-localization.html) + +**Example:** ```json { "Stage": "SST_LOCALIZE_CANDIDATE_BARCODES", - "LocalizationModes": [] + "LocalizationModes": [ + { + "Mode": "LM_CONNECTED_BLOCKS" + } + ] } ``` -## Available Parameters +> [!NOTE] +> - This snippet shows a Stage object configured for localizing candidate barcodes. +> - To use it, add this object to the `StageArray` within a [BarcodeLocalizationSection]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-barcode-localization.html). +> - 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) + +## Parameters ### Stage -The name of the current stage, whose value is a fixed value: `SST_LOCALIZE_CANDIDATE_BARCODES`. +Specifies the stage type. Fixed value: `SST_LOCALIZE_CANDIDATE_BARCODES`. + +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_LOCALIZE_CANDIDATE_BARCODES"` | ### LocalizationModes -Parameter [`LocalizationModes`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/localization-modes.html) controls how to localize barcodes. +Controls how to localize barcodes. See [`LocalizationModes`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/localization-modes.html) for details. diff --git a/parameters/reference/barcode-reader-task-settings/stage-predetect-regions.md b/parameters/reference/barcode-reader-task-settings/stage-predetect-regions.md index 4e6ed57..335349e 100644 --- a/parameters/reference/barcode-reader-task-settings/stage-predetect-regions.md +++ b/parameters/reference/barcode-reader-task-settings/stage-predetect-regions.md @@ -1,29 +1,57 @@ --- layout: default-layout title: PredetectRegionsStage - Dynamsoft Barcode Reader Parameters -description: This page defines PredetectRegionsStage object under the Regions Predetection Section. +description: The PredetectRegionsStage identifies potential barcode regions before the main detection process. keywords: PredetectRegionsStage --- # PredetectRegionsStage -The `PredetectRegionsStage` defines the stage that identifies potential barcode regions before the main detection process. +`PredetectRegionsStage` identifies potential barcode regions before the main detection process. In JSON, it is represented as a Stage object with `"Stage": "SST_PREDETECT_REGIONS"`. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeReaderTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_PREDETECT_REGIONS") +``` + +**Parent object:** [StageArray]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-region-predetection.html#stagearray) within [RegionPredetectionSection]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-region-predetection.html) + +**Example:** ```json { "Stage": "SST_PREDETECT_REGIONS", - "RegionPredetectionModes": [] + "RegionPredetectionModes": [ + { + "Mode": "RPM_GENERAL" + } + ] } ``` -## Available Parameters +> [!NOTE] +> - This snippet shows a Stage object configured for region predetection. +> - To use it, add this object to the `StageArray` within a [RegionPredetectionSection]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-region-predetection.html). +> - 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) + +## Parameters ### Stage -The name of the current stage, whose value is a fixed value: `ST_BARCODE_DECODING`. +Specifies the stage type. Fixed value: `SST_PREDETECT_REGIONS`. + +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_PREDETECT_REGIONS"` | ### RegionPredetectionModes -Parameter [`RegionPredetectionModes`]({{ site.dcvb_parameters_reference }}image-parameter/region-predetection-modes.html) controls how to find a region of interest (ROI) within the image or frame. +Controls how to find a region of interest (ROI) within the image or frame. See [`RegionPredetectionModes`]({{ site.dcvb_parameters_reference }}image-parameter/region-predetection-modes.html) for details. diff --git a/parameters/reference/barcode-reader-task-settings/stage-resist-deformation.md b/parameters/reference/barcode-reader-task-settings/stage-resist-deformation.md index 910198d..2842b37 100644 --- a/parameters/reference/barcode-reader-task-settings/stage-resist-deformation.md +++ b/parameters/reference/barcode-reader-task-settings/stage-resist-deformation.md @@ -1,29 +1,57 @@ --- layout: default-layout title: ResistDeformationStage - Dynamsoft Barcode Reader Parameters -description: This page defines ResistDeformationStage object under the BarcodeDecodingSection. +description: The ResistDeformationStage applies preprocessing to reduce image deformation. keywords: ResistDeformationStage --- # ResistDeformationStage -The `ResistDeformationStage` defines the stage that applies preprocessing techniques to reduce image deformation and improve barcode recognition accuracy. +`ResistDeformationStage` applies preprocessing techniques to reduce image deformation and improve barcode recognition accuracy. In JSON, it is represented as a Stage object with `"Stage": "SST_RESIST_DEFORMATION"`. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeReaderTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_RESIST_DEFORMATION") +``` + +**Parent object:** [StageArray]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-barcode-decoding.html#stagearray) within [BarcodeDecodingSection]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-barcode-decoding.html) + +**Example:** ```json { "Stage": "SST_RESIST_DEFORMATION", - "DeformationResistingModes": [] + "DeformationResistingModes": [ + { + "Mode": "DRM_SKIP" + } + ] } ``` -## Available Parameters +> [!NOTE] +> - This snippet shows a Stage object configured for deformation resistance. +> - To use it, add this object to the `StageArray` within a [BarcodeDecodingSection]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-barcode-decoding.html). +> - 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) + +## Parameters ### Stage -The name of the current stage, whose value is a fixed value: `SST_RESIST_DEFORMATION`. +Specifies the stage type. Fixed value: `SST_RESIST_DEFORMATION`. + +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_RESIST_DEFORMATION"` | ### DeformationResistingModes -Parameter [`DeformationResistingModes`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/deformation-resisting-modes.html) defines how to handle distorted and deformed barcodes. +Defines how to handle distorted and deformed barcodes. See [`DeformationResistingModes`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/deformation-resisting-modes.html) for details. diff --git a/parameters/reference/barcode-reader-task-settings/stage-scale-barcode-image.md b/parameters/reference/barcode-reader-task-settings/stage-scale-barcode-image.md index 83b1aa4..156a535 100644 --- a/parameters/reference/barcode-reader-task-settings/stage-scale-barcode-image.md +++ b/parameters/reference/barcode-reader-task-settings/stage-scale-barcode-image.md @@ -1,29 +1,57 @@ --- layout: default-layout title: ScaleBarcodeImageStage - Dynamsoft Barcode Reader Parameters -description: This page defines ScaleBarcodeImageStage object under the BarcodeDecodingSection. +description: The ScaleBarcodeImageStage scales barcode images to optimize recognition. keywords: ScaleBarcodeImageStage --- # ScaleBarcodeImageStage -The `ScaleBarcodeImageStage` defines the stage where the barcode image is scaled according to the specified scaling mode to optimize recognition. +`ScaleBarcodeImageStage` scales barcode images according to the specified scaling mode to optimize recognition. In JSON, it is represented as a Stage object with `"Stage": "SST_SCALE_BARCODE_IMAGE"`. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeReaderTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_SCALE_BARCODE_IMAGE") +``` + +**Parent object:** [StageArray]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-barcode-decoding.html#stagearray) within [BarcodeDecodingSection]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-barcode-decoding.html) + +**Example:** ```json { "Stage": "SST_SCALE_BARCODE_IMAGE", - "BarcodeScaleModes": [] + "BarcodeScaleModes": [ + { + "Mode": "BSM_AUTO" + } + ] } ``` -## Available Parameters +> [!NOTE] +> - This snippet shows a Stage object configured for barcode image scaling. +> - To use it, add this object to the `StageArray` within a [BarcodeDecodingSection]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-barcode-decoding.html). +> - 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) + +## Parameters ### Stage -The name of the current stage, whose value is a fixed value: `SST_SCALE_BARCODE_IMAGE`. +Specifies the stage type. Fixed value: `SST_SCALE_BARCODE_IMAGE`. + +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_SCALE_BARCODE_IMAGE"` | ### BarcodeScaleModes -Parameter [`BarcodeScaleModes`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/barcode-scale-modes.html) defines the scaling mode applied during barcode recognition. +Defines the scaling mode applied during barcode recognition. See [`BarcodeScaleModes`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/barcode-scale-modes.html) for details. diff --git a/parameters/reference/barcode-reader-task-settings/start-section.md b/parameters/reference/barcode-reader-task-settings/start-section.md deleted file mode 100644 index 65fde8a..0000000 --- a/parameters/reference/barcode-reader-task-settings/start-section.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -layout: default-layout -title: StartSection - Dynamsoft Barcode Reader Parameters -description: The parameter StartSection defines the start section of the barcode reader algorithm task. -keywords: Start section -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true -permalink: /parameters/reference/barcode-reader-task-settings/start-section.html ---- - -# StartSection - -Parameter `StartSection` defines the start section of the `BarcodeReaderTask`. - -## Example - -```json -{ - "StartSection": "ST_REGION_PREDETECTION" -} -``` - -## Parameter Summary - -| StartSection Parameter Summary | -| :---------------------------- | -| **Type**
    *String* | -| **Range**
    ST_REGION_PREDETECTION
    ST_BARCODE_LOCALIZATION | -| **Default Value**
    ST_REGION_PREDETECTION | diff --git a/parameters/reference/barcode-reader-task-settings/terminate-setting.md b/parameters/reference/barcode-reader-task-settings/terminate-setting.md deleted file mode 100644 index f7c3856..0000000 --- a/parameters/reference/barcode-reader-task-settings/terminate-setting.md +++ /dev/null @@ -1,70 +0,0 @@ ---- -layout: default-layout -title: TerminateSetting - Dynamsoft Barcode Reader Parameters -description: The parameter TerminateSetting defines the terminate stage of the barcode reader task. -keywords: Terminate setting -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true -permalink: /parameters/reference/barcode-reader-task-settings/terminate-setting.html ---- - -# TerminateSetting - -Parameter `TerminateSetting` defines the stage where the algorithm task stops. - -## Example - -```json -"TerminateSetting": -{ - "Section": "ST_REGION_PREDETECTION", - "Stage": "IRUT_GRAYSCALE_IMAGE" -} -``` - -## Parameter Summary - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    Child Parameter NameChild Parameter Summary
    Section
    Description
    Specifies the section type where the algorithm task stops.
    Type
    String
    Range
    One of the following SectionType as a string. -
    ST_REGION_PREDETECTION -
    ST_BARCODE_LOCALIZATION -
    ST_BARCODE_DECODING -
    Stage
    Description
    Specifies the stage type where the algorithm task stops.
    Type
    String
    Range
    One of the IntermediateResultUnitType as a string. The available stage types are different for each section. View the appendix for more details. -
    - -## Appendix - Available Stage for Sections - -| Section | Available Stages | -| :------------------ | :--------------- | -| ST_REGION_PREDETECTION | IRUT_COLOUR_IMAGE
    IRUT_SCALED_DOWN_COLOUR_IMAGE
    IRUT_GRAYSCALE_IMAGE
    IRUT_TRANSFORMED_GRAYSCALE_IMAGE
    IRUT_PREDETECTED_REGIONS | -| ST_BARCODE_LOCALIZATION | IRUT_COLOUR_IMAGE
    IRUT_SCALED_DOWN_COLOUR_IMAGE
    IRUT_GRAYSCALE_IMAGE
    IRUT_TRANSFORMED_GRAYSCALE_IMAGE
    IRUT_ENHANCED_GRAYSCALE_IMAGE
    IRUT_BINARY_IMAGE
    IRUT_TEXTURE_DETECTION_RESULT
    IRUT_TEXTURE_REMOVED_GRAYSCALE_IMAGE
    IRUT_TEXTURE_REMOVED_BINARY_IMAGE
    IRUT_TEXT_ZONES
    IRUT_TEXT_REMOVED_BINARY_IMAGE
    IRUT_CONTOURS
    IRUT_LINE_SEGMENTS
    IRUT_CANDIDATE_BARCODE_ZONES
    IRUT_LOCALIZED_BARCODES | -| ST_BARCODE_DECODING | IRUT_COLOUR_IMAGE
    IRUT_GRAYSCALE_IMAGE
    IRUT_TRANSFORMED_GRAYSCALE_IMAGE
    IRUT_DEFORMATION_RESISTED_BARCODE_IMAGE
    IRUT_COMPLEMENTED_BARCODE_IMAGE
    IRUT_SCALED_UP_BARCODE_IMAGE
    IRUT_DECODED_BARCODES | diff --git a/parameters/reference/barcode-reader-task-settings/text-result-order-modes.md b/parameters/reference/barcode-reader-task-settings/text-result-order-modes.md index 88b1126..db71d2b 100644 --- a/parameters/reference/barcode-reader-task-settings/text-result-order-modes.md +++ b/parameters/reference/barcode-reader-task-settings/text-result-order-modes.md @@ -6,35 +6,54 @@ keywords: Text result order modes needGenerateH3Content: true needAutoGenerateSidebar: true noTitleIndex: true -permalink: /parameters/reference/barcode-reader-task-settings/text-result-order-modes.html --- # TextResultOrderModes -Parameter `TextResultOrderModes` defines the order of the returned text results. +Parameter `TextResultOrderModes` defines the order of the returned text results. It consists of one or more modes, each mode representing a different ordering criterion. -## Example +## JSON Structure + +**Location in template:** +``` +BarcodeReaderTaskSettingOptions[i] + └── TextResultOrderModes +``` + +**Parent object:** [BarcodeReaderTaskSetting]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/index.html) object + +**Example:** ```json { - "TextResultOrderModes" : - [ + "TextResultOrderModes": [ { - "Mode" : "TROM_CONFIDENCE" + "Mode": "TROM_CONFIDENCE" }, { - "Mode" : "TROM_POSITION" + "Mode": "TROM_POSITION" }, { - "Mode" : "TROM_FORMAT" + "Mode": "TROM_FORMAT" } ] } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `TextResultOrderModes` parameter. +> - To use it, embed this parameter within a [BarcodeReaderTaskSetting]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/index.html) object at the task-level. +> - 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 `TextResultOrderModes` consist of a group of text result order mode objects. Each text result order mode object includes a candidate mode and a series of auxiliary mode arguments. The structure of the text result order mode object is shown as follow: +Parameter `TextResultOrderModes` consists of a group of text result order mode objects. Each text result order mode object includes a candidate mode and a series of auxiliary mode arguments. + +### Mode Arguments + +The mode arguments of the text result order mode object are as follows: ### Mode Arguments @@ -46,7 +65,7 @@ Parameter `TextResultOrderModes` consist of a group of text result order mode ob - Mode
    (Required) + Mode
    (Required) Description
    Specifies a mode for ordering. @@ -61,10 +80,6 @@ Parameter `TextResultOrderModes` consist of a group of text result order mode ob
    TROM_SKIP - - Default Value
    - - ### Default Setting @@ -73,22 +88,21 @@ If the `TextResultOrderModes` is not configured in your template file, the follo ```json { - "TextResultOrderModes" : - [ + "TextResultOrderModes": [ { - "Mode" : "TROM_CONFIDENCE" + "Mode": "TROM_CONFIDENCE" }, { - "Mode" : "TROM_POSITION" + "Mode": "TROM_POSITION" }, { - "Mode" : "TROM_FORMAT" + "Mode": "TROM_FORMAT" } ] } ``` -## Candidate Modes Introduction +## Candidate Mode Introductions ### TROM_CONFIDENCE diff --git a/parameters/reference/capture-vision-template/image-roi-processing-name-array.md b/parameters/reference/capture-vision-template/image-roi-processing-name-array.md index 08c5d4f..ba56c40 100644 --- a/parameters/reference/capture-vision-template/image-roi-processing-name-array.md +++ b/parameters/reference/capture-vision-template/image-roi-processing-name-array.md @@ -3,17 +3,23 @@ layout: default-layout title: ImageROIProcessingNameArray - Dynamsoft Capture Vision Parameters description: The parameter ImageROIProcessingNameArray of Dynamsoft Capture Vision defines the collection of image ROI processing object names. keywords: image ROI processing, TargetROIDef, CaptureVisionTemplate -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true permalink: /parameters/reference/capture-vision-template/image-roi-processing-name-array.html --- - # ImageROIProcessingNameArray Parameter `ImageROIProcessingNameArray` defines the collection of image ROI processing object names, used to refer to the `TargetROIDef` objects -## Example +## JSON Structure + +**Location in template:** +``` +CaptureVisionTemplates[i] + └── ImageROIProcessingNameArray +``` + +**Parent object:** [CaptureVisionTemplate]({{ site.dcvb_parameters }}file/capture-vision-template.html) object + +**Example:** ```json { @@ -21,11 +27,18 @@ Parameter `ImageROIProcessingNameArray` defines the collection of image ROI proc } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `ImageROIProcessingNameArray` parameter. +> - To use it, embed this parameter within a [CaptureVisionTemplate]({{ site.dcvb_parameters }}file/capture-vision-template.html) 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 -| ImageROIProcessingNameArray Parameter Summary | +| ImageROIProcessingNameArray Parameter Details | | :----------------------------------- | | **Type**
    *String[]* | | **Range**
    Each element is the name of a `TargetROIDef` object. | | **Default Value**
    ['roi_default'] | -| **Remarks**
    If `ImageROIProcessingNameArray` is not specified, a default array ["roi_default"] will be created. The TargetROIDef object with the name "roi_default" will have a default configuration of tasks including one barcode reading task, one label recognition task, and one document normalizer task.| +| **Remarks**
    If `ImageROIProcessingNameArray` is not specified, a default array ["roi_default"] will be created. The `TargetROIDef` object with the name "roi_default" will have a default configuration of tasks including one barcode reading task, one label recognition task, and one document normalizer task.| diff --git a/parameters/reference/capture-vision-template/image-source-name.md b/parameters/reference/capture-vision-template/image-source-name.md index 8b3aac7..5d57093 100644 --- a/parameters/reference/capture-vision-template/image-source-name.md +++ b/parameters/reference/capture-vision-template/image-source-name.md @@ -3,17 +3,23 @@ layout: default-layout title: ImageSourceName - Dynamsoft Capture Vision Parameters description: The parameter ImageSourceName of Dynamsoft Capture Vision defines the name of the ImageSource object. keywords: image source, CaptureVisionTemplate -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true permalink: /parameters/reference/capture-vision-template/image-source-name.html --- - # ImageSourceName Parameter `ImageSourceName` indicates the input source name, used to refer to the `ImageSource` object. It is used to define the input image source of DCV. -## Example +## JSON Structure + +**Location in template:** +``` +CaptureVisionTemplates[i] + └── ImageSourceName +``` + +**Parent object:** [CaptureVisionTemplate]({{ site.dcvb_parameters }}file/capture-vision-template.html) object + +**Example:** ```json { @@ -21,9 +27,16 @@ Parameter `ImageSourceName` indicates the input source name, used to refer to th } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `ImageSourceName` parameter. +> - To use it, embed this parameter within a [CaptureVisionTemplate]({{ site.dcvb_parameters }}file/capture-vision-template.html) 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 -| ImageSourceName Parameter Summary | +| ImageSourceName Parameter Details | | :----------------------------------- | | **Type**
    *String* | | **Range**
    The name of the `ImageSource` object. | diff --git a/parameters/reference/capture-vision-template/index.md b/parameters/reference/capture-vision-template/index.md deleted file mode 100644 index f2b156c..0000000 --- a/parameters/reference/capture-vision-template/index.md +++ /dev/null @@ -1,22 +0,0 @@ ---- -layout: default-layout -title: Index - CaptureVisionTemplate Parameters -description: The index of CaptureVisionTemplate parameters. -keywords: CaptureVisionTemplate, parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true ---- - -# CaptureVisionTemplate Parameters - -| Parameter Name | Description | -| -------------- | ----------- | -| [`ImageSourceName`](image-source-name.md) | Indicates the input source name, used to refer to the `ImageSource` object. | -| [`ImageROIProcessingNameArray`](image-roi-processing-name-array.md) | Defines the collection of image ROI processing object names, used to refer to the `TargetROIDef` objects. | -| [`MaxParallelTasks`](max-parallel-tasks.md) | Defines the maximum number of parallel tasks for the DCV runtime. | -| [`MinImageCaptureInterval`]({{ site.dcvb_parameters_reference }}capture-vision-template/min-image-capture-interval.html) | Specifies the minimum time interval (in milliseconds) allowed between consecutive image captures. | -| [`Name`](name.md) | Defines the name of a `CaptureVisionTemplate` object, which serves as its unique identifier. | -| [`OutputOriginalImage`](output-original-Image.md) | 0, don't output the original image. 1, output the original image. | -| [`SemanticProcessingNameArray`](semantic-processing-name-array.md) | Represents the collection of semantic-processing object names, used to refer to the `SematicProcessing` objects. | -| [`Timeout`](timeout.md) | Defines the maximum amount of time (in milliseconds) that should be spent processing each image or frame. | diff --git a/parameters/reference/capture-vision-template/max-parallel-tasks.md b/parameters/reference/capture-vision-template/max-parallel-tasks.md index adeadf0..1273e77 100644 --- a/parameters/reference/capture-vision-template/max-parallel-tasks.md +++ b/parameters/reference/capture-vision-template/max-parallel-tasks.md @@ -3,17 +3,23 @@ layout: default-layout title: MaxParallelTasks - Dynamsoft Capture Vision Parameters description: The parameter MaxParallelTasks defines the maximum number of parallel tasks for the DCV runtime. keywords: Max parallel tasks, CaptureVisionTemplate -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true permalink: /parameters/reference/capture-vision-template/max-parallel-tasks.html --- - # MaxParallelTasks Parameter `MaxParallelTasks` defines the maximum number of parallel tasks for the DCV runtime. -## Example +## JSON Structure + +**Location in template:** +``` +CaptureVisionTemplates[i] + └── MaxParallelTasks +``` + +**Parent object:** [CaptureVisionTemplate]({{ site.dcvb_parameters }}file/capture-vision-template.html) object + +**Example:** ```json { @@ -21,9 +27,16 @@ Parameter `MaxParallelTasks` defines the maximum number of parallel tasks for th } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `MaxParallelTasks` parameter. +> - To use it, embed this parameter within a [CaptureVisionTemplate]({{ site.dcvb_parameters }}file/capture-vision-template.html) 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 -| MaxParallelTasks Parameter Summary | +| MaxParallelTasks Parameter Details | | :------------- | | **Type**
    *int* | | **Range**
    -1, 0, [1, 256] | diff --git a/parameters/reference/capture-vision-template/min-image-capture-interval.md b/parameters/reference/capture-vision-template/min-image-capture-interval.md index 814762c..731b988 100644 --- a/parameters/reference/capture-vision-template/min-image-capture-interval.md +++ b/parameters/reference/capture-vision-template/min-image-capture-interval.md @@ -3,16 +3,23 @@ layout: default-layout title: MinImageCaptureInterval - Dynamsoft Capture Vision Parameters description: The parameter MinImageCaptureInterval defines the minimum time interval (in milliseconds) allowed between consecutive image captures. keywords: MinImageCaptureInterval, CaptureVisionTemplate -needGenerateH3Content: true -needAutoGenerateSidebar: true noTitleIndex: true --- - # MinImageCaptureInterval Parameter `MinImageCaptureInterval` defines the minimum time interval (in milliseconds) allowed between consecutive image captures. -## Example +## JSON Structure + +**Location in template:** +``` +CaptureVisionTemplates[i] + └── MinImageCaptureInterval +``` + +**Parent object:** [CaptureVisionTemplate]({{ site.dcvb_parameters }}file/capture-vision-template.html) object + +**Example:** ```json { @@ -20,12 +27,18 @@ Parameter `MinImageCaptureInterval` defines the minimum time interval (in millis } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `MinImageCaptureInterval` parameter. +> - To use it, embed this parameter within a [CaptureVisionTemplate]({{ site.dcvb_parameters }}file/capture-vision-template.html) 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 -| MinImageCaptureInterval Parameter Summary | +| MinImageCaptureInterval Parameter Details | | :------------- | | **Type**
    *int* | | **Range**
    [0, 0x7fffffff] | | **Default Value**
    0 | -| **Remarks**
    This property represents the minimum time interval (in milliseconds) that must elapse before the next image capture operation can be initiated. -Setting a larger value for this property will introduce a delay between image captures, while setting a smaller value allows for more frequent captures. It can be used to reduce the computational frequency, which can effectively lower energy consumption. Please note that the actual time interval between captures may be longer than the specified minimum interval due to various factors, such as image processing time and hardware limitations.| +| **Remarks**
    This property represents the minimum time interval (in milliseconds) that must elapse before the next image capture operation can be initiated.
    Setting a larger value for this property will introduce a delay between image captures, while setting a smaller value allows for more frequent captures. It can be used to reduce the computational frequency, which can effectively lower energy consumption. Please note that the actual time interval between captures may be longer than the specified minimum interval due to various factors, such as image processing time and hardware limitations.| diff --git a/parameters/reference/capture-vision-template/name.md b/parameters/reference/capture-vision-template/name.md index e6b6edb..f160154 100644 --- a/parameters/reference/capture-vision-template/name.md +++ b/parameters/reference/capture-vision-template/name.md @@ -3,17 +3,23 @@ layout: default-layout title: Name - Dynamsoft Capture Vision Parameter Reference CaptureVisionTemplate Object. description: The parameter Name defines the unique identifier of CaptureVisionTemplate object. keywords: top-level object, name, unique identifier -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true permalink: /parameters/reference/capture-vision-template/name.html --- - # Name Parameter `Name` represents the name of a `CaptureVisionTemplate` object, which serves as its unique identifier. -## Example +## JSON Structure + +**Location in template:** +``` +CaptureVisionTemplates[i] + └── Name +``` + +**Parent object:** [CaptureVisionTemplate]({{ site.dcvb_parameters }}file/capture-vision-template.html) object + +**Example:** ```json { @@ -21,7 +27,14 @@ Parameter `Name` represents the name of a `CaptureVisionTemplate` object, which } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `Name` parameter. +> - To use it, embed this parameter within a [CaptureVisionTemplate]({{ site.dcvb_parameters }}file/capture-vision-template.html) 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 Details | | :----------------------------------- | diff --git a/parameters/reference/capture-vision-template/output-original-Image.md b/parameters/reference/capture-vision-template/output-original-Image.md index 7552ac1..b35e5de 100644 --- a/parameters/reference/capture-vision-template/output-original-Image.md +++ b/parameters/reference/capture-vision-template/output-original-Image.md @@ -3,17 +3,23 @@ layout: default-layout title: OutputOriginalImage - Dynamsoft Capture Vision Parameters description: The parameter OutputOriginalImage indicates whether DCV finally outputs the original input image. keywords: original image, captured results, CaptureVisionTemplate -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true permalink: /parameters/reference/capture-vision-template/output-original-image.html --- - # OutputOriginalImage Parameter `OutputOriginalImage` indicates whether DCV finally outputs the original input image. -## Example +## JSON Structure + +**Location in template:** +``` +CaptureVisionTemplates[i] + └── OutputOriginalImage +``` + +**Parent object:** [CaptureVisionTemplate]({{ site.dcvb_parameters }}file/capture-vision-template.html) object + +**Example:** ```json { @@ -21,9 +27,16 @@ Parameter `OutputOriginalImage` indicates whether DCV finally outputs the origin } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `OutputOriginalImage` parameter. +> - To use it, embed this parameter within a [CaptureVisionTemplate]({{ site.dcvb_parameters }}file/capture-vision-template.html) 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 -| OutputOriginalImage Parameter Summary | +| OutputOriginalImage Parameter Details | | :------------- | | **Type**
    *int* | | **Range**
    0,1 | diff --git a/parameters/reference/capture-vision-template/output-raw-Image.md b/parameters/reference/capture-vision-template/output-raw-Image.md deleted file mode 100644 index 60ad6d0..0000000 --- a/parameters/reference/capture-vision-template/output-raw-Image.md +++ /dev/null @@ -1,31 +0,0 @@ ---- -layout: default-layout -title: OutputRawImage - Dynamsoft Capture Vision Parameters -description: The parameter OutputRawImage indicates whether DCV finally outputs the original input image. -keywords: raw image, captured results, CaptureVisionTemplate -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/capture-vision-template/output-raw-image.html ---- - -# OutputRawImage - -Parameter `OutputRawImage` indicates whether DCV finally outputs the original input image. - -## Example - -```json -{ - "OutputRawImage":0 -} -``` - -## Parameter Summary - -| OutputRawImage Parameter Summary | -| :------------- | -| **Type**
    *int* | -| **Range**
    0,1 | -| **Default Value**
    0 | -| **Remarks**
    0: The raw image is not included in the final captured results.
    1: The raw image is included in the final captured results.| diff --git a/parameters/reference/capture-vision-template/semantic-processing-name-array.md b/parameters/reference/capture-vision-template/semantic-processing-name-array.md index 0cf187a..32b84c7 100644 --- a/parameters/reference/capture-vision-template/semantic-processing-name-array.md +++ b/parameters/reference/capture-vision-template/semantic-processing-name-array.md @@ -3,17 +3,23 @@ layout: default-layout title: SemanticProcessingNameArray - Dynamsoft Capture Vision Parameters description: The parameter SemanticProcessingNameArray of Dynamsoft Capture Vision defines the collection of semantic-processing object names. keywords: sematic processing, CaptureVisionTemplate -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true permalink: /parameters/reference/capture-vision-template/semantic-processing-name-array.html --- - # SemanticProcessingNameArray Parameter `SemanticProcessingNameArray` represents the collection of semantic-processing object names, used to refer to the `SematicProcessing` objects. It is used to define post-processing code parsing tasks performed on input text/bytes. -## Example +## JSON Structure + +**Location in template:** +``` +CaptureVisionTemplates[i] + └── SemanticProcessingNameArray +``` + +**Parent object:** [CaptureVisionTemplate]({{ site.dcvb_parameters }}file/capture-vision-template.html) object + +**Example:** ```json { @@ -21,9 +27,16 @@ Parameter `SemanticProcessingNameArray` represents the collection of semantic-pr } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `SemanticProcessingNameArray` parameter. +> - To use it, embed this parameter within a [CaptureVisionTemplate]({{ site.dcvb_parameters }}file/capture-vision-template.html) 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 -| SemanticProcessingNameArray Parameter Summary | +| SemanticProcessingNameArray Parameter Details | | :----------------------------------- | | **Type**
    *String[]* | | **Range**
    Each element is the name of a `SematicProcessing` object. | diff --git a/parameters/reference/capture-vision-template/timeout.md b/parameters/reference/capture-vision-template/timeout.md index fb0fc14..39dd3c2 100644 --- a/parameters/reference/capture-vision-template/timeout.md +++ b/parameters/reference/capture-vision-template/timeout.md @@ -3,12 +3,8 @@ layout: default-layout title: Timeout - Dynamsoft Capture Vision Parameters description: The parameter Timeout defines the maximum amount of time (in milliseconds) that the recognition tasks should take per page. keywords: timeout, CaptureVisionTemplate -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true permalink: /parameters/reference/capture-vision-template/timeout.html --- - # Timeout Parameter `Timeout` defines the maximum amount of time (in milliseconds) that should be spent processing each image or frame. It does not include the time taken to load/decode an image from disk into memory. @@ -20,7 +16,17 @@ The timer starts when the library start processing the first task of the image. * If there exist results of the unfinished tasks, the existing results are output. You will receive an `EC_TIMEOUT` error code in your `CapturedResult` as well. * If none of the tasks has result, you still receive a CapturedResult with an empty array of `CapturedResultItem` and the error code `EC_TIMEOUT`. -## Example +## JSON Structure + +**Location in template:** +``` +CaptureVisionTemplates[i] + └── Timeout +``` + +**Parent object:** [CaptureVisionTemplate]({{ site.dcvb_parameters }}file/capture-vision-template.html) object + +**Example:** ```json { @@ -28,9 +34,16 @@ The timer starts when the library start processing the first task of the image. } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `Timeout` parameter. +> - To use it, embed this parameter within a [CaptureVisionTemplate]({{ site.dcvb_parameters }}file/capture-vision-template.html) 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 -| Timeout Parameter Summary | +| Timeout Parameter Details | | :------------- | | **Type**
    *int* | | **Range**
    [0, 0x7fffffff] | diff --git a/parameters/reference/character-model/char-set.md b/parameters/reference/character-model/char-set.md deleted file mode 100644 index 0cccbc9..0000000 --- a/parameters/reference/character-model/char-set.md +++ /dev/null @@ -1,79 +0,0 @@ ---- -layout: default-layout -title: CharSet - CharacterModel - Dynamsoft Capture Vision Parameters -description: The parameter CharSet defines a path of character models. -keywords: Directory path -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true ---- - -# CharSet - -Parameter `CharSet` is an object that defines specific configurations for character recognition. It allows for the inclusion of special characters and the exclusion of certain characters, providing more control over which characters are recognized or ignored during processing. - -## Example - -```json -{ - "CharSet": { - "AddSpecialChars": ["-", ":"], - "ExcludeChars": ["O", "Q"] - } -} -``` - -## Parameter Summary - -### Arguments - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    Argument NameArgument Summary
    AddSpecialChars
    (Required)
    Description
    It is an array that specifies additional special characters to be recognized. -
    Type
    string array -
    Range
    hyphen (-) -
    underscore (_) -
    colon (:) -
    space ( ) -
    period (.) -
    Default Value
    null: It means no extra special characters are recognized unless explicitly added. -
    ExcludeChars
    (Optional)
    Description
    It is an array that specifies characters to be excluded from recognition. -
    Type
    string array -
    Range
    It is dependent on the CharRecognition model:
    - Number: [0-9]
    - Letter: [a-zA-Z]
    - UpperCase: [A-Z]
    - LowerCase: [a-z]
    -
    Default Value
    null: It means no characters are excluded unless explicitly specified. -
    diff --git a/parameters/reference/character-model/directory-path.md b/parameters/reference/character-model/directory-path.md deleted file mode 100644 index b21ca80..0000000 --- a/parameters/reference/character-model/directory-path.md +++ /dev/null @@ -1,27 +0,0 @@ ---- -layout: default-layout -title: DirectoryPath - CharacterModel - Dynamsoft Capture Vision Parameters -description: The parameter DirectoryPath defines a path of character models. -keywords: Directory path -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true ---- - -# DirectoryPath - -Parameter `DirectoryPath` defines the path of character models. - -## Example - -```json -{ - "DirectoryPath" : "D:\\CharacterModel\\" -} -``` - -## Parameter Summary - -| DirectoryPath Parameter Summary | -| :------------- | -| **Type**
    *String* | diff --git a/parameters/reference/character-model/filter-file-path.md b/parameters/reference/character-model/filter-file-path.md deleted file mode 100644 index dba16af..0000000 --- a/parameters/reference/character-model/filter-file-path.md +++ /dev/null @@ -1,38 +0,0 @@ ---- -layout: default-layout -title: FilterFilePath - Dynamsoft Label Recognizer Parameters -description: The parameter FilterFilePath defines a path when the library recognize characters. -keywords: Directory path -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/character-model/filter-file-path.html ---- - -# FilterFilePath - -Parameter `FilterFilePath` defines the full path of the filter file which specifies the characters to be recognized. - -## Example - -```json -{ - "FilterFilePath" : "D:\\CharacterModel\\" -} -``` - -## Parameter Summary - -| FilterFilePath Parameter Summary | -| :------------- | -| **Type**
    *string* | - -### Default Settings - -If the `FilterFilePath` is not configured in your template file, the following settings will be used as the default settings. - -```json -{ - "FilterFilePath" : "" -} -``` diff --git a/parameters/reference/character-model/index.md b/parameters/reference/character-model/index.md deleted file mode 100644 index 0f49073..0000000 --- a/parameters/reference/character-model/index.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -layout: default-layout -title: Index - CharacterModel Parameters -description: The index of CharacterModel parameters. -keywords: CharacterModel, parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/character-model/index.html ---- - -# CharacterModel Parameters - -| Parameter Name | Description | -| -------------------- | ----------- | -| [`DirectoryPath`](directory-path.md) | Defines the path of character models. | -| [`FilterFilePath`](filter-file-path.md) | Defines the full path of the filter file which specifies the characters to be recognized. | -| [`Name`](name.md) | Defines the name of a `CharacterModel` object, which serves as its unique identifier. | diff --git a/parameters/reference/character-model/name.md b/parameters/reference/character-model/name.md deleted file mode 100644 index 37c0df0..0000000 --- a/parameters/reference/character-model/name.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -layout: default-layout -title: Name - Dynamsoft Capture Vision Parameter Reference CharacterModel Object. -description: The parameter Name defines the unique identifier of CharacterModel object. -keywords: top-level object, name, unique identifier -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true -permalink: /parameters/reference/character-model/name.html ---- - -# Name - -Parameter `Name` represents the name of a `CharacterModel` object, which serves as its unique identifier. - -## Example - -```json -{ - "Name" : "cm_0" -} -``` - -## Parameter Summary - -| Parameter Details | -| :----------------------------------- | -| **Type**
    *String* | -| **Default Value**
    It must be a mandatory setting value. | -| **Remarks**
    It must be a unique name. | diff --git a/parameters/reference/code-parser-task-settings/code-specifications.md b/parameters/reference/code-parser-task-settings/code-specifications.md index 61def5d..25ff4c7 100644 --- a/parameters/reference/code-parser-task-settings/code-specifications.md +++ b/parameters/reference/code-parser-task-settings/code-specifications.md @@ -2,16 +2,23 @@ layout: default-layout title: CodeSpecifications - Dynamsoft Capture Vision Parameter Reference description: The parameter CodeSpecifications of Dynamsoft Capture Vision. -needAutoGenerateSidebar: true -needGenerateH3Content: false noTitleIndex: true --- - # CodeSpecifications Parameter `CodeSpecifications` specifies the names of `CodeSpecification` used for code parsing. -## Example +## JSON Structure + +**Location in template:** +``` +CodeParserTaskSettingOptions[i] + └── CodeSpecifications +``` + +**Parent object:** [CodeParserTaskSetting]({{ site.dcvb_parameters }}file/task-settings/code-parser-task-settings.html) object + +**Example:** ```json { @@ -19,9 +26,16 @@ Parameter `CodeSpecifications` specifies the names of `CodeSpecification` used f } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `CodeSpecifications` parameter. +> - To use it, embed this parameter within a [CodeParserTaskSetting]({{ site.dcvb_parameters }}file/task-settings/code-parser-task-settings.html) 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 -| Brightness Parameter Summary | +| Brightness Parameter Details | | :------------- | | **Type**
    *string array* | | **Range**
    Any valid string | diff --git a/parameters/reference/code-parser-task-settings/index.md b/parameters/reference/code-parser-task-settings/index.md deleted file mode 100644 index e00de4d..0000000 --- a/parameters/reference/code-parser-task-settings/index.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -layout: default-layout -title: Index - CodeParserTaskSetting Parameters -description: The index of CodeParserTaskSetting parameters. -keywords: CodeParserTaskSetting, parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/code-parser-task-settings/index.html ---- - -# CodeParserTaskSetting Parameters - -| Parameter Name | Description | -| ------------------------ | ----------- | -| [`CodeSpecifications`](code-specifications.md) | Defines the names of CodeSpecification used for code parsing. | -| [`Name`](name.md) | Defines the name of a `CodeParserTaskSetting` object, which serves as its unique identifier. | -| [`ResourcesPath`](resources-path.md) | Defines the directory path that contains the resources needed for code parsing. | diff --git a/parameters/reference/code-parser-task-settings/name.md b/parameters/reference/code-parser-task-settings/name.md index ea45b83..310bf07 100644 --- a/parameters/reference/code-parser-task-settings/name.md +++ b/parameters/reference/code-parser-task-settings/name.md @@ -3,17 +3,23 @@ layout: default-layout title: Name - Dynamsoft Capture Vision Parameter Reference CodeParserTaskSetting Object. description: The parameter Name defines the unique identifier of CodeParserTaskSetting object. keywords: top-level object, name, unique identifier -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true permalink: /parameters/reference/code-parser-task-settings/name.html --- - # Name Parameter `Name` represents the name of a `CodeParserTaskSetting` object, which serves as its unique identifier. -## Example +## JSON Structure + +**Location in template:** +``` +CodeParserTaskSettingOptions[i] + └── Name +``` + +**Parent object:** [CodeParserTaskSetting]({{ site.dcvb_parameters }}file/task-settings/code-parser-task-settings.html) object + +**Example:** ```json { @@ -21,7 +27,14 @@ Parameter `Name` represents the name of a `CodeParserTaskSetting` object, which } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `Name` parameter. +> - To use it, embed this parameter within a [CodeParserTaskSetting]({{ site.dcvb_parameters }}file/task-settings/code-parser-task-settings.html) 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 Details | | :----------------------------------- | diff --git a/parameters/reference/code-parser-task-settings/resources-path.md b/parameters/reference/code-parser-task-settings/resources-path.md index 98a812b..9a56140 100644 --- a/parameters/reference/code-parser-task-settings/resources-path.md +++ b/parameters/reference/code-parser-task-settings/resources-path.md @@ -2,17 +2,23 @@ layout: default-layout title: ResourcesPath - Dynamsoft Capture Vision Parameter Reference description: The parameter ResourcesPath of Dynamsoft Capture Vision. -needAutoGenerateSidebar: true -needGenerateH3Content: false -noTitleIndex: true permalink: /parameters/reference/code-parser-task-settings/resources-path.html --- - # ResourcesPath Parameter `ResourcesPath` specifies the directory path that contains the resources needed for code parsing. -## Example +## JSON Structure + +**Location in template:** +``` +CodeParserTaskSettingOptions[i] + └── ResourcesPath +``` + +**Parent object:** [CodeParserTaskSetting]({{ site.dcvb_parameters }}file/task-settings/code-parser-task-settings.html) object + +**Example:** ```json { @@ -20,9 +26,16 @@ Parameter `ResourcesPath` specifies the directory path that contains the resourc } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `ResourcesPath` parameter. +> - To use it, embed this parameter within a [CodeParserTaskSetting]({{ site.dcvb_parameters }}file/task-settings/code-parser-task-settings.html) 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 -| Brightness Parameter Summary | +| Brightness Parameter Details | | :------------- | | **Type**
    *String* | | **Range**
    any valid string | diff --git a/parameters/reference/document-normalizer-task-settings/base-document-normalizer-task-setting-name.md b/parameters/reference/document-normalizer-task-settings/base-document-normalizer-task-setting-name.md index 8d87c39..ef21187 100644 --- a/parameters/reference/document-normalizer-task-settings/base-document-normalizer-task-setting-name.md +++ b/parameters/reference/document-normalizer-task-settings/base-document-normalizer-task-setting-name.md @@ -1,18 +1,25 @@ --- layout: default-layout title: BaseDocumentNormalizerTaskSettingName - Dynamsoft Document Normalizer Parameters -description: The parameter BaseDocumentNormalizerTaskSettingName of Dynamsoft Document Normalizer defines the base object of the current DocumentNormalizerTaskSetting. +description: The parameter BaseDocumentNormalizerTaskSettingName defines the base object of the current DocumentNormalizerTaskSetting. keywords: Base document normalizer task setting name -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- # BaseDocumentNormalizerTaskSettingName -Parameter `BaseDocumentNormalizerTaskSettingName` represents the name of another `DocumentNormalizerTaskSetting` object. It is used to inherit the parameters defined in its parent `DocumentNormalizerTaskSetting` object. If a parameter has already been defined in this object, the parameter with the same name will not be inherited from the parent object. +`BaseDocumentNormalizerTaskSettingName` represents the name of another `DocumentNormalizerTaskSetting` object. It is used to inherit the parameters defined in its parent `DocumentNormalizerTaskSetting` object. If a parameter has already been defined in this object, the parameter with the same name will not be inherited from the parent object. -## Example +## JSON Structure + +**Location in template:** +``` +DocumentNormalizerTaskSettingOptions[i] + └── BaseDocumentNormalizerTaskSettingName +``` + +**Parent object:** [DocumentNormalizerTaskSetting]({{ site.dcvb_parameters }}file/task-settings/document-normalizer-task-settings.html) + +**Example:** ```json { @@ -20,10 +27,18 @@ Parameter `BaseDocumentNormalizerTaskSettingName` represents the name of another } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `BaseDocumentNormalizerTaskSettingName` parameter. +> - To use it, embed this parameter within a [DocumentNormalizerTaskSetting]({{ site.dcvb_parameters }}file/task-settings/document-normalizer-task-settings.html) object in the complete JSON structure. +> - 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 -| BaseDocumentNormalizerTaskSettingName Parameter Summary | +| BaseDocumentNormalizerTaskSettingName Parameter Details | | :------------------------------------------- | | **Type**
    *String* | | **Range**
    One of the existing `DocumentNormalizerTaskSetting` object name. | | **Default Value**
    "" | +| **Remarks**
    The default value "" means this object don't inherit the settings of another object. | diff --git a/parameters/reference/document-normalizer-task-settings/brightness.md b/parameters/reference/document-normalizer-task-settings/brightness.md index b7a36c9..1c698dc 100644 --- a/parameters/reference/document-normalizer-task-settings/brightness.md +++ b/parameters/reference/document-normalizer-task-settings/brightness.md @@ -1,18 +1,27 @@ --- layout: default-layout title: Brightness - Dynamsoft Document Normalizer Parameters -description: The parameter Brightness of Dynamsoft Document Normalizer defines the brightness of the image. -keywords: -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true +description: The parameter Brightness defines the brightness of the image. +keywords: Brightness --- # Brightness -Parameter `Brightness` defines the brightness of the target image. +`Brightness` defines the brightness of the target image. -## Example +## JSON Structure + +**Location in template:** +``` +DocumentNormalizerTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_ENHANCE_IMAGE") + └── Brightness +``` + +**Parent object:** [EnhanceImageStage]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/stage-enhance-image.html) + +**Example:** ```json { @@ -20,9 +29,16 @@ Parameter `Brightness` defines the brightness of the target image. } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `Brightness` parameter. +> - To use it, embed this parameter within an [EnhanceImageStage]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/stage-enhance-image.html) object in the complete JSON structure. +> - 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 -| Brightness Parameter Summary | +| Brightness Parameter Details | | :------------- | | **Type**
    *int* | | **Range**
    [-100, 100] | diff --git a/parameters/reference/document-normalizer-task-settings/colour-mode.md b/parameters/reference/document-normalizer-task-settings/colour-mode.md index 88c7e63..34cd720 100644 --- a/parameters/reference/document-normalizer-task-settings/colour-mode.md +++ b/parameters/reference/document-normalizer-task-settings/colour-mode.md @@ -1,18 +1,27 @@ --- layout: default-layout title: ColourMode - Dynamsoft Document Normalizer Parameters -description: The parameter ColourMode of Dynamsoft Document Normalizer defines the output colour mode of the image. -keywords: -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true +description: The parameter ColourMode defines the output colour mode of the image. +keywords: ColourMode --- # ColourMode -Parameter `ColourMode` defines the output colour mode of the target image. It influence the image that output by both `CapturedResult` and `IntermediateResult`. +`ColourMode` defines the output colour mode of the target image. It influences the image that output by both `CapturedResult` and `IntermediateResult`. -## Example +## JSON Structure + +**Location in template:** +``` +DocumentNormalizerTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_ENHANCE_IMAGE") + └── ColourMode +``` + +**Parent object:** [EnhanceImageStage]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/stage-enhance-image.html) + +**Example:** ```json { @@ -20,9 +29,16 @@ Parameter `ColourMode` defines the output colour mode of the target image. It in } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `ColourMode` parameter. +> - To use it, embed this parameter within an [EnhanceImageStage]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/stage-enhance-image.html) object in the complete JSON structure. +> - 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 -| ColourMode Parameter Summary | +| ColourMode Parameter Details | | :--------------------------- | | **Type**
    *String* | | **Available Colour Mode List**

    ICM_BINARY
    ICM_GRAYSCALE
    ICM_COLOUR | diff --git a/parameters/reference/document-normalizer-task-settings/content-type.md b/parameters/reference/document-normalizer-task-settings/content-type.md index a3072a3..3f784da 100644 --- a/parameters/reference/document-normalizer-task-settings/content-type.md +++ b/parameters/reference/document-normalizer-task-settings/content-type.md @@ -1,18 +1,26 @@ --- layout: default-layout title: ContentType - Dynamsoft Document Normalizer Parameters -description: The parameter ContentType of Dynamsoft Document Normalizer is XXX. -keywords: -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true +description: The parameter ContentType defines which contents are the targeting objects. +keywords: ContentType --- # ContentType -Parameter `ContentType` defines which contents are the targeting objects. +`ContentType` defines which contents are the targeting objects. -## Example +## JSON Structure + +**Location in template:** +``` +DocumentNormalizerTaskSettingOptions[i] + └── SectionArray[j] (Section object where Section = "ST_DOCUMENT_DETECTION") + └── ContentType +``` + +**Parent object:** [DocumentDetectionSection]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-document-detection.html) + +**Example:** ```json { @@ -20,9 +28,16 @@ Parameter `ContentType` defines which contents are the targeting objects. } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `ContentType` parameter. +> - To use it, embed this parameter within a [DocumentDetectionSection]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-document-detection.html) object in the complete JSON structure. +> - 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 -| ContentType Parameter Summary | +| ContentType Parameter Details | | :---------------------------- | | **Type**
    *String* | | **Available Content Type**

    CT_DOCUMENT
    CT_TABLE
    CT_UNKNOWN | diff --git a/parameters/reference/document-normalizer-task-settings/contrast.md b/parameters/reference/document-normalizer-task-settings/contrast.md index 3142b34..3887a89 100644 --- a/parameters/reference/document-normalizer-task-settings/contrast.md +++ b/parameters/reference/document-normalizer-task-settings/contrast.md @@ -1,18 +1,27 @@ --- layout: default-layout title: Contrast - Dynamsoft Document Normalizer Parameters -description: The parameter Contrast of Dynamsoft Document Normalizer specifies the contrast of the image. -keywords: -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true +description: The parameter Contrast specifies the contrast of the image. +keywords: Contrast --- # Contrast -Parameter `Contrast` specifies the contrast of the image. +`Contrast` specifies the contrast of the image. -## Example +## JSON Structure + +**Location in template:** +``` +DocumentNormalizerTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_ENHANCE_IMAGE") + └── Contrast +``` + +**Parent object:** [EnhanceImageStage]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/stage-enhance-image.html) + +**Example:** ```json { @@ -20,9 +29,16 @@ Parameter `Contrast` specifies the contrast of the image. } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `Contrast` parameter. +> - To use it, embed this parameter within an [EnhanceImageStage]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/stage-enhance-image.html) object in the complete JSON structure. +> - 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 -| Contrast Parameter Summary | +| Contrast Parameter Details | | :------------------------ | | **Type**
    *int* | | **Range**
    [-100,100] | diff --git a/parameters/reference/document-normalizer-task-settings/corner-angle-range.md b/parameters/reference/document-normalizer-task-settings/corner-angle-range.md index b814b57..95cc058 100644 --- a/parameters/reference/document-normalizer-task-settings/corner-angle-range.md +++ b/parameters/reference/document-normalizer-task-settings/corner-angle-range.md @@ -1,30 +1,45 @@ --- layout: default-layout title: CornerAngleRange - Dynamsoft Document Normalizer Parameters -description: The parameter CornerAngleRange of Dynamsoft Document Normalizer is XXX. -keywords: -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true +description: The parameter CornerAngleRange specifies the range of angles of the extracted corners. +keywords: CornerAngleRange --- # CornerAngleRange -Parameter `CornerAngleRange` specifies the range of angles (in degrees) of the extracted corners. The corners refer to the corners of a quad or document. +`CornerAngleRange` specifies the range of angles (in degrees) of the extracted corners. The corners refer to the corners of a quad or document. -## Example +## JSON Structure + +**Location in template:** +``` +DocumentNormalizerTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_DETECT_CORNERS") + └── CornerAngleRange +``` + +**Parent object:** [DetectCornersStage]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/stage-detect-corners.html) + +**Example:** ```json { - "CornerAngleRange": - { - "MinValue": 80, - "MaxValue": 100 - } + "CornerAngleRange": { + "MinValue": 80, + "MaxValue": 100 + } } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `CornerAngleRange` parameter. +> - To use it, embed this parameter within a [DetectCornersStage]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/stage-detect-corners.html) object in the complete JSON structure. +> - 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 `CornerAngleRange` The range of a maximum and a minimum value of the angles. diff --git a/parameters/reference/document-normalizer-task-settings/deskew-mode.md b/parameters/reference/document-normalizer-task-settings/deskew-mode.md index 4e57573..ae8ecb0 100644 --- a/parameters/reference/document-normalizer-task-settings/deskew-mode.md +++ b/parameters/reference/document-normalizer-task-settings/deskew-mode.md @@ -1,30 +1,45 @@ --- layout: default-layout title: DeskewMode - Dynamsoft Document Normalizer Parameters -description: The parameter DeskewMode of Dynamsoft Document Normalizer is XXX. -keywords: -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true +description: The parameter DeskewMode specifies the method to apply the deskew process on the target image. +keywords: DeskewMode --- # DeskewMode -Parameter `DeskewMode` specifies the method in which the deskew process way used to apply the deskew process on the target image. It consists one of one following candidate modes, each mode represents an implement. +`DeskewMode` specifies the method in which the deskew process is applied to the target image. It consists of one of the following candidate modes, each mode represents an implementation. -## Example +## JSON Structure + +**Location in template:** +``` +DocumentNormalizerTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_DESKEW_IMAGE") + └── DeskewMode +``` + +**Parent object:** [DeskewImageStage]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/stage-deskew-image.html) + +**Example:** ```json { - "DeskewMode" : - { - "ContentDirection" : 0, - "Mode" : "DM_PERSPECTIVE_CORRECTION" - }, + "DeskewMode": { + "ContentDirection": 0, + "Mode": "DSM_PERSPECTIVE_CORRECTION" + } } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `DeskewMode` parameter. +> - To use it, embed this parameter within a [DeskewImageStage]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/stage-deskew-image.html) object in the complete JSON structure. +> - 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 DeskewMode is defined with a object that contains two mode arguments, `Mode` and `ContentDirection`. @@ -47,11 +62,11 @@ DeskewMode is defined with a object that contains two mode arguments, `Mode` and - Candidate Mode List

    DM_PERSPECTIVE_CORRECTION + Candidate Mode List

    DSM_PERSPECTIVE_CORRECTION - Default Value
    ["DM_PERSPECTIVE_CORRECTION"] + Default Value
    ["DSM_PERSPECTIVE_CORRECTION"] @@ -72,7 +87,7 @@ DeskewMode is defined with a object that contains two mode arguments, `Mode` and - Remarks
    Only available for "DM_PERSPECTIVE_CORRECTION". + Remarks
    Only available for "DSM_PERSPECTIVE_CORRECTION".
    0: Direction unknown.
    1: Vertical direction.
    2: Horizontal direction. @@ -89,13 +104,13 @@ If the `DeskewMode` is not configured in your template file, the following setti "DeskewMode" : { "ContentDirection" : 0, - "Mode" : "DM_PERSPECTIVE_CORRECTION" + "Mode" : "DSM_PERSPECTIVE_CORRECTION" } } ``` -## Candidate Modes Introduction +## Candidate Mode Introductions -### DM_PERSPECTIVE_CORRECTION +### DSM_PERSPECTIVE_CORRECTION Deskew the document by applying perspective correction process. diff --git a/parameters/reference/document-normalizer-task-settings/expected-documents-count.md b/parameters/reference/document-normalizer-task-settings/expected-documents-count.md index 6805f0d..2ccac1d 100644 --- a/parameters/reference/document-normalizer-task-settings/expected-documents-count.md +++ b/parameters/reference/document-normalizer-task-settings/expected-documents-count.md @@ -1,28 +1,42 @@ --- layout: default-layout title: ExpectedDocumentsCount - Dynamsoft Document Normalizer Parameters -description: The parameter ExpectedDocumentsCount of Dynamsoft Document Normalizer sets the number of documents expected to be detected. +description: The parameter ExpectedDocumentsCount sets the number of documents expected to be detected. keywords: Expected Documents Count -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- # ExpectedDocumentsCount -ExpectedDocumentsCount sets the number of documents expected to be detected. +`ExpectedDocumentsCount` sets the number of documents expected to be detected. -## Example +## JSON Structure + +**Location in template:** +``` +DocumentNormalizerTaskSettingOptions[i] + └── ExpectedDocumentsCount +``` + +**Parent object:** [DocumentNormalizerTaskSetting]({{ site.dcvb_parameters }}file/task-settings/document-normalizer-task-settings.html) + +**Example:** ```json { - "ExpectedDocumentsCount" : 1 + "ExpectedDocumentsCount": 1 } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `ExpectedDocumentsCount` parameter. +> - To use it, embed this parameter within a [DocumentNormalizerTaskSetting]({{ site.dcvb_parameters }}file/task-settings/document-normalizer-task-settings.html) object in the complete JSON structure. +> - 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 -| ExpectedDocumentsCount Parameter Summary | +| ExpectedDocumentsCount Parameter Details | | :--------------- | | **Type**
    int | | **Range**
    [0, 0x7fffffff] | diff --git a/parameters/reference/document-normalizer-task-settings/line-assembly-mode.md b/parameters/reference/document-normalizer-task-settings/line-assembly-mode.md deleted file mode 100644 index 860b617..0000000 --- a/parameters/reference/document-normalizer-task-settings/line-assembly-mode.md +++ /dev/null @@ -1,102 +0,0 @@ ---- -layout: default-layout -title: LineAssemblyMode - Dynamsoft Capture Vision Parameters -description: The parameter LineAssemblyMode of Dynamsoft Capture Vision is for assembling short lines. -keywords: LineAssemblyMode, parameter reference, parameter -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true ---- - - -# LineAssemblyMode - -Parameter `LineAssemblyMode` determines how to assemble the short lines. For tasks like document detection, short line is very important and usually requires a stronger assembling sensitivity to ensure enough lines are captured. - -## Example - -```json -{ - "LineAssemblyMode": - { - "Mode": "LAM_GENERAL", - "Sensitivity": 3 - } -} -``` - -## Parameter Summary - -Parameter `LineAssemblyMode` includes a mode arguments shown as follow: - -### Mode Arguments - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    Mode Argument NameMode Argument Summary
    Mode
    (Required)
    Description
    Any one in Candidate Mode List as string -
    Type
    String -
    Candidate Mode List
    LAM_GENERAL -
    Default Value
    LAM_GENERAL -
    Sensitivity
    (Optional)
    Description
    Sets the sensitivity used for short line assembling. A larger value means the library will take more effort to assemble short lines. -
    Type
    int -
    Range
    [1, 9] -
    Valid For
    -
    LAM_GENERAL -
    - -### Default Setting - -If the `LineAssemblyMode` is not configured in your template file, the following setting will be used as the default setting. - -```json -{ - "LineAssemblyMode": - [ - { - "Mode": "LAM_GENERAL", - "Sensitivity": 6 - } - ] -} -``` - -## Candidate Modes Introduction - -### LAM_GENERAL - -Assemble short lines using the general algorithm. This mode has the following arguments for further customization. - -**Available Mode Arguments:** - -- Sensitivity diff --git a/parameters/reference/document-normalizer-task-settings/line-extraction-modes.md b/parameters/reference/document-normalizer-task-settings/line-extraction-modes.md deleted file mode 100644 index fbd24d2..0000000 --- a/parameters/reference/document-normalizer-task-settings/line-extraction-modes.md +++ /dev/null @@ -1,89 +0,0 @@ ---- -layout: default-layout -title: LineExtractionModes - Dynamsoft Document Normalizer Parameters -description: The parameter LineExtractionModes of Dynamsoft Document Normalizer is to specifies the modes used in line extraction. -keywords: -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true -ignore: true -pageEndVer: 2.4.2200 ---- - -# LineExtractionModes - -Parameter `LineExtractionModes` specifies the algorithm used to extract lines. It currently consist of `LEM_GENERAL` and `LEM_MARGIN_BASED`. Each mode representing a different way to extract lines. - -## Example - -```json -{ - "LineExtractionModes": - [ - { - "Mode": "LEM_GENERAL" - }, - { - "Mode": "LEM_MARGIN_BASED" - } - ] -} -``` - -## Parameter Summary - -`LineExtractionModes` consist one or more mode objects. Each mode object contains a candidate mode and other mode arguments. - -### Mode Arguments - - - - - - - - - - - - - - - - - - - - - -
    Mode Argument NameMode Argument Summary
    Mode
    (Required)
    Description
    Specifies a mode for line extraction. -
    Type
    String -
    Candidate Mode List
    LEM_GENERAL -
    LEM_MARGIN_BASED -
    Default Value
    ["LEM_GENERAL"] -
    - -### Default Setting - -If the `LineExtractionModes` is not configured in your template file, the following setting will be used as the default setting. - -```json -{ - "LineExtractionModes" : - [ - { - "Mode" : "LEM_GENERAL" - } - ] -} -``` - -## Candidate Modes Introduction - -### LEM_GENERAL - -Designed for the senarios where the document background colour is distinct from the environment background colour. In these scenarios, contours of the document bounaries are clear enough on the binary images. As a result, the line segments can be easily extracted from the image. - -### LEM_MARGIN_BASED - -Designed for the senarios where the background colour is similar to the environment background colour. For these scenarios, it is hard to get distinct contours of document boundaries with general binarization process. When the mode `LEM_MARGIN_BASED` is enabled, the library will implement different parameters for the binarization mode to separate the document contents and the background areas. The line segments of the document boundaries will be extracted from the margin between document contents and the background areas. diff --git a/parameters/reference/document-normalizer-task-settings/max-threads-in-one-task.md b/parameters/reference/document-normalizer-task-settings/max-threads-in-one-task.md index 3f7004b..b476a52 100644 --- a/parameters/reference/document-normalizer-task-settings/max-threads-in-one-task.md +++ b/parameters/reference/document-normalizer-task-settings/max-threads-in-one-task.md @@ -3,26 +3,40 @@ layout: default-layout title: MaxThreadsInOneTask - Dynamsoft Document Normalizer Parameters description: The parameter MaxThreadsInOneTask defines the maximum threads that can be consumed in one document normalizer task. keywords: Max threads -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- # MaxThreadsInOneTask -Parameter `MaxThreadsInOneTask` defines the maximum threads that can be consumed in one task. +`MaxThreadsInOneTask` defines the maximum threads that can be consumed in one task. -## Example +## JSON Structure + +**Location in template:** +``` +DocumentNormalizerTaskSettingOptions[i] + └── MaxThreadsInOneTask +``` + +**Parent object:** [DocumentNormalizerTaskSetting]({{ site.dcvb_parameters }}file/task-settings/document-normalizer-task-settings.html) + +**Example:** ```json { - "MaxThreadsInOneTask":4 + "MaxThreadsInOneTask": 4 } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `MaxThreadsInOneTask` parameter. +> - To use it, embed this parameter within a [DocumentNormalizerTaskSetting]({{ site.dcvb_parameters }}file/task-settings/document-normalizer-task-settings.html) object in the complete JSON structure. +> - 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 -| MaxThreadsInOneTask Parameter Summary | +| MaxThreadsInOneTask Parameter Details | | :------------- | | **Type**
    *int* | | **Range**
    [0, 256] | diff --git a/parameters/reference/document-normalizer-task-settings/name.md b/parameters/reference/document-normalizer-task-settings/name.md index 7ff6ab8..abe7c7c 100644 --- a/parameters/reference/document-normalizer-task-settings/name.md +++ b/parameters/reference/document-normalizer-task-settings/name.md @@ -1,26 +1,40 @@ --- layout: default-layout -title: DocumentNormalizerTaskSetting Name - Dynamsoft Document Normalizer Parameter. +title: Name - Dynamsoft Document Normalizer DocumentNormalizerTaskSetting Parameters description: The parameter Name defines the unique identifier of a DocumentNormalizerTaskSetting object. keywords: top-level object, name, unique identifier -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- # Name -Parameter `Name` represents the name of a `DocumentNormalizerTaskSetting` object, which serves as its unique identifier. +`Name` represents the name of a `DocumentNormalizerTaskSetting` object, which serves as its unique identifier. -## Example +## JSON Structure + +**Location in template:** +``` +DocumentNormalizerTaskSettingOptions[i] + └── Name +``` + +**Parent object:** [DocumentNormalizerTaskSetting]({{ site.dcvb_parameters }}file/task-settings/document-normalizer-task-settings.html) + +**Example:** ```json { - "Name" : "dn_0" + "Name": "dn_0" } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `Name` parameter. +> - To use it, embed this parameter within a [DocumentNormalizerTaskSetting]({{ site.dcvb_parameters }}file/task-settings/document-normalizer-task-settings.html) object in the complete JSON structure. +> - 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 Details | | :----------------------------------- | diff --git a/parameters/reference/document-normalizer-task-settings/page-size.md b/parameters/reference/document-normalizer-task-settings/page-size.md index 8d5cfa9..0d0a619 100644 --- a/parameters/reference/document-normalizer-task-settings/page-size.md +++ b/parameters/reference/document-normalizer-task-settings/page-size.md @@ -1,28 +1,44 @@ --- layout: default-layout title: PageSize - Dynamsoft Document Normalizer Parameters -description: The parameter PageSize of Dynamsoft Document Normalizer is XXX. +description: The parameter PageSize sets the page size of the target image. keywords: Page size -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- # PageSize -Parameter `PageSize` sets the page size (width by height in pixels) of the target image. +`PageSize` sets the page size (width by height in pixels) of the target image. -## Example +## JSON Structure + +**Location in template:** +``` +DocumentNormalizerTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_DESKEW_IMAGE") + └── PageSize +``` + +**Parent object:** [DeskewImageStage]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/stage-deskew-image.html) + +**Example:** ```json { - "PageSize" : [ 210, 297 ] + "PageSize": [210, 297] } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `PageSize` parameter. +> - To use it, embed this parameter within a [DeskewImageStage]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/stage-deskew-image.html) object in the complete JSON structure. +> - 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 -| PageSize Parameter Summary | +| PageSize Parameter Details | | :--------------- | | **Type**
    int[2] | | **Range**
    Each member should be a int value betweem [-1,0x7fffffff]. | diff --git a/parameters/reference/document-normalizer-task-settings/quadrilateral-detection-modes.md b/parameters/reference/document-normalizer-task-settings/quadrilateral-detection-modes.md index e595457..7f5042e 100644 --- a/parameters/reference/document-normalizer-task-settings/quadrilateral-detection-modes.md +++ b/parameters/reference/document-normalizer-task-settings/quadrilateral-detection-modes.md @@ -1,31 +1,47 @@ --- layout: default-layout title: QuadrilateralDetectionModes - Dynamsoft Document Normalizer Parameters -description: The parameter QuadrilateralDetectionModes of Dynamsoft Document Normalizer. +description: The parameter QuadrilateralDetectionModes controls the quadrilateral detection process on an image. keywords: Quadrilateral detection -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- # QuadrilateralDetectionModes -Parameter `QuadrilateralDetectionModes` controls the quadrilateral detection process on an image. It currently includes only one mode. +`QuadrilateralDetectionModes` controls the quadrilateral detection process on an image. It currently includes only one mode. -## Example +## JSON Structure + +**Location in template:** +``` +DocumentNormalizerTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_DETECT_QUADS") + └── QuadrilateralDetectionModes +``` + +**Parent object:** [DetectQuadsStage]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/stage-detect-quads.html) + +**Example:** ```json { "QuadrilateralDetectionModes": [ { "Mode": "QDM_GENERAL", - "MinQuadrilateralAreaRatio" : 30 + "MinQuadrilateralAreaRatio": 30 } ] } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `QuadrilateralDetectionModes` parameter. +> - To use it, embed this parameter within a [DetectQuadsStage]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/stage-detect-quads.html) object in the complete JSON structure. +> - 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 `QuadrilateralDetectionModes` consist one or more mode objects. Each mode object contains a candidate mode and other mode arguments. @@ -90,7 +106,7 @@ If the `QuadrilateralDetectionModes` is not configured in your template file, th } ``` -## Candidate Modes Introduction +## Candidate Mode Introductions ### QDM_GENERAL diff --git a/parameters/reference/document-normalizer-task-settings/section-array.md b/parameters/reference/document-normalizer-task-settings/section-array.md index c5144fe..b7671ac 100644 --- a/parameters/reference/document-normalizer-task-settings/section-array.md +++ b/parameters/reference/document-normalizer-task-settings/section-array.md @@ -3,46 +3,59 @@ layout: default-layout title: SectionArray - Dynamsoft Document Normalizer Parameters description: The parameter SectionArray defines which sections exist under the DocumentNormalizerTask. keywords: Section Array parameter -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- # SectionArray -`SectionArray` is a parameter that defines which sections exist under the `DocumentNormalizerTask`. A `Section` is a sequence of Stages that form a relatively complete processing unit, producing milestone results that include location information along with other details. +Parameter `SectionArray` defines which sections exist under the `DocumentNormalizerTask`. A `Section` is a sequence of `Stages` that form a relatively complete processing unit, producing milestone results that include location information along with other details. -The `DocumentNormalizerTask` includes the following sections: +## JSON Structure + +**Location in template:** +``` +DocumentNormalizerTaskSettingOptions[i] + └── SectionArray +``` + +**Parent object:** [DocumentNormalizerTaskSetting]({{ site.dcvb_parameters }}file/task-settings/document-normalizer-task-settings.html) object -* [ST_REGION_PREDETECTION](./section-regions-predetection.md) - * It is designed to find regions of interest (ROIs) and thus ignoring other parts of the image during subsequent processing. -* [ST_DOCUMENT_DETECTION](./section-document-detection.md) - * It is designed to detect the edges of the document. -* [ST_DOCUMENT_DESKEWING](./section-document-deskewing.md) - * It is designed to correct perspective distortion. -* [ST_IMAGE_ENHANCEMENT](./section-image-enhancement.md) - * It is designed to enhance the quality of the image. +**Example:** ```json { - "SectionArray": - [ + "SectionArray": [ { - "Section": "ST_REGION_PREDETECTION", - // Other parameters... + "Section": "ST_REGION_PREDETECTION" }, { - "Section": "ST_DOCUMENT_DETECTION", - // Other parameters... + "Section": "ST_DOCUMENT_DETECTION" }, { - "Section": "ST_DOCUMENT_DESKEWING", - // Other parameters... + "Section": "ST_DOCUMENT_DESKEWING" }, { - "Section": "ST_IMAGE_ENHANCEMENT", - // Other parameters... + "Section": "ST_IMAGE_ENHANCEMENT" } ] } ``` + +> [!NOTE] +> - This snippet shows only the `SectionArray` parameter. +> - To use it, embed this parameter within a [DocumentNormalizerTaskSetting]({{ site.dcvb_parameters }}file/task-settings/document-normalizer-task-settings.html) 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 + +The `DocumentNormalizerTask` includes the following sections: + +* [RegionPredetectionSection](./section-regions-predetection.md) (`ST_REGION_PREDETECTION`) + * Designed to find regions of interest (ROIs) and thus ignore other parts of the image during subsequent processing. +* [DocumentDetectionSection](./section-document-detection.md) (`ST_DOCUMENT_DETECTION`) + * Designed to detect the edges of the document. +* [DocumentDeskewingSection](./section-document-deskewing.md) (`ST_DOCUMENT_DESKEWING`) + * Designed to correct perspective distortion. +* [ImageEnhancementSection](./section-image-enhancement.md) (`ST_IMAGE_ENHANCEMENT`) + * Designed to enhance the quality of the image. diff --git a/parameters/reference/document-normalizer-task-settings/section-document-deskewing.md b/parameters/reference/document-normalizer-task-settings/section-document-deskewing.md index 69d7735..483e412 100644 --- a/parameters/reference/document-normalizer-task-settings/section-document-deskewing.md +++ b/parameters/reference/document-normalizer-task-settings/section-document-deskewing.md @@ -1,44 +1,71 @@ --- layout: default-layout -title: Document Deskewing Section - Dynamsoft Document Normalizer Parameters -description: The parameter defines document deskewing section under the DocumentNormalizerTask. -keywords: Document Deskewing Section -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true +title: DocumentDeskewingSection - Dynamsoft Document Normalizer Parameters +description: The DocumentDeskewingSection corrects perspective distortion by deskewing the document. +keywords: DocumentDeskewingSection --- -# Document Deskewing Section +# DocumentDeskewingSection -The Document Deskewing Section is designed to detect the edges of a document. +`DocumentDeskewingSection` corrects perspective distortion by deskewing the document. In JSON, it is represented as a Section object with `"Section": "ST_DOCUMENT_DESKEWING"`. + +## JSON Structure + +**Location in template:** +``` +DocumentNormalizerTaskSettingOptions[i] + └── SectionArray[j] (Section object where Section = "ST_DOCUMENT_DESKEWING") +``` + +**Parent object:** [SectionArray]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-array.html) + +**Example:** ```json { "Section": "ST_DOCUMENT_DESKEWING", "ImageParameterName": "ip_ddnDefault", - "StageArray": [] + "StageArray": [ + { + "Stage": "SST_DESKEW_IMAGE" + } + ] } ``` -## Section +> [!NOTE] +> - This snippet shows a Section object configured for document deskewing. +> - To use it, add this object to the [SectionArray]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-array.html) of a [DocumentNormalizerTaskSetting]({{ site.dcvb_parameters }}file/task-settings/document-normalizer-task-settings.html). +> - 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) -The section is named `ST_DOCUMENT_DESKEWING`. +## Parameters -## ImageParameterName +### Section -Specifies the `ImageParameter` to apply in the stages of this section. +Specifies the section type. Fixed value: `ST_DOCUMENT_DESKEWING`. -| Parameter Summary | +| Parameter Details | | :------------- | | **Type**
    *string* | -| **Range**
    *It must be one of the name that defined under `ImageParameterOptions`* | -| **Default Value**
    *ip_ddnDefault* | +| **Required**
    Yes | +| **Default Value**
    `"ST_DOCUMENT_DESKEWING"` | + +### ImageParameterName + +Specifies the name of an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) object to apply in the stages of this section. -## StageArray +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Range**
    Must be the name of an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) object defined under `ImageParameterOptions` | +| **Default Value**
    `""` | -`StageArray` is a parameter that specifies the stages within the `Document Deskewing Section`. A `Stage` is the smallest step significant enough to involve users in image processing. +### StageArray -The `Document Deskewing Section` consists of only one stage: +Specifies the stage objects within this section. The `DocumentDeskewingSection` consists of the following stages: -* [SST_DESKEW_IMAGE](./stage-deskew-image.md) - * It is designed at the stage level to de-skew the quadrilateral to transform it into a rectangle. +| Stage | Description | +|-------|-------------| +| [DeskewImageStage](./stage-deskew-image.md) (`SST_DESKEW_IMAGE`) | Deskews the quadrilateral to transform it into a rectangle. | diff --git a/parameters/reference/document-normalizer-task-settings/section-document-detection.md b/parameters/reference/document-normalizer-task-settings/section-document-detection.md index 05d6472..3a19f3a 100644 --- a/parameters/reference/document-normalizer-task-settings/section-document-detection.md +++ b/parameters/reference/document-normalizer-task-settings/section-document-detection.md @@ -1,52 +1,75 @@ --- layout: default-layout -title: Document Detection Section - Dynamsoft Document Normalizer Parameters -description: The parameter defines document detection section under the DocumentNormalizerTask. -keywords: Document Detection Section -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true +title: DocumentDetectionSection - Dynamsoft Document Normalizer Parameters +description: The DocumentDetectionSection detects the edges of a document. +keywords: DocumentDetectionSection --- -# Document Detection Section +# DocumentDetectionSection -The Document Detection Section is designed to detect the edges of a document. +`DocumentDetectionSection` detects the edges of a document. In JSON, it is represented as a Section object with `"Section": "ST_DOCUMENT_DETECTION"`. + +## JSON Structure + +**Location in template:** +``` +DocumentNormalizerTaskSettingOptions[i] + └── SectionArray[j] (Section object where Section = "ST_DOCUMENT_DETECTION") +``` + +**Parent object:** [SectionArray]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-array.html) + +**Example:** ```json { "Section": "ST_DOCUMENT_DETECTION", "ImageParameterName": "ip_ddnDefault", - "StageArray": [] + "StageArray": [ + { + "Stage": "SST_DETECT_QUADS" + } + ] } ``` -## Section +> [!NOTE] +> - This snippet shows a Section object configured for document detection. +> - To use it, add this object to the [SectionArray]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-array.html) of a [DocumentNormalizerTaskSetting]({{ site.dcvb_parameters }}file/task-settings/document-normalizer-task-settings.html). +> - 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) -The section is named `ST_DOCUMENT_DETECTION`. +## Parameters -## ImageParameterName +### Section -Specifies the `ImageParameter` to apply in the stages of this section. +Specifies the section type. Fixed value: `ST_DOCUMENT_DETECTION`. -| Parameter Summary | +| Parameter Details | | :------------- | | **Type**
    *string* | -| **Range**
    *It must be one of the name that defined under `ImageParameterOptions`* | -| **Default Value**
    *ip_ddnDefault* | +| **Required**
    Yes | +| **Default Value**
    `"ST_DOCUMENT_DETECTION"` | + +### ImageParameterName + +Specifies the name of an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) object to apply in the stages of this section. -## StageArray +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Range**
    Must be the name of an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) object defined under `ImageParameterOptions` | +| **Default Value**
    `""` | -`StageArray` is a parameter that specifies the stages within the `Document Detection Section`. A `Stage` is the smallest step significant enough to involve users in image processing. +### StageArray -The `Document Detection Section` consists of stages show below: +Specifies the stage objects within this section. The `DocumentDetectionSection` consists of the following stages: -* [SST_ASSEMBLE_LONG_LINES](./stage-assemble-long-lines.md) - * It is designed at the stage level to assemble relatively long line segments to facilitate the assembly of more advanced line segments. -* [SST_ASSEMBLE_LOGICAL_LINES](./stage-assemble-logical-lines.md) - * It is designed at the stage level to assemble line segments based on certain criteria to serve the assembly of quadrilateral corners. -* [SST_DETECT_CORNERS](./stage-detect-corners.md) - * It is designed at the stage level to detect corners of quadrilaterals that meet the specified conditions. -* [SST_DETECT_EDGES](./stage-detect-edges.md) - * It is designed at the stage level to detect edges of quadrilaterals that meet the specified conditions. -* [SST_DETECT_QUADS](./stage-detect-quads.md) - * It is designed at the stage level to detect complete quadrilaterals. +| Stage | Description | +|-------|-------------| +| [AssembleLongLinesStage](./stage-assemble-long-lines.md) (`SST_ASSEMBLE_LONG_LINES`) | Assembles relatively long line segments to facilitate the assembly of more advanced line segments. | +| [AssembleLogicalLinesStage](./stage-assemble-logical-lines.md) (`SST_ASSEMBLE_LOGICAL_LINES`) | Assembles line segments based on certain criteria to serve the assembly of quadrilateral corners. | +| [DetectCornersStage](./stage-detect-corners.md) (`SST_DETECT_CORNERS`) | Detects corners of quadrilaterals that meet the specified conditions. | +| [DetectEdgesStage](./stage-detect-edges.md) (`SST_DETECT_EDGES`) | Detects edges of quadrilaterals that meet the specified conditions. | +| [DetectQuadsStage](./stage-detect-quads.md) (`SST_DETECT_QUADS`) | Detects complete quadrilaterals. | diff --git a/parameters/reference/document-normalizer-task-settings/section-image-enhancement.md b/parameters/reference/document-normalizer-task-settings/section-image-enhancement.md index a3a0289..356014f 100644 --- a/parameters/reference/document-normalizer-task-settings/section-image-enhancement.md +++ b/parameters/reference/document-normalizer-task-settings/section-image-enhancement.md @@ -1,44 +1,71 @@ --- layout: default-layout -title: Image Enhancement Section - Dynamsoft Document Normalizer Parameters -description: The parameter defines Image Enhancement section under the DocumentNormalizerTask. -keywords: Image Enhancement Section -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true +title: ImageEnhancementSection - Dynamsoft Document Normalizer Parameters +description: The ImageEnhancementSection adjusts the image quality. +keywords: ImageEnhancementSection --- -# Image Enhancement Section +# ImageEnhancementSection -The Image Enhancement Section is designed to adjust the image quality. +`ImageEnhancementSection` adjusts the image quality. In JSON, it is represented as a Section object with `"Section": "ST_IMAGE_ENHANCEMENT"`. + +## JSON Structure + +**Location in template:** +``` +DocumentNormalizerTaskSettingOptions[i] + └── SectionArray[j] (Section object where Section = "ST_IMAGE_ENHANCEMENT") +``` + +**Parent object:** [SectionArray]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-array.html) + +**Example:** ```json { "Section": "ST_IMAGE_ENHANCEMENT", "ImageParameterName": "ip_ddnDefault", - "StageArray": [] + "StageArray": [ + { + "Stage": "SST_ENHANCE_IMAGE" + } + ] } ``` -## Section +> [!NOTE] +> - This snippet shows a Section object configured for image enhancement. +> - To use it, add this object to the [SectionArray]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-array.html) of a [DocumentNormalizerTaskSetting]({{ site.dcvb_parameters }}file/task-settings/document-normalizer-task-settings.html). +> - 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) -The section is named `ST_IMAGE_ENHANCEMENT`. +## Parameters -## ImageParameterName +### Section -Specifies the `ImageParameter` to apply in the stages of this section. +Specifies the section type. Fixed value: `ST_IMAGE_ENHANCEMENT`. -| Parameter Summary | +| Parameter Details | | :------------- | | **Type**
    *string* | -| **Range**
    *It must be one of the name that defined under `ImageParameterOptions`* | -| **Default Value**
    *ip_ddnDefault* | +| **Required**
    Yes | +| **Default Value**
    `"ST_IMAGE_ENHANCEMENT"` | + +### ImageParameterName + +Specifies the name of an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) object to apply in the stages of this section. -## StageArray +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Range**
    Must be the name of an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) object defined under `ImageParameterOptions` | +| **Default Value**
    `""` | -`StageArray` is a parameter that specifies the stages within the `Image Enhancement Section`. A `Stage` is the smallest step significant enough to involve users in image processing. +### StageArray -The `Image Enhancement Section` consists of only one stage: +Specifies the stage objects within this section. The `ImageEnhancementSection` consists of the following stages: -* [SST_ENHANCE_IMAGE](./stage-enhance-image.md) - * It is designed at the stage level to adjust the image quality, such as changing the brightness, contrast, and the color mode of the image. +| Stage | Description | +|-------|-------------| +| [EnhanceImageStage](./stage-enhance-image.md) (`SST_ENHANCE_IMAGE`) | Adjusts the image quality, such as changing the brightness, contrast, and color mode. | diff --git a/parameters/reference/document-normalizer-task-settings/section-image-parameter-array.md b/parameters/reference/document-normalizer-task-settings/section-image-parameter-array.md deleted file mode 100644 index 3566989..0000000 --- a/parameters/reference/document-normalizer-task-settings/section-image-parameter-array.md +++ /dev/null @@ -1,74 +0,0 @@ ---- -layout: default-layout -title: SectionImageParameterArray - Dynamsoft Document Normalizer Parameters -description: The parameter SectionImageParameterArray defines the image processing algorithms that implemented in the different sections of a document normalizer algorithm task. -keywords: Section image parameter -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true ---- - -# SectionImageParameterArray - -`SectionImageParameterArray` is a parameter that defines `ImageParameter` in section unit. Each `SectionImageParameterArray` element is a group of a section name and a `ImageParameter` name so that this section will use the ImageParameter you specified. If a section is not specified in the array, it will use the default `ImageParameter` configuration. - -The `DocumentNormalizerTask` includes the following sections: - -* `ST_REGION_PREDETECTION` -* `ST_DOCUMENT_DETECTION` -* `ST_DOCUMENT_NORMALIZATION` - -## Example - -```json -{ - "SectionImageParameterArray": - [ - { - "Section": "ST_REGION_PREDETECTION", - "ImageParameterName": "IP_0" - }, - { - "Section": "ST_DOCUMENT_DETECTION", - "ImageParameterName": "IP_1" - }, - { - "Section": "ST_DOCUMENT_NORMALIZATION", - "ImageParameterName": "IP_1" - } - - ] -} -``` - -## Parameter Summary - - - - - - - - - - - - - - - - - - - - - - - - - -
    Child Parameter NameChild Parameter Summary
    Section
    Description
    Specifies an algorithm section.
    Type
    String
    Range
    One of the following SectionType as a string. -
    ST_REGION_PREDETECTION -
    ST_DOCUMENT_DETECTION -
    ST_DOCUMENT_NORMALIZATION -
    ImageParameterName
    Description
    Specifies the ImageParameter that you want to implement in this section. It must be one of the name that defined under ImageParameterOptions.
    Type
    String
    diff --git a/parameters/reference/document-normalizer-task-settings/section-regions-predetection.md b/parameters/reference/document-normalizer-task-settings/section-regions-predetection.md index 684d713..74e0fbf 100644 --- a/parameters/reference/document-normalizer-task-settings/section-regions-predetection.md +++ b/parameters/reference/document-normalizer-task-settings/section-regions-predetection.md @@ -1,44 +1,71 @@ --- layout: default-layout -title: Regions Predetection Section - Dynamsoft Label Recognizer Parameters -description: The parameter defines regions predtection section under the LabelRecognizerTask. -keywords: Regions Predetection Section -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true +title: RegionPredetectionSection - Dynamsoft Document Normalizer Parameters +description: The RegionPredetectionSection identifies regions of interest (ROIs) for subsequent processing. +keywords: RegionPredetectionSection --- -# Regions Predetection Section +# RegionPredetectionSection -The Regions Predetection Section is designed to identify regions of interest (ROIs), allowing subsequent processing to ignore other parts of the image. The pre-detected region may be identified based on color features, grayscale features, or neural network localization. +`RegionPredetectionSection` identifies regions of interest (ROIs), allowing subsequent processing to ignore other parts of the image. In JSON, it is represented as a Section object with `"Section": "ST_REGION_PREDETECTION"`. + +## JSON Structure + +**Location in template:** +``` +DocumentNormalizerTaskSettingOptions[i] + └── SectionArray[j] (Section object where Section = "ST_REGION_PREDETECTION") +``` + +**Parent object:** [SectionArray]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-array.html) + +**Example:** ```json { "Section": "ST_REGION_PREDETECTION", - "ImageParameterName": "ip_dlrDefault", - "StageArray": [] + "ImageParameterName": "ip_ddnDefault", + "StageArray": [ + { + "Stage": "SST_PREDETECT_REGIONS" + } + ] } ``` -## Section +> [!NOTE] +> - This snippet shows a Section object configured for region predetection. +> - To use it, add this object to the [SectionArray]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-array.html) of a [DocumentNormalizerTaskSetting]({{ site.dcvb_parameters }}file/task-settings/document-normalizer-task-settings.html). +> - 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) -The section is named `ST_REGION_PREDETECTION`. +## Parameters -## ImageParameterName +### Section -Specifies the `ImageParameter` to apply in the stages of this section. +Specifies the section type. Fixed value: `ST_REGION_PREDETECTION`. -| Parameter Summary | +| Parameter Details | | :------------- | | **Type**
    *string* | -| **Range**
    *It must be one of the name that defined under `ImageParameterOptions`* | -| **Default Value**
    *ip_dlrDefault* | +| **Required**
    Yes | +| **Default Value**
    `"ST_REGION_PREDETECTION"` | + +### ImageParameterName + +Specifies the name of an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) object to apply in the stages of this section. -## StageArray +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Range**
    Must be the name of an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) object defined under `ImageParameterOptions` | +| **Default Value**
    `""` | -`StageArray` is a parameter that specifies the stages within the `Regions Predetection Section`. A `Stage` is the smallest step significant enough to involve users in image processing. +### StageArray -The `Regions Predetection Section` consists of a single stage: +Specifies the stage objects within this section. The `RegionPredetectionSection` consists of the following stages: -* [SST_PREDETECT_REGIONS](./stage-predetect-regions.md) - * It is designed at the stage level to identify regions of interest (ROIs). +| Stage | Description | +|-------|-------------| +| [PredetectRegionsStage](./stage-predetect-regions.md) (`SST_PREDETECT_REGIONS`) | Identifies regions of interest (ROIs). | diff --git a/parameters/reference/document-normalizer-task-settings/short-line-detection-mode.md b/parameters/reference/document-normalizer-task-settings/short-line-detection-mode.md deleted file mode 100644 index a345309..0000000 --- a/parameters/reference/document-normalizer-task-settings/short-line-detection-mode.md +++ /dev/null @@ -1,102 +0,0 @@ ---- -layout: default-layout -title: ShortLineDetectionMode - Dynamsoft Capture Vision Parameters -description: The parameter ShortLineDetectionMode of Dynamsoft Capture Vision is for detecting short lines on an image. -keywords: ShortLineDetectionMode, parameter reference, parameter -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true ---- - - -# ShortLineDetectionMode - -Parameter `ShortLineDetectionMode` determines how to detect the short lines. For tasks like document detection, short line is very important and usually requires a stronger detection sensitivity to ensure enough short lines are captured. - -## Example - -```json -{ - "ShortlineDetectionMode": - { - "Mode": "SDM_GENERAL", - "Sensitivity": 3 - } -} -``` - -## Parameter Summary - -Parameter `ShortlineDetectionMode` includes a mode arguments shown as follow: - -### Mode Arguments - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    Mode Argument NameMode Argument Summary
    Mode
    (Required)
    Description
    Any one in Candidate Mode List as string -
    Type
    String -
    Candidate Mode List
    SDM_GENERAL -
    Default Value
    SDM_GENERAL -
    Sensitivity
    (Optional)
    Description
    Sets the sensitivity used for short line detection. A larger value means the library will take more effort to detect short lines. -
    Type
    int -
    Range
    [1, 9] -
    Valid For
    -
    SDM_GENERAL -
    - -### Default Setting - -If the `ShortlineDetectionMode` is not configured in your template file, the following setting will be used as the default setting. - -```json -{ - "ShortlineDetectionMode": - [ - { - "Mode": "SDM_GENERAL", - "Sensitivity": 6 - } - ] -} -``` - -## Candidate Modes Introduction - -### SDM_GENERAL - -Detects short lines using the general algorithm. This mode has the following arguments for further customization. - -**Available Mode Arguments:** - -- Sensitivity diff --git a/parameters/reference/document-normalizer-task-settings/stage-assemble-logical-lines.md b/parameters/reference/document-normalizer-task-settings/stage-assemble-logical-lines.md index 9c4e561..bbc733b 100644 --- a/parameters/reference/document-normalizer-task-settings/stage-assemble-logical-lines.md +++ b/parameters/reference/document-normalizer-task-settings/stage-assemble-logical-lines.md @@ -1,16 +1,26 @@ --- layout: default-layout -title: Assemble Logical Lines Stage - Dynamsoft Document Normalizer Parameters -description: The parameter defines Assemble Logical Lines Stage under the Document Detection Section. +title: AssembleLogicalLinesStage - Dynamsoft Document Normalizer Parameters +description: The AssembleLogicalLinesStage assembles long line segments based on certain criteria. keywords: Assemble Logical Lines Stage -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- -# Assemble Logical Lines Stage +# AssembleLogicalLinesStage -The `Assemble Logical Lines Stage` is designed at the stage level to assemble long line segments based on certain criteria to serve the assembly of quadrilateral corners. +`AssembleLogicalLinesStage` assembles long line segments based on certain criteria to serve the assembly of quadrilateral corners. In JSON, it is represented as a Stage object with `"Stage": "SST_ASSEMBLE_LOGICAL_LINES"`. + +## JSON Structure + +**Location in template:** +``` +DocumentNormalizerTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_ASSEMBLE_LOGICAL_LINES") +``` + +**Parent object:** [StageArray]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-document-detection.html#stagearray) within [DocumentDetectionSection]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-document-detection.html) + +**Example:** ```json { @@ -18,6 +28,21 @@ The `Assemble Logical Lines Stage` is designed at the stage level to assemble lo } ``` -## Stage +> [!NOTE] +> - This snippet shows a Stage object configured for assembling logical lines. +> - To use it, add this object to the `StageArray` within a [DocumentDetectionSection]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-document-detection.html). +> - 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) + +## Parameters + +### Stage + +Specifies the stage type. Fixed value: `SST_ASSEMBLE_LOGICAL_LINES`. -The stage is named `SST_ASSEMBLE_LOGICAL_LINES`. \ No newline at end of file +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_ASSEMBLE_LOGICAL_LINES"` | \ No newline at end of file diff --git a/parameters/reference/document-normalizer-task-settings/stage-assemble-long-lines.md b/parameters/reference/document-normalizer-task-settings/stage-assemble-long-lines.md index e429fbb..c5b334e 100644 --- a/parameters/reference/document-normalizer-task-settings/stage-assemble-long-lines.md +++ b/parameters/reference/document-normalizer-task-settings/stage-assemble-long-lines.md @@ -1,16 +1,26 @@ --- layout: default-layout -title: Assemble Long Lines Stage - Dynamsoft Document Normalizer Parameters -description: The parameter defines Assemble Long Lines Stage under the Document Detection Section. +title: AssembleLongLinesStage - Dynamsoft Document Normalizer Parameters +description: The AssembleLongLinesStage assembles relatively long line segments. keywords: Assemble Long Lines Stage -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- -# Assemble Long Lines Stage +# AssembleLongLinesStage -The `Assemble Long Lines Stage` is designed at the stage level to assemble relatively long line segments to facilitate the assembly of more advanced line segments. +`AssembleLongLinesStage` assembles relatively long line segments to facilitate the assembly of more advanced line segments. In JSON, it is represented as a Stage object with `"Stage": "SST_ASSEMBLE_LONG_LINES"`. + +## JSON Structure + +**Location in template:** +``` +DocumentNormalizerTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_ASSEMBLE_LONG_LINES") +``` + +**Parent object:** [StageArray]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-document-detection.html#stagearray) within [DocumentDetectionSection]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-document-detection.html) + +**Example:** ```json { @@ -18,6 +28,21 @@ The `Assemble Long Lines Stage` is designed at the stage level to assemble relat } ``` -## Stage +> [!NOTE] +> - This snippet shows a Stage object configured for assembling long lines. +> - To use it, add this object to the `StageArray` within a [DocumentDetectionSection]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-document-detection.html). +> - 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) + +## Parameters + +### Stage + +Specifies the stage type. Fixed value: `SST_ASSEMBLE_LONG_LINES`. -The stage is named `SST_ASSEMBLE_LONG_LINES`. \ No newline at end of file +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_ASSEMBLE_LONG_LINES"` | \ No newline at end of file diff --git a/parameters/reference/document-normalizer-task-settings/stage-deskew-image.md b/parameters/reference/document-normalizer-task-settings/stage-deskew-image.md index bb149b8..09b3a81 100644 --- a/parameters/reference/document-normalizer-task-settings/stage-deskew-image.md +++ b/parameters/reference/document-normalizer-task-settings/stage-deskew-image.md @@ -1,39 +1,61 @@ --- layout: default-layout -title: Deskew Image Stage - Dynamsoft Document Normalizer Parameters -description: The parameter defines Deskew Image Stage under the Document Deskewing Section. +title: DeskewImageStage - Dynamsoft Document Normalizer Parameters +description: The DeskewImageStage de-skews the quadrilateral to transform it into a rectangle. keywords: Deskew Image Stage -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- -# Deskew Image Stage +# DeskewImageStage -The `Deskew Image Stage` is designed at the stage level to de-skew the quadrilateral to transform it into a rectangle. +`DeskewImageStage` de-skews the quadrilateral to transform it into a rectangle. In JSON, it is represented as a Stage object with `"Stage": "SST_DESKEW_IMAGE"`. + +## JSON Structure + +**Location in template:** +``` +DocumentNormalizerTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_DESKEW_IMAGE") +``` + +**Parent object:** [StageArray]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-document-deskewing.html#stagearray) within [DocumentDeskewingSection]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-document-deskewing.html) + +**Example:** ```json { - "Stage": "SST_DESKEW_IMAGE", - "DeskewMode": { - "ContentDirection": 0, - "Mode": "DSM_PERSPECTIVE_CORRECTION" - }, - "PageSize": [ - -1, - -1 - ] + "Stage": "SST_DESKEW_IMAGE", + "DeskewMode": { + "ContentDirection": 0, + "Mode": "DSM_PERSPECTIVE_CORRECTION" + }, + "PageSize": [-1, -1] } ``` -## Stage +> [!NOTE] +> - This snippet shows a Stage object configured for deskewing images. +> - To use it, add this object to the `StageArray` within a [DocumentDeskewingSection]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-document-deskewing.html). +> - 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) + +## Parameters + +### Stage + +Specifies the stage type. Fixed value: `SST_DESKEW_IMAGE`. -The stage is named `SST_DESKEW_IMAGE`. +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_DESKEW_IMAGE"` | -## DeskewMode +### DeskewMode -Parameter [`DeskewMode`](./deskew-mode.md) specifies the method in which the deskew process way used to apply the deskew process on the target image. +Specifies the method in which the deskew process is applied to the target image. See [`DeskewMode`](deskew-mode.md) for details. -## PageSize +### PageSize -Parameter [`PageSize`](./page-size.md) sets the page size (width by height in pixels) of the image after deskew process. \ No newline at end of file +Sets the page size (width by height in pixels) of the image after deskew process. See [`PageSize`](page-size.md) for details. \ No newline at end of file diff --git a/parameters/reference/document-normalizer-task-settings/stage-detect-corners.md b/parameters/reference/document-normalizer-task-settings/stage-detect-corners.md index b178aa3..e0a827f 100644 --- a/parameters/reference/document-normalizer-task-settings/stage-detect-corners.md +++ b/parameters/reference/document-normalizer-task-settings/stage-detect-corners.md @@ -1,31 +1,56 @@ --- layout: default-layout -title: Detect Corners Stage - Dynamsoft Document Normalizer Parameters -description: The parameter defines Detect Corners Stage under the Document Detection Section. +title: DetectCornersStage - Dynamsoft Document Normalizer Parameters +description: The DetectCornersStage detects corners of quadrilaterals that meet the specified conditions. keywords: Detect Corners Stage -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- -# Detect Corners Stage +# DetectCornersStage -The `Detect Corners Stage` is designed at the stage level to detect corners of quadrilaterals that meet the specified conditions. +`DetectCornersStage` detects corners of quadrilaterals that meet the specified conditions. In JSON, it is represented as a Stage object with `"Stage": "SST_DETECT_CORNERS"`. + +## JSON Structure + +**Location in template:** +``` +DocumentNormalizerTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_DETECT_CORNERS") +``` + +**Parent object:** [StageArray]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-document-detection.html#stagearray) within [DocumentDetectionSection]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-document-detection.html) + +**Example:** ```json { "Stage": "SST_DETECT_CORNERS", - "CornerAngleRange": { - "MaxValue": 110, - "MinValue": 70 - } + "CornerAngleRange": { + "MaxValue": 110, + "MinValue": 70 + } } ``` -## Stage +> [!NOTE] +> - This snippet shows a Stage object configured for detecting corners. +> - To use it, add this object to the `StageArray` within a [DocumentDetectionSection]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-document-detection.html). +> - 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) + +## Parameters + +### Stage + +Specifies the stage type. Fixed value: `SST_DETECT_CORNERS`. -The stage is named `SST_DETECT_CORNERS`. +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_DETECT_CORNERS"` | -## CornerAngleRange +### CornerAngleRange -Parameter [`CornerAngleRange`](./corner-angle-range.md) specifies the range of angles (in degrees) of the extracted corners. The corners refer to the corners of a quad or document. \ No newline at end of file +Specifies the range of angles (in degrees) of the extracted corners. See [`CornerAngleRange`](corner-angle-range.md) for details. \ No newline at end of file diff --git a/parameters/reference/document-normalizer-task-settings/stage-detect-edges.md b/parameters/reference/document-normalizer-task-settings/stage-detect-edges.md index 48f54d7..48bc069 100644 --- a/parameters/reference/document-normalizer-task-settings/stage-detect-edges.md +++ b/parameters/reference/document-normalizer-task-settings/stage-detect-edges.md @@ -1,16 +1,26 @@ --- layout: default-layout -title: Detect Edges Stage - Dynamsoft Document Normalizer Parameters -description: The parameter defines Detect Edges Stage under the Document Detection Section. +title: DetectEdgesStage - Dynamsoft Document Normalizer Parameters +description: The DetectEdgesStage detects edges of quadrilaterals that meet the specified conditions. keywords: Detect Edges Stage -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- -# Detect Edges Stage +# DetectEdgesStage -The `Detect Edges Stage` is designed at the stage level to detect edges of quadrilaterals that meet the specified conditions. +`DetectEdgesStage` detects edges of quadrilaterals that meet the specified conditions. In JSON, it is represented as a Stage object with `"Stage": "SST_DETECT_EDGES"`. + +## JSON Structure + +**Location in template:** +``` +DocumentNormalizerTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_DETECT_EDGES") +``` + +**Parent object:** [StageArray]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-document-detection.html#stagearray) within [DocumentDetectionSection]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-document-detection.html) + +**Example:** ```json { @@ -18,6 +28,21 @@ The `Detect Edges Stage` is designed at the stage level to detect edges of quadr } ``` -## Stage +> [!NOTE] +> - This snippet shows a Stage object configured for detecting edges. +> - To use it, add this object to the `StageArray` within a [DocumentDetectionSection]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-document-detection.html). +> - 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) + +## Parameters + +### Stage + +Specifies the stage type. Fixed value: `SST_DETECT_EDGES`. -The stage is named `SST_DETECT_EDGES`. \ No newline at end of file +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_DETECT_EDGES"` | \ No newline at end of file diff --git a/parameters/reference/document-normalizer-task-settings/stage-detect-quads.md b/parameters/reference/document-normalizer-task-settings/stage-detect-quads.md index 37c459e..e3aba0a 100644 --- a/parameters/reference/document-normalizer-task-settings/stage-detect-quads.md +++ b/parameters/reference/document-normalizer-task-settings/stage-detect-quads.md @@ -1,32 +1,57 @@ --- layout: default-layout -title: Detect Quads Stage - Dynamsoft Document Normalizer Parameters -description: The parameter defines Detect Quads Stage under the Document Detection Section. +title: DetectQuadsStage - Dynamsoft Document Normalizer Parameters +description: The DetectQuadsStage detects complete quadrilaterals. keywords: Detect Quads Stage -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- -# Detect Quads Stage +# DetectQuadsStage -The `Detect Quads Stage` is designed at the stage level to detect complete quadrilaterals. +`DetectQuadsStage` detects complete quadrilaterals. In JSON, it is represented as a Stage object with `"Stage": "SST_DETECT_QUADS"`. + +## JSON Structure + +**Location in template:** +``` +DocumentNormalizerTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_DETECT_QUADS") +``` + +**Parent object:** [StageArray]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-document-detection.html#stagearray) within [DocumentDetectionSection]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-document-detection.html) + +**Example:** ```json { -"Stage": "SST_DETECT_QUADS", -"QuadrilateralDetectionModes": [ - { - "Mode": "QDM_GENERAL" - } -] + "Stage": "SST_DETECT_QUADS", + "QuadrilateralDetectionModes": [ + { + "Mode": "QDM_GENERAL" + } + ] } ``` -## Stage +> [!NOTE] +> - This snippet shows a Stage object configured for detecting quads. +> - To use it, add this object to the `StageArray` within a [DocumentDetectionSection]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-document-detection.html). +> - 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) + +## Parameters + +### Stage + +Specifies the stage type. Fixed value: `SST_DETECT_QUADS`. -The stage is named `SST_DETECT_QUADS`. +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_DETECT_QUADS"` | -## QuadrilateralDetectionModes +### QuadrilateralDetectionModes -Parameter [`QuadrilateralDetectionModes`](./quadrilateral-detection-modes.md) controls the quadrilateral detection process on an image. \ No newline at end of file +Controls the quadrilateral detection process on an image. See [`QuadrilateralDetectionModes`](quadrilateral-detection-modes.md) for details. \ No newline at end of file diff --git a/parameters/reference/document-normalizer-task-settings/stage-enhance-image.md b/parameters/reference/document-normalizer-task-settings/stage-enhance-image.md index 82f710c..09c1ff8 100644 --- a/parameters/reference/document-normalizer-task-settings/stage-enhance-image.md +++ b/parameters/reference/document-normalizer-task-settings/stage-enhance-image.md @@ -1,38 +1,63 @@ --- layout: default-layout -title: Enhance Image Stage - Dynamsoft Document Normalizer Parameters -description: The parameter defines Enhance Image Stage under the Image Enhancement Section. +title: EnhanceImageStage - Dynamsoft Document Normalizer Parameters +description: The EnhanceImageStage adjusts the image quality. keywords: Enhance Image Stage -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- -# Enhance Image Stage +# EnhanceImageStage -The `Enhance Image Stage` is designed at the stage level to adjust the image quality, such as changing the brightness, contrast, and the color mode of the image. +`EnhanceImageStage` adjusts the image quality, such as changing the brightness, contrast, and the color mode of the image. In JSON, it is represented as a Stage object with `"Stage": "SST_ENHANCE_IMAGE"`. + +## JSON Structure + +**Location in template:** +``` +DocumentNormalizerTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_ENHANCE_IMAGE") +``` + +**Parent object:** [StageArray]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-image-enhancement.html#stagearray) within [ImageEnhancementSection]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-image-enhancement.html) + +**Example:** ```json { "Stage": "SST_ENHANCE_IMAGE", - "ColourMode": "ICM_COLOUR", - "Brightness": 0, - "Contrast": 0 + "ColourMode": "ICM_COLOUR", + "Brightness": 0, + "Contrast": 0 } ``` -## Stage +> [!NOTE] +> - This snippet shows a Stage object configured for enhancing images. +> - To use it, add this object to the `StageArray` within an [ImageEnhancementSection]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-image-enhancement.html). +> - 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) + +## Parameters + +### Stage + +Specifies the stage type. Fixed value: `SST_ENHANCE_IMAGE`. -The stage is named `SST_ENHANCE_IMAGE`. +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_ENHANCE_IMAGE"` | -## ColourMode +### ColourMode -Parameter [`ColourMode`](./colour-mode.md) defines the output colour mode of the target image. +Defines the output colour mode of the target image. See [`ColourMode`](colour-mode.md) for details. -## Brightness +### Brightness -Parameter [`Brightness`](./brightness.md) defines the brightness of the target image. +Defines the brightness of the target image. See [`Brightness`](brightness.md) for details. -## Contrast +### Contrast -Parameter [`Contrast`](./contrast.md) specifies the contrast of the target image. \ No newline at end of file +Specifies the contrast of the target image. See [`Contrast`](contrast.md) for details. \ No newline at end of file diff --git a/parameters/reference/document-normalizer-task-settings/stage-predetect-regions.md b/parameters/reference/document-normalizer-task-settings/stage-predetect-regions.md index 4a3ad34..1ca55b2 100644 --- a/parameters/reference/document-normalizer-task-settings/stage-predetect-regions.md +++ b/parameters/reference/document-normalizer-task-settings/stage-predetect-regions.md @@ -1,28 +1,57 @@ --- layout: default-layout -title: Predetect Regions Stage - Dynamsoft Label Recognizer Parameters -description: The parameter defines Predetect Regions Stage under the Regions Predetection Section. +title: PredetectRegionsStage - Dynamsoft Document Normalizer Parameters +description: The PredetectRegionsStage identifies regions of interest (ROIs). keywords: Predetect Regions Stage -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- -# Predetect Regions Stage +# PredetectRegionsStage -The `Predetect Regions Stage` is designed at the stage level to identify regions of interest (ROIs). The pre-detected region may be identified based on color features, grayscale features, or neural network localization. +`PredetectRegionsStage` identifies regions of interest (ROIs). The pre-detected region may be identified based on color features, grayscale features, or neural network localization. In JSON, it is represented as a Stage object with `"Stage": "SST_PREDETECT_REGIONS"`. + +## JSON Structure + +**Location in template:** +``` +DocumentNormalizerTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_PREDETECT_REGIONS") +``` + +**Parent object:** [StageArray]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-regions-predetection.html#stagearray) within [RegionsPredetectionSection]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-regions-predetection.html) + +**Example:** ```json { "Stage": "SST_PREDETECT_REGIONS", - "RegionPredetectionModes": [] + "RegionPredetectionModes": [ + { + "Mode": "RPM_GENERAL" + } + ] } ``` -## Stage +> [!NOTE] +> - This snippet shows a Stage object configured for region predetection. +> - To use it, add this object to the `StageArray` within a [RegionsPredetectionSection]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-regions-predetection.html). +> - 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) + +## Parameters + +### Stage + +Specifies the stage type. Fixed value: `SST_PREDETECT_REGIONS`. -The stage is named `SST_PREDETECT_REGIONS`. +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_PREDETECT_REGIONS"` | -## RegionPredetectionModes +### RegionPredetectionModes -Parameter [`RegionPredetectionModes`](../image-parameter/region-predetection-modes.md) controls how to find a region of interest (ROI) within the image or frame. +Controls how to find a region of interest (ROI) within the image or frame. See [`RegionPredetectionModes`]({{ site.dcvb_parameters_reference }}image-parameter/region-predetection-modes.html) for details. diff --git a/parameters/reference/document-normalizer-task-settings/start-section.md b/parameters/reference/document-normalizer-task-settings/start-section.md deleted file mode 100644 index 42cc303..0000000 --- a/parameters/reference/document-normalizer-task-settings/start-section.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -layout: default-layout -title: StartSection - Dynamsoft Document Normalizer Parameters -description: The parameter StartSection defines the start section of the document normalizer algorithm task. -keywords: Start section -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true ---- - -# StartSection - -Parameter `StartSection` defines the start section of the `DocumentNormalizerTask`. - -## Example - -```json -{ - "StartSection": "ST_REGION_PREDETECTION" -} -``` - -## Parameter Summary - -| StartSection Parameter Summary | -| :---------------------------- | -| **Type**
    *String* | -| **Range**
    ST_REGION_PREDETECTION
    ST_DOCUMENT_DETECTION
    ST_DOCUMENT_NORMALIZATION | -| **Default Value**
    ST_REGION_PREDETECTION | diff --git a/parameters/reference/document-normalizer-task-settings/terminate-setting.md b/parameters/reference/document-normalizer-task-settings/terminate-setting.md deleted file mode 100644 index a4f79bf..0000000 --- a/parameters/reference/document-normalizer-task-settings/terminate-setting.md +++ /dev/null @@ -1,67 +0,0 @@ ---- -layout: default-layout -title: TerminateSetting - Dynamsoft Document Normalizer Parameters -description: The parameter TerminateSetting defines the terminate stages of the document normalizer task. -keywords: Terminate setting -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true ---- - -# TerminateSetting - -Parameter `TerminateSetting` defines the terminate stages of each section in the task. For each sections, you can define only one terminate stage. - -## Example - -```json -"TerminateSetting": -{ - "Section": "ST_REGION_PREDETECTION", - "Stage": "IRUT_GRAYSCALE_IMAGE" -} -``` - -## Parameter Summary - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    Child Parameter NameChild Parameter Summary
    Section
    Description
    Specifies a mode for ordering.
    Type
    String
    Range
    One of the following SectionType as a string. -
    ST_REGION_PREDETECTION -
    ST_DOCUMENT_DETECTION -
    ST_DOCUMENT_NORMALIZATION -
    Stage
    Description
    Specifies a mode for ordering.
    Type
    String
    Range
    One of the IntermediateResultUnitType as a string. The available stage type is different for each sections. View the appendix for more details. -
    - -## Appendix - Available Stage for Sections - -| Section | Available Stages | -| :------------------ | :--------------- | -| ST_REGION_PREDETECTION | IRUT_COLOUR_IMAGE
    IRUT_SCALED_DOWN_COLOUR_IMAGE
    IRUT_GRAYSCALE_IMAGE
    IRUT_TRANSFORMED_GRAYSCALE_IMAGE
    IRUT_PREDETECTED_REGIONS | -| ST_DOCUMENT_DETECTION | IRUT_COLOUR_IMAGE
    IRUT_SCALED_DOWN_COLOUR_IMAGE
    IRUT_GRAYSCALE_IMAGE
    IRUT_TRANSFORMED_GRAYSCALE_IMAGE
    IRUT_ENHANCED_GRAYSCALE_IMAGE
    IRUT_BINARY_IMAGE
    IRUT_TEXTURE_DETECTION_RESULT
    IRUT_TEXTURE_REMOVED_GRAYSCALE_IMAGE
    IRUT_TEXTURE_REMOVED_BINARY_IMAGE
    IRUT_TEXT_ZONES
    IRUT_TEXT_REMOVED_BINARY_IMAGE
    IRUT_CONTOURS
    IRUT_LINE_SEGMENTS
    IRUT_LONG_LINES
    IRUT_CORNERS
    IRUT_CANDIDATE_QUAD_EDGES
    IRUT_DETECTED_QUADS | -| ST_DOCUMENT_NORMALIZATION | IRUT_NORMALIZED_IMAGES | diff --git a/parameters/reference/image-parameter/applicable-stages.md b/parameters/reference/image-parameter/applicable-stages.md index 5c1f418..60fdb53 100644 --- a/parameters/reference/image-parameter/applicable-stages.md +++ b/parameters/reference/image-parameter/applicable-stages.md @@ -2,10 +2,7 @@ layout: default-layout title: ApplicableStages - Dynamsoft Capture Vision Parameters description: The parameter ApplicableStages of Dynamsoft Capture Vision is for configuring the applicable stages parameters. -keywords: Stages -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true +keywords: ApplicableStages --- @@ -13,41 +10,56 @@ noTitleIndex: true Defines the applicable stage parameters with an array of stage objects. Each applicable stage object contains the name of the stage and related parameters. +## JSON Structure + +**Location in template:** +``` +ImageParameterOptions[i] + └── ApplicableStages +``` + +**Parent object:** [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) + +**Example:** + ```json -"ApplicableStages":[ - { - "Stage":"SST_SCALE_IMAGE", - "ImageScaleSetting" : {} - }, - { - "Stage":"SST_CONVERT_TO_GRAYSCALE", - "ColourConversionModes" : [] - }, - { - "Stage":"SST_TRANSFORM_GRAYSCALE", - "GrayscaleTransformationModes" : [] - }, - { - "Stage":"SST_ENHANCE_GRAYSCALE", - "GrayscaleEnhancementModes" : [] - }, -] +{ + "ApplicableStages": [ + { + "Stage": "SST_SCALE_IMAGE", + "ImageScaleSetting": {} + }, + { + "Stage": "SST_CONVERT_TO_GRAYSCALE", + "ColourConversionModes": [] + } + ] +} ``` -## Stages +> [!NOTE] +> - This snippet shows only the `ApplicableStages` parameter. +> - To use it, embed this parameter within an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) 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 + +The `ImageParameter` includes the following stages: -| Applicable Name | Descriptions | +| Stage Name | Descriptions | | -------------- | ------------ | -| [`SST_ASSEMBLE_LINES`](stage-assemble-lines.md) | The stage that assembles short lines when processing documents. | -| [`SST_BINARIZE_IMAGE`](stage-binarize-image.md) | The stage that transfers a grayscale image into a binary image. | -| [`SST_BINARIZE_TEXTURE_REMOVED_GRAYSCALE`](stage-binarize-texture-removed-grayscale.md) | The stage that transfers a texture-removed grayscale image into a binary image. | -| [`SST_CONVERT_TO_GRAYSCALE`](stage-convert-to-grayscale.md) | The stage that converts a colour image to a grayscale image. | -| [`SST_DETECT_SHORTLINES`](stage-detect-shortlines.md) | The stage that detects short lines for document boundary detection. | -| [`SST_DETECT_TEXTURE`](stage-detect-texture.md) | The stage that detects texture on the image. | -| [`SST_DETECT_TEXT_ZONES`](stage-detect-text-zones.md) | The stage that detects text zones on the image. | -| [`SST_ENHANCE_GRAYSCALE`](stage-enhance-grayscale.md) | The stage that improves the quality of the grayscale image. | -| [`SST_FIND_CONTOURS`](stage-find-contours.md) | The stage that finds contours in the image. | -| [`SST_REMOVE_TEXTURE_FROM_GRAYSCALE`](stage-remove-texture-from-grayscale.md) | The stage that removes texture from the grayscale image. | -| [`SST_REMOVE_TEXT_ZONES_FROM_BINARY`](stage-remove-text-zones-from-binary.md) | The stage that removes text zones from the binary image. | -| [`SST_SCALE_IMAGE`](stage-scale-image.md) | The stage that down/up scales the image. | -| [`SST_TRANSFORM_GRAYSCALE`](stage-transform-grayscale.md) | The stage that transforms the grayscale image. | +| [AssembleLinesStage](stage-assemble-lines.md) (`SST_ASSEMBLE_LINES`) | The stage that assembles short lines when processing documents. | +| [BinarizeImageStage](stage-binarize-image.md) (`SST_BINARIZE_IMAGE`) | The stage that transfers a grayscale image into a binary image. | +| [BinarizeTextureRemovedGrayscaleStage](stage-binarize-texture-removed-grayscale.md) (`SST_BINARIZE_TEXTURE_REMOVED_GRAYSCALE`) | The stage that transfers a texture-removed grayscale image into a binary image. | +| [ConvertToGrayscaleStage](stage-convert-to-grayscale.md) (`SST_CONVERT_TO_GRAYSCALE`) | The stage that converts a colour image to a grayscale image. | +| [DetectShortLinesStage](stage-detect-shortlines.md) (`SST_DETECT_SHORTLINES`) | The stage that detects short lines for document boundary detection. | +| [DetectTextureStage](stage-detect-texture.md) (`SST_DETECT_TEXTURE`) | The stage that detects texture on the image. | +| [DetectTextZonesStage](stage-detect-text-zones.md) (`SST_DETECT_TEXT_ZONES`) | The stage that detects text zones on the image. | +| [EnhanceGrayscaleStage](stage-enhance-grayscale.md) (`SST_ENHANCE_GRAYSCALE`) | The stage that improves the quality of the grayscale image. | +| [FindContoursStage](stage-find-contours.md) (`SST_FIND_CONTOURS`) | The stage that finds contours in the image. | +| [RemoveTextureFromGrayscaleStage](stage-remove-texture-from-grayscale.md) (`SST_REMOVE_TEXTURE_FROM_GRAYSCALE`) | The stage that removes texture from the grayscale image. | +| [RemoveTextZonesFromBinaryStage](stage-remove-text-zones-from-binary.md) (`SST_REMOVE_TEXT_ZONES_FROM_BINARY`) | The stage that removes text zones from the binary image. | +| [ScaleImageStage](stage-scale-image.md) (`SST_SCALE_IMAGE`) | The stage that down/up scales the image. | +| [TransformGrayscaleStage](stage-transform-grayscale.md) (`SST_TRANSFORM_GRAYSCALE`) | The stage that transforms the grayscale image. | diff --git a/parameters/reference/image-parameter/base-image-parameter-name.md b/parameters/reference/image-parameter/base-image-parameter-name.md index c747ac9..97c1e91 100644 --- a/parameters/reference/image-parameter/base-image-parameter-name.md +++ b/parameters/reference/image-parameter/base-image-parameter-name.md @@ -1,31 +1,44 @@ --- layout: default-layout title: BaseImageParameterName - Dynamsoft Capture Vision Parameters -description: The parameter BaseImageParameterName of Dynamsoft Capture Vision is for Inheritancing parameters from a ImageParameter object. +description: The parameter BaseImageParameterName of Dynamsoft Capture Vision is for inheriting parameters from an ImageParameter object. keywords: BaseImageParameterName, parameter reference, parameter -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true -permalink: /parameters/reference/image-parameter/base-image-parameter-name.html --- # BaseImageParameterName Parameter `BaseImageParameterName` represents the name of another `ImageParameter` object. It is used to inherit the parameters defined in its parent `ImageParameter` object. If a parameter has already been defined in this object, the parameter with the same name will not be inherited from the parent object. -## Example +## JSON Structure + +**Location in template:** +``` +ImageParameterOptions[i] + └── BaseImageParameterName +``` + +**Parent object:** [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) + +**Example:** ```json { - "BaseImageParameterName": "IP_0" + "BaseImageParameterName": "ip_0" } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `BaseImageParameterName` parameter. +> - To use it, embed this parameter within an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) 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 -| BaseImageParameterName Parameter Summary | +| Parameter Details | | :---------------------------------- | -| **Description**
    Name of the ImageParameter object to inherit. | | **Type**
    *String* | -| **Value range**
    One of the ImageParameter name. | -| **Default Value**
    "" | +| **Value Range**
    One of the `ImageParameter` name. | +| **Default Value**
    `""` | +| **Remarks**
    The default value "" means this object don't inherit the settings of another object. | diff --git a/parameters/reference/image-parameter/binarization-modes.md b/parameters/reference/image-parameter/binarization-modes.md index 5f1f5fe..fbdb659 100644 --- a/parameters/reference/image-parameter/binarization-modes.md +++ b/parameters/reference/image-parameter/binarization-modes.md @@ -3,9 +3,6 @@ layout: default-layout title: BinarizationModes - Dynamsoft Capture Vision Parameters description: The parameter BinarizationModes of Dynamsoft Capture Vision is for controlling the process of image binarization. keywords: BinarizationModes, parameter reference, parameter -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true --- @@ -13,30 +10,41 @@ noTitleIndex: true Parameter `BinarizationModes` helps control the process of binarization, i.e., converting a grayscale image to a binary image. A better binary image greatly helps the following processes. During binarization, the threshold is the key criteria. If the pixel value is smaller than the threshold, it is set to 0, otherwise, it is set to a maximum value (255 in the library). By default, the library automatically calculates the adaptive size of the neighbourhood area and then binarizes the grayscale image with the adaptive threshold based on a small neighbourhood area with an adaptive size around it. `BinarizationModes` consists of one or more modes, each mode representing a different binarization process. -## Example +## JSON Structure + +**Location in template:** +``` +ImageParameterOptions[i] + └── ApplicableStages[j] (Stage object where Stage = "SST_BINARIZE_IMAGE" or "SST_BINARIZE_TEXTURE_REMOVED_GRAYSCALE") + └── BinarizationModes +``` + +**Parent object:** [BinarizeImageStage](stage-binarize-image.md) or [BinarizeTextureRemovedGrayscaleStage](stage-binarize-texture-removed-grayscale.md) + +**Example:** ```json { - "BinarizationModes" : - [ + "BinarizationModes": [ { - "BinarizationThreshold" : -1, - "BlockSizeX" : 0, - "BlockSizeY" : 0, - "EnableFillBinaryVacancy" : 1, - "GrayscaleEnhancementModesIndex" : -1, - "Mode" : "BM_LOCAL_BLOCK", - "MorphOperation" : "None", - "MorphOperationKernelSizeX" : 0, - "MorphOperationKernelSizeY" : 0, - "MorphShape" : "Rectangle", - "ThresholdCompensation" : 10 + "Mode": "BM_LOCAL_BLOCK", + "BlockSizeX": 0, + "BlockSizeY": 0, + "EnableFillBinaryVacancy": 1, + "ThresholdCompensation": 10 } ] } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `BinarizationModes` parameter. +> - To use it, embed this parameter within a Stage object (such as [BinarizeImageStage](stage-binarize-image.md)). +> - 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 `BinarizationModes` consist of a group of binarization mode objects. Each binarization mode object includes a candidate mode and a series of mode arguments. The available mode arguments of the binarization mode object is shown as follow. @@ -350,7 +358,7 @@ If the `BinarizationModes` is not configured in your template file, the followin } ``` -## Candidate Modes Introduction +## Candidate Mode Introductions ### BM_LOCAL_BLOCK diff --git a/parameters/reference/image-parameter/colour-conversion-modes.md b/parameters/reference/image-parameter/colour-conversion-modes.md index fd0f20e..3faa337 100644 --- a/parameters/reference/image-parameter/colour-conversion-modes.md +++ b/parameters/reference/image-parameter/colour-conversion-modes.md @@ -3,9 +3,6 @@ layout: default-layout title: ColourConversionModes - Dynamsoft Capture Vision Parameters description: The parameter ColourConversionModes of Dynamsoft Capture Vision is for controlling the converting of colour image to grayscale image. keywords: ColourConversionModes, parameter reference, parameter -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true --- @@ -13,7 +10,18 @@ noTitleIndex: true Parameter `ColourConversionModes` is a parameter for setting the mode for converting a colour image to a grayscale image. It consists of one or more `ColourConversionMode` items and each item has its own arguments. -## Example +## JSON Structure + +**Location in template:** +``` +ImageParameterOptions[i] + └── ApplicableStages[j] (Stage object where Stage = "SST_CONVERT_TO_GRAYSCALE") + └── ColourConversionModes +``` + +**Parent object:** [ConvertToGrayscaleStage](stage-convert-to-grayscale.md) + +**Example:** ```json { @@ -25,7 +33,14 @@ Parameter `ColourConversionModes` is a parameter for setting the mode for conver } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `ColourConversionModes` parameter. +> - To use it, embed this parameter within a [ConvertToGrayscaleStage](stage-convert-to-grayscale.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 `ColourConversionModes` consist of a group of colour conversion mode objects. Each colour conversion mode object includes a candidate mode and a series of mode arguments. The mode arguments of the colour conversion mode object is shown as follow: @@ -232,7 +247,7 @@ In document detection tasks, various ColuorConversionModes will be tried as much } ``` -## Candidate Modes Introduction +## Candidate Mode Introductions ### CICM_GENERAL diff --git a/parameters/reference/image-parameter/grayscale-enhancement-modes.md b/parameters/reference/image-parameter/grayscale-enhancement-modes.md index 432eb39..a0e4906 100644 --- a/parameters/reference/image-parameter/grayscale-enhancement-modes.md +++ b/parameters/reference/image-parameter/grayscale-enhancement-modes.md @@ -3,9 +3,6 @@ layout: default-layout title: GrayscaleEnhancementModes - Dynamsoft Capture Vision Parameters description: The parameter GrayscaleEnhancementModes of Dynamsoft Capture Vision is for enhancing the quality of grayscale image. keywords: GrayscaleEnhancementModes, parameter reference, parameter -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true --- @@ -13,32 +10,37 @@ noTitleIndex: true Parameter `GrayscaleEnhancementModes` provides some image processing methods to enhance the quality of the grayscale image. By default, the library does no image preprocessing. Assume your image has distorted features that can be solved by common image processing methods, this parameter can help you get a higher quality grayscale image by shifting the order of the preprocessing algorithms used (if at all). -## Example +## JSON Structure + +**Location in template:** +``` +ImageParameterOptions[i] + └── ApplicableStages[j] (Stage object where Stage = "SST_ENHANCE_GRAYSCALE") + └── GrayscaleEnhancementModes +``` + +**Parent object:** [EnhanceGrayscaleStage](stage-enhance-grayscale.md) + +**Example:** ```json { "GrayscaleEnhancementModes": [ { - "Mode": "GEM_GRAY_EQUALIZE", - "Sensitivity": 1 - }, - { - "Mode": "GEM_GRAY_SMOOTH", - "SmoothBlockSizeX": 5, - "SmoothBlockSizeY": 5 - }, - { - "Mode": "GEM_SHARPEN_SMOOTH", - "SmoothBlockSizeX": 5, - "SmoothBlockSizeY": 5, - "SharpenBlockSizeX": 5, - "SharpenBlockSizeY": 5 + "Mode": "GEM_GENERAL" } ] } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `GrayscaleEnhancementModes` parameter. +> - To use it, embed this parameter within an [EnhanceGrayscaleStage](stage-enhance-grayscale.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 `GrayscaleEnhancementModes` consist of a group of grayscale enhancement mode objects. Each grayscale enhancement mode object includes a candidate mode and a series of mode arguments. The mode arguments of the grayscale enhancement mode object is shown as follow: @@ -243,7 +245,7 @@ If the `GrayscaleEnhancementModes` is not configured in your template file, the } ``` -## Candidate Modes Introduction +## Candidate Mode Introductions ### GEM_GENERAL diff --git a/parameters/reference/image-parameter/grayscale-transformation-modes.md b/parameters/reference/image-parameter/grayscale-transformation-modes.md index 3c8ad24..3e0d4a2 100644 --- a/parameters/reference/image-parameter/grayscale-transformation-modes.md +++ b/parameters/reference/image-parameter/grayscale-transformation-modes.md @@ -3,9 +3,6 @@ layout: default-layout title: GrayscaleTransformationModes - Dynamsoft Capture Vision Parameters description: The parameter GrayscaleTransformationModes of Dynamsoft Capture Vision is for controlling the inversion of colors in grayscale image. keywords: GrayscaleTransformationModes, parameter reference, parameter -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true --- @@ -13,22 +10,37 @@ noTitleIndex: true Parameter `GrayscaleTransformationModes` are used to control whether or not to invert the color of the grayscale image. Generally, we think of the lighter colors as the background and the darker colors as the target in a grayscale image. However in a few cases it is opposite. -## Example +## JSON Structure + +**Location in template:** +``` +ImageParameterOptions[i] + └── ApplicableStages[j] (Stage object where Stage = "SST_TRANSFORM_GRAYSCALE") + └── GrayscaleTransformationModes +``` + +**Parent object:** [TransformGrayscaleStage](stage-transform-grayscale.md) + +**Example:** ```json { "GrayscaleTransformationModes": [ { "Mode": "GTM_ORIGINAL" - }, - { - "Mode": "GTM_INVERTED" } ] } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `GrayscaleTransformationModes` parameter. +> - To use it, embed this parameter within a [TransformGrayscaleStage](stage-transform-grayscale.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 ### Mode Arguments @@ -100,7 +112,7 @@ If the `GrayscaleTransformationModes` is not configured in your template file, t } ``` -## Candidate Modes Introduction +## Candidate Mode Introductions ### GTM_ORIGINAL diff --git a/parameters/reference/image-parameter/if-erase-text-zone.md b/parameters/reference/image-parameter/if-erase-text-zone.md index ba2287a..e164a04 100644 --- a/parameters/reference/image-parameter/if-erase-text-zone.md +++ b/parameters/reference/image-parameter/if-erase-text-zone.md @@ -3,9 +3,6 @@ layout: default-layout title: IfEraseTextZone - Dynamsoft Capture Vision Parameters description: The parameter IfEraseTextZone of Dynamsoft Capture Vision is for controlling whether to erase the detected text zone. keywords: IfEraseTextZone, parameter reference, parameter -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true --- @@ -21,9 +18,9 @@ Parameter `IfEraseTextZone` sets whether to erase the detected text zone. The de } ``` -## Parameter Summary +## Parameter Details -| IfEraseTextZone Parameter Summary | +| IfEraseTextZone Parameter Details | | :---------------------------------- | | **Description**
    0: Do not erase the text zone.
    1: Erase the text zone. | | **Type**
    *int* | diff --git a/parameters/reference/image-parameter/image-scale-settings.md b/parameters/reference/image-parameter/image-scale-settings.md index 1d09577..431ab2f 100644 --- a/parameters/reference/image-parameter/image-scale-settings.md +++ b/parameters/reference/image-parameter/image-scale-settings.md @@ -3,45 +3,67 @@ layout: default-layout title: ImageScaleSetting - Dynamsoft Capture Vision Parameters description: The parameter ImageScaleSetting of Dynamsoft Capture Vision is for controlling how to up or down scale the image. keywords: scale-up, scale down, parameter reference, parameter -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true --- # ImageScaleSetting Parameter `ImageScaleSetting` is for controlling how to up or down scale the image. +## JSON Structure + +**Location in template:** +``` +ImageParameterOptions[i] + └── ApplicableStages[j] (Stage object where Stage = "SST_SCALE_IMAGE") + └── ImageScaleSetting +``` + +**Parent object:** [ScaleImageStage](stage-scale-image.md) + +**Example:** + ```json -"ImageScaleSetting": { - "ScaleType": "ST_SCALE_DOWN", - "ReferenceEdge": "RE_SHORTER_EDGE", - "EdgeLengthThreshold": 2300 + "ImageScaleSetting": { + "ScaleType": "ST_SCALE_DOWN", + "ReferenceEdge": "RE_SHORTER_EDGE", + "EdgeLengthThreshold": 2300 + } } ``` -## ScaleType +> [!NOTE] +> - This snippet shows only the `ImageScaleSetting` parameter. +> - To use it, embed this parameter within a [ScaleImageStage](stage-scale-image.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 + +The `ImageScaleSetting` object includes the following parameters: + +### ScaleType Specifies whether to scale up or down the image. | ScaleType Parameter Details | | :-------------------------- | | **Type**
    *String* | -| **Value range**
    "ST_SCALE_DOWN", "ST_SCALE_UP" | +| **Value Range**
    "ST_SCALE_DOWN", "ST_SCALE_UP" | | **Default Value**
    "ST_SCALE_DOWN" | -## ReferenceEdge +### ReferenceEdge Specifies which edge (longer edge or shorter edge) to use when scaling the image. | ReferenceEdge Parameter Details | | :------------------------------ | | **Type**
    *String* | -| **Value range**
    "RE_SHORTER_EDGE", "RE_LONGER_EDGE" | +| **Value Range**
    "RE_SHORTER_EDGE", "RE_LONGER_EDGE" | | **Default Value**
    "RE_SHORTER_EDGE" | -## EdgeLengthThreshold +### EdgeLengthThreshold Specifies the threshold for scaling the image. @@ -51,5 +73,5 @@ Specifies the threshold for scaling the image. | EdgeLengthThreshold Parameter Details | | :----------------------------------- | | **Type**
    *int* | -| **Value range**
    [512, 0x7fffffff] | +| **Value Range**
    [512, 0x7fffffff] | | **Default Value**
    2300 | diff --git a/parameters/reference/image-parameter/index.md b/parameters/reference/image-parameter/index.md deleted file mode 100644 index 1592a0f..0000000 --- a/parameters/reference/image-parameter/index.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -layout: default-layout -title: Index - ImageParameter Parameters -description: The index of ImageParameter parameters. -keywords: ImageParameter, parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true ---- - -# ImageParameter Parameters - -| Parameter Name | Description | -| ---------------------------------- | ----------- | -| [`BaseImageParameterName`](base-image-parameter-name.md) | Represents the name of another `ImageParameter` object to inherit from. | -| [`Name`](name.md) | Defines the name of a `ImageParameter` object, which serves as its unique identifier. | -| [`ApplicableStages`](applicable-stages.md) | Defines the applicable stage parameters with an array of stage objects. | diff --git a/parameters/reference/image-parameter/line-assembly-mode.md b/parameters/reference/image-parameter/line-assembly-mode.md index c352fc4..9a304d6 100644 --- a/parameters/reference/image-parameter/line-assembly-mode.md +++ b/parameters/reference/image-parameter/line-assembly-mode.md @@ -3,9 +3,6 @@ layout: default-layout title: LineAssemblyMode - Dynamsoft Capture Vision Parameters description: The parameter LineAssemblyMode of Dynamsoft Capture Vision is for controlling how to assemble the lines. keywords: LineAssemblyMode, assemble lines, parameter reference, parameter -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true --- @@ -13,64 +10,56 @@ noTitleIndex: true Parameter `LineAssemblyMode` is for controlling how to assemble the lines. -## Example +## JSON Structure + +**Location in template:** +``` +ImageParameterOptions[i] + └── ApplicableStages[j] (Stage object where Stage = "SST_ASSEMBLE_LINES") + └── LineAssemblyMode +``` + +**Parent object:** [AssembleLinesStage](stage-assemble-lines.md) + +**Example:** ```json { "LineAssemblyMode": { - "Mode": "LAM_GENERAL", + "Mode": "LAM_GENERAL", "Sensitivity": 3 } } ``` -### Mode Arguments - -Each `LineAssemblyMode` object consists a candidate mode name and a series of other mode arguments. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    Mode Argument NameMode Argument Summary
    Mode
    (Required)
    Description
    Any one in Candidate Mode List as string -
    Type
    String -
    Candidate Mode List
    "LAM_GENERAL" -
    Default Value
    -
    "LAM_GENERAL" -
    Sensitivity
    (Optional)
    Description
    The sensitivity level used for line assembling. -
    Type
    int -
    Range
    [1, 9] -
    Default Value
    3 for BarcodeReader Task.
    6 for DocumentNormalizer Task -
    Valid For
    "LAM_GENERAL" -
    +> [!NOTE] +> - This snippet shows only the `LineAssemblyMode` parameter. +> - To use it, embed this parameter within an [AssembleLinesStage](stage-assemble-lines.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 + +The `LineAssemblyMode` object includes the following parameters: + +### Mode + +Specifies the line assembly mode to use. + +| Mode Parameter Details | +| :--------------------- | +| **Type**
    *String* | +| **Value Range**
    "LAM_GENERAL" | +| **Default Value**
    "LAM_GENERAL" | + +### Sensitivity + +Specifies the sensitivity level used for line assembling. A higher value means the algorithm will be more sensitive when detecting and assembling lines. + +| Sensitivity Parameter Details | +| :---------------------------- | +| **Type**
    *int* | +| **Value Range**
    [1, 9] | +| **Default Value**
    3 for BarcodeReader Task
    6 for DocumentNormalizer Task | +| **Valid For**
    "LAM_GENERAL" | diff --git a/parameters/reference/image-parameter/name.md b/parameters/reference/image-parameter/name.md index 348b326..6a0a461 100644 --- a/parameters/reference/image-parameter/name.md +++ b/parameters/reference/image-parameter/name.md @@ -3,27 +3,42 @@ layout: default-layout title: Name - Dynamsoft Capture Vision Parameter Reference ImageParameter Object. description: The parameter Name defines the unique identifier of ImageParameter object. keywords: top-level object, name, unique identifier -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- # Name Parameter `Name` represents the name of a `ImageParameter` object, which serves as its unique identifier. -## Example +## JSON Structure + +**Location in template:** +``` +ImageParameterOptions[i] + └── Name +``` + +**Parent object:** [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) + +**Example:** ```json { - "Name" : "ip_0" + "Name": "ip_0" } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `Name` parameter. +> - To use it, embed this parameter within an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) 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 Details | | :----------------------------------- | | **Type**
    *String* | -| **Default Value**
    It must be a mandatory setting value. | +| **Required**
    Yes | +| **Default Value**
    N/A | | **Remarks**
    It must be a unique name. | diff --git a/parameters/reference/image-parameter/region-predetection-modes.md b/parameters/reference/image-parameter/region-predetection-modes.md index 927b87c..f9f945f 100644 --- a/parameters/reference/image-parameter/region-predetection-modes.md +++ b/parameters/reference/image-parameter/region-predetection-modes.md @@ -1,11 +1,8 @@ --- layout: default-layout -title: RegionPredetectionModes * Dynamsoft Capture Vision Parameters +title: RegionPredetectionModes - Dynamsoft Capture Vision Parameters description: The parameter RegionPredetectionModes of Dynamsoft Capture Vision is for detecting the region of interest(s) automatically. keywords: RegionPredetectionModes, parameter reference, parameter -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true --- @@ -13,6 +10,23 @@ noTitleIndex: true Parameter `RegionPredetectionModes` controls how to find a region of interest (ROI) within the image or frame. +## JSON Structure + +**Location in template:** +``` +BarcodeReaderTaskSettingOptions[i] / DocumentNormalizerTaskSettingOptions[i] / LabelRecognizerTaskSettingOptions[i] + └── SectionArray[j] (Section object where Section = "ST_REGION_PREDETECTION") + └── StageArray[k] (Stage object where Stage = "SST_PREDETECT_REGIONS") + └── RegionPredetectionModes +``` + +**Parent object:** +- [PredetectRegionsStage]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/stage-predetect-regions.html) object within [RegionPredetectionSection]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/section-region-predetection.html) of `BarcodeReaderTaskSettingOptions` +- [PredetectRegionsStage]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/stage-predetect-regions.html) object within [RegionPredetectionSection]({{ site.dcvb_parameters_reference }}document-normalizer-task-settings/section-regions-predetection.html) of `DocumentNormalizerTaskSettingOptions` +- [PredetectRegionsStage]({{ site.dcvb_parameters_reference }}label-recognizer-task-settings/stage-predetect-regions.html) object within [RegionPredetectionSection]({{ site.dcvb_parameters_reference }}label-recognizer-task-settings/section-regions-predetection.html) of `LabelRecognizerTaskSettingOptions` + +**Example:** + ```json { "RegionPredetectionModes": [ @@ -20,24 +34,23 @@ Parameter `RegionPredetectionModes` controls how to find a region of interest (R "Mode": "RPM_GENERAL_GRAY_CONTRAST", "Sensitivity": 5 }, - { - "Mode": "RPM_GENERAL_RGB_CONTRAST", - "Sensitivity": 5 - }, { "Mode": "RPM_GENERAL_HSV_CONTRAST", "ForeAndBackgroundColours":"[20,170,10]", "WidthRange": "[100, 200]" - }, - { - "Mode": "RPM_NEURAL_NETWORK", - "DetectionModelName": "" - } + } ] } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `RegionPredetectionModes` parameter. +> - To use it, embed this parameter within a Stage object in the `RegionPredetectionSection`. +> - 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 ### Mode Arguments @@ -340,7 +353,7 @@ The default settings of RegionPredetectionModes is: } ``` -## Candidate Modes Introduction +## Candidate Mode Introductions ### RPM_SKIP diff --git a/parameters/reference/image-parameter/scale-down-threshold.md b/parameters/reference/image-parameter/scale-down-threshold.md deleted file mode 100644 index 6536452..0000000 --- a/parameters/reference/image-parameter/scale-down-threshold.md +++ /dev/null @@ -1,33 +0,0 @@ ---- -layout: default-layout -title: ScaleDownThreshold - Dynamsoft Capture Vision Parameters -description: The parameter ScaleDownThreshold of Dynamsoft Capture Vision is for defining the threshold for image shrinking. -keywords: ScaleDownThreshold, parameter reference, parameter -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true ---- - - -# ScaleDownThreshold - -Parameter `ScaleDownThreshold` defines the threshold for image shrinking. - -## Example - -```json -{ - "ScaleDownThreshold": 1024 -} -``` - -## Parameter Summary - -When the input image is too large, this parameter ScaleDownThreshold can be used to reduce the size. - -| ScaleDownThreshold Parameter Summary | -| :---------------------------------- | -| **Description**
    If the shorter edge size is larger than the given value, the library will calculate the required height and width of the barcode image and shrink the image to that size before going to further processes. Otherwise, it will perform processes on the original image. | -| **Type**
    *int* | -| **Value range**
    [512, 0x7fffffff] | -| **Default Value**
    2300 | diff --git a/parameters/reference/image-parameter/scale-up-modes.md b/parameters/reference/image-parameter/scale-up-modes.md deleted file mode 100644 index a4117c2..0000000 --- a/parameters/reference/image-parameter/scale-up-modes.md +++ /dev/null @@ -1,290 +0,0 @@ ---- -layout: default-layout -title: ScaleUpModes - Dynamsoft Capture Vision Parameters -description: The parameter ScaleUpModes of Dynamsoft Capture Vision is for controlling the scale-up process when targets are too small in the image. -keywords: ScaleUpModes, parameter reference, parameter -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true ---- - - -# ScaleUpModes - -Parameter `ScaleUpModes` is for controlling the scale-up process when targets in the image are too small. - -## Example - -```json -{ - "ScaleUpModes": - [ - { - "Mode": "SUM_LINEAR_INTERPOLATION", - "ModuleSizeThreshold": 4, - "TargetModuleSize": 8 - }, - { - "Mode": "SUM_NEAREST_NEIGHBOUR_INTERPOLATION", - "ModuleSizeThreshold": 4, - "TargetModuleSize": 6 - }, - { - "Mode": "SUM_LINEAR_INTERPOLATION", - "LetterHeightThreshold": 10, - "TargetLetterHeight": 50 - } - ] -} -``` - -## Parameter Summary - -Parameter `ScaleUpModes` consist of a group of scale up mode objects. Each scale up mode object includes a candidate mode and a series of mode arguments. The mode arguments of the scale up mode object is shown as follow: - -### Mode Arguments - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    Mode Argument NameMode Argument Summary
    Mode
    (Required)
    Description
    Any one in Candidate Mode List as string -
    Type
    String -
    Candidate Mode List
    SUM_LINEAR_INTERPOLATION -
    SUM_NEAREST_NEIGHBOUR_INTERPOLATION -
    SUM_AUTO -
    SUM_SKIP -
    Default Value
    -
    SUM_AUTO -
    AcuteAngleWithXThreshold
    (Optional)
    Description
    Sets the acute angle threshold for barcode scale-up. -
    -1: means automatically set by the library. -
    If the module size of the barcode is smaller than the ModuleSizeThreshold and the acute angle with X of the barcode is larger than the AcuteAngleWithXThreshold, the barcode will be enlarged by a scale factor of N (the value of N is a power of 2) till N * modulesize >= TargetModuleSize. -
    Type
    int -
    Range
    [-1, 90] -
    Default Value
    -1 -
    Valid For
    -
    SUM_LINEAR_INTERPOLATION -
    SUM_NEAREST_NEIGHBOUR_INTERPOLATION -
    ModuleSizeThreshold
    (Optional)
    Description
    Sets the module size threshold for barcode scale-up. -
    0: means automatically set by the library. -
    If the module size of the barcode is smaller than the ModuleSizeThreshold and the acute angle with X of the barcode is larger than the AcuteAngleWithXThreshold, the barcode will be enlarged by a scale factor of N (the value of N is a power of 2) till N * modulesize >= TargetModuleSize. -
    Type
    int -
    Range
    [1, 0x7fffffff] -
    Default Value
    0 -
    Valid For
    -
    SUM_LINEAR_INTERPOLATION -
    SUM_NEAREST_NEIGHBOUR_INTERPOLATION -
    TargetModuleSize
    (Optional)
    Description
    Sets the module size threshold for barcode scale-up. -
    0: means automatically set by the library. -
    If the module size of the barcode is smaller than the ModuleSizeThreshold and the acute angle with X of the barcode is larger than the AcuteAngleWithXThreshold, the barcode will be enlarged by a scale factor of N (the value of N is a power of 2) till N * modulesize >= TargetModuleSize. -
    Type
    int -
    Range
    [0, 0x7fffffff] -
    Default Value
    0 -
    Valid For
    -
    SUM_LINEAR_INTERPOLATION -
    SUM_NEAREST_NEIGHBOUR_INTERPOLATION -
    LetterHeightThreshold
    (Optional)
    Description
    Sets the letter height threshold for character scale-up. -
    0 : means automatically set by the library. If the average letter height of a text line is smaller than the LetterHeightThreshold, the image will be enlarged to N times (N=2,4,8…) till N * LetterHeight >= TargetLetterHeight. -
    Type
    int -
    Range
    [0, 0x7fffffff] -
    Default Value
    0 -
    Valid For
    -
    SUM_LINEAR_INTERPOLATION -
    SUM_NEAREST_NEIGHBOUR_INTERPOLATION -
    TargetLetterHeight
    (Optional)
    Description
    Sets the target letter height for character scale-up. -
    0 : means automatically set by the library. -
    Type
    int -
    Range
    [0, 0x7fffffff] -
    Default Value
    0 -
    Valid For
    -
    SUM_LINEAR_INTERPOLATION -
    SUM_NEAREST_NEIGHBOUR_INTERPOLATION -
    LibraryFileName
    (Optional)
    Description
    Sets the file name of the library to load dynamically. -
    Type
    String -
    Range
    A string value representing file name. -
    Default Value
    "" -
    Valid For
    All modes. -
    LibraryParameters
    (Optional)
    Description
    The library must be in the same place with Dynamsoft Barcode Reader Library. -
    Type
    String -
    Range
    A string value representing parameters. -
    Default Value
    "" -
    Valid For
    All modes. -
    - -### Default Setting - -If the `ScaleUpModes` is not configured in your template file, the following setting will be used as the default setting. - -```json -{ - "ScaleUpModes" : - [ - { - "AcuteAngleWithXThreshold" : -1, - "LetterHeightThreshold" : 0, - "Mode" : "SUM_AUTO", - "ModuleSizeThreshold" : 0, - "TargetLetterHeight" : 0, - "TargetModuleSize" : 0 - } - ] -} -``` - -## Candidate Modes Introduction - -### SUM_LINEAR_INTERPOLATION - -Scales up using the linear interpolation method. This mode has the following arguments for further customizing: - -- AcuteAngleWithXThreshold -- ModuleSizeThreshold -- TargetModuleSize -- LetterHeightThreshold -- TargetLetterHeight -- LibraryFileName -- LibraryParameters - -### SUM_NEAREST_NEIGHBOUR_INTERPOLATION - -Scales up using the nearest neighbour method. This mode has the following arguments for further customizing: - -- AcuteAngleWithXThreshold -- ModuleSizeThreshold -- TargetModuleSize -- LetterHeightThreshold -- TargetLetterHeight -- LibraryFileName -- LibraryParameters - -### SUM_AUTO - -Lets the library choose a mode automatically. diff --git a/parameters/reference/image-parameter/shortline-detection-mode.md b/parameters/reference/image-parameter/shortline-detection-mode.md index 62f791e..5fcdeb7 100644 --- a/parameters/reference/image-parameter/shortline-detection-mode.md +++ b/parameters/reference/image-parameter/shortline-detection-mode.md @@ -3,9 +3,6 @@ layout: default-layout title: ShortlineDetectionMode - Dynamsoft Capture Vision Parameters description: The parameter ShortlineDetectionMode of Dynamsoft Capture Vision is for controlling how to detect the shortlines. keywords: ShortlineDetectionMode, short lines, parameter reference, parameter -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true --- @@ -13,64 +10,56 @@ noTitleIndex: true Parameter `ShortlineDetectionMode` is for controlling how to detect the shortlines. -## Example +## JSON Structure + +**Location in template:** +``` +ImageParameterOptions[i] + └── ApplicableStages[j] (Stage object where Stage = "SST_DETECT_SHORTLINES") + └── ShortlineDetectionMode +``` + +**Parent object:** [DetectShortLinesStage](stage-detect-shortlines.md) + +**Example:** ```json { "ShortlineDetectionMode": { - "Mode": "SDM_GENERAL", + "Mode": "SDM_GENERAL", "Sensitivity": 3 } } ``` -### Mode Arguments - -Each `ShortlineDetectionMode` object consists a candidate mode name and a series of other mode arguments. - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    Mode Argument NameMode Argument Summary
    Mode
    (Required)
    Description
    Any one in Candidate Mode List as string -
    Type
    String -
    Candidate Mode List
    "SDM_GENERAL" -
    Default Value
    -
    "SDM_GENERAL" -
    Sensitivity
    (Optional)
    Description
    The sensitivity level used for short line detection. -
    Type
    int -
    Range
    [1, 9] -
    Default Value
    3 for BarcodeReader Task.
    6 for DocumentNormalizer Task -
    Valid For
    "SDM_GENERAL" -
    +> [!NOTE] +> - This snippet shows only the `ShortlineDetectionMode` parameter. +> - To use it, embed this parameter within a [DetectShortLinesStage](stage-detect-shortlines.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 + +The `ShortlineDetectionMode` object includes the following parameters: + +### Mode + +Specifies the shortline detection mode to use. + +| Mode Parameter Details | +| :--------------------- | +| **Type**
    *String* | +| **Value Range**
    "SDM_GENERAL" | +| **Default Value**
    "SDM_GENERAL" | + +### Sensitivity + +Specifies the sensitivity level used for shortline detection. A higher value means the algorithm will be more sensitive when detecting short lines. + +| Sensitivity Parameter Details | +| :---------------------------- | +| **Type**
    *int* | +| **Value Range**
    [1, 9] | +| **Default Value**
    3 for BarcodeReader Task
    6 for DocumentNormalizer Task | +| **Valid For**
    "SDM_GENERAL" | diff --git a/parameters/reference/image-parameter/stage-assemble-lines.md b/parameters/reference/image-parameter/stage-assemble-lines.md index adfd6b9..2f35e13 100644 --- a/parameters/reference/image-parameter/stage-assemble-lines.md +++ b/parameters/reference/image-parameter/stage-assemble-lines.md @@ -1,32 +1,54 @@ --- layout: default-layout -title: Assemble Lines Stage Parameters - Dynamsoft Capture Vision Parameters -description: The parameters that available under assemble lines stage of Dynamsoft Capture Vision. -keywords: Stages, assemble lines, LineAssemblyMode, line assembly mode -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true +title: AssembleLinesStage - Dynamsoft Capture Vision Parameters +description: The AssembleLinesStage assembles short lines when processing documents. +keywords: Assemble Lines Stage --- -# Assemble Lines Stage Parameters +# AssembleLinesStage -The parameters that available under the assemble lines stage. +`AssembleLinesStage` assembles short lines when processing documents. In JSON, it is represented as a Stage object with `"Stage": "SST_ASSEMBLE_LINES"`. + +## JSON Structure + +**Location in template:** +``` +ImageParameterOptions[i] + └── ApplicableStages[j] (Stage object where Stage = "SST_ASSEMBLE_LINES") +``` + +**Parent object:** [ApplicableStages]({{ site.dcvb_parameters_reference }}image-parameter/applicable-stages.html) within [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) + +**Example:** ```json { "Stage": "SST_ASSEMBLE_LINES", - "LineAssemblyMode": {} -}, + "LineAssemblyMode": { + "Mode": "LAM_GENERAL" + } +} ``` -## Stage +> [!NOTE] +> - This snippet shows a Stage object configured for assembling lines. +> - To use it, add this object to the `ApplicableStages` array within an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html). +> - 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) + +## Parameters + +### Stage -The stage name of assemble lines stage is `SST_ASSEMBLE_LINES`. +Specifies the stage type. Fixed value: `SST_ASSEMBLE_LINES`. -## LineAssemblyMode +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_ASSEMBLE_LINES"` | -Defines how to assemble lines. +### LineAssemblyMode -| Stage Parameter Summary | -| :---------------------- | -| **Type**
    A *[LineAssemblyMode](line-assembly-mode.md)* Object | +Defines how to assemble lines. See [`LineAssemblyMode`](line-assembly-mode.md) for details. diff --git a/parameters/reference/image-parameter/stage-binarize-image.md b/parameters/reference/image-parameter/stage-binarize-image.md index 5f17e6e..d2744a4 100644 --- a/parameters/reference/image-parameter/stage-binarize-image.md +++ b/parameters/reference/image-parameter/stage-binarize-image.md @@ -1,32 +1,56 @@ --- layout: default-layout -title: Binarize Image Stage Parameters - Dynamsoft Capture Vision Parameters -description: The parameters that available under binarize image stage of Dynamsoft Capture Vision. -keywords: Stages, binarize image, binarization modes, BinarizationMode -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true +title: BinarizeImageStage - Dynamsoft Capture Vision Parameters +description: The BinarizeImageStage transfers a grayscale image into a binary image. +keywords: Binarize Image Stage --- -# Binarize Image Stage Parameters +# BinarizeImageStage -The parameters that available under the Binarize Image Stage. +`BinarizeImageStage` transfers a grayscale image into a binary image. In JSON, it is represented as a Stage object with `"Stage": "SST_BINARIZE_IMAGE"`. + +## JSON Structure + +**Location in template:** +``` +ImageParameterOptions[i] + └── ApplicableStages[j] (Stage object where Stage = "SST_BINARIZE_IMAGE") +``` + +**Parent object:** [ApplicableStages]({{ site.dcvb_parameters_reference }}image-parameter/applicable-stages.html) within [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) + +**Example:** ```json { - "Stage":"SST_BINARIZE_IMAGE", - "BinarizationModes" : [] + "Stage": "SST_BINARIZE_IMAGE", + "BinarizationModes": [ + { + "Mode": "BM_LOCAL_BLOCK" + } + ] } ``` -## Stage +> [!NOTE] +> - This snippet shows a Stage object configured for binarizing images. +> - To use it, add this object to the `ApplicableStages` array within an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html). +> - 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) + +## Parameters + +### Stage -The stage name of binarize image stage is `SST_BINARIZE_IMAGE`. +Specifies the stage type. Fixed value: `SST_BINARIZE_IMAGE`. -## BinarizationModes +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_BINARIZE_IMAGE"` | -Defines the binarization options with an array of [`BinarizationMode`](binarization-modes.md) objects. The modes in the array will be executed sequentially until the task is completed. +### BinarizationModes -| Stage Parameter Summary | -| :---------------------- | -| **Type**
    An array of [`BinarizationMode`](binarization-modes.md) objects | +Defines the binarization options. See [`BinarizationModes`](binarization-modes.md) for details. diff --git a/parameters/reference/image-parameter/stage-binarize-texture-removed-grayscale.md b/parameters/reference/image-parameter/stage-binarize-texture-removed-grayscale.md index da1c9f3..6a8e141 100644 --- a/parameters/reference/image-parameter/stage-binarize-texture-removed-grayscale.md +++ b/parameters/reference/image-parameter/stage-binarize-texture-removed-grayscale.md @@ -1,32 +1,56 @@ --- layout: default-layout -title: Binarize texture removed grayscale image Stage Parameters - Dynamsoft Capture Vision Parameters -description: The parameters that available under binarize texture removed grayscale image stage of Dynamsoft Capture Vision. -keywords: Stages, binarize texture removed grayscale image -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true +title: BinarizeTextureRemovedGrayscaleStage - Dynamsoft Capture Vision Parameters +description: The BinarizeTextureRemovedGrayscaleStage transfers a texture-removed grayscale image into a binary image. +keywords: Binarize Texture Removed Grayscale Stage --- -# Binarize texture removed grayscale image Stage Parameters +# BinarizeTextureRemovedGrayscaleStage -The parameters that available under the Binarize texture removed grayscale image Stage. +`BinarizeTextureRemovedGrayscaleStage` transfers a texture-removed grayscale image into a binary image. In JSON, it is represented as a Stage object with `"Stage": "SST_BINARIZE_TEXTURE_REMOVED_GRAYSCALE"`. + +## JSON Structure + +**Location in template:** +``` +ImageParameterOptions[i] + └── ApplicableStages[j] (Stage object where Stage = "SST_BINARIZE_TEXTURE_REMOVED_GRAYSCALE") +``` + +**Parent object:** [ApplicableStages]({{ site.dcvb_parameters_reference }}image-parameter/applicable-stages.html) within [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) + +**Example:** ```json { - "Stage":"SST_BINARIZE_TEXTURE_REMOVED_GRAYSCALE", - "BinarizationModes" : [] -}, + "Stage": "SST_BINARIZE_TEXTURE_REMOVED_GRAYSCALE", + "BinarizationModes": [ + { + "Mode": "BM_LOCAL_BLOCK" + } + ] +} ``` -## Stage +> [!NOTE] +> - This snippet shows a Stage object configured for binarizing texture-removed grayscale images. +> - To use it, add this object to the `ApplicableStages` array within an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html). +> - 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) + +## Parameters + +### Stage -The stage name of binarize texture removed grayscale image stage is `SST_BINARIZE_TEXTURE_REMOVED_GRAYSCALE`. +Specifies the stage type. Fixed value: `SST_BINARIZE_TEXTURE_REMOVED_GRAYSCALE`. -## BinarizationModes +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_BINARIZE_TEXTURE_REMOVED_GRAYSCALE"` | -Defines the binarization options with an array of [`BinarizationMode`](binarization-modes.md) objects. The modes in the array will be executed sequentially until the task is completed. +### BinarizationModes -| Stage Parameter Summary | -| :---------------------- | -| **Type**
    An array of [`BinarizationMode`](binarization-modes.md) objects | +Defines the binarization options. See [`BinarizationModes`](binarization-modes.md) for details. diff --git a/parameters/reference/image-parameter/stage-convert-to-grayscale.md b/parameters/reference/image-parameter/stage-convert-to-grayscale.md index 2e6338f..8ea5ac5 100644 --- a/parameters/reference/image-parameter/stage-convert-to-grayscale.md +++ b/parameters/reference/image-parameter/stage-convert-to-grayscale.md @@ -1,32 +1,56 @@ --- layout: default-layout -title: Convert to Grayscale Stage Parameters - Dynamsoft Capture Vision Parameters -description: The parameters that available under convert to grayscale stage of Dynamsoft Capture Vision. -keywords: Stages, convert to grayscale, ColourConversionModes, colour conversion modes -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true +title: ConvertToGrayscaleStage - Dynamsoft Capture Vision Parameters +description: The ConvertToGrayscaleStage converts a colour image to a grayscale image. +keywords: Convert to Grayscale Stage --- -# Convert to Grayscale Stage Parameters +# ConvertToGrayscaleStage -The parameters that available under the convert to grayscale stage. +`ConvertToGrayscaleStage` converts a colour image to a grayscale image. In JSON, it is represented as a Stage object with `"Stage": "SST_CONVERT_TO_GRAYSCALE"`. + +## JSON Structure + +**Location in template:** +``` +ImageParameterOptions[i] + └── ApplicableStages[j] (Stage object where Stage = "SST_CONVERT_TO_GRAYSCALE") +``` + +**Parent object:** [ApplicableStages]({{ site.dcvb_parameters_reference }}image-parameter/applicable-stages.html) within [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) + +**Example:** ```json { - "Stage":"SST_CONVERT_TO_GRAYSCALE", - "ColourConversionModes" : [] -}, + "Stage": "SST_CONVERT_TO_GRAYSCALE", + "ColourConversionModes": [ + { + "Mode": "CICM_GENERAL" + } + ] +} ``` -## Stage +> [!NOTE] +> - This snippet shows a Stage object configured for converting to grayscale. +> - To use it, add this object to the `ApplicableStages` array within an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html). +> - 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) + +## Parameters + +### Stage -The stage name of Convert to grayscale stage is `SST_CONVERT_TO_GRAYSCALE`. +Specifies the stage type. Fixed value: `SST_CONVERT_TO_GRAYSCALE`. -## ColourConversionModes +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_CONVERT_TO_GRAYSCALE"` | -Defines how to Convert to grayscale. +### ColourConversionModes -| Stage Parameter Summary | -| :---------------------- | -| **Type**
    An array of *[ColourConversionModes](colour-conversion-modes.md)* objects | +Defines how to convert a colour image to a grayscale image. See [`ColourConversionModes`](colour-conversion-modes.md) for details. diff --git a/parameters/reference/image-parameter/stage-detect-shortlines.md b/parameters/reference/image-parameter/stage-detect-shortlines.md index 448f280..c4655b8 100644 --- a/parameters/reference/image-parameter/stage-detect-shortlines.md +++ b/parameters/reference/image-parameter/stage-detect-shortlines.md @@ -1,35 +1,55 @@ --- layout: default-layout -title: Detect Short Lines Stage Parameters - Dynamsoft Capture Vision Parameters -description: The parameters that available under detect short lines stage of Dynamsoft Capture Vision. -keywords: Stages, detect short lines, ShortlineDetectionMode, short line detection modes -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true +title: DetectShortLinesStage - Dynamsoft Capture Vision Parameters +description: The DetectShortLinesStage detects short lines for document boundary detection. +keywords: Detect Short Lines Stage --- -# Detect Short Lines Stage Parameters +# DetectShortLinesStage -The parameters that available under the detect short lines stage. +`DetectShortLinesStage` detects short lines for document boundary detection. In JSON, it is represented as a Stage object with `"Stage": "SST_DETECT_SHORTLINES"`. + +## JSON Structure + +**Location in template:** +``` +ImageParameterOptions[i] + └── ApplicableStages[j] (Stage object where Stage = "SST_DETECT_SHORTLINES") +``` + +**Parent object:** [ApplicableStages]({{ site.dcvb_parameters_reference }}image-parameter/applicable-stages.html) within [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) + +**Example:** ```json { "Stage": "SST_DETECT_SHORTLINES", "ShortlineDetectionMode": { - "Mode": "SDM_GENERAL", + "Mode": "SDM_GENERAL", "Sensitivity": 3 } -}, +} ``` -## Stage +> [!NOTE] +> - This snippet shows a Stage object configured for detecting short lines. +> - To use it, add this object to the `ApplicableStages` array within an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html). +> - 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) + +## Parameters + +### Stage -The stage name of detect short lines stage is `SST_DETECT_SHORTLINES`. +Specifies the stage type. Fixed value: `SST_DETECT_SHORTLINES`. -## ShortlineDetectionMode +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_DETECT_SHORTLINES"` | -Defines how to detect short lines. +### ShortlineDetectionMode -| Stage Parameter Summary | -| :---------------------- | -| **Type**
    A *[ShortlineDetectionMode](shortline-detection-mode.md)* object. | +Defines how to detect short lines. See [`ShortlineDetectionMode`](shortline-detection-mode.md) for details. diff --git a/parameters/reference/image-parameter/stage-detect-text-zones.md b/parameters/reference/image-parameter/stage-detect-text-zones.md index 4b86dcd..7b9198e 100644 --- a/parameters/reference/image-parameter/stage-detect-text-zones.md +++ b/parameters/reference/image-parameter/stage-detect-text-zones.md @@ -1,33 +1,54 @@ --- layout: default-layout -title: Detect Text Zones Stage Parameters - Dynamsoft Capture Vision Parameters -description: The parameters that available under detect Text Zones stage of Dynamsoft Capture Vision. -keywords: Stages, detect Text Zones, TextDetectionMode, text detection modes -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true +title: DetectTextZonesStage - Dynamsoft Capture Vision Parameters +description: The DetectTextZonesStage detects text zones on the image. +keywords: Detect Text Zones Stage --- -# Detect Text Zones Stage Parameters +# DetectTextZonesStage -The parameters that available under the detect text zones stage. +`DetectTextZonesStage` detects text zones on the image. In JSON, it is represented as a Stage object with `"Stage": "SST_DETECT_TEXT_ZONES"`. + +## JSON Structure + +**Location in template:** +``` +ImageParameterOptions[i] + └── ApplicableStages[j] (Stage object where Stage = "SST_DETECT_TEXT_ZONES") +``` + +**Parent object:** [ApplicableStages]({{ site.dcvb_parameters_reference }}image-parameter/applicable-stages.html) within [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) + +**Example:** ```json { "Stage": "SST_DETECT_TEXT_ZONES", "TextDetectionMode": { + "Mode": "TTDM_LINE" } -}, +} ``` -## Stage +> [!NOTE] +> - This snippet shows a Stage object configured for detecting text zones. +> - To use it, add this object to the `ApplicableStages` array within an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html). +> - 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) + +## Parameters + +### Stage -The stage name of detect text zones stage is `SST_DETECT_TEXT_ZONES`. +Specifies the stage type. Fixed value: `SST_DETECT_TEXT_ZONES`. -## TextDetectionMode +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_DETECT_TEXT_ZONES"` | -Defines how to detect text zones. +### TextDetectionMode -| Stage Parameter Summary | -| :---------------------- | -| **Type**
    A *[TextDetectionMode](text-detection-mode.md)* object. | +Defines how to detect text zones. See [`TextDetectionMode`](text-detection-mode.md) for details. diff --git a/parameters/reference/image-parameter/stage-detect-texture.md b/parameters/reference/image-parameter/stage-detect-texture.md index a918379..ccd78e5 100644 --- a/parameters/reference/image-parameter/stage-detect-texture.md +++ b/parameters/reference/image-parameter/stage-detect-texture.md @@ -1,33 +1,56 @@ --- layout: default-layout -title: Detect Texture Stage Parameters - Dynamsoft Capture Vision Parameters -description: The parameters that available under detect texture stage of Dynamsoft Capture Vision. -keywords: Stages, detect texture, TextureDetectionModes, texture detection modes -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true +title: DetectTextureStage - Dynamsoft Capture Vision Parameters +description: The DetectTextureStage detects texture on the image. +keywords: Detect Texture Stage --- -# Detect Texture Stage Parameters +# DetectTextureStage -The parameters that available under the detect texture stage. +`DetectTextureStage` detects texture on the image. In JSON, it is represented as a Stage object with `"Stage": "SST_DETECT_TEXTURE"`. + +## JSON Structure + +**Location in template:** +``` +ImageParameterOptions[i] + └── ApplicableStages[j] (Stage object where Stage = "SST_DETECT_TEXTURE") +``` + +**Parent object:** [ApplicableStages]({{ site.dcvb_parameters_reference }}image-parameter/applicable-stages.html) within [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) + +**Example:** ```json { - "Stage":"SST_DETECT_TEXTURE", - "TextureDetectionModes" : [ + "Stage": "SST_DETECT_TEXTURE", + "TextureDetectionModes": [ + { + "Mode": "TDM_GENERAL_WIDTH_CONCENTRATION" + } ] } ``` -## Stage +> [!NOTE] +> - This snippet shows a Stage object configured for detecting texture. +> - To use it, add this object to the `ApplicableStages` array within an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html). +> - 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) + +## Parameters + +### Stage -The stage name of detect texture stage is `SST_DETECT_TEXTURE`. +Specifies the stage type. Fixed value: `SST_DETECT_TEXTURE`. -## TextureDetectionModes +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_DETECT_TEXTURE"` | -Defines how to detect texture. +### TextureDetectionModes -| Stage Parameter Summary | -| :---------------------- | -| **Type**
    An array of *[TextureDetectionModes](texture-detection-modes.md)* objects. | +Defines how to detect texture. See [`TextureDetectionModes`](texture-detection-modes.md) for details. diff --git a/parameters/reference/image-parameter/stage-enhance-grayscale.md b/parameters/reference/image-parameter/stage-enhance-grayscale.md index 9573e58..505f59e 100644 --- a/parameters/reference/image-parameter/stage-enhance-grayscale.md +++ b/parameters/reference/image-parameter/stage-enhance-grayscale.md @@ -1,33 +1,56 @@ --- layout: default-layout -title: Enhance Grayscale Stage Parameters - Dynamsoft Capture Vision Parameters -description: The parameters that available under enhance grayscale stage of Dynamsoft Capture Vision. -keywords: Stages, enhance grayscale, GrayscaleEnhancementModes, grayscale enhancement modes -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true +title: EnhanceGrayscaleStage - Dynamsoft Capture Vision Parameters +description: The EnhanceGrayscaleStage improves the quality of the grayscale image. +keywords: Enhance Grayscale Stage --- -# Enhance Grayscale Stage Parameters +# EnhanceGrayscaleStage -The parameters that available under the enhance grayscale stage. +`EnhanceGrayscaleStage` improves the quality of the grayscale image. In JSON, it is represented as a Stage object with `"Stage": "SST_ENHANCE_GRAYSCALE"`. + +## JSON Structure + +**Location in template:** +``` +ImageParameterOptions[i] + └── ApplicableStages[j] (Stage object where Stage = "SST_ENHANCE_GRAYSCALE") +``` + +**Parent object:** [ApplicableStages]({{ site.dcvb_parameters_reference }}image-parameter/applicable-stages.html) within [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) + +**Example:** ```json { - "Stage":"SST_ENHANCE_GRAYSCALE", - "GrayscaleEnhancementModes" : [ + "Stage": "SST_ENHANCE_GRAYSCALE", + "GrayscaleEnhancementModes": [ + { + "Mode": "GEM_GENERAL" + } ] -}, +} ``` -## Stage +> [!NOTE] +> - This snippet shows a Stage object configured for enhancing grayscale images. +> - To use it, add this object to the `ApplicableStages` array within an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html). +> - 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) + +## Parameters + +### Stage -The stage name of enhance grayscale stage is `SST_ENHANCE_GRAYSCALE`. +Specifies the stage type. Fixed value: `SST_ENHANCE_GRAYSCALE`. -## GrayscaleEnhancementModes +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_ENHANCE_GRAYSCALE"` | -Defines how to enhance grayscale. +### GrayscaleEnhancementModes -| Stage Parameter Summary | -| :---------------------- | -| **Type**
    An array of *[GrayscaleEnhancementModes](grayscale-enhancement-modes.md)* objects. | +Defines how to enhance the grayscale image. See [`GrayscaleEnhancementModes`](grayscale-enhancement-modes.md) for details. diff --git a/parameters/reference/image-parameter/stage-find-contours.md b/parameters/reference/image-parameter/stage-find-contours.md index 8cd63a8..5a1e298 100644 --- a/parameters/reference/image-parameter/stage-find-contours.md +++ b/parameters/reference/image-parameter/stage-find-contours.md @@ -1,23 +1,47 @@ --- layout: default-layout -title: Find Contours Stage Parameters - Dynamsoft Capture Vision Parameters -description: The parameters that available under find contours stage of Dynamsoft Capture Vision. -keywords: Stages, find contours -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true +title: FindContoursStage - Dynamsoft Capture Vision Parameters +description: The FindContoursStage finds contours in the image. +keywords: Find Contours Stage --- -# Find Contours Stage Parameters +# FindContoursStage -The parameters that available under the find contours stage. +`FindContoursStage` finds contours in the image. In JSON, it is represented as a Stage object with `"Stage": "SST_FIND_CONTOURS"`. + +## JSON Structure + +**Location in template:** +``` +ImageParameterOptions[i] + └── ApplicableStages[j] (Stage object where Stage = "SST_FIND_CONTOURS") +``` + +**Parent object:** [ApplicableStages]({{ site.dcvb_parameters_reference }}image-parameter/applicable-stages.html) within [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) + +**Example:** ```json { "Stage": "SST_FIND_CONTOURS" -}, +} ``` -## Stage +> [!NOTE] +> - This snippet shows a Stage object configured for finding contours. +> - To use it, add this object to the `ApplicableStages` array within an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html). +> - 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) + +## Parameters + +### Stage + +Specifies the stage type. Fixed value: `SST_FIND_CONTOURS`. -The stage name of find contours stage is `SST_FIND_CONTOURS`. +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_FIND_CONTOURS"` | diff --git a/parameters/reference/image-parameter/stage-remove-text-zones-from-binary.md b/parameters/reference/image-parameter/stage-remove-text-zones-from-binary.md index 174967d..b93b1d8 100644 --- a/parameters/reference/image-parameter/stage-remove-text-zones-from-binary.md +++ b/parameters/reference/image-parameter/stage-remove-text-zones-from-binary.md @@ -1,30 +1,52 @@ --- layout: default-layout -title: Remove Text Zones from Binary Stage Parameters - Dynamsoft Capture Vision Parameters -description: The parameters that available under remove text zones from binary stage of Dynamsoft Capture Vision. -keywords: Stages, remove text zones from binary, IfEraseTextZone, erase text zone -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true +title: RemoveTextZonesFromBinaryStage - Dynamsoft Capture Vision Parameters +description: The RemoveTextZonesFromBinaryStage removes text zones from the binary image. +keywords: Remove Text Zones from Binary Stage --- -# Remove Text Zones from Binary Stage Parameters +# RemoveTextZonesFromBinaryStage -The parameters that available under the remove text zones from binary stage. +`RemoveTextZonesFromBinaryStage` removes text zones from the binary image. In JSON, it is represented as a Stage object with `"Stage": "SST_REMOVE_TEXT_ZONES_FROM_BINARY"`. + +## JSON Structure + +**Location in template:** +``` +ImageParameterOptions[i] + └── ApplicableStages[j] (Stage object where Stage = "SST_REMOVE_TEXT_ZONES_FROM_BINARY") +``` + +**Parent object:** [ApplicableStages]({{ site.dcvb_parameters_reference }}image-parameter/applicable-stages.html) within [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) + +**Example:** ```json { "Stage": "SST_REMOVE_TEXT_ZONES_FROM_BINARY", - "IfEraseTextZone": 0 + "IfEraseTextZone": 1 } ``` -## Stage +> [!NOTE] +> - This snippet shows a Stage object configured for removing text zones from binary images. +> - To use it, add this object to the `ApplicableStages` array within an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html). +> - 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) + +## Parameters + +### Stage -The stage name of remove text zones from binary stage is `SST_REMOVE_TEXT_ZONES_FROM_BINARY`. +Specifies the stage type. Fixed value: `SST_REMOVE_TEXT_ZONES_FROM_BINARY`. -## IfEraseTextZone +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_REMOVE_TEXT_ZONES_FROM_BINARY"` | -Defines how to remove text zones from binary. +### IfEraseTextZone -See [`IfEraseTextZone`](if-erase-text-zone.md) +Defines whether to erase text zones from the binary image. See [`IfEraseTextZone`](if-erase-text-zone.md) for details. diff --git a/parameters/reference/image-parameter/stage-remove-texture-from-grayscale.md b/parameters/reference/image-parameter/stage-remove-texture-from-grayscale.md index c614310..c78712a 100644 --- a/parameters/reference/image-parameter/stage-remove-texture-from-grayscale.md +++ b/parameters/reference/image-parameter/stage-remove-texture-from-grayscale.md @@ -1,34 +1,58 @@ --- layout: default-layout -title: Remove Texture from Grayscale Stage Parameters - Dynamsoft Capture Vision Parameters -description: The parameters that available under remove texture from grayscale stage of Dynamsoft Capture Vision. -keywords: Stages, remove texture from grayscale -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true +title: RemoveTextureFromGrayscaleStage - Dynamsoft Capture Vision Parameters +description: The RemoveTextureFromGrayscaleStage removes texture from the grayscale image. +keywords: Remove Texture from Grayscale Stage --- -# Remove Texture from Grayscale Stage Parameters +# RemoveTextureFromGrayscaleStage -The parameters that available under the remove texture from grayscale stage. +`RemoveTextureFromGrayscaleStage` removes texture from the grayscale image. In JSON, it is represented as a Stage object with `"Stage": "SST_REMOVE_TEXTURE_FROM_GRAYSCALE"`. + +## JSON Structure + +**Location in template:** +``` +ImageParameterOptions[i] + └── ApplicableStages[j] (Stage object where Stage = "SST_REMOVE_TEXTURE_FROM_GRAYSCALE") +``` + +**Parent object:** [ApplicableStages]({{ site.dcvb_parameters_reference }}image-parameter/applicable-stages.html) within [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) + +**Example:** ```json { - "Stage":"SST_REMOVE_TEXTURE_FROM_GRAYSCALE", + "Stage": "SST_REMOVE_TEXTURE_FROM_GRAYSCALE", "TextureRemovalStrength": 2 -}, +} ``` -## Stage +> [!NOTE] +> - This snippet shows a Stage object configured for removing texture from grayscale images. +> - To use it, add this object to the `ApplicableStages` array within an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html). +> - 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) + +## Parameters + +### Stage + +Specifies the stage type. Fixed value: `SST_REMOVE_TEXTURE_FROM_GRAYSCALE`. -The stage name of remove texture from grayscale stage is `SST_REMOVE_TEXTURE_FROM_GRAYSCALE`. +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_REMOVE_TEXTURE_FROM_GRAYSCALE"` | -## TextureRemovalStrength +### TextureRemovalStrength -Defines how to remove texture from grayscale. +Defines the strength for removing texture from the grayscale image. -| TextureRemovalStrength Parameter Summary | -| :---------------------------------- | +| Parameter Details | +| :------------- | | **Type**
    *int* | -| **Value range**
    [1,9] | +| **Value Range**
    [1, 9] | | **Default Value**
    2 for BarcodeReaderTask & DocumentNormalizerTask
    1 for LabelRecognizerTask | diff --git a/parameters/reference/image-parameter/stage-scale-image.md b/parameters/reference/image-parameter/stage-scale-image.md index 9dda0a7..864f377 100644 --- a/parameters/reference/image-parameter/stage-scale-image.md +++ b/parameters/reference/image-parameter/stage-scale-image.md @@ -1,33 +1,56 @@ --- layout: default-layout -title: Scale Image Stage Parameters - Dynamsoft Capture Vision Parameters -description: The parameters that available under scale image stage of Dynamsoft Capture Vision. -keywords: Stages, scale image, ImageScaleSetting, image scale setting -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true +title: ScaleImageStage - Dynamsoft Capture Vision Parameters +description: The ScaleImageStage down/up scales the image. +keywords: Scale Image Stage --- -# Scale Image Stage Parameters +# ScaleImageStage -The parameters that available under the scale image stage. +`ScaleImageStage` down/up scales the image. In JSON, it is represented as a Stage object with `"Stage": "SST_SCALE_IMAGE"`. + +## JSON Structure + +**Location in template:** +``` +ImageParameterOptions[i] + └── ApplicableStages[j] (Stage object where Stage = "SST_SCALE_IMAGE") +``` + +**Parent object:** [ApplicableStages]({{ site.dcvb_parameters_reference }}image-parameter/applicable-stages.html) within [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) + +**Example:** ```json { - "Stage":"SST_SCALE_IMAGE", - "ImageScaleSetting" : { + "Stage": "SST_SCALE_IMAGE", + "ImageScaleSetting": { + "ScaleType": "ST_SCALE_DOWN", + "ReferenceEdge": "RE_SHORTER_EDGE", + "EdgeLengthThreshold": 2300 } -}, +} ``` -## Stage +> [!NOTE] +> - This snippet shows a Stage object configured for scaling images. +> - To use it, add this object to the `ApplicableStages` array within an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html). +> - 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) + +## Parameters + +### Stage -The stage name of scale image stage is `SST_SCALE_IMAGE`. +Specifies the stage type. Fixed value: `SST_SCALE_IMAGE`. -## ImageScaleSetting +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_SCALE_IMAGE"` | -Defines how to scale image. +### ImageScaleSetting -| Stage Parameter Summary | -| :---------------------- | -| **Type**
    An *[ImageScaleSetting](image-scale-settings.md)* object. | +Defines how to scale the image. See [`ImageScaleSetting`](image-scale-settings.md) for details. diff --git a/parameters/reference/image-parameter/stage-transform-grayscale.md b/parameters/reference/image-parameter/stage-transform-grayscale.md index e20782a..f31a0a1 100644 --- a/parameters/reference/image-parameter/stage-transform-grayscale.md +++ b/parameters/reference/image-parameter/stage-transform-grayscale.md @@ -1,33 +1,56 @@ --- layout: default-layout -title: Transform Grayscale Stage Parameters - Dynamsoft Capture Vision Parameters -description: The parameters that available under transform grayscale stage of Dynamsoft Capture Vision. -keywords: Stages, transform grayscale, GrayscaleTransformationModes, grayscale transformation modes -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true +title: TransformGrayscaleStage - Dynamsoft Capture Vision Parameters +description: The TransformGrayscaleStage transforms the grayscale image. +keywords: Transform Grayscale Stage --- -# Transform Grayscale Stage Parameters +# TransformGrayscaleStage -The parameters that available under the transform grayscale Stage. +`TransformGrayscaleStage` transforms the grayscale image. In JSON, it is represented as a Stage object with `"Stage": "SST_TRANSFORM_GRAYSCALE"`. + +## JSON Structure + +**Location in template:** +``` +ImageParameterOptions[i] + └── ApplicableStages[j] (Stage object where Stage = "SST_TRANSFORM_GRAYSCALE") +``` + +**Parent object:** [ApplicableStages]({{ site.dcvb_parameters_reference }}image-parameter/applicable-stages.html) within [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) + +**Example:** ```json { - "Stage":"SST_TRANSFORM_GRAYSCALE", - "GrayscaleTransformationModes" : [ + "Stage": "SST_TRANSFORM_GRAYSCALE", + "GrayscaleTransformationModes": [ + { + "Mode": "GTM_ORIGINAL" + } ] -}, +} ``` -## Stage +> [!NOTE] +> - This snippet shows a Stage object configured for transforming grayscale images. +> - To use it, add this object to the `ApplicableStages` array within an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html). +> - 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) + +## Parameters + +### Stage -The stage name of transform grayscale stage is `SST_TRANSFORM_GRAYSCALE`. +Specifies the stage type. Fixed value: `SST_TRANSFORM_GRAYSCALE`. -## GrayscaleTransformationModes +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_TRANSFORM_GRAYSCALE"` | -Defines how to transform grayscale. +### GrayscaleTransformationModes -| Stage Parameter Summary | -| :---------------------- | -| **Type**
    An array of *[GrayscaleTransformationModes](grayscale-transformation-modes.md)* objects. | +Defines how to transform the grayscale image. See [`GrayscaleTransformationModes`](grayscale-transformation-modes.md) for details. diff --git a/parameters/reference/image-parameter/text-detection-mode.md b/parameters/reference/image-parameter/text-detection-mode.md index 438ff5f..fcfa88c 100644 --- a/parameters/reference/image-parameter/text-detection-mode.md +++ b/parameters/reference/image-parameter/text-detection-mode.md @@ -3,9 +3,6 @@ layout: default-layout title: TextDetectionMode - Dynamsoft Capture Vision Parameters description: The parameter TextDetectionMode of Dynamsoft Capture Vision is for detecting texts on an image. keywords: TextDetectionMode, parameter reference, parameter -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true --- @@ -13,20 +10,35 @@ noTitleIndex: true Parameter `TextDetectionMode` determines how to detect the text area. For tasks like barcode reading or border detection, the text part is not important; while for the task of text recognition, the results of detected text zone are mandatory. -## Example +## JSON Structure + +**Location in template:** +``` +ImageParameterOptions[i] + └── ApplicableStages[j] (Stage object where Stage = "SST_DETECT_TEXT_ZONES") + └── TextDetectionMode +``` + +**Parent object:** [DetectTextZonesStage](stage-detect-text-zones.md) + +**Example:** ```json { - "TextDetectionMode": - { - "Mode": "TTDM_WORD", - "Direction": "HORIZONTAL", - "CharHeightRange": [1,1000,1] + "TextDetectionMode": { + "Mode": "TTDM_LINE" } } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `TextDetectionMode` parameter. +> - To use it, embed this parameter within a [DetectTextZonesStage](stage-detect-text-zones.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 `TextDetectionMode` consist of a group of text detection mode objects. Each text detection mode object includes a candidate mode and a series of mode arguments. The mode arguments of the text detection mode object is shown as follow: @@ -249,7 +261,7 @@ Parameter `TextDetectionMode` consist of a group of text detection mode objects. } ``` -## Candidate Modes Introduction +## Candidate Mode Introductions ### TTDM_WORD diff --git a/parameters/reference/image-parameter/texture-detection-modes.md b/parameters/reference/image-parameter/texture-detection-modes.md index 129df74..6e784b4 100644 --- a/parameters/reference/image-parameter/texture-detection-modes.md +++ b/parameters/reference/image-parameter/texture-detection-modes.md @@ -3,9 +3,6 @@ layout: default-layout title: TextureDetectionModes - Dynamsoft Capture Vision Parameters description: The parameter TextureDetectionModes of Dynamsoft Capture Vision is for detecting texts on an image. keywords: TextureDetectionModes, parameter reference, parameter -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true --- @@ -13,25 +10,37 @@ noTitleIndex: true Parameter `TextureDetectionModes` controls how to detect texture on an image. -## Example +## 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": - [ + "TextureDetectionModes": [ { - "Mode": "TDM_GENERAL_WIDTH_CONCENTRATION", - "Sensitivity": 1 - }, - { - "Mode": "TDM_GENERAL_WIDTH_CONCENTRATION", - "Sensitivity": 9 + "Mode": "TDM_GENERAL_WIDTH_CONCENTRATION" } ] } ``` -## Parameter Summary +> [!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: @@ -143,7 +152,7 @@ If the `TextureDetectionModes` is not configured in your template file, the foll } ``` -## Candidate Modes Introduction +## Candidate Mode Introductions ### TDM_GENERAL_WIDTH_CONCENTRATION diff --git a/parameters/reference/image-source-options/directory-path.md b/parameters/reference/image-source-options/directory-path.md index 54c099d..7e3ecc4 100644 --- a/parameters/reference/image-source-options/directory-path.md +++ b/parameters/reference/image-source-options/directory-path.md @@ -3,17 +3,23 @@ layout: default-layout title: DirectoryPath - ImageSource - Dynamsoft Capture Vision Parameters description: The parameter DirectoryPath defines a path when the library have to read files. keywords: Directory path -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true permalink: /parameters/reference/image-source-options/directory-path.html --- - # DirectoryPath Parameter `DirectoryPath` defines a path when the library have to read files. -## Example +## JSON Structure + +**Location in template:** +``` +ImageSourceOptions + └── DirectoryPath +``` + +**Parent object:** [ImageSource]({{ site.dcvb_parameters }}file/image-source.html) object + +**Example:** ```json { @@ -21,8 +27,15 @@ Parameter `DirectoryPath` defines a path when the library have to read files. } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `DirectoryPath` parameter. +> - To use it, embed this parameter within a [ImageSource]({{ site.dcvb_parameters }}file/image-source.html) 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 -| DirectoryPath Parameter Summary | +| DirectoryPath Parameter Details | | :------------- | | **Type**
    *String* | diff --git a/parameters/reference/image-source-options/file-filter.md b/parameters/reference/image-source-options/file-filter.md index ac174e2..1322822 100644 --- a/parameters/reference/image-source-options/file-filter.md +++ b/parameters/reference/image-source-options/file-filter.md @@ -9,7 +9,17 @@ keywords: File filter, ISA Parameter `FileFilter` specifies a file name filter string, which determines which files are fetched. -## Example +## JSON Structure + +**Location in template:** +``` +ImageSourceOptions + └── FileFilter +``` + +**Parent object:** [ImageSource]({{ site.dcvb_parameters }}file/image-source.html) object + +**Example:** ```json { @@ -17,9 +27,16 @@ Parameter `FileFilter` specifies a file name filter string, which determines whi } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `FileFilter` parameter. +> - To use it, embed this parameter within a [ImageSource]({{ site.dcvb_parameters }}file/image-source.html) 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 -| FileFilter Parameter Summary | +| FileFilter Parameter Details | | :----------------------------------- | | **Description**
    A file name filter string | | **Type**
    *String* | diff --git a/parameters/reference/image-source-options/index.md b/parameters/reference/image-source-options/index.md deleted file mode 100644 index 9fd677d..0000000 --- a/parameters/reference/image-source-options/index.md +++ /dev/null @@ -1,21 +0,0 @@ ---- -layout: default-layout -title: Index - ImageSourceOptions Parameters -description: The index of ImageSourceOptions parameters. -keywords: ImageSourceOptions, parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true ---- - -# ImageSourceOptions Parameters - -| Parameter Name | Description | -| -------------------- | ----------- | -| [`DirectoryPath`](directory-path.md) | Defines the path of the image source. | -| [`FileFilter`](file-filter.md) | Defines a file name filter string, which determines which files are fetched. | -| [`Name`](name.md) | Defines the name of a `ImageSourceOptions` object, which serves as its unique identifier. | -| [`Pages`]({{ site.dcvb_parameters_reference }}image-source-options/pages.html) | Sets the 0-based page indexes of a file (.tiff or .pdf) for barcode searching. | -| [`PDFReadingMode`](pdf-reading-mode.md) | Defines how to handle PDF files. | -| [`Recursive`](recursive.md) | Defines whether to fetch files recursively. | -| [`Type`](type.md) | Defines the type of the ImageSource object, which helps CVR create the correct type of image source. | diff --git a/parameters/reference/image-source-options/name.md b/parameters/reference/image-source-options/name.md index 6aa8609..c9f541a 100644 --- a/parameters/reference/image-source-options/name.md +++ b/parameters/reference/image-source-options/name.md @@ -3,16 +3,23 @@ layout: default-layout title: Name - Dynamsoft Capture Vision Parameter Reference ImageSource Object. description: The parameter Name defines the unique identifier of ImageSource object. keywords: top-level object, name, unique identifier -needAutoGenerateSidebar: true -noTitleIndex: true needGenerateH3Content: true --- - # Name Parameter `Name` represents the name of a `ImageSource` object, which serves as its unique identifier. -## Example +## JSON Structure + +**Location in template:** +``` +ImageSourceOptions + └── Name +``` + +**Parent object:** [ImageSource]({{ site.dcvb_parameters }}file/image-source.html) object + +**Example:** ```json { @@ -20,7 +27,14 @@ Parameter `Name` represents the name of a `ImageSource` object, which serves as } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `Name` parameter. +> - To use it, embed this parameter within a [ImageSource]({{ site.dcvb_parameters }}file/image-source.html) 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 Details | | :----------------------------------- | diff --git a/parameters/reference/image-source-options/pages.md b/parameters/reference/image-source-options/pages.md index d7eadbd..f8e0fea 100644 --- a/parameters/reference/image-source-options/pages.md +++ b/parameters/reference/image-source-options/pages.md @@ -3,16 +3,23 @@ layout: default-layout title: Pages - Dynamsoft Capture Vision Parameters description: The parameter Pages of Dynamsoft Capture Vision defines . keywords: Pages, ISA -needAutoGenerateSidebar: true -noTitleIndex: true needGenerateH3Content: true --- - # Pages Parameter `Pages` sets the 0-based page indexes of a file (.tiff or .pdf) for barcode searching. -## Example +## JSON Structure + +**Location in template:** +``` +ImageSourceOptions + └── Pages +``` + +**Parent object:** [ImageSource]({{ site.dcvb_parameters }}file/image-source.html) object + +**Example:** ```json { @@ -20,9 +27,16 @@ Parameter `Pages` sets the 0-based page indexes of a file (.tiff or .pdf) for ba } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `Pages` parameter. +> - To use it, embed this parameter within a [ImageSource]({{ site.dcvb_parameters }}file/image-source.html) 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 -| Pages Parameter Summary | +| Pages Parameter Details | | :--------------------- | | **Description**
    Sets the 0-based page indexes of a file (.tiff or .pdf) for barcode searching. | | **Type**
    *int array* | diff --git a/parameters/reference/image-source-options/pdf-reading-mode.md b/parameters/reference/image-source-options/pdf-reading-mode.md index 4d11800..34fcb26 100644 --- a/parameters/reference/image-source-options/pdf-reading-mode.md +++ b/parameters/reference/image-source-options/pdf-reading-mode.md @@ -3,21 +3,27 @@ layout: default-layout title: PDFReadingMode - Dynamsoft Capture Vision Parameters description: The parameter PDFReadingMode of Dynamsoft Capture Vision defines . keywords: PDF reading mode, ISA -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true permalink: /parameters/reference/image-source-options/pdf-reading-mode.html --- - # PDFReadingMode Parameter `PDFReadingMode` defines how to handle PDF files. -## Example +## JSON Structure + +**Location in template:** +``` +ImageSourceOptions + └── PdfReadingMode +``` + +**Parent object:** [ImageSource]({{ site.dcvb_parameters }}file/image-source.html) object + +**Example:** ```json { - "PDFReadingMode": + "PDFReadingMode": { "Mode": "PDFRM_RASTER", "DPI": 300, @@ -26,7 +32,14 @@ Parameter `PDFReadingMode` defines how to handle PDF files. } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `PdfReadingMode` parameter. +> - To use it, embed this parameter within a [ImageSource]({{ site.dcvb_parameters }}file/image-source.html) 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 `PDFReadingMode` is configured by a PDF reading mode objects. The PDF reading mode object includes a candidate mode and a series of mode arguments. The available mode arguments of the PDF reading mode object is shown as follow. diff --git a/parameters/reference/image-source-options/recursive.md b/parameters/reference/image-source-options/recursive.md index 39b10e9..1a38125 100644 --- a/parameters/reference/image-source-options/recursive.md +++ b/parameters/reference/image-source-options/recursive.md @@ -3,17 +3,23 @@ layout: default-layout title: Recursive - Dynamsoft Capture Vision Parameters description: The parameter Recursive of Dynamsoft Capture Vision defines . keywords: Recursive, ISA -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true permalink: /parameters/reference/image-source-options/recursive.html --- - # Recursive Parameter `Recursive` indicates whether to fetch files recursively. -## Example +## JSON Structure + +**Location in template:** +``` +ImageSourceOptions + └── Recursive +``` + +**Parent object:** [ImageSource]({{ site.dcvb_parameters }}file/image-source.html) object + +**Example:** ```json { @@ -21,9 +27,16 @@ Parameter `Recursive` indicates whether to fetch files recursively. } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `Recursive` parameter. +> - To use it, embed this parameter within a [ImageSource]({{ site.dcvb_parameters }}file/image-source.html) 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 -| Recursive Parameter Summary | +| Recursive Parameter Details | | :-------------------------- | | **Description**
    Use 0 (false) and 1 (true) to define whether to fetch files. | | **Type**
    *int* | diff --git a/parameters/reference/image-source-options/type.md b/parameters/reference/image-source-options/type.md index fb84773..539b884 100644 --- a/parameters/reference/image-source-options/type.md +++ b/parameters/reference/image-source-options/type.md @@ -3,17 +3,23 @@ layout: default-layout title: Type - Dynamsoft Capture Vision Parameters description: The parameter Type of Dynamsoft Capture Vision defines . keywords: Type, ISA -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true permalink: /parameters/reference/image-source-options/type.html --- - # Type -Parameter `Type` indicates the type of the ImageSource object, which helps CVR create the correct type of image source. +Parameter `Type` indicates the type of the `ImageSource` object, which helps CVR create the correct type of image source. + +## JSON Structure -## Example +**Location in template:** +``` +ImageSourceOptions + └── Type +``` + +**Parent object:** [ImageSource]({{ site.dcvb_parameters }}file/image-source.html) object + +**Example:** ```json { @@ -21,9 +27,16 @@ Parameter `Type` indicates the type of the ImageSource object, which helps CVR c } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `Type` parameter. +> - To use it, embed this parameter within a [ImageSource]({{ site.dcvb_parameters }}file/image-source.html) 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 -| Type Parameter Summary | +| Type Parameter Details | | :--------------------- | | **Description**
    Define the type of ImageSource. | | **Type**
    *String* | diff --git a/parameters/reference/index.md b/parameters/reference/index.md deleted file mode 100644 index 88544cf..0000000 --- a/parameters/reference/index.md +++ /dev/null @@ -1,222 +0,0 @@ ---- -layout: default-layout -title: Dynamsoft Capture Vision Parameter Reference - Main Page -description: Dynamsoft Capture Vision Parameter Reference - Main Page -keywords: parameter reference, parameters -needAutoGenerateSidebar: false -permalink: /parameters/reference/index.html ---- - -# Parameter Reference - -## Capture Vision Template - -| Parameter Name | Description | -| -------------- | ----------- | -| [`ImageROIProcessingNameArray`](capture-vision-template/image-roi-processing-name-array.md) | Defines the collection of image ROI processing object names, used to refer to the `TargetROIDef` objects. | -| [`ImageSourceName`](capture-vision-template/image-source-name.md) | Indicates the input source name, used to refer to the `ImageSource` object. | -| [`MaxParallelTasks`](capture-vision-template/max-parallel-tasks.md) | Defines the maximum number of parallel tasks for the DCV runtime. | -| [`MinImageCaptureInterval`]({{ site.dcvb_parameters_reference }}capture-vision-template/min-image-capture-interval.html) | Specifies the minimum time interval (in milliseconds) allowed between consecutive image captures. | -| [`Name`](capture-vision-template/name.md) | Defines the name of a `CaptureVisionTemplate` object, which serves as its unique identifier. | -| [`OutputOriginalImage`](capture-vision-template/output-original-Image.md) | Indicates whether DCV finally outputs the original input image. | -| [`SemanticProcessingNameArray`](capture-vision-template/semantic-processing-name-array.md) | Represents the collection of semantic-processing object names, used to refer to the `SematicProcessing` objects. | -| [`Timeout`](capture-vision-template/timeout.md) | Defines the maximum amount of time (in milliseconds) that should be spent processing each image or frame. | - -## Target ROI Def - -| Parameter Name | Description | -| --------------- | ----------- | -| [`BaseTargetROIDefName`](target-roi-def/base-target-roidef-name.md) | Represents the name of another `TargetROIDef` object to inherit from. | -| [`Location`](target-roi-def/location.md) | Defines the location of the TargetROI with `reference objects` filter conditions and `offset` parameters. | -| [`Name`](target-roi-def/name.md) | Defines the name of a `TargetROIDef` object, which serves as its unique identifier. | -| [`PauseFlag`](target-roi-def/pause-flag.md) | Indicates that the region results generated by this `TargetROIDef` will not be used by other `TargetROIDef` objects that depend on it to calculate the target regions, unless the user explicitly performs an update operation. | -| [`TaskSettingNameArray`](target-roi-def/task-setting-name-array.md) | Parameter `TaskSettingNameArray` represents the collection of task setting object names, used to refer to the `BarcodeReaderTaskSetting`, `LabelRecognizerTaskSetting`, `DocumentNormalizerTaskSetting` objects. | - -## Semantic Processing - -| Parameter Name | Description | -| --------------- | ----------- | -| [`Name`](semantic-processing/name.md) | Defines the name of a `SemanticProcessing` object, which serves as its unique identifier. | -| [`ReferenceObjectFilter`](semantic-processing/reference-object-filter.md) | Sets a [ReferenceObjectFilter](#referenceobjectfilter) object to define the filter conditions. | -| [`TaskSettingNameArray`](semantic-processing/task-setting-name-array.md) | Represents the collection of task setting object names, used to refer to the `CodeParserTaskSetting` objects. | - -## Barcode Reader Task Setting - -| Parameter Name | Description | -| -------------- | ----------- | -| [`BarcodeColourModes`](barcode-reader-task-settings/barcode-colour-modes.md) | Defines the barcode colour modes. | -| [`BarcodeComplementModes`](barcode-reader-task-settings/barcode-complement-modes.md) | Defines how to complement the missing parts of a barcode. | -| [`BarcodeFormatIds`](barcode-reader-task-settings/barcode-format-ids.md) | Defines the formats of the barcode to process. | -| [`BaseBarcodeReaderTaskSettingName`](barcode-reader-task-settings/base-barcode-reader-task-setting-name.md) | Represents the name of another `BarcodeReaderTaskSetting` object to inherit from. | -| [`DeblurModes`](barcode-reader-task-settings/deblur-modes.md) | Defines the mode and priority for deblurring. | -| [`DeformationResistingModes`](barcode-reader-task-settings/deformation-resisting-modes.md) | Defines how to handle distorted and deformed barcodes. | -| [`DPMCodeReadingModes`](barcode-reader-task-settings/dpm-code-reading-modes.md) | Defines how to read direct part mark (DPM) barcodes. | -| [`ExpectedBarcodesCount`](barcode-reader-task-settings/expected-barcodes-count.md) | Defines the number of barcodes expected to be detected. | -| [`LocalizationModes`](barcode-reader-task-settings/localization-modes.md) | Defines how to localize barcodes. | -| [`MaxThreadsInOneTask`](barcode-reader-task-settings/max-threads-in-one-task.md) | Defines the maximum threads that can be consumed in one task. | -| [`Name`](barcode-reader-task-settings/name.md) | Defines the name of a `BarcodeReaderTaskSetting` object, which serves as its unique identifier. | -| [`ReturnBarcodeZoneClarity`](barcode-reader-task-settings/return-barcode-zone-clarity.md) | Defines whether to return the clarity of the barcode zone. | -| [`SectionImageParameterArray`](barcode-reader-task-settings/section-image-parameter-array.md) | Defines `ImageParameter` in section unit. | -| [`StartSection`](barcode-reader-task-settings/start-section.md) | Defines the start section of the `BarcodeReaderTask`. | -| [`TerminateSetting`](barcode-reader-task-settings/terminate-setting.md) | Defines the terminate stages of each section in the task. For each sections, you can define only one terminate stage. | -| [`TextResultOrderModes`](barcode-reader-task-settings/text-result-order-modes.md) | Defines the order of the returned text results. | - -## Label Recognizer Task Setting - -| Parameter Name | Description | -| -------------- | ----------- | -| [`BaseLabelRecognizerTaskSettingName`](label-recognizer-task-settings/base-label-recognizer-task-setting-name.md) | Represents the name of another `LabelRecognizerTaskSetting` object to inherit from. | -| [`DictionaryCorrectionThresholds`](label-recognizer-task-settings/dictionary-correction-thresholds.md) | Sets the threshold of dictionary error correction. | -| [`DictionaryPath`](label-recognizer-task-settings/dictionary-path.md) | Sets the path of the dictionary file. | -| [`MaxThreadsInOneTask`](label-recognizer-task-settings/max-threads-in-one-task.md) | Defines the maximum threads that can be consumed in one task. | -| [`Name`](label-recognizer-task-settings/name.md) | Defines the name of a `LabelRecognizerTaskSetting` object, which serves as its unique identifier. | -| [`SectionImageParameterArray`](label-recognizer-task-settings/section-image-parameter-array.md) | Defines `ImageParameter` in section unit. | -| [`StartSection`](label-recognizer-task-settings/start-section.md) | Defines the start section of the `LabelRecognizerTask`. | -| [`StringLengthRange`](label-recognizer-task-settings/string-length-range.md) | Sets the range of string lengths for concatenated strings of recognized text lines. | -| [`StringRegExPattern`](label-recognizer-task-settings/string-regex-pattern.md) | Specifies the regular expression pattern for concatenated strings of recognized text lines. | -| [`TerminateSetting`](label-recognizer-task-settings/terminate-setting.md) | Defines the terminate stages of each section in the task. For each sections, you can define only one terminate stage. | -| [`TextLineSpecificationNameArray`](label-recognizer-task-settings/text-line-specification-name-array.md) | Defines the collection of text line specification object names | -| [`ConfusableCharactersPath`](label-recognizer-task-settings/confusable-characters-path.md) | Defines the path to the .data file of the confusable characters. | -| [`ClusterSamplesCountThreshold`](label-recognizer-task-settings/cluster-samples-count-threshold.md) | Defines the threshold for successful character clustering. | - -## Document Normalizer Task Setting - -| Parameter Name | Description | -| ------------------------------------------- | ----------- | -| [`BaseDocumentNormalizerTaskSettingName`](document-normalizer-task-settings/base-document-normalizer-task-setting-name.md) | Represents the name of another `DocumentNormalizerTaskSetting` object to inherit from. | -| [`Brightness`](document-normalizer-task-settings/brightness.md) | Defines the brightness of the normalized image. | -| [`ColourMode`](document-normalizer-task-settings/colour-mode.md) | Defines the output colour mode of the normalized image. | -| [`ContentType`](document-normalizer-task-settings/content-type.md) | Defines which contents are the targeting objects. | -| [`Contrast`](document-normalizer-task-settings/contrast.md) | Defines the contrast of the normalized image. | -| [`CornerAngleRange`](document-normalizer-task-settings/corner-angle-range.md) | Defines the range of angles (in degrees) of the extracted corners. | -| [`DeskewMode`](document-normalizer-task-settings/deskew-mode.md) | Defines the method in which the deskew process way used to apply the deskew process on the target normalized image. | -| [`ExpectedDocumentsCount`](document-normalizer-task-settings/expected-documents-count.md) | Defines the number of documents expected to be detected. | -| [`LineExtractionModes`](document-normalizer-task-settings/line-extraction-modes.md) | Defines the algorithm used to extract lines. | -| [`MaxThreadsInOneTask`](document-normalizer-task-settings/max-threads-in-one-task.md) | Defines the maximum threads that can be consumed in one task. | -| [`Name`](document-normalizer-task-settings/name.md) | Defines the name of a `DocumentNormalizerTaskSetting` object, which serves as its unique identifier. | -| [`PageSize`](document-normalizer-task-settings/page-size.md) | Defines the page size (width by height in pixels) of the normalized image. | -| [`QuadrilateralDetectionModes`](document-normalizer-task-settings/quadrilateral-detection-modes.md) | Defines the quadrilateral detection process on an image. | -| [`SectionImageParameterArray`](document-normalizer-task-settings/section-image-parameter-array.md) | Defines `ImageParameter` in section unit. | -| [`StartSection`](document-normalizer-task-settings/start-section.md) | Defines the start section of the `DocumentNormalizerTask`. | -| [`TerminateSetting`](document-normalizer-task-settings/terminate-setting.md) | Defines the terminate stages of each section in the task. For each sections, you can define only one terminate stage. | - -## Image Parameter - -| Parameter Name | Description | -| ---------------------------------- | ----------- | -| [`BaseImageParameterName`](image-parameter/base-image-parameter-name.md) | Represents the name of another `ImageParameter` object to inherit from. | -| [`BinarizationModes`](image-parameter/binarization-modes.md) | Defines the process of binarization | -| [`ColourConversionModes`](image-parameter/colour-conversion-modes.md) | Defines how to convert a colour image to a grayscale image. | -| [`GrayscaleEnhancementModes`](image-parameter/grayscale-enhancement-modes.md) | Defines the image processing methods to enhance the quality of the grayscale image. | -| [`GrayscaleTransformationModes`](image-parameter/grayscale-transformation-modes.md) | Defines whether or not to invert the color of the grayscale image. | -| [`IfEraseTextZone`](image-parameter/if-erase-text-zone.md) | Defines whether to erase the detected text zone. | -| [`Name`](image-parameter/name.md) | Defines the name of a `ImageParameter` object, which serves as its unique identifier. | -| [`RegionPredetectionModes`](image-parameter/region-predetection-modes.md) | Defines how to find a region of interest (ROI) within the image or frame. | -| [`ScaleDownThreshold`](image-parameter/scale-down-threshold.md) | Defines the threshold for image shrinking. | -| [`ScaleUpModes`](image-parameter/scale-up-modes.md) | Defines the scale-up process when targets in the image are too small. | -| [`TextDetectionMode`](image-parameter/text-detection-mode.md) | Defines how to detect the text area. | -| [`TextureDetectionModes`](image-parameter/texture-detection-modes.md) | Defines how to detect texture on an image. | - -## TextLine Specification - -| Parameter Name | Description | -| ----------------------------------- | ----------- | -| [`ApplicableTextLineNumbers`](text-line-specification/applicable-text-line-numbers.md) | Defines the line numers of the targeting lines which are specified by the `TextLineSpecification` object. | -| [`BaseTextLineSpecificationName`](text-line-specification/base-text-line-specification-name.md) | Defines the name of another `BaseTextLineSpecificationName` object. | -| [`CharHeightRange`](text-line-specification/char-height-range.md) | Defines the range of the character height. | -| [`CharacterModelName`](text-line-specification/character-model-name.md) | Defines the name of the character model. | -| [`CharacterNormalizationModes`](text-line-specification/character-normalization-modes.md) | Defines an array of character normalization mode to implement. | -| [`FirstPoint`](text-line-specification/position.md#firstpoint) | The top-left vertex coordinate of the the text line. | -| [`SecondPoint`](text-line-specification/position.md#secondpoint) | The top-right vertex coordinate of the the text line. | -| [`ThirdPoint`](text-line-specification/position.md#thirdpoint) | The bottom-right vertex coordinate of the the text line. | -| [`FourthPoint`](text-line-specification/position.md#fourthpoint) | The bottom-left vertex coordinate of the the text line. | -| [`Name`](text-line-specification/name.md) | Defines the name of a `TextLineSpecification` object, which serves as its unique identifier. | -| [`BinarizationModes`](text-line-specification/binarization-modes.md) | Helps control the process of binarization, i.e., converting a grayscale image to a binary image. | -| [`GrayscaleEnhancementModes`](text-line-specification/grayscale-enhancement-modes.md) | Provides some image processing methods to enhance the grayscale quality of the text line area. | -| [`StringLengthRange`](text-line-specification/string-length-range.md) | Sets the range of string length for each recognized line. | -| [`StringRegExPattern`](text-line-specification/string-regex-pattern.md) | Specifies the regular expression pattern of the string within a line. It is used to correct the recognized line text. | -| [`ConcatStringLengthRange`](text-line-specification/concat-string-length-range.md) | Sets the range of string length for the concated recognized text lines. | -| [`ConcatStringRegExPattern`](text-line-specification/concat-string-regex-pattern.md) | Specifies the regular expression pattern of the concated text lines. It is used to correct the recognized line text. | -| [`ConcatSeparator`](text-line-specification/concat-separator.md) | Defines the concat separator used to join multiple lines of text. | -| [`ConcatResults`](text-line-specification/concat-results.md) | Defines whether to concatenate multiple lines of text. | -| [`OutputResults`](text-line-specification/output-results.md) | Defines whether to enable the output of the `TextLineSpecification` object. | -| [`SubGroups`](text-line-specification/sub-groups.md) | Defines the layout of subgroups of the `TextLineSpecification` object. | -| [`ReferenceGroupName`](text-line-specification/reference-group-name.md) | Defines the reference group for space layout configuration. | -| [`TextLinesCount`](text-line-specification/text-lines-count.md) | Defines the expected number of text lines for the `TextLineSpecification` object. | -| [`ConfusableCharactersCorrection`](text-line-specification/confusable-characters-correction.md) | Defines the confusing character set and an array of reference font names for error correction. | - -## Character Model - -| Parameter Name | Description | -| -------------------- | ----------- | -| [`DirectoryPath`](character-model/directory-path.md) | Defines the path of character models. | -| [`FilterFilePath`](character-model/filter-file-path.md) | Defines the full path of the filter file which specifies the characters to be recognized. | -| [`Name`](character-model/name.md) | Defines the name of a `CharacterModel` object, which serves as its unique identifier. | - -## Barcode Format Specification - -| Parameter Name | Description | -| ---------------- | ----------- | -| [`AllModuleDeviation`](barcode-format-specification/all-module-deviation.md) | Defines the width deviation value (in moduleSize) of a non-standard 1D barcode type relative to the standard barcode width. | -| [`AustralianPostEncodingTable`](barcode-format-specification/australian-post-encoding-table.md) | Defines the encoding table used to code the Customer Information Field of Australian Post Customer Barcode. | -| [`BarcodeAngleRangeArray`](barcode-format-specification/barcode-angle-range-array.md) | Defines the range of angles (in degrees) for barcodes searching and result filtering. | -| [`BarcodeBytesLengthRangeArray`](barcode-format-specification/barcode-bytes-length-range-array.md) | Defines the range of barcode bytes length for barcodes searching and result filtering. | -| [`BarcodeHeightRangeArray`](barcode-format-specification/barcode-height-range-array.md) | Defines the range of heights (in pixels) for barcodes searching and result filtering. | -| [`BarcodeTextLengthRangeArray`](barcode-format-specification/barcode-text-length-range-array.md) | Defines the range of barcode text length for barcodes searching and result filtering. | -| [`BarcodeTextRegExPattern`](barcode-format-specification/barcode-text-regex-pattern.md) | Defines the regular expression pattern of barcode text characters for barcodes searching and result filtering. | -| [`BarcodeWidthRangeArray`](barcode-format-specification/barcode-width-range-array.md) | Defines the range of widths (in pixels) for barcodes searching and result filtering. | -| [`BarcodeZoneBarCountRangeArray`](barcode-format-specification/barcode-zone-bar-count-range-array.md) | Defines the range of bar count of the barcode zone for barcodes searching. | -| [`BarcodeZoneMinDistanceToImageBorders`](barcode-format-specification/barcode-zone-min-distance-to-image-borders.md) | Defines the minimum distance (in pixels) between the barcode zone and image borders. | -| [`Code128Subset`](barcode-format-specification/code128-subset.md) | Defines the subset of Code 128. | -| [`EnableAddOnCode`](barcode-format-specification/enable-addon-code.md) | Defines whether to identify addon code. | -| [`EnableDataMatrixECC000-140`](barcode-format-specification/enable-data-matrix-ecc000-140.md) | Defines whether to read Data Matrix ECC000-140 barcode. | -| [`EnableQRCodeModel1`](barcode-format-specification/enable-qr-code-model-1.md) | Defines whether to read QR code model 1. | -| [`FindUnevenModuleBarcode`](barcode-format-specification/find-uneven-module-barcode.md) | Defines whether to find barcodes with uneven barcode modules. | -| [`HeadModuleRatio`](barcode-format-specification/head-module-ratio.md) | Defines the module count and module size ratio of the barcode head section. | -| [`MinQuietZoneWidth`](barcode-format-specification/min-quiet-zone-width.md) | Defines the minimum width (in moduleSize) of the barcode quiet zone. | -| [`MinRatioOfBarcodeZoneWidthToHeight`](barcode-format-specification/min-ratio-of-barcode-zone-width-to-height.md) | Defines the minimum ratio (width/height as a percentage) of the barcode zone. | -| [`MinResultConfidence`](barcode-format-specification/min-result-confidence.md) | Defines the minimum confidence of the result. | -| [`MirrorMode`](barcode-format-specification/mirror-mode.md) | Defines whether to decode mirrored barcodes. | -| [`ModuleSizeRangeArray`](barcode-format-specification/module-size-range-array.md) | Defines the range of module size (in pixels) while barcode searching and result filtering. | -| [`MSICodeCheckDigitCalculation`](barcode-format-specification/msi-code-check-digit-calculation.md) | Defines the scheme used for calculating a check digit of an MSI barcode. | -| [`Name`](barcode-format-specification/name.md) | Defines the name of a `BarcodeFormatSpecification` object, which serves as its unique identifier. | -| [`PartitionModes`](barcode-format-specification/partition-modes.md) | Defines the mode to apply partition process when decoding QRCode and DataMatrix. | -| [`PatchCodeSearchingMargin`](barcode-format-specification/patch-code-searching-margins.md) | Defines the patch code searching margins. | -| [`RequireStartStopChars`](barcode-format-specification/require-start-stop-chars.md) | Defines whether the start and stop characters are required when searching for common 1D barcodes. | -| [`ReturnPartialBarcodeValue`](barcode-format-specification/return-partial-barcode-value.md) | Defines whether to return partial barcode value(s). | -| [`StandardFormat`](barcode-format-specification/standard-format.md) | Defines the standard barcode format. | -| [`TailModuleRatio`](barcode-format-specification/tail-module-ratio.md) | Defines the module count and module size ratio of the barcode tail section. | -| [`VerifyCheckDigit`](barcode-format-specification/verify-check-digit.md) | Defines whether to verify the check digit in barcodes where this check digit is optional. | - -## Code Parser Task Setting Options - -| Parameter Name | Description | -| ------------------------ | ----------- | -| [`CodeSpecifications`](code-parser-task-settings/code-specifications.md) | Defines the names of CodeSpecification used for code parsing. | -| [`Name`](code-parser-task-settings/name.md) | Defines the name of a `CodeParserTaskSetting` object, which serves as its unique identifier. | -| [`ResourcesPath`](code-parser-task-settings/resources-path.md) | Defines the directory path that contains the resources needed for code parsing. | - -## Image Source Options - -| Parameter Name | Description | -| -------------------- | ----------- | -| [`DirectoryPath`](image-source-options/directory-path.md) | Defines the path of the image source. | -| [`FileFilter`](image-source-options/file-filter.md) | Defines a file name filter string, which determines which files are fetched. | -| [`Name`]({{ site.dcvb_parameters_reference }}image-source-options/name.html) | Defines the name of a `ImageSource` object, which serves as its unique identifier. | -| [`Pages`]({{ site.dcvb_parameters_reference }}image-source-options/pages.html) | Sets the 0-based page indexes of a file (.tiff or .pdf) for barcode searching. | -| [`PDFReadingMode`](image-source-options/pdf-reading-mode.md) | Defines how to handle PDF files. | -| [`Recursive`](image-source-options/recursive.md) | Defines whether to fetch files recursively. | -| [`Type`](image-source-options/type.md) | Defines the type of the ImageSource object, which helps CVR create the correct type of image source. | - -## Global Parameter - -| Parameter Name | Description | -| ---------------------------- | ----------- | -| [`MaxTotalImageDimension`](global-parameter/max-total-image-dimension.md) | Defines the maximum total dimension of the images that read in the memory. | - -## OutputTaskSetting Parameters - -| Parameter Name | Description | -| -------------- | ----------- | -| [`Name`](output-task-setting/name.md) | Defines the name of a [`OutputTaskSetting`]({{ site.dcvb_parameters }}file/task-settings/output-task-setting.html) object, which serves as its unique identifier. | -| [`OutputCondidtion`](output-task-setting/output-condition.md) | Defines how the [`OutputTaskSetting`]({{ site.dcvb_parameters }}file/task-settings/output-task-setting.html) object outputs results that satisfy multiple filter conditions across products. | diff --git a/parameters/reference/label-recognizer-task-settings/base-label-recognizer-task-setting-name.md b/parameters/reference/label-recognizer-task-settings/base-label-recognizer-task-setting-name.md index 1cec614..2cc8386 100644 --- a/parameters/reference/label-recognizer-task-settings/base-label-recognizer-task-setting-name.md +++ b/parameters/reference/label-recognizer-task-settings/base-label-recognizer-task-setting-name.md @@ -1,18 +1,25 @@ --- layout: default-layout title: BaseLabelRecognizerTaskSettingName - Dynamsoft Label Recognizer Parameters -description: The parameter BaseLabelRecognizerTaskSettingName of Dynamsoft Label Recognizer defines the name of the inherited LabelRecognizerTaskSetting object. +description: The parameter BaseLabelRecognizerTaskSettingName defines the name of the inherited LabelRecognizerTaskSetting object. keywords: inheritance, LabelRecognizerTaskSetting -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- # BaseLabelRecognizerTaskSettingName -Parameter `BaseLabelRecognizerTaskSettingName` represents the name of another `LabelRecognizerTaskSetting` object. It is used to inherit the parameters defined in its parent `LabelRecognizerTaskSetting` object. If a parameter has already been defined in this object, the parameter with the same name will not be inherited from the parent object. +`BaseLabelRecognizerTaskSettingName` represents the name of another `LabelRecognizerTaskSetting` object. It is used to inherit the parameters defined in its parent `LabelRecognizerTaskSetting` object. If a parameter has already been defined in this object, the parameter with the same name will not be inherited from the parent object. -## Example +## JSON Structure + +**Location in template:** +``` +LabelRecognizerTaskSettingOptions[i] + └── BaseLabelRecognizerTaskSettingName +``` + +**Parent object:** [LabelRecognizerTaskSetting]({{ site.dcvb_parameters }}file/task-settings/label-recognizer-task-settings.html) + +**Example:** ```json { @@ -20,7 +27,14 @@ Parameter `BaseLabelRecognizerTaskSettingName` represents the name of another `L } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `BaseLabelRecognizerTaskSettingName` parameter. +> - To use it, embed this parameter within a [LabelRecognizerTaskSetting]({{ site.dcvb_parameters }}file/task-settings/label-recognizer-task-settings.html) object in the complete JSON structure. +> - 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 | BaseLabelRecognizerTaskSettingName Parameter Details | | :----------------------------------- | diff --git a/parameters/reference/label-recognizer-task-settings/cluster-samples-count-threshold.md b/parameters/reference/label-recognizer-task-settings/cluster-samples-count-threshold.md index fec57d3..b6b7df2 100644 --- a/parameters/reference/label-recognizer-task-settings/cluster-samples-count-threshold.md +++ b/parameters/reference/label-recognizer-task-settings/cluster-samples-count-threshold.md @@ -3,16 +3,26 @@ layout: default-layout title: ClusterSamplesCountThreshold - Dynamsoft Label Recognizer Parameters description: The parameter ClusterSamplesCountThreshold of Dynamsoft Label Recognizer defines the threshold for successful character clustering. keywords: confusable character clustering -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- # ClusterSamplesCountThreshold The parameter `ClusterSamplesCountThreshold` defines the threshold for successful character clustering. It defines the minimum number of samples in a single cluster. If every character in a group of confusable characters has been successfully clustered, the group will stop clustering. For example, [0,O,o] is a typical group of confusing characters. -## Example +## JSON Structure + +**Location in template:** + +``` +LabelRecognizerTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_RECOGNIZE_RAW_TEXT_LINES") + └── ClusterSamplesCountThreshold +``` + +**Parent object:** [RecognizeRawTextLinesStage]({{ site.dcvb_parameters }}reference/label-recognizer-task-settings/stage-recognize-raw-text-lines.html) + +**Example:** ```json { @@ -20,9 +30,16 @@ The parameter `ClusterSamplesCountThreshold` defines the threshold for successfu } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `ClusterSamplesCountThreshold` parameter. +> - To use it, embed this parameter within a [RecognizeRawTextLinesStage]({{ site.dcvb_parameters }}reference/label-recognizer-task-settings/stage-recognize-raw-text-lines.html) object. +> - For the complete JSON structure, see: +> - [Full JSON Structure]({{ site.dcvb_parameters }}file/index.html) +> - [Minimal Valid JSON]({{ site.dcvb_parameters }}file/index.html#minimal-valid-json) + +## Parameter Details -| ClusterSamplesCountThreshold Parameter Summary | +| ClusterSamplesCountThreshold Parameter Details | | :----------------------------------- | | **Type**
    *int* | | **Range**
    [0, 0x7FFFFFFF].| diff --git a/parameters/reference/label-recognizer-task-settings/confusable-characters-path.md b/parameters/reference/label-recognizer-task-settings/confusable-characters-path.md index 8115898..7d5dd40 100644 --- a/parameters/reference/label-recognizer-task-settings/confusable-characters-path.md +++ b/parameters/reference/label-recognizer-task-settings/confusable-characters-path.md @@ -3,26 +3,43 @@ layout: default-layout title: ConfusableCharactersPath - Dynamsoft Label Recognizer Parameters description: The parameter ConfusableCharactersPath of Dynamsoft Label Recognizer defines the path to the .data file containing standard characters features for confusable characters telling. keywords: confusable characters path -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- # ConfusableCharactersPath The parameter `ConfusableCharactersPath` sets the path to the .data file containing characters features for confusable characters telling. -## Example +## JSON Structure + +**Location in template:** + +``` +LabelRecognizerTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_RECOGNIZE_RAW_TEXT_LINES") + └── ConfusableCharactersPath +``` + +**Parent object:** [RecognizeRawTextLinesStage]({{ site.dcvb_parameters }}reference/label-recognizer-task-settings/stage-recognize-raw-text-lines.html) + +**Example:** ```json { - "ConfusableCharactersPath" : "D:\\YourApp\\ConfusableChars.data" + "ConfusableCharactersPath": "D:\\YourApp\\ConfusableChars.data" } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `ConfusableCharactersPath` parameter. +> - To use it, embed this parameter within a [RecognizeRawTextLinesStage]({{ site.dcvb_parameters }}reference/label-recognizer-task-settings/stage-recognize-raw-text-lines.html) object. +> - For the complete JSON structure, see: +> - [Full JSON Structure]({{ site.dcvb_parameters }}file/index.html) +> - [Minimal Valid JSON]({{ site.dcvb_parameters }}file/index.html#minimal-valid-json) + +## Parameter Details -| ConfusableCharactersPath Parameter Summary | +| ConfusableCharactersPath Parameter Details | | :----------------------------------- | | **Type**
    *String* | | **Range**
    The absolute file path or the path relative to the Dynamsoft Label Recognizer library.| diff --git a/parameters/reference/label-recognizer-task-settings/dictionary-correction-thresholds.md b/parameters/reference/label-recognizer-task-settings/dictionary-correction-thresholds.md index f7abe54..fcb0b28 100644 --- a/parameters/reference/label-recognizer-task-settings/dictionary-correction-thresholds.md +++ b/parameters/reference/label-recognizer-task-settings/dictionary-correction-thresholds.md @@ -3,16 +3,26 @@ layout: default-layout title: DictionaryCorrectionThresholds - Dynamsoft Label Recognizer Parameters description: The parameter DictionaryCorrectionThresholds of Dynamsoft Label Recognizer defines the threshold of dictionary error correction. keywords: user dictionary, text correction -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- # DictionaryCorrectionThresholds Parameter `DictionaryCorrectionThresholds` sets the threshold of dictionary error correction. -## Example +## JSON Structure + +**Location in template:** + +``` +LabelRecognizerTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_RECOGNIZE_RAW_TEXT_LINES") + └── DictionaryCorrectionThresholds +``` + +**Parent object:** [RecognizeRawTextLinesStage]({{ site.dcvb_parameters }}reference/label-recognizer-task-settings/stage-recognize-raw-text-lines.html) + +**Example:** ```json { @@ -32,16 +42,22 @@ Parameter `DictionaryCorrectionThresholds` sets the threshold of dictionary erro "Threshold": 3 } ] - } ``` +> [!NOTE] +> - This snippet shows only the `DictionaryCorrectionThresholds` parameter. +> - To use it, embed this parameter within a [RecognizeRawTextLinesStage]({{ site.dcvb_parameters }}reference/label-recognizer-task-settings/stage-recognize-raw-text-lines.html) object. +> - For the complete JSON structure, see: +> - [Full JSON Structure]({{ site.dcvb_parameters }}file/index.html) +> - [Minimal Valid JSON]({{ site.dcvb_parameters }}file/index.html#minimal-valid-json) + **Remarks** - It supports segmentation threshold. - It works together with the [DictionaryPath](dictionary-path.md) parameter to perform error correction during the recognition process. -## Parameter Summary +## Parameter Details Parameter `DictionaryCorrectionThresholds` consist of a group of dictionary correction threshold objects. Each threshold object includes a series of child parameters. diff --git a/parameters/reference/label-recognizer-task-settings/dictionary-path.md b/parameters/reference/label-recognizer-task-settings/dictionary-path.md index 0ffc233..cd85415 100644 --- a/parameters/reference/label-recognizer-task-settings/dictionary-path.md +++ b/parameters/reference/label-recognizer-task-settings/dictionary-path.md @@ -3,26 +3,43 @@ layout: default-layout title: DictionaryPath - Dynamsoft Label Recognizer Parameters description: The parameter DictionaryPath of Dynamsoft Label Recognizer defines the path of the dictionary file keywords: user dictionary, text correction -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- # DictionaryPath Parameter `DictionaryPath` sets the path of the dictionary file. -## Example +## JSON Structure + +**Location in template:** + +``` +LabelRecognizerTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_RECOGNIZE_RAW_TEXT_LINES") + └── DictionaryPath +``` + +**Parent object:** [RecognizeRawTextLinesStage]({{ site.dcvb_parameters }}reference/label-recognizer-task-settings/stage-recognize-raw-text-lines.html) + +**Example:** ```json { - "DictionaryPath" : "D:\\DictModel\\nutrition.txt" + "DictionaryPath": "D:\\DictModel\\nutrition.txt" } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `DictionaryPath` parameter. +> - To use it, embed this parameter within a [RecognizeRawTextLinesStage]({{ site.dcvb_parameters }}reference/label-recognizer-task-settings/stage-recognize-raw-text-lines.html) object. +> - For the complete JSON structure, see: +> - [Full JSON Structure]({{ site.dcvb_parameters }}file/index.html) +> - [Minimal Valid JSON]({{ site.dcvb_parameters }}file/index.html#minimal-valid-json) + +## Parameter Details -| DictionaryPath Parameter Summary | +| DictionaryPath Parameter Details | | :----------------------------------- | | **Type**
    *String* | | **Range**
    The absolute file path.| diff --git a/parameters/reference/label-recognizer-task-settings/enable-regex-force-correction.md b/parameters/reference/label-recognizer-task-settings/enable-regex-force-correction.md index e2c76a8..ece1c84 100644 --- a/parameters/reference/label-recognizer-task-settings/enable-regex-force-correction.md +++ b/parameters/reference/label-recognizer-task-settings/enable-regex-force-correction.md @@ -3,26 +3,43 @@ layout: default-layout title: EnableRegexForceCorrection - Dynamsoft Label Recognizer Parameters description: The parameter EnableRegexForceCorrection of Dynamsoft Label Recognizer defines the regular expression pattern for concatenated strings of recognized text lines. keywords: text lines, concatenated strings, regular expression -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- # EnableRegexForceCorrection Parameter `EnableRegexForceCorrection` specifies whether to enable forced correction based on the regular expression pattern. -## Example +## JSON Structure + +**Location in template:** + +``` +LabelRecognizerTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_RECOGNIZE_RAW_TEXT_LINES") + └── EnableRegexForceCorrection +``` + +**Parent object:** [RecognizeRawTextLinesStage]({{ site.dcvb_parameters }}reference/label-recognizer-task-settings/stage-recognize-raw-text-lines.html) + +**Example:** ```json { - "EnableRegexForceCorrection" : 1 + "EnableRegexForceCorrection": 1 } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `EnableRegexForceCorrection` parameter. +> - To use it, embed this parameter within a [RecognizeRawTextLinesStage]({{ site.dcvb_parameters }}reference/label-recognizer-task-settings/stage-recognize-raw-text-lines.html) object. +> - For the complete JSON structure, see: +> - [Full JSON Structure]({{ site.dcvb_parameters }}file/index.html) +> - [Minimal Valid JSON]({{ site.dcvb_parameters }}file/index.html#minimal-valid-json) + +## Parameter Details -| EnableRegexForceCorrection Parameter Summary | +| EnableRegexForceCorrection Parameter Details | | :----------------------------------- | | **Type**
    *int* | | **Range**
    0, 1| diff --git a/parameters/reference/label-recognizer-task-settings/localization-modes.md b/parameters/reference/label-recognizer-task-settings/localization-modes.md index 3f2c4f3..7558c01 100644 --- a/parameters/reference/label-recognizer-task-settings/localization-modes.md +++ b/parameters/reference/label-recognizer-task-settings/localization-modes.md @@ -3,35 +3,52 @@ layout: default-layout title: LocalizationModes - Dynamsoft Label Recognizer Parameters description: The parameter LocalizationModes of Dynamsoft Label Recognizer defines how to localize text lines. keywords: Localization modes -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true --- # LocalizationModes -Determines how to localize barcodes. It consists of one or more modes, each mode representing a different localization process. +Determines how to localize text lines. It consists of one or more modes, each mode representing a different localization process. **Remarks** - Introduced in Dynamsoft Capture Vision version 3.2.1000. -## Example +## JSON Structure + +**Location in template:** + +``` +LabelRecognizerTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_LOCALIZE_TEXT_LINES") + └── LocalizationModes +``` + +**Parent object:** [LocalizeTextLinesStage]({{ site.dcvb_parameters }}reference/label-recognizer-task-settings/stage-localize-text-lines.html) + +**Example:** ```json -"LocalizationModes" : +"LocalizationModes": [ { - "Mode" : "LM_NEURAL_NETWORK", + "Mode": "LM_NEURAL_NETWORK", "ModelNameArray": ["MRZLocalization"] }, { - "Mode" : "LM_GENERAL" + "Mode": "LM_GENERAL" } ] ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `LocalizationModes` parameter. +> - To use it, embed this parameter within a [LocalizeTextLinesStage]({{ site.dcvb_parameters }}reference/label-recognizer-task-settings/stage-localize-text-lines.html) object. +> - For the complete JSON structure, see: +> - [Full JSON Structure]({{ site.dcvb_parameters }}file/index.html) +> - [Minimal Valid JSON]({{ site.dcvb_parameters }}file/index.html#minimal-valid-json) + +## Parameter Details Parameter `LocalizationModes` consist of a group of localization mode objects. Each localization mode object includes a candidate mode and a series of auxiliary mode arguments. The structure of the localization mode object is shown as follow: @@ -92,10 +109,10 @@ If the `LocalizationModes` is not configured in your template file, the followin ```json { - "LocalizationModes" : + "LocalizationModes": [ { - "Mode" : "LM_GENERAL" + "Mode": "LM_GENERAL" } ] } diff --git a/parameters/reference/label-recognizer-task-settings/max-threads-in-one-task.md b/parameters/reference/label-recognizer-task-settings/max-threads-in-one-task.md index e34405a..331a37a 100644 --- a/parameters/reference/label-recognizer-task-settings/max-threads-in-one-task.md +++ b/parameters/reference/label-recognizer-task-settings/max-threads-in-one-task.md @@ -3,26 +3,40 @@ layout: default-layout title: MaxThreadsInOneTask - Dynamsoft Label Recognizer Parameters description: The parameter MaxThreadsInOneTask defines the maximum threads that can be consumed in one label recognition task. keywords: Max threads -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- # MaxThreadsInOneTask -Parameter `MaxThreadsInOneTask` defines the maximum threads that can be consumed in one task. +`MaxThreadsInOneTask` defines the maximum threads that can be consumed in one task. -## Example +## JSON Structure + +**Location in template:** +``` +LabelRecognizerTaskSettingOptions[i] + └── MaxThreadsInOneTask +``` + +**Parent object:** [LabelRecognizerTaskSetting]({{ site.dcvb_parameters }}file/task-settings/label-recognizer-task-settings.html) + +**Example:** ```json { - "MaxThreadsInOneTask":4 + "MaxThreadsInOneTask": 4 } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `MaxThreadsInOneTask` parameter. +> - To use it, embed this parameter within a [LabelRecognizerTaskSetting]({{ site.dcvb_parameters }}file/task-settings/label-recognizer-task-settings.html) object in the complete JSON structure. +> - 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 -| MaxThreadsInOneTask Parameter Summary | +| MaxThreadsInOneTask Parameter Details | | :------------- | | **Type**
    *int* | | **Range**
    [0, 256] | diff --git a/parameters/reference/label-recognizer-task-settings/name.md b/parameters/reference/label-recognizer-task-settings/name.md index 1b947eb..6bbc990 100644 --- a/parameters/reference/label-recognizer-task-settings/name.md +++ b/parameters/reference/label-recognizer-task-settings/name.md @@ -1,26 +1,40 @@ --- layout: default-layout -title: LabelRecognizerTaskSetting Name - Dynamsoft Label Recognizer Parameter. +title: Name - Dynamsoft Label Recognizer LabelRecognizerTaskSetting Parameters description: The parameter Name defines the unique identifier of a LabelRecognizerTaskSetting object. keywords: top-level object, name, unique identifier -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- # Name -Parameter `Name` represents the name of a `LabelRecognizerTaskSetting` object, which serves as its unique identifier. +`Name` represents the name of a `LabelRecognizerTaskSetting` object, which serves as its unique identifier. -## Example +## JSON Structure + +**Location in template:** +``` +LabelRecognizerTaskSettingOptions[i] + └── Name +``` + +**Parent object:** [LabelRecognizerTaskSetting]({{ site.dcvb_parameters }}file/task-settings/label-recognizer-task-settings.html) + +**Example:** ```json { - "Name" : "lr_0" + "Name": "lr_0" } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `Name` parameter. +> - To use it, embed this parameter within a [LabelRecognizerTaskSetting]({{ site.dcvb_parameters }}file/task-settings/label-recognizer-task-settings.html) object in the complete JSON structure. +> - 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 Details | | :----------------------------------- | diff --git a/parameters/reference/label-recognizer-task-settings/overlapping-characters-path.md b/parameters/reference/label-recognizer-task-settings/overlapping-characters-path.md index 29f1dea..0a7d318 100644 --- a/parameters/reference/label-recognizer-task-settings/overlapping-characters-path.md +++ b/parameters/reference/label-recognizer-task-settings/overlapping-characters-path.md @@ -3,26 +3,43 @@ layout: default-layout title: OverlappingCharactersPath - Dynamsoft Label Recognizer Parameters description: The parameter OverlappingCharactersPath of Dynamsoft Label Recognizer defines the path to the .data file containing characters features for overlapping matching. keywords: characters overlapping matching -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- # OverlappingCharactersPath The parameter `OverlappingCharactersPath` sets the path to the .data file containing characters features for overlapping matching. -## Example +## JSON Structure + +**Location in template:** + +``` +LabelRecognizerTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_RECOGNIZE_RAW_TEXT_LINES") + └── OverlappingCharactersPath +``` + +**Parent object:** [RecognizeRawTextLinesStage]({{ site.dcvb_parameters }}reference/label-recognizer-task-settings/stage-recognize-raw-text-lines.html) + +**Example:** ```json { - "OverlappingCharactersPath" : "D:\\YourApp\\OverlappingChars.data" + "OverlappingCharactersPath": "D:\\YourApp\\OverlappingChars.data" } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `OverlappingCharactersPath` parameter. +> - To use it, embed this parameter within a [RecognizeRawTextLinesStage]({{ site.dcvb_parameters }}reference/label-recognizer-task-settings/stage-recognize-raw-text-lines.html) object. +> - For the complete JSON structure, see: +> - [Full JSON Structure]({{ site.dcvb_parameters }}file/index.html) +> - [Minimal Valid JSON]({{ site.dcvb_parameters }}file/index.html#minimal-valid-json) + +## Parameter Details -| OverlappingCharactersPath Parameter Summary | +| OverlappingCharactersPath Parameter Details | | :----------------------------------- | | **Type**
    *String* | | **Range**
    The absolute file path or the path relative to the Dynamsoft Label Recognizer library.| diff --git a/parameters/reference/label-recognizer-task-settings/section-array.md b/parameters/reference/label-recognizer-task-settings/section-array.md index f4ae378..453eea5 100644 --- a/parameters/reference/label-recognizer-task-settings/section-array.md +++ b/parameters/reference/label-recognizer-task-settings/section-array.md @@ -3,40 +3,54 @@ layout: default-layout title: SectionArray - Dynamsoft Label Recognizer Parameters description: The parameter SectionArray defines which sections exist under the LabelRecognizerTask. keywords: Section Array parameter -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- # SectionArray -`SectionArray` is a parameter that defines which sections exist under the `LabelRecognizerTask`. A `Section` is a sequence of Stages that form a relatively complete processing unit, producing milestone results that include location information along with other details. +Parameter `SectionArray` defines which sections exist under the `LabelRecognizerTask`. A `Section` is a sequence of `Stages` that form a relatively complete processing unit, producing milestone results that include location information along with other details. -The `LabelRecognizerTask` includes the following sections: +## JSON Structure + +**Location in template:** +``` +LabelRecognizerTaskSettingOptions[i] + └── SectionArray +``` + +**Parent object:** [LabelRecognizerTaskSetting]({{ site.dcvb_parameters }}file/task-settings/label-recognizer-task-settings.html) object -* [ST_REGION_PREDETECTION](section-regions-predetection.md) - * It is designed to find regions of interest (ROIs) and thus ignoring other parts of the image during subsequent processing. -* [ST_TEXT_LINE_LOCALIZATION](section-text-lines-localization.md) - * It is designed to detect the exact locations of text-lines. -* [ST_TEXT_LINE_RECOGNITION](section-text-lines-recognition.md) - * It is designed to recognize the text from the text-line areas identified in the previous section [ST_TEXT_LINE_LOCALIZATION](text-line-localization-section.md) +**Example:** ```json { - "SectionArray": - [ + "SectionArray": [ { - "Section": "ST_REGION_PREDETECTION", - // Other parameters... + "Section": "ST_REGION_PREDETECTION" }, { - "Section": "ST_TEXT_LINE_LOCALIZATION", - // Other parameters... + "Section": "ST_TEXT_LINE_LOCALIZATION" }, { - "Section": "ST_TEXT_LINE_RECOGNITION", - // Other parameters... + "Section": "ST_TEXT_LINE_RECOGNITION" } ] } ``` + +> [!NOTE] +> - This snippet shows only the `SectionArray` parameter. +> - To use it, embed this parameter within a [LabelRecognizerTaskSetting]({{ site.dcvb_parameters }}file/task-settings/label-recognizer-task-settings.html) 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 + +The `LabelRecognizerTask` includes the following sections: + +* [RegionPredetectionSection](section-regions-predetection.md) (`ST_REGION_PREDETECTION`) + * Designed to find regions of interest (ROIs) and thus ignore other parts of the image during subsequent processing. +* [TextLineLocalizationSection](section-text-lines-localization.md) (`ST_TEXT_LINE_LOCALIZATION`) + * Designed to detect the exact locations of text-lines. +* [TextLineRecognitionSection](section-text-lines-recognition.md) (`ST_TEXT_LINE_RECOGNITION`) + * Designed to recognize the text from the text-line areas identified in the previous `TextLineLocalizationSection` section. diff --git a/parameters/reference/label-recognizer-task-settings/section-image-parameter-array.md b/parameters/reference/label-recognizer-task-settings/section-image-parameter-array.md deleted file mode 100644 index 1bf764d..0000000 --- a/parameters/reference/label-recognizer-task-settings/section-image-parameter-array.md +++ /dev/null @@ -1,73 +0,0 @@ ---- -layout: default-layout -title: SectionImageParameterArray - Dynamsoft Label Recognizer Parameters -description: The parameter SectionImageParameterArray defines the image processing algorithms that implemented in the different sections of a label recognition algorithm task. -keywords: Section image parameter -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true ---- - -# SectionImageParameterArray - -`SectionImageParameterArray` is a parameter that defines `ImageParameter` in section unit. Each `SectionImageParameterArray` element is a group of a section name and a `ImageParameter` name so that this section will use the ImageParameter you specified. If a section is not specified in the array, it will use the default `ImageParameter` configuration. - -The `LabelRecognizerTask` includes the following sections: - -* `ST_REGION_PREDETECTION` -* `ST_TEXT_LINE_LOCALIZATION` -* `ST_TEXT_LINE_RECOGNITION` - -## Example - -```json -{ - "SectionImageParameterArray": - [ - { - "Section": "ST_REGION_PREDETECTION", - "ImageParameterName": "IP_0" - }, - { - "Section": "ST_TEXT_LINE_LOCALIZATION", - "ImageParameterName": "IP_1" - }, - { - "Section": "ST_TEXT_LINE_RECOGNITION", - "ImageParameterName": "IP_1" - } - ] -} -``` - -## Parameter Summary - - - - - - - - - - - - - - - - - - - - - - - - - -
    Child Parameter NameChild Parameter Summary
    Section
    Description
    Specifies an algorithm section.
    Type
    String
    Range
    One of the following SectionType as a string. -
    ST_REGION_PREDETECTION -
    ST_TEXT_LINE_LOCALIZATION -
    ST_TEXT_LINE_RECOGNITION -
    ImageParameterName
    Description
    Specifies the ImageParameter that you want to implement in this section. It must be one of the name that defined under ImageParameterOptions.
    Type
    String
    diff --git a/parameters/reference/label-recognizer-task-settings/section-regions-predetection.md b/parameters/reference/label-recognizer-task-settings/section-regions-predetection.md index 5690ea8..4aaf8e5 100644 --- a/parameters/reference/label-recognizer-task-settings/section-regions-predetection.md +++ b/parameters/reference/label-recognizer-task-settings/section-regions-predetection.md @@ -1,44 +1,71 @@ --- layout: default-layout -title: RegionsPredetectionSection - Dynamsoft Label Recognizer Parameters -description: The parameter defines regions predtection section under the Section Array. -keywords: Regions Predetection Section -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true +title: RegionPredetectionSection - Dynamsoft Label Recognizer Parameters +description: The RegionPredetectionSection identifies regions of interest (ROIs) for subsequent processing. +keywords: RegionPredetectionSection --- -# RegionsPredetectionSection Object +# RegionPredetectionSection -The `RegionsPredetectionSection` is designed to identify regions of interest (ROIs), allowing subsequent processing to ignore other parts of the image. The pre-detected region may be identified based on color features, grayscale features, or neural network localization. +`RegionPredetectionSection` identifies regions of interest (ROIs), allowing subsequent processing to ignore other parts of the image. In JSON, it is represented as a Section object with `"Section": "ST_REGION_PREDETECTION"`. + +## JSON Structure + +**Location in template:** +``` +LabelRecognizerTaskSettingOptions[i] + └── SectionArray[j] (Section object where Section = "ST_REGION_PREDETECTION") +``` + +**Parent object:** [SectionArray]({{ site.dcvb_parameters_reference }}label-recognizer-task-settings/section-array.html) + +**Example:** ```json { "Section": "ST_REGION_PREDETECTION", "ImageParameterName": "ip_dlrDefault", - "StageArray": [] + "StageArray": [ + { + "Stage": "SST_PREDETECT_REGIONS" + } + ] } ``` -## Section +> [!NOTE] +> - This snippet shows a Section object configured for region predetection. +> - To use it, add this object to the [SectionArray]({{ site.dcvb_parameters_reference }}label-recognizer-task-settings/section-array.html) of a [LabelRecognizerTaskSetting]({{ site.dcvb_parameters }}file/task-settings/label-recognizer-task-settings.html). +> - 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) -The section is named `ST_REGION_PREDETECTION`. +## Parameters -## ImageParameterName +### Section -Specifies the `ImageParameter` to apply in the stages of this section. +Specifies the section type. Fixed value: `ST_REGION_PREDETECTION`. -| Parameter Summary | +| Parameter Details | | :------------- | | **Type**
    *string* | -| **Range**
    *It must be one of the name that defined under `ImageParameterOptions`* | -| **Default Value**
    *ip_dlrDefault* | +| **Required**
    Yes | +| **Default Value**
    `"ST_REGION_PREDETECTION"` | + +### ImageParameterName + +Specifies the name of an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) object to apply in the stages of this section. -## StageArray +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Range**
    Must be the name of an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) object defined under `ImageParameterOptions` | +| **Default Value**
    `""` | -`StageArray` is a parameter that specifies the stages within the `RegionsPredetectionSection`. A `Stage` is the smallest step significant enough to involve users in image processing. +### StageArray -The `RegionsPredetectionSection` consists of a single stage: +Specifies the stage objects within this section. The `RegionPredetectionSection` consists of the following stages: -* [SST_PREDETECT_REGIONS](stage-predetect-regions.md) - * It is designed at the stage level to identify regions of interest (ROIs). +| Stage | Description | +|-------|-------------| +| [PredetectRegionsStage](stage-predetect-regions.md) (`SST_PREDETECT_REGIONS`) | Identifies regions of interest (ROIs). | diff --git a/parameters/reference/label-recognizer-task-settings/section-text-lines-localization.md b/parameters/reference/label-recognizer-task-settings/section-text-lines-localization.md index 4962450..eec40ca 100644 --- a/parameters/reference/label-recognizer-task-settings/section-text-lines-localization.md +++ b/parameters/reference/label-recognizer-task-settings/section-text-lines-localization.md @@ -1,44 +1,71 @@ --- layout: default-layout -title: TextLinesLocalizationSection - Dynamsoft Label Recognizer Parameters -description: The parameter defines text lines localization section under the Section Array. -keywords: Text Lines Localization Section -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true +title: TextLineLocalizationSection - Dynamsoft Label Recognizer Parameters +description: The TextLineLocalizationSection detects the exact locations of text-lines. +keywords: TextLineLocalizationSection --- -# TextLinesLocalizationSection Object +# TextLineLocalizationSection -The `TextLinesLocalizationSection` is designed to detect the exact locations of text-lines. +`TextLineLocalizationSection` detects the exact locations of text-lines. In JSON, it is represented as a Section object with `"Section": "ST_TEXT_LINE_LOCALIZATION"`. + +## JSON Structure + +**Location in template:** +``` +LabelRecognizerTaskSettingOptions[i] + └── SectionArray[j] (Section object where Section = "ST_TEXT_LINE_LOCALIZATION") +``` + +**Parent object:** [SectionArray]({{ site.dcvb_parameters_reference }}label-recognizer-task-settings/section-array.html) + +**Example:** ```json { "Section": "ST_TEXT_LINE_LOCALIZATION", "ImageParameterName": "ip_dlrDefault", - "StageArray": [] + "StageArray": [ + { + "Stage": "SST_LOCALIZE_TEXT_LINES" + } + ] } ``` -## Section +> [!NOTE] +> - This snippet shows a Section object configured for text line localization. +> - To use it, add this object to the [SectionArray]({{ site.dcvb_parameters_reference }}label-recognizer-task-settings/section-array.html) of a [LabelRecognizerTaskSetting]({{ site.dcvb_parameters }}file/task-settings/label-recognizer-task-settings.html). +> - 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) -The section is named `ST_TEXT_LINE_LOCALIZATION`. +## Parameters -## ImageParameterName +### Section -Specifies the `ImageParameter` to apply in the stages of this section. +Specifies the section type. Fixed value: `ST_TEXT_LINE_LOCALIZATION`. -| Parameter Summary | +| Parameter Details | | :------------- | | **Type**
    *string* | -| **Range**
    *It must be one of the name that defined under `ImageParameterOptions`* | -| **Default Value**
    *ip_dlrDefault* | +| **Required**
    Yes | +| **Default Value**
    `"ST_TEXT_LINE_LOCALIZATION"` | + +### ImageParameterName + +Specifies the name of an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) object to apply in the stages of this section. -## StageArray +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Range**
    Must be the name of an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) object defined under `ImageParameterOptions` | +| **Default Value**
    `""` | -`StageArray` is a parameter that specifies the stages within the `TextLinesLocalizationSection`. A `Stage` is the smallest step significant enough to involve users in image processing. +### StageArray -The `TextLinesLocalizationSection` consists of a single stage: +Specifies the stage objects within this section. The `TextLineLocalizationSection` consists of the following stages: -* [SST_LOCALIZE_TEXT_LINES](stage-localize-text-lines.md) - * It is designed at the stage level to detect the exact locations of text-lines. +| Stage | Description | +|-------|-------------| +| [LocalizeTextLinesStage](stage-localize-text-lines.md) (`SST_LOCALIZE_TEXT_LINES`) | Detects the exact locations of text-lines. | diff --git a/parameters/reference/label-recognizer-task-settings/section-text-lines-recognition.md b/parameters/reference/label-recognizer-task-settings/section-text-lines-recognition.md index f154e2d..71a1867 100644 --- a/parameters/reference/label-recognizer-task-settings/section-text-lines-recognition.md +++ b/parameters/reference/label-recognizer-task-settings/section-text-lines-recognition.md @@ -1,46 +1,75 @@ --- layout: default-layout -title: TextLinesRecognitionSection - Dynamsoft Label Recognizer Parameters -description: The parameter defines text lines recognition section under the Section Array. -keywords: Text Lines Recognition Section -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true +title: TextLineRecognitionSection - Dynamsoft Label Recognizer Parameters +description: The TextLineRecognitionSection recognizes text from localized text-line regions. +keywords: TextLineRecognitionSection --- -# TextLinesRecognitionSection Object +# TextLineRecognitionSection -The `TextLinesRecognitionSection` is designed to detect the exact locations of text-lines. +`TextLineRecognitionSection` recognizes text from localized text-line regions. In JSON, it is represented as a Section object with `"Section": "ST_TEXT_LINE_RECOGNITION"`. + +## JSON Structure + +**Location in template:** +``` +LabelRecognizerTaskSettingOptions[i] + └── SectionArray[j] (Section object where Section = "ST_TEXT_LINE_RECOGNITION") +``` + +**Parent object:** [SectionArray]({{ site.dcvb_parameters_reference }}label-recognizer-task-settings/section-array.html) + +**Example:** ```json { "Section": "ST_TEXT_LINE_RECOGNITION", "ImageParameterName": "ip_dlrDefault", - "StageArray": [] + "StageArray": [ + { + "Stage": "SST_RECOGNIZE_RAW_TEXT_LINES" + }, + { + "Stage": "SST_ASSEMBLE_TEXT_LINES" + } + ] } ``` -## Section +> [!NOTE] +> - This snippet shows a Section object configured for text line recognition. +> - To use it, add this object to the [SectionArray]({{ site.dcvb_parameters_reference }}label-recognizer-task-settings/section-array.html) of a [LabelRecognizerTaskSetting]({{ site.dcvb_parameters }}file/task-settings/label-recognizer-task-settings.html). +> - 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) -The section is named `ST_TEXT_LINE_RECOGNITION`. +## Parameters -## ImageParameterName +### Section -Specifies the `ImageParameter` to apply in the stages of this section. +Specifies the section type. Fixed value: `ST_TEXT_LINE_RECOGNITION`. -| Parameter Summary | +| Parameter Details | | :------------- | | **Type**
    *string* | -| **Range**
    *It must be one of the name that defined under `ImageParameterOptions`* | -| **Default Value**
    *ip_dlrDefault* | +| **Required**
    Yes | +| **Default Value**
    `"ST_TEXT_LINE_RECOGNITION"` | + +### ImageParameterName + +Specifies the name of an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) object to apply in the stages of this section. -## StageArray +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Range**
    Must be the name of an [ImageParameter]({{ site.dcvb_parameters }}file/image-parameter.html) object defined under `ImageParameterOptions` | +| **Default Value**
    `""` | -`StageArray` is a parameter that specifies the stages within the `TextLinesRecognitionSection`. A `Stage` is the smallest step significant enough to involve users in image processing. +### StageArray -The `TextLinesRecognitionSection` consists of two stages: +Specifies the stage objects within this section. The `TextLineRecognitionSection` consists of the following stages: -* [SST_RECOGNIZE_RAW_TEXT_LINES](stage-recognize-raw-text-lines.md) - * It is designed at the stage level to recognize the raw values of text-lines. -* [SST_ASSEMBLE_TEXT_LINES](stage-assemble-text-lines.md) - * It is designed at the stage level to assemble the grouped text-lines into a single text-line. +| Stage | Description | +|-------|-------------| +| [RecognizeRawTextLinesStage](stage-recognize-raw-text-lines.md) (`SST_RECOGNIZE_RAW_TEXT_LINES`) | Recognizes the raw values of text-lines. | +| [AssembleTextLinesStage](stage-assemble-text-lines.md) (`SST_ASSEMBLE_TEXT_LINES`) | Assembles grouped text-lines into a single text-line. | diff --git a/parameters/reference/label-recognizer-task-settings/stage-assemble-text-lines.md b/parameters/reference/label-recognizer-task-settings/stage-assemble-text-lines.md index 33c9e09..f493933 100644 --- a/parameters/reference/label-recognizer-task-settings/stage-assemble-text-lines.md +++ b/parameters/reference/label-recognizer-task-settings/stage-assemble-text-lines.md @@ -1,36 +1,58 @@ --- layout: default-layout title: AssembleTextLinesStage - Dynamsoft Label Recognizer Parameters -description: The parameter defines Assemble Text Lines Stage under the Text Line Recognition Section. +description: The AssembleTextLinesStage assembles the grouped text lines into a single text line. keywords: Assemble Text Lines Stage -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- -# AssembleTextLinesStage Object +# AssembleTextLinesStage -The `AssembleTextLinesStage` is designed at the stage level to assemble the grouped text-lines into a single text-line. +`AssembleTextLinesStage` assembles the grouped text lines into a single text line. In JSON, it is represented as a Stage object with `"Stage": "SST_ASSEMBLE_TEXT_LINES"`. + +## JSON Structure + +**Location in template:** +``` +LabelRecognizerTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_ASSEMBLE_TEXT_LINES") +``` + +**Parent object:** [StageArray]({{ site.dcvb_parameters_reference }}label-recognizer-task-settings/section-text-lines-recognition.html#stagearray) within [TextLinesRecognitionSection]({{ site.dcvb_parameters_reference }}label-recognizer-task-settings/section-text-lines-recognition.html) + +**Example:** ```json { "Stage": "SST_ASSEMBLE_TEXT_LINES", - "StringLengthRange": [ - 3, - 200 - ], + "StringLengthRange": [3, 200], "StringRegExPattern": "" } ``` -## Stage +> [!NOTE] +> - This snippet shows a Stage object configured for assembling text lines. +> - To use it, add this object to the `StageArray` within a [TextLinesRecognitionSection]({{ site.dcvb_parameters_reference }}label-recognizer-task-settings/section-text-lines-recognition.html). +> - 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) + +## Parameters + +### Stage + +Specifies the stage type. Fixed value: `SST_ASSEMBLE_TEXT_LINES`. -The stage is named `SST_ASSEMBLE_TEXT_LINES`. +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_ASSEMBLE_TEXT_LINES"` | -## StringLengthRange +### StringLengthRange -Parameter [`StringLengthRange`](string-length-range.md) sets the range of string lengths for concatenated strings of recognized text lines. +Sets the range of string lengths for concatenated strings of recognized text lines. See [`StringLengthRange`](string-length-range.md) for details. -## StringRegExPattern +### StringRegExPattern -Parameter [`StringRegExPattern`](string-regex-pattern.md) specifies the regular expression pattern for concatenated strings of recognized text lines. +Specifies the regular expression pattern for concatenated strings of recognized text lines. See [`StringRegExPattern`](string-regex-pattern.md) for details. diff --git a/parameters/reference/label-recognizer-task-settings/stage-localize-text-lines.md b/parameters/reference/label-recognizer-task-settings/stage-localize-text-lines.md index db72b24..ad7685a 100644 --- a/parameters/reference/label-recognizer-task-settings/stage-localize-text-lines.md +++ b/parameters/reference/label-recognizer-task-settings/stage-localize-text-lines.md @@ -1,16 +1,26 @@ --- layout: default-layout title: LocalizeTextLinesStage - Dynamsoft Label Recognizer Parameters -description: The parameter defines Localize Text Lines Stage under the Text Lines Localization Section. +description: The LocalizeTextLinesStage detects the exact locations of text lines. keywords: Localize Text Lines Stage -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- -# LocalizeTextLinesStage Object +# LocalizeTextLinesStage -The `LocalizeTextLinesStage` is designed at the stage level to detect the exact locations of text-lines. +`LocalizeTextLinesStage` detects the exact locations of text lines. In JSON, it is represented as a Stage object with `"Stage": "SST_LOCALIZE_TEXT_LINES"`. + +## JSON Structure + +**Location in template:** +``` +LabelRecognizerTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_LOCALIZE_TEXT_LINES") +``` + +**Parent object:** [StageArray]({{ site.dcvb_parameters_reference }}label-recognizer-task-settings/section-text-lines-localization.html#stagearray) within [TextLinesLocalizationSection]({{ site.dcvb_parameters_reference }}label-recognizer-task-settings/section-text-lines-localization.html) + +**Example:** ```json { @@ -18,6 +28,21 @@ The `LocalizeTextLinesStage` is designed at the stage level to detect the exact } ``` -## Stage +> [!NOTE] +> - This snippet shows a Stage object configured for localizing text lines. +> - To use it, add this object to the `StageArray` within a [TextLinesLocalizationSection]({{ site.dcvb_parameters_reference }}label-recognizer-task-settings/section-text-lines-localization.html). +> - 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) + +## Parameters + +### Stage + +Specifies the stage type. Fixed value: `SST_LOCALIZE_TEXT_LINES`. -The stage is named `SST_LOCALIZE_TEXT_LINES`. +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_LOCALIZE_TEXT_LINES"` | diff --git a/parameters/reference/label-recognizer-task-settings/stage-predetect-regions.md b/parameters/reference/label-recognizer-task-settings/stage-predetect-regions.md index 2c2687c..38dccef 100644 --- a/parameters/reference/label-recognizer-task-settings/stage-predetect-regions.md +++ b/parameters/reference/label-recognizer-task-settings/stage-predetect-regions.md @@ -1,28 +1,57 @@ --- layout: default-layout title: PredetectRegionsStage - Dynamsoft Label Recognizer Parameters -description: The parameter defines Predetect Regions Stage under the Regions Predetection Section. +description: The PredetectRegionsStage identifies regions of interest (ROIs). keywords: Predetect Regions Stage -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- -# PredetectRegionsStage Object +# PredetectRegionsStage -The `PredetectRegionsStage` is designed at the stage level to identify regions of interest (ROIs). The pre-detected region may be identified based on color features, grayscale features, or neural network localization. +`PredetectRegionsStage` identifies regions of interest (ROIs). The pre-detected region may be identified based on color features, grayscale features, or neural network localization. In JSON, it is represented as a Stage object with `"Stage": "SST_PREDETECT_REGIONS"`. + +## JSON Structure + +**Location in template:** +``` +LabelRecognizerTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_PREDETECT_REGIONS") +``` + +**Parent object:** [StageArray]({{ site.dcvb_parameters_reference }}label-recognizer-task-settings/section-regions-predetection.html#stagearray) within [RegionsPredetectionSection]({{ site.dcvb_parameters_reference }}label-recognizer-task-settings/section-regions-predetection.html) + +**Example:** ```json { "Stage": "SST_PREDETECT_REGIONS", - "RegionPredetectionModes": [] + "RegionPredetectionModes": [ + { + "Mode": "RPM_GENERAL" + } + ] } ``` -## Stage +> [!NOTE] +> - This snippet shows a Stage object configured for region predetection. +> - To use it, add this object to the `StageArray` within a [RegionsPredetectionSection]({{ site.dcvb_parameters_reference }}label-recognizer-task-settings/section-regions-predetection.html). +> - 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) + +## Parameters + +### Stage + +Specifies the stage type. Fixed value: `SST_PREDETECT_REGIONS`. -The stage is named `SST_PREDETECT_REGIONS`. +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_PREDETECT_REGIONS"` | -## RegionPredetectionModes +### RegionPredetectionModes -Parameter [`RegionPredetectionModes`](../image-parameter/region-predetection-modes.md) controls how to find a region of interest (ROI) within the image or frame. +Controls how to find a region of interest (ROI) within the image or frame. See [`RegionPredetectionModes`]({{ site.dcvb_parameters_reference }}image-parameter/region-predetection-modes.html) for details. diff --git a/parameters/reference/label-recognizer-task-settings/stage-recognize-raw-text-lines.md b/parameters/reference/label-recognizer-task-settings/stage-recognize-raw-text-lines.md index 7cd4fa5..9d2ffd0 100644 --- a/parameters/reference/label-recognizer-task-settings/stage-recognize-raw-text-lines.md +++ b/parameters/reference/label-recognizer-task-settings/stage-recognize-raw-text-lines.md @@ -1,16 +1,26 @@ --- layout: default-layout title: RecognizeRawTextLinesStage - Dynamsoft Label Recognizer Parameters -description: The parameter defines Recognize Raw Text Lines Stage under the Text Line Recognition Section. +description: The RecognizeRawTextLinesStage recognizes the raw values of text lines. keywords: Recognize Raw Text Lines Stage -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- -# RecognizeRawTextLinesStage Object +# RecognizeRawTextLinesStage -The `RecognizeRawTextLinesStage` is designed at the stage level to recognize the raw values of text-lines. +`RecognizeRawTextLinesStage` recognizes the raw values of text lines. In JSON, it is represented as a Stage object with `"Stage": "SST_RECOGNIZE_RAW_TEXT_LINES"`. + +## JSON Structure + +**Location in template:** +``` +LabelRecognizerTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_RECOGNIZE_RAW_TEXT_LINES") +``` + +**Parent object:** [StageArray]({{ site.dcvb_parameters_reference }}label-recognizer-task-settings/section-text-lines-recognition.html#stagearray) within [TextLinesRecognitionSection]({{ site.dcvb_parameters_reference }}label-recognizer-task-settings/section-text-lines-recognition.html) + +**Example:** ```json { @@ -25,35 +35,50 @@ The `RecognizeRawTextLinesStage` is designed at the stage level to recognize the ], "ConfusableCharactersPath": "", "ClusterSamplesCountThreshold": 0, - "OverlappingCharactersPath": "OverlappingChars.data", + "OverlappingCharactersPath": "OverlappingChars.data", "EnableRegexForceCorrection": 1 } ``` -## Stage +> [!NOTE] +> - This snippet shows a Stage object configured for recognizing raw text lines. +> - To use it, add this object to the `StageArray` within a [TextLinesRecognitionSection]({{ site.dcvb_parameters_reference }}label-recognizer-task-settings/section-text-lines-recognition.html). +> - 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) + +## Parameters + +### Stage + +Specifies the stage type. Fixed value: `SST_RECOGNIZE_RAW_TEXT_LINES`. -The stage is named `SST_RECOGNIZE_RAW_TEXT_LINES`. +| Parameter Details | +| :------------- | +| **Type**
    *string* | +| **Required**
    Yes | +| **Default Value**
    `"SST_RECOGNIZE_RAW_TEXT_LINES"` | -## DictionaryPath +### DictionaryPath -Parameter [`DictionaryPath`](dictionary-path.md) sets the path of the dictionary file. +Sets the path of the dictionary file. See [`DictionaryPath`](dictionary-path.md) for details. -## DictionaryCorrectionThresholds +### DictionaryCorrectionThresholds -Parameter [`DictionaryCorrectionThresholds`](dictionary-correction-thresholds.md) sets the threshold of dictionary error correction. +Sets the threshold of dictionary error correction. See [`DictionaryCorrectionThresholds`](dictionary-correction-thresholds.md) for details. -## ConfusableCharactersPath +### ConfusableCharactersPath -Parameter [`ConfusableCharactersPath`](confusable-characters-path.md) sets the path to the .data file containing characters features for confusable characters telling. +Sets the path to the .data file containing characters features for confusable characters telling. See [`ConfusableCharactersPath`](confusable-characters-path.md) for details. -## ClusterSamplesCountThreshold +### ClusterSamplesCountThreshold -Parameter [`ClusterSamplesCountThreshold`](cluster-samples-count-threshold.md) sets the threshold of cluster samples count. +Sets the threshold of cluster samples count. See [`ClusterSamplesCountThreshold`](cluster-samples-count-threshold.md) for details. -## OverlappingCharactersPath +### OverlappingCharactersPath -Parameter [`OverlappingCharactersPath`](overlapping-characters-path.md) sets the path to the .data file containing characters features for overlapping matching. +Sets the path to the .data file containing characters features for overlapping matching. See [`OverlappingCharactersPath`](overlapping-characters-path.md) for details. -## EnableRegexForceCorrection +### EnableRegexForceCorrection -Parameter [`EnableRegexForceCorrection`](enable-regex-force-correction.md) sets whether to enable forced correction based on the RegexPattern. +Sets whether to enable forced correction based on the RegexPattern. See [`EnableRegexForceCorrection`](enable-regex-force-correction.md) for details. diff --git a/parameters/reference/label-recognizer-task-settings/start-section.md b/parameters/reference/label-recognizer-task-settings/start-section.md deleted file mode 100644 index 5f27be8..0000000 --- a/parameters/reference/label-recognizer-task-settings/start-section.md +++ /dev/null @@ -1,29 +0,0 @@ ---- -layout: default-layout -title: StartSection - Dynamsoft Label Recognizer Parameters -description: The parameter StartSection defines the start section of the label recognition algorithm task. -keywords: Start section -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true ---- - -# StartSection - -Parameter `StartSection` defines the start section of the `LabelRecognizerTask`. - -## Example - -```json -{ - "StartSection": "ST_REGION_PREDETECTION" -} -``` - -## Parameter Summary - -| StartSection Parameter Summary | -| :---------------------------- | -| **Type**
    *String* | -| **Range**
    ST_REGION_PREDETECTION
    ST_TEXT_LINE_LOCALIZATION | -| **Default Value**
    ST_REGION_PREDETECTION | diff --git a/parameters/reference/label-recognizer-task-settings/string-length-range.md b/parameters/reference/label-recognizer-task-settings/string-length-range.md index d482a57..5c63a04 100644 --- a/parameters/reference/label-recognizer-task-settings/string-length-range.md +++ b/parameters/reference/label-recognizer-task-settings/string-length-range.md @@ -3,26 +3,43 @@ layout: default-layout title: StringLengthRange - Dynamsoft Label Recognizer Parameters description: The parameter StringLengthRange of Dynamsoft Label Recognizer defines the range of string lengths for concatenated strings of recognized text lines. keywords: text lines, concatenated strings length -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- # StringLengthRange Parameter `StringLengthRange` sets the range of string lengths for concatenated strings of recognized text lines. -## Example +## JSON Structure + +**Location in template:** + +``` +LabelRecognizerTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_ASSEMBLE_TEXT_LINES") + └── StringLengthRange +``` + +**Parent object:** [AssembleTextLinesStage]({{ site.dcvb_parameters }}reference/label-recognizer-task-settings/stage-assemble-text-lines.html) + +**Example:** ```json { - "StringLengthRange" : [3,200] + "StringLengthRange": [3,200] } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `StringLengthRange` parameter. +> - To use it, embed this parameter within a [AssembleTextLinesStage]({{ site.dcvb_parameters }}reference/label-recognizer-task-settings/stage-assemble-text-lines.html) object. +> - For the complete JSON structure, see: +> - [Full JSON Structure]({{ site.dcvb_parameters }}file/index.html) +> - [Minimal Valid JSON]({{ site.dcvb_parameters }}file/index.html#minimal-valid-json) + +## Parameter Details -| StringLengthRange Parameter Summary | +| StringLengthRange Parameter Details | | :----------------------------------- | | **Type**
    *int[]* | | **Range**
    The array contains only two elements, corresponding to the lower and upper bounds of the Range, respectively. The value range is [0, 0x7fffffff].| diff --git a/parameters/reference/label-recognizer-task-settings/string-regex-pattern.md b/parameters/reference/label-recognizer-task-settings/string-regex-pattern.md index f7cda8d..fe7ba96 100644 --- a/parameters/reference/label-recognizer-task-settings/string-regex-pattern.md +++ b/parameters/reference/label-recognizer-task-settings/string-regex-pattern.md @@ -3,26 +3,43 @@ layout: default-layout title: StringRegExPattern - Dynamsoft Label Recognizer Parameters description: The parameter StringRegExPattern of Dynamsoft Label Recognizer defines the regular expression pattern for concatenated strings of recognized text lines. keywords: text lines, concatenated strings, regular expression -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- # StringRegExPattern Parameter `StringRegExPattern` specifies the regular expression pattern for concatenated strings of recognized text lines. -## Example +## JSON Structure + +**Location in template:** + +``` +LabelRecognizerTaskSettingOptions[i] + └── SectionArray[j] (Section object) + └── StageArray[k] (Stage object where Stage = "SST_ASSEMBLE_TEXT_LINES") + └── StringRegExPattern +``` + +**Parent object:** [AssembleTextLinesStage]({{ site.dcvb_parameters }}reference/label-recognizer-task-settings/stage-assemble-text-lines.html) + +**Example:** ```json { - "StringRegExPattern" : "" + "StringRegExPattern": "" } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `StringRegExPattern` parameter. +> - To use it, embed this parameter within a [AssembleTextLinesStage]({{ site.dcvb_parameters }}reference/label-recognizer-task-settings/stage-assemble-text-lines.html) object. +> - For the complete JSON structure, see: +> - [Full JSON Structure]({{ site.dcvb_parameters }}file/index.html) +> - [Minimal Valid JSON]({{ site.dcvb_parameters }}file/index.html#minimal-valid-json) + +## Parameter Details -| StringRegExPattern Parameter Summary | +| StringRegExPattern Parameter Details | | :----------------------------------- | | **Type**
    *String* | | **Range**
    All standard regular expressions.| diff --git a/parameters/reference/label-recognizer-task-settings/terminate-setting.md b/parameters/reference/label-recognizer-task-settings/terminate-setting.md deleted file mode 100644 index 3a560d7..0000000 --- a/parameters/reference/label-recognizer-task-settings/terminate-setting.md +++ /dev/null @@ -1,67 +0,0 @@ ---- -layout: default-layout -title: TerminateSetting - Dynamsoft Label Recognizer Parameters -description: The parameter TerminateSetting defines the terminate stages of the label recognition task. -keywords: Terminate setting -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true ---- - -# TerminateSetting - -Parameter `TerminateSetting` defines the terminate stages of each section in the task. For each sections, you can define only one terminate stage. - -## Example - -```json -"TerminateSetting": -{ - "Section": "ST_REGION_PREDETECTION", - "Stage": "IRUT_GRAYSCALE_IMAGE" -} -``` - -## Parameter Summary - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    Child Parameter NameChild Parameter Summary
    Section
    Description
    Specifies a mode for ordering.
    Type
    String
    Range
    One of the following SectionType as a string. -
    ST_REGION_PREDETECTION -
    ST_TEXT_LINE_LOCALIZATION -
    ST_TEXT_LINE_RECOGNITION -
    Stage
    Description
    Specifies a mode for ordering.
    Type
    String
    Range
    One of the IntermediateResultUnitType as a string. The available stage type is different for each sections. View the appendix for more details. -
    - -## Appendix - Available Stage for Sections - -| Section | Available Stages | -| :------------------ | :--------------- | -| ST_REGION_PREDETECTION | IRUT_COLOUR_IMAGE
    IRUT_SCALED_DOWN_COLOUR_IMAGE
    IRUT_GRAYSCALE_IMAGE
    IRUT_TRANSFORMED_GRAYSCALE_IMAGE
    IRUT_PREDETECTED_REGIONS | -| ST_TEXT_LINE_LOCALIZATION | IRUT_COLOUR_IMAGE
    IRUT_SCALED_DOWN_COLOUR_IMAGE
    IRUT_GRAYSCALE_IMAGE
    IRUT_TRANSFORMED_GRAYSCALE_IMAGE
    IRUT_ENHANCED_GRAYSCALE_IMAGE
    IRUT_BINARY_IMAGE
    IRUT_TEXTURE_DETECTION_RESULT
    IRUT_TEXTURE_REMOVED_GRAYSCALE_IMAGE
    IRUT_TEXTURE_REMOVED_BINARY_IMAGE
    IRUT_TEXT_ZONES
    IRUT_TEXT_REMOVED_BINARY_IMAGE
    IRUT_LOCALIZED_TEXT_LINES | -| ST_TEXT_LINE_RECOGNITION | IRUT_COLOUR_IMAGE
    IRUT_GRAYSCALE_IMAGE
    IRUT_TRANSFORMED_GRAYSCALE_IMAGE
    IRUT_RECOGNIZED_TEXT_LINES | diff --git a/parameters/reference/label-recognizer-task-settings/text-line-specification-name-array.md b/parameters/reference/label-recognizer-task-settings/text-line-specification-name-array.md index 281ab96..05257fa 100644 --- a/parameters/reference/label-recognizer-task-settings/text-line-specification-name-array.md +++ b/parameters/reference/label-recognizer-task-settings/text-line-specification-name-array.md @@ -1,18 +1,25 @@ --- layout: default-layout title: TextLineSpecificationNameArray - Dynamsoft Label Recognizer Parameters -description: The parameter TextLineSpecificationNameArray of Dynamsoft Label Recognizer defines the collection of text line specification object names +description: The parameter TextLineSpecificationNameArray defines the collection of text line specification object names. keywords: text line specification, LabelRecognizerTaskSetting -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true --- # TextLineSpecificationNameArray -Parameter `TextLineSpecificationNameArray` defines the collection of text line specification object names, used to refer to the `TextLineSpecification` objects +`TextLineSpecificationNameArray` defines the collection of text line specification object names, used to refer to the `TextLineSpecification` objects. -## Example +## JSON Structure + +**Location in template:** +``` +LabelRecognizerTaskSettingOptions[i] + └── TextLineSpecificationNameArray +``` + +**Parent object:** [LabelRecognizerTaskSetting]({{ site.dcvb_parameters }}file/task-settings/label-recognizer-task-settings.html) + +**Example:** ```json { @@ -20,11 +27,18 @@ Parameter `TextLineSpecificationNameArray` defines the collection of text line s } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `TextLineSpecificationNameArray` parameter. +> - To use it, embed this parameter within a [LabelRecognizerTaskSetting]({{ site.dcvb_parameters }}file/task-settings/label-recognizer-task-settings.html) object in the complete JSON structure. +> - 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 -| TextLineSpecificationNameArray Parameter Summary | +| TextLineSpecificationNameArray Parameter Details | | :----------------------------------- | | **Type**
    *String[]* | | **Range**
    Each element is the name of a `TextLineSpecification` object. | | **Default Value**
    ['tls_default'] | -| **Remarks**
    If `TextLineSpecificationNameArray` is not specified, a default array ["tls_default"] will be created. The TextLineSpecification object with the name "tls_default" will have a default configuration for all text lines.| +| **Remarks**
    If `TextLineSpecificationNameArray` is not specified, a default array ["tls_default"] will be created. The `TextLineSpecification` object with the name "tls_default" will have a default configuration for all text lines.| diff --git a/parameters/reference/output-task-setting/index.md b/parameters/reference/output-task-setting/index.md deleted file mode 100644 index 4ac9bf7..0000000 --- a/parameters/reference/output-task-setting/index.md +++ /dev/null @@ -1,17 +0,0 @@ ---- -layout: default-layout -title: Index - OutputTaskSetting Parameters -description: The index of OutputTaskSetting parameters. -keywords: OutputTaskSetting, parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/output-task-setting/index.html ---- - -# OutputTaskSetting Parameters - -| Parameter Name | Description | -| -------------- | ----------- | -| [`Name`](name.md) | Defines the name of a `OutputTaskSetting` object, which serves as its unique identifier. | -| [`OutputCondidtion`](output-condition.md) | Defines how the [`OutputTaskSetting`](../../file/task-settings/output-task-setting.md) object outputs results that satisfy multiple filter conditions across products. | diff --git a/parameters/reference/output-task-setting/name.md b/parameters/reference/output-task-setting/name.md index f13962b..7eb3f34 100644 --- a/parameters/reference/output-task-setting/name.md +++ b/parameters/reference/output-task-setting/name.md @@ -13,7 +13,17 @@ permalink: /parameters/reference/output-task-setting/name.html Parameter `Name` represents the name of a `OutputTaskSetting` object, which serves as its unique identifier. -## Example +## JSON Structure + +**Location in template:** +``` +OutputTaskSettingOptions[i] + └── Name +``` + +**Parent object:** [OutputTaskSetting]({{ site.dcvb_parameters }}file/task-settings/output-task-setting.html) object + +**Example:** ```json { @@ -21,7 +31,15 @@ Parameter `Name` represents the name of a `OutputTaskSetting` object, which serv } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `Name` parameter. +> - To use it, embed this parameter within a [OutputTaskSetting]({{ site.dcvb_parameters }}file/task-settings/output-task-setting.html) 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 Details | | :----------------------------------- | diff --git a/parameters/reference/output-task-setting/output-condition.md b/parameters/reference/output-task-setting/output-condition.md index 0d5452e..b1c373a 100644 --- a/parameters/reference/output-task-setting/output-condition.md +++ b/parameters/reference/output-task-setting/output-condition.md @@ -3,17 +3,30 @@ layout: default-layout title: OutputCondition - Dynamsoft Capture Vision OutputSetting Object description: The parameter OutputCondition of OutputSetting object defines the OutputCondition information of the ROIs. keywords: OutputCondition -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true -permalink: /parameters/reference/output-task-setting/output-condition.html --- # OutputCondition -The parameter `OutputCondition` defines how the [`OutputTaskSetting`](../../file/task-settings/output-task-setting.md) object outputs results that satisfy multiple filter conditions across products. +## Overview -## Example +The parameter `OutputCondition` defines how the [`OutputTaskSetting`](../../file/task-settings/output-task-setting.md) object outputs results that satisfy multiple filter conditions across products. It allows you to configure complex filtering logic by combining results from multiple tasks and TargetROIDef objects using logical operators (AND/OR). + +**Use Cases:** +- Filter outputs based on conditions from descendant TargetROIDef tasks +- Combine results from multiple processing tasks with logical operators +- Reference specific atomic result types from previous tasks + +## JSON Structure + +**Location in template:** +``` +OutputTaskSettingOptions[i] + └── OutputCondition +``` + +**Parent object:** [OutputTaskSetting]({{ site.dcvb_parameters }}file/task-settings/output-task-setting.html) object + +**Example:** ```json { @@ -23,7 +36,6 @@ The parameter `OutputCondition` defines how the [`OutputTaskSetting`](../../file "TargetROIDefName": "B", "TaskSettingNameArray": ["B_task"], "Operator": "AND", - "BackwardReferenceOutput": { "ReferenceTaskNameArray": ["A_task"], "ReferenceResultTypeArray":[ "ART_TEXT_LINE","ART_BARCODE","ART_FRAME", "ART_TABLE_CELL", "ART_COLOUR_REGION" ] @@ -35,83 +47,117 @@ The parameter `OutputCondition` defines how the [`OutputTaskSetting`](../../file } ``` -## Parameter Summary +**Example Explanation:** -### TaskResultArray +This configuration filters output results where: +- The top-level `Operator` is "AND", requiring all conditions in `TaskResultArray` to be met +- Results from task "B_task" on TargetROIDef "B" must exist +- These results must have backward references to task "A_task" +- The referenced results must be one of the specified atomic result types (text lines, barcodes, frames, table cells, or color regions) + +> [!NOTE] +> - This snippet shows only the `OutputCondition` parameter. +> - To use it, embed this parameter within a [OutputTaskSetting]({{ site.dcvb_parameters }}file/task-settings/output-task-setting.html) 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) -The parameter `TaskResultArray` configures multiple tasks of descendant `TargetROIDef` objects to filter out the results of the tasks of the reference `TargetROIDef`. -### Operator +## Parameter Details -The parameter `Operator` defines the type of filtered combination of results from multiple tasks within a `TargetROIDef` object or across multiple `TargetROIDef` objects. +### Operator (Top-Level) -| Operator Parameter Summary | +The top-level `Operator` parameter defines how to combine the conditions from multiple items in the `TaskResultArray`. + +| Operator Parameter Details | | :------------------- | | **Type**
    *String* | | **Range**
    One of the following values: "OR", "AND" | | **Default Value**
    "AND"| +**Explanation:** +- **"AND"**: All conditions in `TaskResultArray` must be satisfied +- **"OR"**: At least one condition in `TaskResultArray` must be satisfied + +### TaskResultArray + +The parameter `TaskResultArray` is an array that configures multiple filtering conditions based on tasks from descendant `TargetROIDef` objects. Each array element represents one filtering condition. + +**Type:** Array of objects + +Each object in the array contains the following parameters: + #### TargetROIDefName -The parameter `TargetROIDefName` configures the name of descendant `TargetROIDef` object. +Specifies the name of the descendant `TargetROIDef` object to reference. -| TargetROIDefName Parameter Summary | +| TargetROIDefName Parameter Details | | :------------------- | | **Type**
    *String* | -| **Range**
    One of the names of descendant `TargetROIDef` object | -| **Default Value**
    mandatory| +| **Range**
    Must be one of the descendant `TargetROIDef` object names defined in your template | +| **Default Value**
    Mandatory (no default)| #### TaskSettingNameArray -The parameter `TaskSettingNameArray` specifies the task name array on the descendant `TargetROIDef` object. +Specifies which tasks on the descendant `TargetROIDef` object to check for results. -| TaskSettingNameArray Parameter Summary | +| TaskSettingNameArray Parameter Details | | :------------------- | -| **Type**
    *String[]* | -| **Range**
    Each member of the array should be one of the task in the descendant `TargetROIDef` object. | +| **Type**
    *String[]* (Array of strings) | +| **Range**
    Each member must be a valid task name in the specified descendant `TargetROIDef` object | | **Default Value**
    null| +#### Operator (Task-Level) + +Defines how to combine multiple task results within this specific condition. + +| Operator Parameter Details | +| :------------------- | +| **Type**
    *String* | +| **Range**
    One of the following values: "OR", "AND" | +| **Default Value**
    "AND"| + +**Note:** This is different from the top-level `Operator`. The task-level operator combines results within a single `TaskResultArray` item, while the top-level operator combines across multiple array items. + #### BackwardReferenceOutput - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    Child Parameter NameChild Parameter Summary
    ReferenceTaskNameArrayDescription
    Specifies the task name array on the TargetROIDef object. -
    Type
    String[] -
    Range
    Each member of the array should be one of the task in the reference `TargetROIDef` object. -
    Default Value
    null -
    ReferenceResultTypeArrayDescription
    Specifies the type of atomic results produced by tasks (except OutputTask) on the TargetROIDef object. -
    Type
    String[] -
    Range
    Each member should be one of the `AtomicResultType`, which are `ART_TEXT_LINE`, `ART_BARCODE`, `ART_FRAME` and `ART_COLOUR_REGION` -
    Default Value
    ["ART_TEXT_LINE","ART_BARCODE","ART_FRAME"] -
    +Configures backward reference filtering based on results from the reference (parent) `TargetROIDef` object. + +##### ReferenceTaskNameArray + +Specifies which tasks on the reference `TargetROIDef` object to check for backward references. + +| ReferenceTaskNameArray Parameter Details | +| :------------------- | +| **Type**
    *String[]* (Array of strings) | +| **Range**
    Each member must be a valid task name in the reference `TargetROIDef` object | +| **Default Value**
    null| + +##### ReferenceResultTypeArray + +Specifies which types of atomic results to accept from the referenced tasks. + +| ReferenceResultTypeArray Parameter Details | +| :------------------- | +| **Type**
    *String[]* (Array of strings) | +| **Range**
    Each member must be one of the following `AtomicResultType` values:
    - `"ART_TEXT_LINE"`: Text line results
    - `"ART_BARCODE"`: Barcode results
    - `"ART_FRAME"`: Frame results
    - `"ART_TABLE_CELL"`: Table cell results
    - `"ART_COLOUR_REGION"`: Color region results | +| **Default Value**
    ["ART_TEXT_LINE","ART_BARCODE","ART_FRAME"]| + +## Terminology + +- **Reference TargetROIDef**: The parent or current `TargetROIDef` object that contains the `OutputTaskSetting` with this `OutputCondition` +- **Descendant TargetROIDef**: Child `TargetROIDef` objects that are referenced in the `TaskResultArray` +- **Backward Reference**: A link from a descendant task result back to a parent task result + +## Best Practices + +1. **Use meaningful names**: Choose descriptive names for TargetROIDef and task settings to make your configuration easier to understand +2. **Start simple**: Begin with a single condition and "AND" operator, then add complexity as needed +3. **Specify result types**: Explicitly set `ReferenceResultTypeArray` to only include the atomic result types you actually need +4. **Test conditions**: Verify that your filter conditions work as expected with sample data before deploying + +## See Also + +- [OutputTaskSetting]({{ site.dcvb_parameters }}file/task-settings/output-task-setting.html) +- [TargetROIDef]({{ site.dcvb_parameters }}file/target-roi-definition/index.html) +- [Full JSON Structure]({{ site.dcvb_parameters }}file/index.html#full-json-structure) diff --git a/parameters/reference/semantic-processing/index.md b/parameters/reference/semantic-processing/index.md deleted file mode 100644 index 316f9d5..0000000 --- a/parameters/reference/semantic-processing/index.md +++ /dev/null @@ -1,18 +0,0 @@ ---- -layout: default-layout -title: Index - SemanticProcessing Parameters -description: The index of SemanticProcessing parameters. -keywords: SemanticProcessing, parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true -permalink: /parameters/reference/semantic-processing/index.html ---- - -# SemanticProcessing Parameters - -| Parameter Name | Description | -| -------------- | ----------- | -| [`Name`](name.md) | Defines the name of a `SemanticProcessing` object, which serves as its unique identifier. | -| [`ReferenceObjectFilter`](reference-object-filter.md) | Sets a [ReferenceObjectFilter](#referenceobjectfilter) object to define the filter conditions. | -| [`TaskSettingsNameArray`](task-setting-name-array.md) | Represents the collection of task setting object names, used to refer to the `CodeParserTaskSetting` objects. | diff --git a/parameters/reference/semantic-processing/name.md b/parameters/reference/semantic-processing/name.md index 0088e08..a7ab58c 100644 --- a/parameters/reference/semantic-processing/name.md +++ b/parameters/reference/semantic-processing/name.md @@ -3,16 +3,23 @@ layout: default-layout title: Name - Dynamsoft Capture Vision semantic processing object description: The parameter Name defines the unique identifier of SemanticProcessing object. keywords: top-level object, name, unique identifier, semantic processing -needAutoGenerateSidebar: true -noTitleIndex: true needGenerateH3Content: true --- - # Name Parameter `Name` represents the name of a `SemanticProcessing` object, which serves as its unique identifier. -## Example +## JSON Structure + +**Location in template:** +``` +SemanticProcessingOptions[i] + └── Name +``` + +**Parent object:** [SemanticProcessing]({{ site.dcvb_parameters }}file/semantic-processing/index.html) object + +**Example:** ```json { @@ -20,7 +27,14 @@ Parameter `Name` represents the name of a `SemanticProcessing` object, which ser } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `Name` parameter. +> - To use it, embed this parameter within a [SemanticProcessing]({{ site.dcvb_parameters }}file/semantic-processing/index.html) 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 Details | | :----------------------------------- | diff --git a/parameters/reference/semantic-processing/reference-object-filter.md b/parameters/reference/semantic-processing/reference-object-filter.md index 2de623d..2c9419b 100644 --- a/parameters/reference/semantic-processing/reference-object-filter.md +++ b/parameters/reference/semantic-processing/reference-object-filter.md @@ -3,64 +3,84 @@ layout: default-layout title: ReferenceObjectFilter - Dynamsoft Capture Vision Semantic Processing object description: The parameter ReferenceObjectFilter defines a group of filter conditions for figuring out the `reference objects`. keywords: referenceobjectfilter -needAutoGenerateSidebar: true -noTitleIndex: true needGenerateH3Content: true --- - # ReferenceObjectFilter Parameter `ReferenceObjectFilter` is a group of filter conditions for figuring out the `reference objects`. +## JSON Structure + +**Location in template:** +``` +SemanticProcessingOptions[i] + └── ReferenceObjectFilter +``` + +**Parent object:** [SemanticProcessing]({{ site.dcvb_parameters }}file/semantic-processing/index.html) object + +**Example:** + ```json -"ReferenceObjectFilter" : { - "ReferenceTargetROIDefNameArray": ["TR_0", "TR_1"], - "AtomicResultTypeArray" : ["ART_TEXT_LINE","ART_BARCODE","ART_FRAME","ART_TABLE_CELL"], - "BarcodeFilteringCondition": - { - "BarcodeFormatIds": ["BF_CODE39"], - "BarcodeTextRegExPattern": ".*b.*b.*b.*", - "RegionState": "default", - }, - "FrameFilteringCondition": - { - "ImageDimensionRange": [16384,0x7fffffff], - "AspectRatioRange": [1, 10000], - "WidthRange": [1, 0x7fffffff], - "HeightRange": [1, 0x7fffffff], - "RegionState": "default", - }, - "TextLineFilteringCondition": + "ReferenceObjectFilter": { - "LineNumbers": "1,3-5", - "LineStringRegExPattern": "Sodium[(\w| )]*", - "RegionState": "default", + "ReferenceTargetROIDefNameArray": ["TR_0", "TR_1"], + "AtomicResultTypeArray" : ["ART_TEXT_LINE","ART_BARCODE","ART_FRAME","ART_TABLE_CELL"], + "BarcodeFilteringCondition": + { + "BarcodeFormatIds": ["BF_CODE39"], + "BarcodeTextRegExPattern": ".*b.*b.*b.*", + "RegionState": "default", + }, + "FrameFilteringCondition": + { + "ImageDimensionRange": [16384,0x7fffffff], + "AspectRatioRange": [1, 10000], + "WidthRange": [1, 0x7fffffff], + "HeightRange": [1, 0x7fffffff], + "RegionState": "default", + }, + "TextLineFilteringCondition": + { + "LineNumbers": "1,3-5", + "LineStringRegExPattern": "Sodium[(\w| )]*", + "RegionState": "default", + } } } ``` -## ReferenceTargetROIDefNameArray +> [!NOTE] +> - This snippet shows only the `ReferenceObjectFilter` parameter. +> - To use it, embed this parameter within a [SemanticProcessing]({{ site.dcvb_parameters }}file/semantic-processing/index.html) 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 + +### ReferenceTargetROIDefNameArray Filter the reference object by specifying `TargetROI` names. -| ReferenceTargetROIDefNameArray Parameter Summary | +| ReferenceTargetROIDefNameArray Parameter Details | | :------------------- | | **Type**
    *String[]* | | **Range**
    Each member should be a name of `TargetROI` that defined in `TargetROIDefOptions`. | | **Default Value**
    null | -## AtomicResultTypeArray +### AtomicResultTypeArray Filter the reference object by specifying the type of atomic results. In the `TargetROIs` algorithm task can produce atomic results that can support the localization of the other `TargetROIs`. -| AtomicResultTypeArray Parameter Summary | +| AtomicResultTypeArray Parameter Details | | :------------------- | | **Type**
    *String[]* | | **Range**
    Each member should be one of the `AtomicResultType`, which are `ART_TEXT_LINE`, `ART_BARCODE`, `ART_FRAME`, `ART_TABLE_CELL`, `ART_GEOMETRY_LINE`, `ART_CORNER` and `ART_COLOUR_REGION` | | **Default Value**
    ["ART_TEXT_LINE","ART_BARCODE","ART_FRAME"] | -## BarcodeFilteringCondition +### BarcodeFilteringCondition One of the filter conditions. Filter the reference objects with the decoded barcode information. The parameter `BarcodeFilteringCondition` includes the following child parameters: @@ -103,7 +123,7 @@ One of the filter conditions. Filter the reference objects with the decoded barc -## FrameFilteringCondition +### FrameFilteringCondition One of the filter conditions. Filter the reference objects with the frame information. The parameter `FrameFilteringCondition` includes the following child parameters: @@ -169,7 +189,7 @@ One of the filter conditions. Filter the reference objects with the frame inform -## TextLineFilteringCondition +### TextLineFilteringCondition One of the filter conditions. Filter the reference objects with the text line content. The parameter `TextLineFilteringCondition` includes the following child parameters: diff --git a/parameters/reference/semantic-processing/task-setting-name-array.md b/parameters/reference/semantic-processing/task-setting-name-array.md index c6b387a..f9e942c 100644 --- a/parameters/reference/semantic-processing/task-setting-name-array.md +++ b/parameters/reference/semantic-processing/task-setting-name-array.md @@ -3,16 +3,23 @@ layout: default-layout title: TaskSettingNameArray - Dynamsoft Capture Vision Semantic Processing Parameters description: The parameter TaskSettingNameArray defines the collection of CodeParserTaskSetting object names. keywords: task settings, semantic processing -needAutoGenerateSidebar: true -noTitleIndex: true needGenerateH3Content: true --- - # TaskSettingNameArray Parameter `TaskSettingNameArray` represents the collection of task setting object names, used to refer to the [`CodeParserTaskSetting`](../../file/task-settings/code-parser-task-settings.md) objects. -## Example +## JSON Structure + +**Location in template:** +``` +SemanticProcessingOptions[i] + └── TaskSettingNameArray +``` + +**Parent object:** [SemanticProcessing]({{ site.dcvb_parameters }}file/semantic-processing.html) object + +**Example:** ```json { @@ -20,9 +27,16 @@ Parameter `TaskSettingNameArray` represents the collection of task setting objec } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `TaskSettingNameArray` parameter. +> - To use it, embed this parameter within a [SemanticProcessing]({{ site.dcvb_parameters }}file/semantic-processing.html) 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 -| TaskSettingNameArray Parameter Summary | +| TaskSettingNameArray Parameter Details | | :----------------------------------- | | **Type**
    *String[]* | | **Range**
    Each element represents the name of a `CodeParserTaskSetting` object. | diff --git a/parameters/reference/shared-parameter/directory-path.md b/parameters/reference/shared-parameter/directory-path.md deleted file mode 100644 index cc59f9c..0000000 --- a/parameters/reference/shared-parameter/directory-path.md +++ /dev/null @@ -1,30 +0,0 @@ ---- -layout: default-layout -title: DirectoryPath - Dynamsoft Capture Vision Shared Parameters -description: The parameter DirectoryPath defines a path. -keywords: Directory path -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true -permalink: /parameters/reference/shared-parameter/directory-path.html ---- - -# DirectoryPath - -Parameter `DirectoryPath` defines a path when the library have to read files. - -## Example - -```json -{ - "DirectoryPath" : "D:\\CharacterModel\\" -} -``` - -## Parameter Summary - -| DirectoryPath Parameter Summary | -| :------------- | -| **Type**
    *String* | - -> Note: Parameter `DirectoryPath` is available for `CharacterModel`, `ImageSourceOptions`. It has the same parameter type under different parent object. diff --git a/parameters/reference/shared-parameter/max-threads-in-one-task.md b/parameters/reference/shared-parameter/max-threads-in-one-task.md deleted file mode 100644 index be45c88..0000000 --- a/parameters/reference/shared-parameter/max-threads-in-one-task.md +++ /dev/null @@ -1,32 +0,0 @@ ---- -layout: default-layout -title: MaxThreadsInOneTask - Dynamsoft Capture Vision Shared Parameters -description: The parameter MaxThreadsInOneTask defines the maximum threads that can be consumed in one task. -keywords: Max threads -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true -permalink: /parameters/reference/shared-parameter/max-threads-in-one-task.html ---- - -# MaxThreadsInOneTask - -Parameter `MaxThreadsInOneTask` defines the maximum threads that can be consumed in one task. - -## Example - -```json -{ - "MaxThreadsInOneTask":4 -} -``` - -## Parameter Summary - -| MaxThreadsInOneTask Parameter Summary | -| :------------- | -| **Type**
    *int* | -| **Range**
    [0, 4] | -| **Default Value**
    4 | - -> Note: Parameter `MaxThreadsInOneTask` is available for `BarcodeReaderTaskSetting`, `LabelRecognizerTaskSetting` and `DocumentNormalizerTaskSetting`. They have the same parameter type, range and default value. diff --git a/parameters/reference/shared-parameter/name.md b/parameters/reference/shared-parameter/name.md deleted file mode 100644 index 0169525..0000000 --- a/parameters/reference/shared-parameter/name.md +++ /dev/null @@ -1,45 +0,0 @@ ---- -layout: default-layout -title: Name - Dynamsoft Capture Vision Shared Parameters -description: The parameter Name of Dynamsoft Capture Vision defines the unique identifier of top-level objects. -keywords: top-level object, name, unique identifier -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true -permalink: /parameters/reference/shared-parameter/name.html ---- - -# Name - -Parameter `Name` represents the name of the top-level objects in Dynamsoft Capture Vision Parameter Template, which serves as its unique identifier. - -## Example - -```json -{ - "Name" : "cv_0" -} -``` - -## Parameter Summary - -| Parameter Details | -| :----------------------------------- | -| **Type**
    *String* | -| **Default Value**
    It must be a mandatory setting value. | -| **Remarks**
    It must be a unique name. | - -**Note**: It is used as a unique identifier for the following top-level objects: - -- [CaptureVisionTemplate Object](../../file/capture-vision-template.md) -- [ImageSource Object](../../file/image-source.md) -- [TargetROIDef Object](../../file/target-roi-definition/index.md) -- [SematicProcessing Object](../../file/semantic-processing/index.md) -- [BarcodeReaderTaskSetting Object](../../file/task-settings/barcode-reader-task-settings.md) -- [LabelRecognizerTaskSetting Object](../../file/task-settings/label-recognizer-task-settings.md) -- [DocumentNormalizerTaskSetting Object](../../file/task-settings/document-normalizer-task-settings.md) -- [CodeParserTaskSetting Object](../../file/task-settings/code-parser-task-settings.md) -- [ImageParameter Object](../../file/image-parameter.md) -- [BarcodeFormatSpecification Object](../../file/auxiliary/barcode-format-specification.md) -- [CharacterModel Object](../../file/auxiliary/character-model.md) -- [TextLineSpecification Object](../../file/auxiliary/textline-specification.md) diff --git a/parameters/reference/shared-parameter/section-image-parameter-array.md b/parameters/reference/shared-parameter/section-image-parameter-array.md deleted file mode 100644 index d22d94a..0000000 --- a/parameters/reference/shared-parameter/section-image-parameter-array.md +++ /dev/null @@ -1,132 +0,0 @@ ---- -layout: default-layout -title: SectionImageParameterArray - Dynamsoft Capture Vision Shared Parameters -description: The parameter SectionImageParameterArray defines the image processing algorithms that implemented in the different sections of an algorithm task. -keywords: Section image parameter -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true -permalink: /parameters/reference/shared-parameter/section-image-parameter-array.html ---- - -# SectionImageParameterArray - -Parameter `SectionImageParameterArray` defines the image processing algorithms that implemented in the task. Each member of the array defines an algorithm section as well as its image processing parameters. - -## Example - -```json -{ - "SectionImageParameterArray": - [ - { - "Section": "ST_REGION_PREDETECTION", - "ImageParameterName": "IP_0" - }, - { - "Section": "ST_TEXT_LINE_LOCALIZATION", - "ImageParameterName": "IP_1" - } - - ] -} -``` - -## Parameter Summary - -Note: Parameter `SectionImageParameterArray` is available for `BarcodeReaderTaskSetting`, `LabelRecognizerTaskSetting` and `DocumentNormalizerTaskSetting`. It has different parameter range and default value under different parent object. - -### As a BarcodeReaderTaskSetting Parameter - - - - - - - - - - - - - - - - - - - - - - - - - -
    Child Parameter NameChild Parameter Summary
    Section
    Description
    Specifies an algorithm section.
    Type
    String
    Range
    One of the following SectionType as a string.
    ST_REGION_PREDETECTION -
    ST_BARCODE_LOCALIZATION -
    ST_BARCODE_DECODING -
    ImageParameterName
    Description
    Specifies a name that defined under ImageParameterOptions.
    Type
    String
    - -### As a DocumentNormalizerTaskSetting Parameter - - - - - - - - - - - - - - - - - - - - - - - - - -
    Child Parameter NameChild Parameter Summary
    Section
    Description
    Specifies an algorithm section.
    Type
    String
    Range
    One of the following SectionType as a string. -
    ST_REGION_PREDETECTION -
    ST_DOCUMENT_DETECTION -
    ST_DOCUMENT_NORMALIZATION -
    ImageParameterName
    Description
    Specifies a name that defined under ImageParameterOptions.
    Type
    String
    - -### As a LabelRecognizerTaskSetting Parameter - - - - - - - - - - - - - - - - - - - - - - - - - -
    Child Parameter NameChild Parameter Summary
    Section
    Description
    Specifies an algorithm section.
    Type
    String
    Range
    One of the following SectionType as a string. -
    ST_REGION_PREDETECTION -
    ST_TEXT_LINE_LOCALIZATION -
    ST_TEXT_LINE_RECOGNITION -
    ImageParameterName
    Description
    Specifies a name that defined under ImageParameterOptions.
    Type
    String
    diff --git a/parameters/reference/shared-parameter/start-section.md b/parameters/reference/shared-parameter/start-section.md deleted file mode 100644 index 46786bd..0000000 --- a/parameters/reference/shared-parameter/start-section.md +++ /dev/null @@ -1,50 +0,0 @@ ---- -layout: default-layout -title: StartSection - Dynamsoft Capture Vision Shared Parameters -description: The parameter StartSection defines the start section of the algorithm task. -keywords: Start section -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true -permalink: /parameters/reference/shared-parameter/start-section.html ---- - -# StartSection - -Parameter `StartSection` defines the start section of the algorithm task. - -## Example - -```json -{ - "StartSection": "ST_REGION_PREDETECTION" -} -``` - -## Parameter Summary - -Parameter `StartSection` is available for `BarcodeReaderTaskSetting`, `LabelRecognizerTaskSetting` and `DocumentNormalizerTaskSetting`. It has different parameter range but the same default value under different parent object. - -### As a BarcodeReaderTaskSetting Parameter - -| StartSection Parameter Summary | -| :---------------------------- | -| **Type**
    *String* | -| **Range**
    ST_REGION_PREDETECTION
    ST_BARCODE_LOCALIZATION
    ST_BARCODE_DECODING | -| **Default Value**
    ST_REGION_PREDETECTION | - -### As a DocumentNormalizerTaskSetting Parameter - -| StartSection Parameter Summary | -| :---------------------------- | -| **Type**
    *String* | -| **Range**
    ST_REGION_PREDETECTION
    ST_DOCUMENT_DETECTION
    ST_DOCUMENT_NORMALIZATION | -| **Default Value**
    ST_REGION_PREDETECTION | - -### As a LabelRecognizerTaskSetting Parameter - -| StartSection Parameter Summary | -| :---------------------------- | -| **Type**
    *String* | -| **Range**
    ST_REGION_PREDETECTION
    ST_TEXT_LINE_LOCALIZATION
    ST_TEXT_LINE_RECOGNITION | -| **Default Value**
    ST_REGION_PREDETECTION | diff --git a/parameters/reference/shared-parameter/terminate-setting.md b/parameters/reference/shared-parameter/terminate-setting.md deleted file mode 100644 index 7cca9cb..0000000 --- a/parameters/reference/shared-parameter/terminate-setting.md +++ /dev/null @@ -1,150 +0,0 @@ ---- -layout: default-layout -title: TerminateSetting - Dynamsoft Capture Vision Shared Parameters -description: The parameter TerminateSetting defines the terminate stages of the task. -keywords: Terminate setting -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true -permalink: /parameters/reference/shared-parameter/terminate-setting.html ---- - -# TerminateSetting - -Parameter `TerminateSetting` defines the terminate stages of each section in the task. For each sections, you can define only one terminate stage. - -## Example - -```json -"TerminateSetting": -{ - "Section": "ST_REGION_PREDETECTION", - "Stage": "IRUT_GRAYSCALE_IMAGE" -} -``` - -## Parameter Summary - -Parameter `TerminateSetting` is available for `BarcodeReaderTaskSetting`, `LabelRecognizerTaskSetting` and `DocumentNormalizerTaskSetting`. It has different parameter range and default value under different parent object. - -### As a BarcodeReaderTaskSetting Parameter - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    Child Parameter NameChild Parameter Summary
    Section
    Description
    Specifies a mode for ordering.
    Type
    String
    Range
    One of the following SectionType as a string. -
    ST_REGION_PREDETECTION -
    ST_BARCODE_LOCALIZATION -
    ST_BARCODE_DECODING -
    Stage
    Description
    Specifies a mode for ordering.
    Type
    String
    Range
    One of the IntermediateResultUnitType as a string. The available stage type is different for each sections. View the appendix for more details. -
    - -### As a DocumentNormalizerTaskSetting Parameter - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    Child Parameter NameChild Parameter Summary
    Section
    Description
    Specifies a mode for ordering.
    Type
    String
    Range
    One of the following SectionType as a string. -
    ST_REGION_PREDETECTION -
    ST_DOCUMENT_DETECTION -
    ST_DOCUMENT_NORMALIZATION -
    Stage
    Description
    Specifies a mode for ordering.
    Type
    String
    Range
    One of the IntermediateResultUnitType as a string. The available stage type is different for each sections. View the appendix for more details. -
    - -### As a LabelRecognizerTaskSetting Parameter - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
    Child Parameter NameChild Parameter Summary
    Section
    Description
    Specifies a mode for ordering.
    Type
    String
    Range
    One of the following SectionType as a string. -
    ST_REGION_PREDETECTION -
    ST_TEXT_LINE_LOCALIZATION -
    ST_TEXT_LINE_RECOGNITION -
    Stage
    Description
    Specifies a mode for ordering.
    Type
    String
    Range
    One of the IntermediateResultUnitType as a string. The available stage type is different for each sections. View the appendix for more details. -
    - -## Appendix - Available Stage for Sections - -| Section | Available Stages | -| :------------------ | :--------------- | -| ST_REGION_PREDETECTION | IRUT_COLOUR_IMAGE
    IRUT_SCALED_DOWN_COLOUR_IMAGE
    IRUT_GRAYSCALE_IMAGE
    IRUT_TRANSFORMED_GRAYSCALE_IMAGE
    IRUT_PREDETECTED_REGIONS | -| ST_BARCODE_LOCALIZATION | IRUT_COLOUR_IMAGE
    IRUT_SCALED_DOWN_COLOUR_IMAGE
    IRUT_GRAYSCALE_IMAGE
    IRUT_TRANSFORMED_GRAYSCALE_IMAGE
    IRUT_ENHANCED_GRAYSCALE_IMAGE
    IRUT_BINARY_IMAGE
    IRUT_TEXTURE_DETECTION_RESULT
    IRUT_TEXTURE_REMOVED_GRAYSCALE_IMAGE
    IRUT_TEXTURE_REMOVED_BINARY_IMAGE
    IRUT_TEXT_ZONES
    IRUT_TEXT_REMOVED_BINARY_IMAGE
    IRUT_CONTOURS
    IRUT_LINE_SEGMENTS
    IRUT_CANDIDATE_BARCODE_ZONES
    IRUT_LOCALIZED_BARCODES | -| ST_BARCODE_DECODING | IRUT_COLOUR_IMAGE
    IRUT_GRAYSCALE_IMAGE
    IRUT_TRANSFORMED_GRAYSCALE_IMAGE
    IRUT_DEFORMATION_RESISTED_BARCODE_IMAGE
    IRUT_COMPLEMENTED_BARCODE_IMAGE
    IRUT_SCALED_UP_BARCODE_IMAGE
    IRUT_DECODED_BARCODES | -| ST_DOCUMENT_DETECTION | IRUT_COLOUR_IMAGE
    IRUT_SCALED_DOWN_COLOUR_IMAGE
    IRUT_GRAYSCALE_IMAGE
    IRUT_TRANSFORMED_GRAYSCALE_IMAGE
    IRUT_ENHANCED_GRAYSCALE_IMAGE
    IRUT_BINARY_IMAGE
    IRUT_TEXTURE_DETECTION_RESULT
    IRUT_TEXTURE_REMOVED_GRAYSCALE_IMAGE
    IRUT_TEXTURE_REMOVED_BINARY_IMAGE
    IRUT_TEXT_ZONES
    IRUT_TEXT_REMOVED_BINARY_IMAGE
    IRUT_CONTOURS
    IRUT_LINE_SEGMENTS
    IRUT_LONG_LINES
    IRUT_CORNERS
    IRUT_CANDIDATE_QUAD_EDGES
    IRUT_DETECTED_QUADS | -| ST_DOCUMENT_NORMALIZATION | IRUT_NORMALIZED_IMAGES | -| ST_TEXT_LINE_LOCALIZATION | IRUT_COLOUR_IMAGE
    IRUT_SCALED_DOWN_COLOUR_IMAGE
    IRUT_GRAYSCALE_IMAGE
    IRUT_TRANSFORMED_GRAYSCALE_IMAGE
    IRUT_ENHANCED_GRAYSCALE_IMAGE
    IRUT_BINARY_IMAGE
    IRUT_TEXTURE_DETECTION_RESULT
    IRUT_TEXTURE_REMOVED_GRAYSCALE_IMAGE
    IRUT_TEXTURE_REMOVED_BINARY_IMAGE
    IRUT_TEXT_ZONES
    IRUT_TEXT_REMOVED_BINARY_IMAGE
    IRUT_LOCALIZED_TEXT_LINES | -| ST_TEXT_LINE_RECOGNITION | IRUT_COLOUR_IMAGE
    IRUT_GRAYSCALE_IMAGE
    IRUT_TRANSFORMED_GRAYSCALE_IMAGE
    IRUT_RECOGNIZED_TEXT_LINES | diff --git a/parameters/reference/target-roi-def/base-target-roidef-name.md b/parameters/reference/target-roi-def/base-target-roidef-name.md index 3a4309a..5be327c 100644 --- a/parameters/reference/target-roi-def/base-target-roidef-name.md +++ b/parameters/reference/target-roi-def/base-target-roidef-name.md @@ -3,17 +3,23 @@ layout: default-layout title: BaseTargetROIDefName - Dynamsoft Capture Vision Parameters description: The parameter BaseTargetROIDefName of Dynamsoft Capture Vision defines the name of the inherited TargetROIDef object. keywords: inheritance, TargetROIDef -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true permalink: /parameters/reference/target-roi-def/base-target-roidef-name.html --- - # BaseTargetROIDefName Parameter `BaseTargetROIDefName` represents the name of another `TargetROIDef` object. It is used to inherit the parameters defined in its parent `TargetROIDef` object. If a parameter has already been defined in this object, the parameter with the same name will not be inherited from the parent object. -## Example +## JSON Structure + +**Location in template:** +``` +TargetROIDefOptions[i] + └── BaseTargetRoidefName +``` + +**Parent object:** [TargetROIDef]({{ site.dcvb_parameters }}file/target-roi-definition/index.html) object + +**Example:** ```json { @@ -21,9 +27,16 @@ Parameter `BaseTargetROIDefName` represents the name of another `TargetROIDef` o } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `BaseTargetRoidefName` parameter. +> - To use it, embed this parameter within a [TargetROIDef]({{ site.dcvb_parameters }}file/target-roi-definition/index.html) 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 -| BaseTargetROIDefName Parameter Summary | +| BaseTargetROIDefName Parameter Details | | :----------------------------------- | | **Type**
    *String* | | **Range**
    The name of the inherited `TargetROIDef` object. | diff --git a/parameters/reference/target-roi-def/enable-results-deduplication.md b/parameters/reference/target-roi-def/enable-results-deduplication.md index db6c41f..a4ea15e 100644 --- a/parameters/reference/target-roi-def/enable-results-deduplication.md +++ b/parameters/reference/target-roi-def/enable-results-deduplication.md @@ -3,16 +3,23 @@ layout: default-layout title: EnableResultsDeduplication - Dynamsoft Capture Vision Parameters description: The parameter EnableResultsDeduplication of Dynamsoft Capture Vision defines whether to enable the result deduplication. keywords: inheritance, deduplication, EnableResultsDeduplication -needAutoGenerateSidebar: true -noTitleIndex: true needGenerateH3Content: true --- - # EnableResultsDeduplication Parameter `EnableResultsDeduplication` defines whether to enable the result deduplication. -## Example +## JSON Structure + +**Location in template:** +``` +TargetROIDefOptions[i] + └── EnableResultsDeduplication +``` + +**Parent object:** [TargetROIDef]({{ site.dcvb_parameters }}file/target-roi-definition/index.html) object + +**Example:** ```json { @@ -20,9 +27,16 @@ Parameter `EnableResultsDeduplication` defines whether to enable the result dedu } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `EnableResultsDeduplication` parameter. +> - To use it, embed this parameter within a [TargetROIDef]({{ site.dcvb_parameters }}file/target-roi-definition/index.html) 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 -| EnableResultsDeduplication Parameter Summary | +| EnableResultsDeduplication Parameter Details | | :----------------------------------- | | **Type**
    *int* | | **Range**
    [0,1] | diff --git a/parameters/reference/target-roi-def/index.md b/parameters/reference/target-roi-def/index.md deleted file mode 100644 index e834988..0000000 --- a/parameters/reference/target-roi-def/index.md +++ /dev/null @@ -1,20 +0,0 @@ ---- -layout: default-layout -title: Index - TargetROIDef Parameters -description: The index of TargetROIDef parameters. -keywords: TargetROIDef, parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true ---- - -# TargetROIDef Parameters - -| Parameter Name | Description | -| --------------- | ----------- | -| [`BaseTargetROIDefName`](base-target-roidef-name.md) | Represents the name of another `TargetROIDef` object to inherit from. | -| [`EnableResultsDeduplication`](enable-results-deduplication.md) | Defines whether to deduplicate the results. | -| [`Location`](location.md) | Defines the location of the TargetROI with `reference objects` filter conditions and `offset` parameters. | -| [`Name`](name.md) | Defines the name of a `TargetROIDef` object, which serves as its unique identifier. | -| [`PauseFlag`](pause-flag.md) | Indicates that the region results generated by this `TargetROIDef` will not be used by other `TargetROIDef` objects that depend on it to calculate the target regions, unless the user explicitly performs an update operation. | -| [`TaskSettingNameArray`](task-setting-name-array.md) | Parameter `TaskSettingNameArray` represents the collection of task setting object names, used to refer to the `BarcodeReaderTaskSetting`, `LabelRecognizerTaskSetting`, `DocumentNormalizerTaskSetting` objects. | diff --git a/parameters/reference/target-roi-def/location.md b/parameters/reference/target-roi-def/location.md index db243e8..6e64b80 100644 --- a/parameters/reference/target-roi-def/location.md +++ b/parameters/reference/target-roi-def/location.md @@ -3,16 +3,23 @@ layout: default-layout title: Location - Dynamsoft Capture Vision Parameters description: The parameter Location of Dynamsoft Capture Vision defines the location information of the ROIs. keywords: Location -needAutoGenerateSidebar: true -noTitleIndex: true needGenerateH3Content: true --- - # Location Parameter `Location` defines the location of the TargetROI with `reference objects` filter conditions and `offset` parameters. -## Example +## JSON Structure + +**Location in template:** +``` +TargetROIDefOptions[i] + └── Location +``` + +**Parent object:** [TargetROIDef]({{ site.dcvb_parameters }}file/target-roi-definition/index.html) object + +**Example:** ```json { @@ -24,12 +31,21 @@ Parameter `Location` defines the location of the TargetROI with `reference objec } ``` -| Name | Description | +> [!NOTE] +> - This snippet shows only the `Location` parameter. +> - To use it, embed this parameter within a [TargetROIDef]({{ site.dcvb_parameters }}file/target-roi-definition/index.html) 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) + +## Parameters + +| Name | Description | | ---- | ----------- | | [`ReferenceObjectFilter`](#referenceobjectfilter) | Filter the reference object by specifying `TargetROI` names. | | [`Offset`](#offset) | Defines how the location is offset from the `reference object` or the original image. | -## ReferenceObjectFilter +### ReferenceObjectFilter Parameter `ReferenceObjectFilter` is a group of filter conditions for figuring out the `reference objects`. @@ -37,7 +53,7 @@ Parameter `ReferenceObjectFilter` is a group of filter conditions for figuring o | :------------------- | | **Type**
    *[ReferenceObjectFilter](location/reference-object-filter/index.md)* Object | -## Offset +### Offset Parameter `Offset` is an object that defines how the location is offset from the `reference object` or the original image. diff --git a/parameters/reference/target-roi-def/location/offset/index.md b/parameters/reference/target-roi-def/location/offset/index.md index c97dbc0..34a1322 100644 --- a/parameters/reference/target-roi-def/location/offset/index.md +++ b/parameters/reference/target-roi-def/location/offset/index.md @@ -3,26 +3,25 @@ layout: default-layout title: Dynamsoft Capture Vision Parameters description: The parameter Location of Dynamsoft Capture Vision defines the location information of the ROIs. keywords: Location -needAutoGenerateSidebar: true -noTitleIndex: true needGenerateH3Content: true --- - # Offset Parameter `Offset` is an object that defines how the location is offset from the `reference object` or the original image. It includes the following child parameters: ```json -"Offset": { - "ReferenceObjectOriginIndex": 0, - "ReferenceObjectType": "ROT_ATOMIC_OBJECT", - "ReferenceXAxis": {}, - "ReferenceYAxis": {}, - "MeasuredByPercentage" : 1, - "FirstPoint" : [ 0, 0 ], - "SecondPoint" : [ 100, 0 ], - "ThirdPoint" : [ 100, 100 ], - "FourthPoint" : [ 0, 100 ] +{ + "Offset": { + "ReferenceObjectOriginIndex": 0, + "ReferenceObjectType": "ROT_ATOMIC_OBJECT", + "ReferenceXAxis": {}, + "ReferenceYAxis": {}, + "MeasuredByPercentage" : 1, + "FirstPoint" : [ 0, 0 ], + "SecondPoint" : [ 100, 0 ], + "ThirdPoint" : [ 100, 100 ], + "FourthPoint" : [ 0, 100 ] + } } ``` diff --git a/parameters/reference/target-roi-def/location/offset/offset-parameter-details.md b/parameters/reference/target-roi-def/location/offset/offset-parameter-details.md index e6a0bc4..f428ba2 100644 --- a/parameters/reference/target-roi-def/location/offset/offset-parameter-details.md +++ b/parameters/reference/target-roi-def/location/offset/offset-parameter-details.md @@ -3,11 +3,8 @@ layout: default-layout title: Dynamsoft Capture Vision Parameters description: The parameter Location of Dynamsoft Capture Vision defines the location information of the ROIs. keywords: Location -needAutoGenerateSidebar: true -noTitleIndex: true needGenerateH3Content: true --- - # Offset Parameter Details ## ReferenceObjectOriginIndex diff --git a/parameters/reference/target-roi-def/location/offset/reference-x-axis.md b/parameters/reference/target-roi-def/location/offset/reference-x-axis.md index 8b3e1fa..fd817a9 100644 --- a/parameters/reference/target-roi-def/location/offset/reference-x-axis.md +++ b/parameters/reference/target-roi-def/location/offset/reference-x-axis.md @@ -3,11 +3,8 @@ layout: default-layout title: Dynamsoft Capture Vision Parameters description: The parameter Location of Dynamsoft Capture Vision defines the location information of the ROIs. keywords: Location -needAutoGenerateSidebar: true -noTitleIndex: true needGenerateH3Content: true --- - ## ReferenceXAxis Defines the x-axis of the coordinate system to use when configuring offset parameters basd on the reference objects. It includes the following child parameters: diff --git a/parameters/reference/target-roi-def/location/offset/reference-y-axis.md b/parameters/reference/target-roi-def/location/offset/reference-y-axis.md index c1c6b8b..b6ceef2 100644 --- a/parameters/reference/target-roi-def/location/offset/reference-y-axis.md +++ b/parameters/reference/target-roi-def/location/offset/reference-y-axis.md @@ -3,11 +3,8 @@ layout: default-layout title: Dynamsoft Capture Vision Parameters description: The parameter Location of Dynamsoft Capture Vision defines the location information of the ROIs. keywords: Location -needAutoGenerateSidebar: true -noTitleIndex: true needGenerateH3Content: true --- - ## ReferenceYAxis Defines the y-axis of the coordinate system to use when configuring offset parameters basd on the reference objects. It includes the following child parameters: diff --git a/parameters/reference/target-roi-def/location/reference-object-filter/barcode-filtering-condition.md b/parameters/reference/target-roi-def/location/reference-object-filter/barcode-filtering-condition.md index 6f85e6d..8ddc79c 100644 --- a/parameters/reference/target-roi-def/location/reference-object-filter/barcode-filtering-condition.md +++ b/parameters/reference/target-roi-def/location/reference-object-filter/barcode-filtering-condition.md @@ -3,11 +3,8 @@ layout: default-layout title: Dynamsoft Capture Vision Parameters description: The parameter Location of Dynamsoft Capture Vision defines the location information of the ROIs. keywords: Location -needAutoGenerateSidebar: true -noTitleIndex: true needGenerateH3Content: true --- - # BarcodeFilteringCondition One of the filter conditions. Filter the reference objects with the decoded barcode information. The parameter `BarcodeFilteringCondition` includes the following child parameters: diff --git a/parameters/reference/target-roi-def/location/reference-object-filter/frame-filtering-condition.md b/parameters/reference/target-roi-def/location/reference-object-filter/frame-filtering-condition.md index 3fbb782..b283f3b 100644 --- a/parameters/reference/target-roi-def/location/reference-object-filter/frame-filtering-condition.md +++ b/parameters/reference/target-roi-def/location/reference-object-filter/frame-filtering-condition.md @@ -3,11 +3,8 @@ layout: default-layout title: Dynamsoft Capture Vision Parameters description: The parameter Location of Dynamsoft Capture Vision defines the location information of the ROIs. keywords: Location -needAutoGenerateSidebar: true -noTitleIndex: true needGenerateH3Content: true --- - # FrameFilteringCondition One of the filter conditions. Filter the reference objects with the frame information. The parameter `FrameFilteringCondition` includes the following child parameters: diff --git a/parameters/reference/target-roi-def/location/reference-object-filter/index.md b/parameters/reference/target-roi-def/location/reference-object-filter/index.md index 837de74..99451fb 100644 --- a/parameters/reference/target-roi-def/location/reference-object-filter/index.md +++ b/parameters/reference/target-roi-def/location/reference-object-filter/index.md @@ -3,25 +3,27 @@ layout: default-layout title: Dynamsoft Capture Vision Parameters description: The parameter Location of Dynamsoft Capture Vision defines the location information of the ROIs. keywords: Location -needAutoGenerateSidebar: true -noTitleIndex: true needGenerateH3Content: true --- - # ReferenceObjectFilter Parameter `ReferenceObjectFilter` is a group of filter conditions for figuring out the `reference objects`. ```json -"ReferenceObjectFilter" : -{ - "ReferenceTargetROIDefNameArray": [], - "AtomicResultTypeArray" : ["ART_TEXT_LINE","ART_BARCODE","ART_FRAME"], - "ReferenceTaskNameArray": ["DBR_task"], - "BarcodeFilteringCondition": {}, - "FrameFilteringCondition": {}, - "TextLineFilteringCondition":{}, - "RegionFilteringCondition": {} +{ + "ReferenceObjectFilter": + { + "ReferenceTargetROIDefNameArray": [], + "AtomicResultTypeArray" : ["ART_TEXT_LINE","ART_BARCODE","ART_FRAME"], + "ReferenceTaskNameArray": ["DBR_task"], + "BarcodeFilteringCondition": {}, + "FrameFilteringCondition": {}, + "TextLineFilteringCondition":{}, + "RegionFilteringCondition": { + "RegionPredetectionMode": "RPM_GENERAL", + "LabelIdArray": [0, 1, 2] + } + } } ``` diff --git a/parameters/reference/target-roi-def/location/reference-object-filter/reference-object-filter-parameter-details.md b/parameters/reference/target-roi-def/location/reference-object-filter/reference-object-filter-parameter-details.md index 5f94c6b..39a7525 100644 --- a/parameters/reference/target-roi-def/location/reference-object-filter/reference-object-filter-parameter-details.md +++ b/parameters/reference/target-roi-def/location/reference-object-filter/reference-object-filter-parameter-details.md @@ -3,18 +3,15 @@ layout: default-layout title: ReferenceObjectFilter Parameter Details - Dynamsoft Capture Vision Parameters description: Details of several ReferenceObjectFilter parameters in Dynamsoft Capture Vision defines the location information of the ROIs. keywords: Location -needAutoGenerateSidebar: true -noTitleIndex: true needGenerateH3Content: true --- - # ReferenceObjectFilter Parameter Details ## ReferenceTargetROIDefNameArray Filter the reference object by specifying `TargetROI` names. -| ReferenceTargetROIDefNameArray Parameter Summary | +| ReferenceTargetROIDefNameArray Parameter Details | | :------------------- | | **Type**
    *String[]* | | **Range**
    Each member should be a name of `TargetROI` that defined in `TargetROIDefOptions`. | @@ -24,7 +21,7 @@ Filter the reference object by specifying `TargetROI` names. Filter the reference object by specifying the type of atomic results. In the `TargetROIs` algorithm task can produce atomic results that can support the localization of the other `TargetROIs`. -| AtomicResultTypeArray Parameter Summary | +| AtomicResultTypeArray Parameter Details | | :------------------- | | **Type**
    *String[]* | | **Range**
    Each member should be one of the `AtomicResultType`, which are `ART_TEXT_LINE`, `ART_BARCODE`, `ART_FRAME`, `ART_TABLE_CELL`, `ART_GEOMETRY_LINE`, `ART_CORNER`, `ART_COLOUR_REGION`, and `ART_IMAGE` | @@ -34,8 +31,8 @@ Filter the reference object by specifying the type of atomic results. In the `Ta Filter the reference object by specifying the reference task name array. -| AtomicResultTypeArray Parameter Summary | +| AtomicResultTypeArray Parameter Details | | :------------------- | | **Type**
    *String[]* | -| **Range**
    Each member should be one of the task in the reference TargetROIDef object array. | +| **Range**
    Each member should be one of the task in the reference `TargetROIDef` object array. | | **Default Value**
    null | diff --git a/parameters/reference/target-roi-def/location/reference-object-filter/region-filtering-condition.md b/parameters/reference/target-roi-def/location/reference-object-filter/region-filtering-condition.md index f2a2678..38a0caf 100644 --- a/parameters/reference/target-roi-def/location/reference-object-filter/region-filtering-condition.md +++ b/parameters/reference/target-roi-def/location/reference-object-filter/region-filtering-condition.md @@ -3,24 +3,11 @@ layout: default-layout title: Dynamsoft Capture Vision Parameters description: The parameter Location of Dynamsoft Capture Vision defines the location information of the ROIs. keywords: Location -needAutoGenerateSidebar: true -noTitleIndex: true needGenerateH3Content: true --- - # RegionFilteringCondition -One of the filter conditions. Filter the reference objects with the decoded barcode information. - -```json -"RegionFilteringCondition": -{ - "RegionPredetectionMode": "RPM_GENERAL", - "LabelIdArray": [0, 1, 2] -} -``` - -The parameter `RegionFilteringCondition` includes the following child parameters: +One of the filter conditions. Filter the reference objects with the decoded barcode information. The parameter `RegionFilteringCondition` includes the following child parameters: diff --git a/parameters/reference/target-roi-def/location/reference-object-filter/text-line-filtering-condition.md b/parameters/reference/target-roi-def/location/reference-object-filter/text-line-filtering-condition.md index 28304b2..ebc4fce 100644 --- a/parameters/reference/target-roi-def/location/reference-object-filter/text-line-filtering-condition.md +++ b/parameters/reference/target-roi-def/location/reference-object-filter/text-line-filtering-condition.md @@ -3,11 +3,8 @@ layout: default-layout title: Dynamsoft Capture Vision Parameters description: The parameter Location of Dynamsoft Capture Vision defines the location information of the ROIs. keywords: Location -needAutoGenerateSidebar: true -noTitleIndex: true needGenerateH3Content: true --- - # TextLineFilteringCondition One of the filter conditions. Filter the reference objects with the text line content. The parameter `TextLineFilteringCondition` includes the following child parameters: diff --git a/parameters/reference/target-roi-def/name.md b/parameters/reference/target-roi-def/name.md index 78b3ad4..4b32e3c 100644 --- a/parameters/reference/target-roi-def/name.md +++ b/parameters/reference/target-roi-def/name.md @@ -3,17 +3,23 @@ layout: default-layout title: Name - Dynamsoft Capture Vision TargetROIDef object description: The parameter Name defines the unique identifier of TargetROIDef object. keywords: top-level object, name, unique identifier -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true permalink: /parameters/reference/target-roi-def/name.html --- - # Name Parameter `Name` represents a `TargetROIDef` object, which serves as its unique identifier. -## Example +## JSON Structure + +**Location in template:** +``` +TargetROIDefOptions[i] + └── Name +``` + +**Parent object:** [TargetROIDef]({{ site.dcvb_parameters }}file/target-roi-definition/index.html) object + +**Example:** ```json { @@ -21,7 +27,14 @@ Parameter `Name` represents a `TargetROIDef` object, which serves as its unique } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `Name` parameter. +> - To use it, embed this parameter within a [TargetROIDef]({{ site.dcvb_parameters }}file/target-roi-definition/index.html) 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 Details | | :----------------------------------- | diff --git a/parameters/reference/target-roi-def/pause-flag.md b/parameters/reference/target-roi-def/pause-flag.md index cf62085..d627e3c 100644 --- a/parameters/reference/target-roi-def/pause-flag.md +++ b/parameters/reference/target-roi-def/pause-flag.md @@ -3,17 +3,23 @@ layout: default-layout title: PauseFlag - Dynamsoft Capture Vision Parameters description: The parameter PauseFlag indicates that the region results generated by this `TargetROIDef` will not be used by other `TargetROIDef` objects. keywords: raw image, captured results, TargetROIDef -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true permalink: /parameters/reference/target-roi-def/pause-flag.html --- - # PauseFlag Parameter `PauseFlag` indicates that the region results generated by this `TargetROIDef` will not be used by other `TargetROIDef` objects that depend on it to calculate the target regions, unless the user explicitly performs an update operation. -## Example +## JSON Structure + +**Location in template:** +``` +TargetROIDefOptions[i] + └── PauseFlag +``` + +**Parent object:** [TargetROIDef]({{ site.dcvb_parameters }}file/target-roi-definition/index.html) object + +**Example:** ```json { @@ -21,7 +27,14 @@ Parameter `PauseFlag` indicates that the region results generated by this `Targe } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `PauseFlag` parameter. +> - To use it, embed this parameter within a [TargetROIDef]({{ site.dcvb_parameters }}file/target-roi-definition/index.html) 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 | PauseFlag Parameter Summary| | :------------- | diff --git a/parameters/reference/target-roi-def/task-setting-name-array.md b/parameters/reference/target-roi-def/task-setting-name-array.md index 10a349e..655078b 100644 --- a/parameters/reference/target-roi-def/task-setting-name-array.md +++ b/parameters/reference/target-roi-def/task-setting-name-array.md @@ -3,17 +3,23 @@ layout: default-layout title: TaskSettingNameArray - Dynamsoft Capture Vision Parameters description: The parameter TaskSettingNameArray of Dynamsoft Capture Vision defines the collection of image ROI processing object names. keywords: task settings, TargetROIDef -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true permalink: /parameters/reference/target-roi-def/task-setting-name-array.html --- - # TaskSettingNameArray Parameter `TaskSettingNameArray` represents the collection of task setting object names, used to refer to the [`BarcodeReaderTaskSetting`](../../file/task-settings/barcode-reader-task-settings.md),[`LabelRecognizerTaskSetting`](../../file/task-settings/label-recognizer-task-settings.md),[`DocumentNormalizerTaskSetting`](../../file/task-settings/document-normalizer-task-settings.md), [`OutputTaskSetting`](../../file/task-settings/output-task-setting.md) objects. It is used to define recognition tasks such as reading barcodes, recognizing labels, or detecting document quads. -## Example +## JSON Structure + +**Location in template:** +``` +TargetROIDefOptions[i] + └── TaskSettingNameArray +``` + +**Parent object:** [TargetROIDef]({{ site.dcvb_parameters }}file/target-roi-definition/index.html) object + +**Example:** ```json { @@ -21,11 +27,18 @@ Parameter `TaskSettingNameArray` represents the collection of task setting objec } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `TaskSettingNameArray` parameter. +> - To use it, embed this parameter within a [TargetROIDef]({{ site.dcvb_parameters }}file/target-roi-definition/index.html) 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 -| TaskSettingNameArray Parameter Summary | +| TaskSettingNameArray Parameter Details | | :----------------------------------- | | **Type**
    *String[]* | | **Range**
    Each element represents the name of a `BarcodeReaderTaskSetting` object, `LabelRecognizerTaskSetting` object, `DocumentNormalizerTaskSetting` object, or `OutputTaskSetting` object. | | **Default Value**
    ["dbr_task_default", "dlr_task_default", "ddn_task_default"] | -| **Remarks**
    If `TaskSettingNameArray` is not specified, a default array ["dbr_task_default", "dlr_task_default", "ddn_task_default"] will be created. The TargetROIDef object will have a default configuration of tasks including one barcode reading task, one label recognition task, and one document normalizer task.| +| **Remarks**
    If `TaskSettingNameArray` is not specified, a default array ["dbr_task_default", "dlr_task_default", "ddn_task_default"] will be created. The `TargetROIDef` object will have a default configuration of tasks including one barcode reading task, one label recognition task, and one document normalizer task.| diff --git a/parameters/reference/text-line-specification/applicable-text-line-numbers.md b/parameters/reference/text-line-specification/applicable-text-line-numbers.md index 9354168..b077010 100644 --- a/parameters/reference/text-line-specification/applicable-text-line-numbers.md +++ b/parameters/reference/text-line-specification/applicable-text-line-numbers.md @@ -3,17 +3,23 @@ layout: default-layout title: ApplicableTextLineNumbers - Dynamsoft Label Recognizer Parameters description: The parameter ApplicableTextLineNumbers of Dynamsoft Label Recognizer defines the line numers of the targeting text lines. keywords: Applicable text line numbers -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true -permalink: /parameters/reference/text-line-specification/applicable-text-line-numbers.html --- # ApplicableTextLineNumbers Parameter `ApplicableTextLineNumbers` specifies the line numbers of the targeting lines which are specified by the `TextLineSpecification` object. -## Example +## JSON Structure + +**Location in template:** +``` +TextLineSpecificationOptions[i] + └── ApplicableTextLineNumbers +``` + +**Parent object:** [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) object + +**Example:** ```json { @@ -21,9 +27,17 @@ Parameter `ApplicableTextLineNumbers` specifies the line numbers of the targetin } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `ApplicableTextLineNumbers` parameter. +> - To use it, embed this parameter within a [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) 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 -| ApplicableTextLineNumbers Parameter Summary | +| ApplicableTextLineNumbers Parameter Details | | :----------------------------------- | | **Type**
    *String* | | **Range**
    A string of one or more of the following data:
    1. One int value which represents a specified line index;
    2. One Expression, start index and stop index connected with ""-"", which represents a specified line index range. | diff --git a/parameters/reference/text-line-specification/base-text-line-specification-name.md b/parameters/reference/text-line-specification/base-text-line-specification-name.md index d9e2195..403d203 100644 --- a/parameters/reference/text-line-specification/base-text-line-specification-name.md +++ b/parameters/reference/text-line-specification/base-text-line-specification-name.md @@ -3,17 +3,23 @@ layout: default-layout title: BaseTextLineSpecificationName - Dynamsoft Label Recognizer Parameters description: The parameter BaseTextLineSpecificationName of Dynamsoft Label Recognizer defines the name of base TextLineSpecification object. keywords: Applicable text line numbers -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true -permalink: /parameters/reference/text-line-specification/base-text-line-specification-name.html --- # BaseTextLineSpecificationName Parameter `BaseTextLineSpecificationName` represents the name of another `BaseTextLineSpecificationName` object. It is used to inherit the parameters defined in its parent `BaseTextLineSpecificationName` object. If a parameter has already been defined in this object, the parameter with the same name will not be inherited from the parent object. -## Example +## JSON Structure + +**Location in template:** +``` +TextLineSpecificationOptions[i] + └── BaseTextLineSpecificationName +``` + +**Parent object:** [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) object + +**Example:** ```json { @@ -21,9 +27,17 @@ Parameter `BaseTextLineSpecificationName` represents the name of another `BaseTe } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `BaseTextLineSpecificationName` parameter. +> - To use it, embed this parameter within a [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) 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 -| BaseTextLineSpecificationName Parameter Summary | +| BaseTextLineSpecificationName Parameter Details | | :----------------------------------------- | | **Type**
    *String* | | **Range**
    One of the existing `TextLineSpecification` object name. | diff --git a/parameters/reference/text-line-specification/binarization-modes.md b/parameters/reference/text-line-specification/binarization-modes.md index 5e785f5..c2fde90 100644 --- a/parameters/reference/text-line-specification/binarization-modes.md +++ b/parameters/reference/text-line-specification/binarization-modes.md @@ -3,10 +3,6 @@ layout: default-layout title: BinarizationModes - Dynamsoft Label Recognizer Parameter description: The parameter BinarizationModes of text line specification controls the process of text line binarization. keywords: BinarizationModes, parameter reference, parameter -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true -permalink: /parameters/reference/text-line-specification/binarization-modes.html --- @@ -14,7 +10,17 @@ permalink: /parameters/reference/text-line-specification/binarization-modes.html Parameter `BinarizationModes` helps control the process of binarization, i.e., converting a grayscale image to a binary image. A better binary image greatly helps the following processes. During binarization, the threshold is the key criteria. If the pixel value is smaller than the threshold, it is set to 0, otherwise, it is set to a maximum value (255 in the library). By default, the library automatically calculates the adaptive size of the neighbourhood area and then binarizes the grayscale image with the adaptive threshold based on a small neighbourhood area with an adaptive size around it. `BinarizationModes` consists of one or more modes, each mode representing a different binarization process. -## Example +## JSON Structure + +**Location in template:** +``` +TextLineSpecificationOptions[i] + └── BinarizationModes +``` + +**Parent object:** [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) object + +**Example:** ```json { @@ -36,7 +42,15 @@ Parameter `BinarizationModes` helps control the process of binarization, i.e., c } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `BinarizationModes` parameter. +> - To use it, embed this parameter within a [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) 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 `BinarizationModes` consist of a group of binarization mode objects. Each binarization mode object includes a candidate mode and a series of mode arguments. The available mode arguments of the binarization mode object is shown as follow. @@ -300,7 +314,7 @@ Parameter `BinarizationModes` consist of a group of binarization mode objects. E } ``` -## Candidate Modes Introduction +## Candidate Mode Introductions ### BM_LOCAL_BLOCK diff --git a/parameters/reference/text-line-specification/char-height-range.md b/parameters/reference/text-line-specification/char-height-range.md index 9bb0991..82499c6 100644 --- a/parameters/reference/text-line-specification/char-height-range.md +++ b/parameters/reference/text-line-specification/char-height-range.md @@ -3,17 +3,23 @@ layout: default-layout title: CharHeightRange - Dynamsoft Label Recognizer Parameters description: The parameter CharHeightRange of Dynamsoft Label Recognizer defines the range of the character height. keywords: Applicable text line numbers -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true -permalink: /parameters/reference/text-line-specification/char-height-range.html --- # CharHeightRange Parameter `CharHeightRange` defines the range of the character height (in pixel or a percentage value relative to the height of the `targetROI`). -## Example +## JSON Structure + +**Location in template:** +``` +TextLineSpecificationOptions[i] + └── CharHeightRange +``` + +**Parent object:** [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) object + +**Example:** ```json { @@ -21,9 +27,17 @@ Parameter `CharHeightRange` defines the range of the character height (in pixel } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `CharHeightRange` parameter. +> - To use it, embed this parameter within a [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) 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 -| CharHeightRange Parameter Summary | +| CharHeightRange Parameter Details | | :-------------------------------- | | **Type**
    *int Array* | | **Range**
    The third member should be 0 or 1, which determines whether the range is measured by thousandth. If measured by thousandth, the first 2 members should be int values between 1 to 1000. Otherwise, they should between 1 to 0x7fffffff. | diff --git a/parameters/reference/text-line-specification/character-model-name.md b/parameters/reference/text-line-specification/character-model-name.md index 47a1638..3ed1ddc 100644 --- a/parameters/reference/text-line-specification/character-model-name.md +++ b/parameters/reference/text-line-specification/character-model-name.md @@ -3,24 +3,41 @@ layout: default-layout title: CharacterModelName - Dynamsoft Label Recognizer Parameters description: The parameter CharacterModelName of Dynamsoft Label Recognizer defines the name of character models. keywords: Character model -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- # CharacterModelName The `CharacterModelName` parameter references the character model by its name. +## JSON Structure + +**Location in template:** +``` +TextLineSpecificationOptions[i] + └── CharacterModelName +``` + +**Parent object:** [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) object + +**Example:** + ```json { "CharacterModelName": "NumberLetterCharRecognition" } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `CharacterModelName` parameter. +> - To use it, embed this parameter within a [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) 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 -| CharacterModelName Parameter Summary | +| CharacterModelName Parameter Details | | :----------------------------------- | | **Type**
    *String* | | **Range**
    The name of a Character Model object that defined in `CaptureVisionModelOptions`. | diff --git a/parameters/reference/text-line-specification/character-normalization-modes.md b/parameters/reference/text-line-specification/character-normalization-modes.md index 2d3a9b9..6eefa55 100644 --- a/parameters/reference/text-line-specification/character-normalization-modes.md +++ b/parameters/reference/text-line-specification/character-normalization-modes.md @@ -3,17 +3,23 @@ layout: default-layout title: CharacterNormalizationModes - Dynamsoft Label Recognizer Parameters description: The parameter CharacterNormalizationModes of Dynamsoft Label Recognizer defines how to normalize the characters. keywords: Character normalization -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true -permalink: /parameters/reference/text-line-specification/character-normalization-modes.html --- # CharacterNormalizationModes Parameter `CharacterNormalizationMode` defines an array of character normalization mode to implement. The array index represents the priority of the item. The smaller index is, the higher priority is. -## Example +## JSON Structure + +**Location in template:** +``` +TextLineSpecificationOptions[i] + └── CharacterNormalizationModes +``` + +**Parent object:** [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) object + +**Example:** ```json { @@ -31,7 +37,15 @@ Parameter `CharacterNormalizationMode` defines an array of character normalizati } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `CharacterNormalizationModes` parameter. +> - To use it, embed this parameter within a [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) 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 `CharacterNormalizationModes` consist of a group of character normalization mode objects. Each character normalization mode object includes a candidate mode and a series of mode arguments. The mode arguments of the character normalization mode object is shown as follow: @@ -118,7 +132,7 @@ Parameter `CharacterNormalizationModes` consist of a group of character normaliz
    Remarks
    - Only available for "DM_PERSPECTIVE_CORRECTION".
    + Only available for "CNM_MORPH".
    0: Direction unknown.
    1: Vertical direction.
    2: Horizontal direction. @@ -128,7 +142,7 @@ Parameter `CharacterNormalizationModes` consist of a group of character normaliz ### Default Setting -## Candidate Modes Introduction +## Candidate Mode Introductions ### CNM_MORPH diff --git a/parameters/reference/text-line-specification/concat-results.md b/parameters/reference/text-line-specification/concat-results.md index 28e8092..3ed870c 100644 --- a/parameters/reference/text-line-specification/concat-results.md +++ b/parameters/reference/text-line-specification/concat-results.md @@ -3,26 +3,39 @@ layout: default-layout title: ConcatResults - Dynamsoft Label Recognizer Parameters description: The parameter ConcatResults defines whether to concatenate the output results of the TextLineSpecification object. keywords: top-level object, ConcatResults -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true -permalink: /parameters/reference/text-line-specification/concat-results.html --- # ConcatResults Parameter `ConcatResults` defines whether to concatenate multiple lines of text. For example, if two lines of text are recognized in a label, the results will be concatenated into one line using `ConcatSeparator` as the separator. -## Example +## JSON Structure + +**Location in template:** +``` +TextLineSpecificationOptions[i] + └── ConcatResults +``` + +**Parent object:** [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) object + +**Example:** ```json { - "Name": "tls_0", - "ConcatResults" : 0 + "ConcatResults": 0 } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `ConcatResults` parameter. +> - To use it, embed this parameter within a [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) 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 Details | | :----------------------------------- | diff --git a/parameters/reference/text-line-specification/concat-separator.md b/parameters/reference/text-line-specification/concat-separator.md index d03cf39..5aa04e5 100644 --- a/parameters/reference/text-line-specification/concat-separator.md +++ b/parameters/reference/text-line-specification/concat-separator.md @@ -3,26 +3,39 @@ layout: default-layout title: ConcatSeparator - Dynamsoft Label Recognizer Parameters description: The parameter ConcatSeparator defines the concat separator of the TextLineSpecification object. keywords: top-level object, ConcatSeparator -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true -permalink: /parameters/reference/text-line-specification/concat-separator.html --- # ConcatSeparator Parameter `ConcatSeparator` defines the concat separator used to join multiple lines of text. For example, if two lines of text are recognized in a label, the results will be concatenated into one line using `ConcatSeparator` as the separator. -## Example +## JSON Structure + +**Location in template:** +``` +TextLineSpecificationOptions[i] + └── ConcatSeparator +``` + +**Parent object:** [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) object + +**Example:** ```json { - "Name": "tls_0", - "ConcatSeparator" : "\n" + "ConcatSeparator": "\n" } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `ConcatSeparator` parameter. +> - To use it, embed this parameter within a [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) 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 Details | | :----------------------------------- | diff --git a/parameters/reference/text-line-specification/concat-string-length-range.md b/parameters/reference/text-line-specification/concat-string-length-range.md index da8b2a9..d3c4de4 100644 --- a/parameters/reference/text-line-specification/concat-string-length-range.md +++ b/parameters/reference/text-line-specification/concat-string-length-range.md @@ -3,24 +3,39 @@ layout: default-layout title: ConcatStringLengthRange - Dynamsoft Label Recognizer Parameters description: The parameter ConcatStringLengthRange of text line specification is for specifying the length range of the text line strings. keywords: concat string length range, parameter reference, parameter -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true --- # ConcatStringLengthRange Sets the range of string length for the concated recognized text lines. -## Example +## JSON Structure + +**Location in template:** +``` +TextLineSpecificationOptions[i] + └── ConcatStringLengthRange +``` + +**Parent object:** [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) object + +**Example:** ```json { - "ConcatStringLengthRange" : [3,200] + "ConcatStringLengthRange": [3, 200] } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `ConcatStringLengthRange` parameter. +> - To use it, embed this parameter within a [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) 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 Details | | :----------------------------------- | diff --git a/parameters/reference/text-line-specification/concat-string-regex-pattern.md b/parameters/reference/text-line-specification/concat-string-regex-pattern.md index 33a0993..9e708a0 100644 --- a/parameters/reference/text-line-specification/concat-string-regex-pattern.md +++ b/parameters/reference/text-line-specification/concat-string-regex-pattern.md @@ -3,24 +3,39 @@ layout: default-layout title: ConcatStringRegExPattern - Dynamsoft Label Recognizer Parameters description: The parameter ConcatStringRegExPattern of text line specification is for specifying the regex pattern of the concated text lines. keywords: concat string regex pattern, parameter reference, parameter -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true --- # ConcatStringRegExPattern Specifies the regular expression pattern of the concated text lines. It is used to correct the recognized line text. -## Example +## JSON Structure + +**Location in template:** +``` +TextLineSpecificationOptions[i] + └── ConcatStringRegexPattern +``` + +**Parent object:** [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) object + +**Example:** ```json { - "ConcatStringRegExPattern":"" + "ConcatStringRegExPattern": "" } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `ConcatStringRegexPattern` parameter. +> - To use it, embed this parameter within a [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) 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 Details | | :----------------------------------- | diff --git a/parameters/reference/text-line-specification/confusable-characters-correction.md b/parameters/reference/text-line-specification/confusable-characters-correction.md index 20902d4..d5d2b4f 100644 --- a/parameters/reference/text-line-specification/confusable-characters-correction.md +++ b/parameters/reference/text-line-specification/confusable-characters-correction.md @@ -3,9 +3,6 @@ layout: default-layout title: ConfusableCharactersCorrection - Dynamsoft Label Recognizer Parameters description: The parameter ConfusableCharactersCorrection of text line specification is for correcting the confusable characters. keywords: confusable characters correction, parameter reference, parameter -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true --- # ConfusableCharactersCorrection @@ -27,7 +24,17 @@ The currently supported built-in confusable characters sets are as follows: - ["l", "1", "I"] - ["5", "s", "S"] -## Example +## JSON Structure + +**Location in template:** +``` +TextLineSpecificationOptions[i] + └── ConfusableCharactersCorrection +``` + +**Parent object:** [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) object + +**Example:** ```json { @@ -45,13 +52,21 @@ The currently supported built-in confusable characters sets are as follows: } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `ConfusableCharactersCorrection` parameter. +> - To use it, embed this parameter within a [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) 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 ### ConfusableCharacters Parameter `ConfusableCharacters` defines an array of confusing characters sets for correction. -| ConfusableCharacters Parameter Summary | +| ConfusableCharacters Parameter Details | | :------------------- | | **Type**
    *String[][]* | | **Range**
    Each row of the array should be a supported confusing characters set. The currently supported built-in confusable characters sets are as follows:
    ["0", "o", "O"]
    ["l", "1", "I"]
    ["5", "s", "S"]| @@ -61,7 +76,7 @@ Parameter `ConfusableCharacters` defines an array of confusing characters sets f Parameter `FontNameArray` is an array of supported font names. -| FontNameArray Parameter Summary | +| FontNameArray Parameter Details | | :------------------- | | **Type**
    *String[]* | | **Range**
    Each member should be a supported font name. The currently supported built-in fonts are as follows:
    ARIAL
    COURIER_NEW
    OCR_B
    TIMES_NEW_ROMAN
    VERDANA
    HELVETICA| diff --git a/parameters/reference/text-line-specification/expected-groups-count.md b/parameters/reference/text-line-specification/expected-groups-count.md index 5afa0a2..1d8cca9 100644 --- a/parameters/reference/text-line-specification/expected-groups-count.md +++ b/parameters/reference/text-line-specification/expected-groups-count.md @@ -3,16 +3,23 @@ layout: default-layout title: ExpectedGroupsCount - Dynamsoft Label Recognizer Parameters description: The parameter ExpectedGroupsCount defines the expected number of TextLineGroups to be found. keywords: expected groups count -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- # ExpectedGroupsCount The parameter `ExpectGroupsCount` indicates the expected number of `TextLineGroups` to be found. Each `TextLineGroup` is a collection formed by spatially continuous text lines. -## Example +## JSON Structure + +**Location in template:** +``` +TextLineSpecificationOptions[i] + └── ExpectedGroupsCount +``` + +**Parent object:** [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) object + +**Example:** ```json { @@ -20,7 +27,15 @@ The parameter `ExpectGroupsCount` indicates the expected number of `TextLineGrou } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `ExpectedGroupsCount` parameter. +> - To use it, embed this parameter within a [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) 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 Details | | :----------------------------------- | diff --git a/parameters/reference/text-line-specification/grayscale-enhancement-modes.md b/parameters/reference/text-line-specification/grayscale-enhancement-modes.md index 76695bd..26a28b7 100644 --- a/parameters/reference/text-line-specification/grayscale-enhancement-modes.md +++ b/parameters/reference/text-line-specification/grayscale-enhancement-modes.md @@ -3,9 +3,6 @@ layout: default-layout title: GrayscaleEnhancementModes - Dynamsoft Label Recognizer Parameters description: The parameter GrayscaleEnhancementModes of text line specification is for enhancing the quality of grayscale image of the text line area. keywords: GrayscaleEnhancementModes, parameter reference, parameter -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true --- @@ -13,7 +10,17 @@ noTitleIndex: true Parameter `GrayscaleEnhancementModes` provides some image processing methods to enhance the grayscale quality of the text line area. By default, the library does no image preprocessing. Assume your image has distorted features that can be solved by common image processing methods, this parameter can help you get a higher quality grayscale image by shifting the order of the preprocessing algorithms used (if at all). -## Example +## JSON Structure + +**Location in template:** +``` +TextLineSpecificationOptions[i] + └── GrayscaleEnhancementModes +``` + +**Parent object:** [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) object + +**Example:** ```json { @@ -38,7 +45,15 @@ Parameter `GrayscaleEnhancementModes` provides some image processing methods to } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `GrayscaleEnhancementModes` parameter. +> - To use it, embed this parameter within a [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) 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 `GrayscaleEnhancementModes` consist of a group of grayscale enhancement mode objects. Each grayscale enhancement mode object includes a candidate mode and a series of mode arguments. The mode arguments of the grayscale enhancement mode object is shown as follow: @@ -243,7 +258,7 @@ If the `GrayscaleEnhancementModes` is not configured in your template file, the } ``` -## Candidate Modes Introduction +## Candidate Mode Introductions ### GEM_GENERAL diff --git a/parameters/reference/text-line-specification/index.md b/parameters/reference/text-line-specification/index.md deleted file mode 100644 index 41ed083..0000000 --- a/parameters/reference/text-line-specification/index.md +++ /dev/null @@ -1,38 +0,0 @@ ---- -layout: default-layout -title: Index - Dynamsoft Label Recognizer TextLineSpecification Parameters -description: The index of TextLineSpecification parameters. -keywords: TextLineSpecification, parameter reference, parameter -needGenerateH3Content: true -needAutoGenerateSidebar: true -noTitleIndex: true ---- - -# TextLineSpecification Parameters - -| Parameter Name | Description | -| ----------------------------------- | ----------- | -| [`ApplicableTextLineNumbers`](applicable-text-line-numbers.md) | Defines the line numers of the targeting lines which are specified by the `TextLineSpecification` object. | -| [`BaseTextLineSpecificationName`](base-text-line-specification-name.md) | Defines the name of another `BaseTextLineSpecificationName` object. | -| [`CharHeightRange`](char-height-range.md) | Defines the range of the character height. | -| [`CharacterModelName`](character-model-name.md) | Defines the name of the character model. | -| [`CharacterNormalizationModes`](character-normalization-modes.md) | Defines an array of character normalization mode to implement. | -| [`FirstPoint`](position.md#firstpoint) | The top-left vertex coordinate of the the text line. | -| [`SecondPoint`](position.md#secondpoint) | The top-right vertex coordinate of the the text line. | -| [`ThirdPoint`](position.md#thirdpoint) | The bottom-right vertex coordinate of the the text line. | -| [`FourthPoint`](position.md#fourthpoint) | The bottom-left vertex coordinate of the the text line. | -| [`Name`](name.md) | Defines the name of a `TextLineSpecification` object, which serves as its unique identifier. | -| [`BinarizationModes`](binarization-modes.md) | Helps control the process of binarization, i.e., converting a grayscale image to a binary image. | -| [`GrayscaleEnhancementModes`](grayscale-enhancement-modes.md) | Provides some image processing methods to enhance the grayscale quality of the text line area. | -| [`StringLengthRange`](string-length-range.md) | Sets the range of string length for each recognized line. | -| [`StringRegExPattern`](string-regex-pattern.md) | Specifies the regular expression pattern of the string within a line. It is used to correct the recognized line text. | -| [`ConcatStringLengthRange`](concat-string-length-range.md) | Sets the range of string length for the concated recognized text lines. | -| [`ConcatStringRegExPattern`](concat-string-regex-pattern.md) | Specifies the regular expression pattern of the concated text lines. It is used to correct the recognized line text. | -| [`ConcatSeparator`](concat-separator.md) | Defines the concat separator used to join multiple lines of text. | -| [`ConcatResults`](concat-results.md) | Defines whether to concatenate multiple lines of text. | -| [`OutputResults`](output-results.md) | Defines whether to enable the output of the `TextLineSpecification` object. | -| [`SubGroups`](sub-groups.md) | Defines the layout of subgroups of the `TextLineSpecification` object. | -| [`ReferenceGroupName`](reference-group-name.md) | Defines the reference group for space layout configuration. | -| [`TextLinesCount`](text-lines-count.md) | Defines the expected number of text lines for the `TextLineSpecification` object. | -| [`ConfusableCharactersCorrection`](confusable-characters-correction.md) | Defines the confusing character set and an array of reference font names for error correction. | -| [`ExpectedGroupsCount`](expected-groups-count.md) | Defines the expected number of `TextLineGroups` to be found. | diff --git a/parameters/reference/text-line-specification/name.md b/parameters/reference/text-line-specification/name.md index 2ee195e..3bc6c95 100644 --- a/parameters/reference/text-line-specification/name.md +++ b/parameters/reference/text-line-specification/name.md @@ -3,25 +3,39 @@ layout: default-layout title: Name - Dynamsoft Label Recognizer Parameters TextLineSpecification object description: The parameter Name defines the unique identifier of TextLineSpecification object. keywords: top-level object, name, unique identifier -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true -permalink: /parameters/reference/text-line-specification/name.html --- # Name Parameter `Name` represents a `TextLineSpecification` object, which serves as its unique identifier. -## Example +## JSON Structure + +**Location in template:** +``` +TextLineSpecificationOptions[i] + └── Name +``` + +**Parent object:** [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) object + +**Example:** ```json { - "Name" : "cv_0" + "Name": "cv_0" } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `Name` parameter. +> - To use it, embed this parameter within a [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) 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 Details | | :----------------------------------- | diff --git a/parameters/reference/text-line-specification/output-results.md b/parameters/reference/text-line-specification/output-results.md index 6aacbbf..cc81e13 100644 --- a/parameters/reference/text-line-specification/output-results.md +++ b/parameters/reference/text-line-specification/output-results.md @@ -3,26 +3,39 @@ layout: default-layout title: OutputResults - Dynamsoft Label Recognizer Parameters description: The parameter OutputResults defines whether to enable the output of the TextLineSpecification object. keywords: top-level object, OutputResults -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true -permalink: /parameters/reference/text-line-specification/output-results.html --- # OutputResults Parameter `OutputResults` defines whether to enable the output of the `TextLineSpecification` object. -## Example +## JSON Structure + +**Location in template:** +``` +TextLineSpecificationOptions[i] + └── OutputResults +``` + +**Parent object:** [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) object + +**Example:** ```json { - "Name": "tls_0", - "OutputResults" : 0 + "OutputResults": 0 } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `OutputResults` parameter. +> - To use it, embed this parameter within a [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) 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 Details | | :----------------------------------- | diff --git a/parameters/reference/text-line-specification/position.md b/parameters/reference/text-line-specification/position.md index a89aabc..210f611 100644 --- a/parameters/reference/text-line-specification/position.md +++ b/parameters/reference/text-line-specification/position.md @@ -3,36 +3,51 @@ layout: default-layout title: Text Line Area Points - Dynamsoft Label Recognizer Parameters description: The parameter Text Line Area Points of Dynamsoft Label Recognizer defines how to normalize the characters. keywords: Character normalization -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true -permalink: /parameters/reference/text-line-specification/position.html --- # Text Line Area Points -Text line area points parameters defines the position of the text lines with the vertices points. The point coordinates are measured in percentage based on the size of the `TargetROI`. +Text line area points parameters defines the position of the text lines with the vertices points. The point coordinates are measured in percentage based on the size of the `TargetROI`. Only the text lines that located in this area will be processed. -## Example +## JSON Structure + +**Location in template:** +``` +TextLineSpecificationOptions[i] + └── FirstPoint + └── SecondPoint + └── ThirdPoint + └── FourthPoint +``` + +**Parent object:** [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) object + +**Example:** ```json { - "FirstPoint" : [ 0, 0 ], - "SecondPoint" : [ 100, 0 ], - "ThirdPoint" : [ 100, 20 ], - "FourthPoint" : [ 0, 20 ] + "FirstPoint": [ 0, 0 ], + "SecondPoint": [ 100, 0 ], + "ThirdPoint": [ 100, 20 ], + "FourthPoint": [ 0, 20 ] } ``` -Only the text lines that located in this area will be processed. +> [!NOTE] +> - This snippet shows only the `Position` parameter. +> - To use it, embed this parameter within a [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) 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 Summary +## Parameter Details ### FirstPoint The top-left vertex coordinate of the the text line. The coordinate is measured in percentage. -| FirstPoint Parameter Summary | +| FirstPoint Parameter Details | | :------------------------ | | **Type**
    *int[2]* | | **Range**
    Each member of the array should be a int value between 0 to 100. | @@ -42,7 +57,7 @@ The top-left vertex coordinate of the the text line. The coordinate is measured The top-right vertex coordinate of the the text line. The coordinate is measured in percentage. -| SecondPoint Parameter Summary | +| SecondPoint Parameter Details | | :---------------------------- | | **Type**
    *int[2]* | | **Range**
    Each member of the array should be a int value between 0 to 100. | @@ -52,7 +67,7 @@ The top-right vertex coordinate of the the text line. The coordinate is measured The bottom-right vertex coordinate of the the text line. The coordinate is measured in percentage. -| ThirdPoint Parameter Summary | +| ThirdPoint Parameter Details | | :--------------------------- | | **Type**
    *int[2]* | | **Range**
    Each member of the array should be a int value between 0 to 100. | @@ -62,7 +77,7 @@ The bottom-right vertex coordinate of the the text line. The coordinate is measu The bottom-left vertex coordinate of the the text line. The coordinate is measured in percentage. -| FourthPoint Parameter Summary | +| FourthPoint Parameter Details | | :---------------------------- | | **Type**
    *int[2]* | | **Range**
    Each member of the array should be a int value between 0 to 100. | diff --git a/parameters/reference/text-line-specification/reference-group-name.md b/parameters/reference/text-line-specification/reference-group-name.md index 1ad3aad..4539868 100644 --- a/parameters/reference/text-line-specification/reference-group-name.md +++ b/parameters/reference/text-line-specification/reference-group-name.md @@ -3,10 +3,6 @@ layout: default-layout title: ReferenceGroupName - Dynamsoft Label Recognizer Parameters description: The parameter ReferenceGroupName defines the reference group name of TextLineSpecification object. keywords: top-level object, reference group name -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true -permalink: /parameters/reference/text-line-specification/reference-group-name.html --- # ReferenceGroupName @@ -19,7 +15,17 @@ Parameter `ReferenceGroupName` can be configured to reference a father, grandfat - ThirdPoint - FourthPoint -## Example +## JSON Structure + +**Location in template:** +``` +TextLineSpecificationOptions[i] + └── ReferenceGroupName +``` + +**Parent object:** [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) object + +**Example:** ```json { @@ -36,7 +42,15 @@ Parameter `ReferenceGroupName` can be configured to reference a father, grandfat } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `ReferenceGroupName` parameter. +> - To use it, embed this parameter within a [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) 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 Details | | :----------------------------------- | diff --git a/parameters/reference/text-line-specification/string-length-range.md b/parameters/reference/text-line-specification/string-length-range.md index 1c24114..a10f499 100644 --- a/parameters/reference/text-line-specification/string-length-range.md +++ b/parameters/reference/text-line-specification/string-length-range.md @@ -3,24 +3,39 @@ layout: default-layout title: StringLengthRange - Dynamsoft Label Recognizer Parameters description: The parameter StringLengthRange of text line specification is for specifying the length range of the text line strings. keywords: string length range, parameter reference, parameter -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true --- # StringLengthRange Sets the range of string length for each recognized line. -## Example +## JSON Structure + +**Location in template:** +``` +TextLineSpecificationOptions[i] + └── StringLengthRange +``` + +**Parent object:** [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) object + +**Example:** ```json { - "StringLengthRange" : [3,50] + "StringLengthRange": [3, 50] } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `StringLengthRange` parameter. +> - To use it, embed this parameter within a [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) 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 Details | | :----------------------------------- | diff --git a/parameters/reference/text-line-specification/string-regex-pattern.md b/parameters/reference/text-line-specification/string-regex-pattern.md index 9a8c3b7..6def027 100644 --- a/parameters/reference/text-line-specification/string-regex-pattern.md +++ b/parameters/reference/text-line-specification/string-regex-pattern.md @@ -3,24 +3,39 @@ layout: default-layout title: StringRegExPattern - Dynamsoft Label Recognizer Parameters description: The parameter StringRegExPattern of text line specification is for specifying the regex pattern of the text line strings. keywords: string regex pattern, parameter reference, parameter -needAutoGenerateSidebar: true -needGenerateH3Content: true -noTitleIndex: true --- # StringRegExPattern Specifies the regular expression pattern of the string within a line. It is used to correct the recognized line text. -## Example +## JSON Structure + +**Location in template:** +``` +TextLineSpecificationOptions[i] + └── StringRegexPattern +``` + +**Parent object:** [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) object + +**Example:** ```json { - "StringRegExPattern":"" + "StringRegExPattern": "" } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `StringRegexPattern` parameter. +> - To use it, embed this parameter within a [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) 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 Details | | :----------------------------------- | diff --git a/parameters/reference/text-line-specification/sub-groups.md b/parameters/reference/text-line-specification/sub-groups.md index 19f17a4..5475248 100644 --- a/parameters/reference/text-line-specification/sub-groups.md +++ b/parameters/reference/text-line-specification/sub-groups.md @@ -3,22 +3,26 @@ layout: default-layout title: SubGroups - Dynamsoft Label Recognizer Parameters description: The parameters SubGroups defines the layout of subgroups of the TextLineSpecification object. keywords: SubGroups -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true -permalink: /parameters/reference/text-line-specification/sub-groups.html --- # SubGroups Parameter `SubGroups` defines the layout of subgroups of the `TextLineSpecification` object. It can be nested recursively defined. -## Example +## JSON Structure + +**Location in template:** +``` +TextLineSpecificationOptions[i] + └── SubGroups +``` + +**Parent object:** [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) object + +**Example:** ```json { - "Name": "tls_0", - "ApplicableTextLineNumbers": "3-7", "SubGroups" : [ { "Name": "tls_0_0", @@ -36,11 +40,19 @@ Parameter `SubGroups` defines the layout of subgroups of the `TextLineSpecificat } ``` +> [!NOTE] +> - This snippet shows only the `SubGroups` parameter. +> - To use it, embed this parameter within a [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) 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) + +

    SubGroups example

    -## Parameter Summary +## Parameter Details | Parameter Details | | :----------------------------------- | diff --git a/parameters/reference/text-line-specification/text-line-rec-model-name.md b/parameters/reference/text-line-specification/text-line-rec-model-name.md index b687624..3a2b056 100644 --- a/parameters/reference/text-line-specification/text-line-rec-model-name.md +++ b/parameters/reference/text-line-specification/text-line-rec-model-name.md @@ -3,24 +3,42 @@ layout: default-layout title: TextLineRecModelName - Dynamsoft Label Recognizer Parameters description: The TextLineRecModelName parameter references the text line recognition model by its name. keywords: Text line recognition model -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true --- # TextLineRecModelName The `TextLineRecModelName` parameter references the text line recognition model by its name. +## JSON Structure + +**Location in template:** +``` +TextLineSpecificationOptions[i] + └── TextLineRecModelName +``` + +**Parent object:** [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) object + +**Example:** + ```json { "TextLineRecModelName": "MRZTextLineRecognition" } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `TextLineRecModelName` parameter. +> - To use it, embed this parameter within a [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) 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 -| CharacterModelName Parameter Summary | +| TextLineRecModelName Parameter Details | | :----------------------------------- | | **Type**
    *String* | | **Range**
    The name of a Text Line Recognition Model object that defined in `CaptureVisionModelOptions`. | diff --git a/parameters/reference/text-line-specification/text-lines-count.md b/parameters/reference/text-line-specification/text-lines-count.md index d702b7b..b086f96 100644 --- a/parameters/reference/text-line-specification/text-lines-count.md +++ b/parameters/reference/text-line-specification/text-lines-count.md @@ -3,26 +3,39 @@ layout: default-layout title: TextLinesCount - Dynamsoft Label Recognizer Parameters description: The parameter TextLinesCount defines the expected number of text lines for the TextLineSpecification object. keywords: TextLinesCount -needAutoGenerateSidebar: true -noTitleIndex: true -needGenerateH3Content: true -permalink: /parameters/reference/text-line-specification/text-lines-count.html --- # TextLinesCount Parameter `TextLinesCount` defines the expected number of text lines for the `TextLineSpecification` object. -## Example +## JSON Structure + +**Location in template:** +``` +TextLineSpecificationOptions[i] + └── TextLinesCount +``` + +**Parent object:** [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) object + +**Example:** ```json { - "Name": "tls_0", - "TextLinesCount" : 3 + "TextLinesCount": 3 } ``` -## Parameter Summary +> [!NOTE] +> - This snippet shows only the `TextLinesCount` parameter. +> - To use it, embed this parameter within a [TextLineSpecification]({{ site.dcvb_parameters }}file/auxiliary/text-line-specification.html) 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 Details | | :----------------------------------- |