Skip to content

Commit bd62db4

Browse files
Merge pull request #371 from dynamsoft-docs/preview
Preview
2 parents 9e94d29 + 857fcd0 commit bd62db4

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

54 files changed

+343
-2565
lines changed

_config.yml

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -75,6 +75,12 @@ dce_maui_api: /camera-enhancer/docs/mobile/programming/maui/api-reference/
7575
dcp_maui: /code-parser/docs/mobile/programming/maui/
7676
dcp_maui_api: /code-parser/docs/mobile/programming/maui/api-reference/
7777

78+
dcv_flutter: /capture-vision/docs/mobile/programming/flutter/
79+
dcv_flutter_api: /capture-vision/docs/mobile/programming/flutter/api-reference/
80+
dce_flutter: /camera-enhancer/docs/mobile/programming/flutter/
81+
dce_flutter_api: /camera-enhancer/docs/mobile/programming/flutter/api-reference/
82+
dcp_flutter: /code-parser/docs/mobile/programming/flutter/
83+
dcp_flutter_api: /code-parser/docs/mobile/programming/flutter/api-reference/
7884
dbr_flutter: /barcode-reader/docs/mobile/programming/flutter/
7985
dbr_flutter_api: /barcode-reader/docs/mobile/programming/flutter/api-reference/
8086

_includes/sidelist-programming/programming-flutter.html

Lines changed: 69 additions & 47 deletions
Large diffs are not rendered by default.
File renamed without changes.

programming/flutter/api-reference/capture-vision-router/barcode-result-item.md renamed to programming/flutter/api-reference/barcode-reader/barcode-result-item.md

Lines changed: 8 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,10 @@ breadcrumbText: BarcodeResultItem
1010

1111
# BarcodeResultItem Class
1212

13-
The `BarcodeResultItem` class represents a single barcode result decoded by the barcode reader. It is part of the [`DecodedBarcodesResult`](../api-reference/capture-vision-router/decoded-barcodes-result.md), which is what the library outputs at the end of the barcode recognition process.
13+
The `BarcodeResultItem` class represents a single barcode result decoded by the barcode reader. It is part of the [`DecodedBarcodesResult`](../api-reference/barcode-reader/decoded-barcodes-result.md), which is what the library outputs at the end of the barcode recognition process.
14+
15+
> [!NOTE]
16+
> BarcodeResultItem implements the [`CapturedResultItem`]({{ site.dcv_flutter_api }}capture-vision-router/captured-result-item.html) class.
1417
1518
## Definition
1619

@@ -24,7 +27,7 @@ class BarcodeResultItem
2427

2528
| Property | Type | Description |
2629
| -------- | ---- | ----------- |
27-
| [`format`](#format) | *[EnumBarcodeFormat](./enum/barcode-format.md)* | The format of the barcode represented as [`EnumBarcodeFormat`](./enum/barcode-format.md). |
30+
| [`format`](#format) | *[EnumBarcodeFormat](../enum/barcode-format.md)* | The format of the barcode represented as [`EnumBarcodeFormat`](../enum/barcode-format.md). |
2831
| [`formatString`](#formatstring) | *String* | The format of the barcode as a text string. |
2932
| [`text`](#text) | *String* | The decoded text of the barcode. |
3033
| [`bytes`](#bytes) | *Uint8List* | The raw bytes of the barcode. |
@@ -37,7 +40,7 @@ class BarcodeResultItem
3740

3841
### format
3942

40-
The format of the barcode represented as a [`EnumBarcodeFormat`](./enum/barcode-format.md).
43+
The format of the barcode represented as a [`EnumBarcodeFormat`](../enum/barcode-format.md).
4144

4245
```dart
4346
EnumBarcodeFormat format;
@@ -69,7 +72,7 @@ Uint8List bytes;
6972

7073
### location
7174

72-
The location of the barcode in the image/frame as a `Quadrilateral`. The quadrilateral contains the four vertex points of the location, with the first vertex being the left-most vertex, then going in a clockwise direction for the remaining points.
75+
The location of the barcode in the image/frame as a [`Quadrilateral`]({{ site.dcv_flutter_api }}core/quadrilateral.html). The quadrilateral contains the four vertex points of the location, with the first vertex being the left-most vertex, then going in a clockwise direction for the remaining points.
7376

7477
```dart
7578
Quadrilateral location;
@@ -101,7 +104,7 @@ int moduleSize;
101104

102105
### isDPM
103106

104-
Indicates whether the barcode is a Dot Peen Marking (DPM), which is a unique type of Datamatrix code.
107+
Indicates whether the barcode is a Dot Peen Marking (DPM), which is a unique type of DataMatrix code.
105108

106109
```dart
107110
bool isDPM;
Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -26,14 +26,14 @@ class DecodedBarcodesResult
2626
| -------- | ---- | ----------- |
2727
| [`items`](#items) | *List\<BarcodeResultItem\>?* | A list of [`BarcodeResultItem`](barcode-result-item.md), the basic unit representing a single barcode result. |
2828

29-
The following properties are inherited from [`CapturedResult`](./capture-vision-router/captured-result.md):
29+
The following properties are inherited from [`CapturedResult`]({{ site.dcv_flutter_api }}capture-vision-router/captured-result.html):
3030

3131
| Property | Type | Description |
3232
| -------- | ---- | ----------- |
33-
| [`originalImageHashId`](../capture-vision-router/captured-result.md#originalimagehashid) | *String* | The hash id of the original image. You can use this ID to get the original image via the `IntermediateResultManager` class. |
34-
| [`rotationTransformMatrix`](../capture-vision-router/captured-result.md#rotationtransformmatrix) | *Matrix4* | The rotation transformation matrix of the original image relative to the rotated image. |
35-
| [`errorCode`](../capture-vision-router/captured-result.md#errorcode) | *int* | The error code associated with the capture result. |
36-
| [`errorMessage`](../capture-vision-router/captured-result.md#errormessage) | *String* | The error message associated with the capture result. |
33+
| [`originalImageHashId`]({{ site.dcv_flutter_api }}capture-vision-router/captured-result.html#originalimagehashid) | *String* | The hash id of the original image. You can use this ID to get the original image via the `IntermediateResultManager` class. |
34+
| [`rotationTransformMatrix`]({{ site.dcv_flutter_api }}capture-vision-router/captured-result.html#rotationtransformmatrix) | *Matrix4* | The rotation transformation matrix of the original image relative to the rotated image. |
35+
| [`errorCode`]({{ site.dcv_flutter_api }}capture-vision-router/captured-result.html#errorcode) | *int* | The error code associated with the capture result. |
36+
| [`errorMessage`]({{ site.dcv_flutter_api }}capture-vision-router/captured-result.html#errormessage) | *String* | The error message associated with the capture result. |
3737

3838
### items
3939

File renamed without changes.
File renamed without changes.
File renamed without changes.
Lines changed: 27 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -10,10 +10,10 @@ breadcrumbText: SimplifiedBarcodeReaderSettings
1010

1111
# SimplifiedBarcodeReaderSettings
1212

13-
The `SimplifiedBarcodeReaderSettings` class comes from the [`SimplifiedCaptureVisionSettings`](./capture-vision-router/simplified-capture-vision-settings.md) class and contains a limited subset of the parameters that influence the Barcode Reader's performance. If you would like to get familiar with the full parameters available to the Barcode Reader, please visit the [main parameters page]({{ site.dcvb_parameters }}file/index.html?product=dbr&lang=objectivec-swift).
13+
The `SimplifiedBarcodeReaderSettings` class comes from the [`SimplifiedCaptureVisionSettings`]({{ site.dcv_flutter_api }}capture-vision-router/simplified-capture-vision-settings.html) class and contains a limited subset of the parameters that influence the Barcode Reader's performance. If you would like to get familiar with the full parameters available to the Barcode Reader, please visit the [main parameters page]({{ site.dcvb_parameters }}file/index.html).
1414

1515
> [!TIP]
16-
> If you visit the main parameters page, the majority of the settings related to the Barcode Reader will be in `BarcodeReaderTaskSetting`, `ImageParameter`, and `BarcodeFormatSpecification`.
16+
> If you visit the main parameters page, the majority of the settings related to the Barcode Reader will be in `BarcodeReaderTaskSetting`, `ImageParameter`, and `BarcodeFormatSpecification`. In order to use any of the settings that are not available in `SimplifiedBarcodeReaderSettings`, you will need to use a Capture Vision JSON template. Please see this [section](../../foundational-user-guide.md#using-a-json-template) of the user guide on how to use JSON templates.
1717
1818
## Definition
1919

@@ -27,21 +27,21 @@ class SimplifiedBarcodeReaderSettings
2727

2828
| Property | Type | Description |
2929
|----------|------|-------------|
30-
| [`barcodeFormatIds`](#barcodeformatids) | [*EnumBarcodeFormat*](./enum/barcode-format.md) | Specifies which barcode format(s) the Barcode Reader will target. |
30+
| [`barcodeFormatIds`](#barcodeformatids) | [*EnumBarcodeFormat*](../enum/barcode-format.md) | Specifies which barcode format(s) the Barcode Reader will target. |
3131
| [`expectedBarcodesCount`](#expectedbarcodescount) | *int* | Determines the expected barcode count, which can be set to 0 if the barcode count is unknown. |
32-
| [`localizationModes`](#localizationmodes) | *List\<EnumLocalizationMode\>* | Defines which localization modes (as [`EnumLocalizationMode`](./enum/localization-mode.md)) the barcode reader will use during the detection process. |
33-
| [`deblurModes`](#deblurmodes) | *List<EnumDeblurMode>* | Sets which deblur algorithms (as [`EnumDeblurMode`](./enum/deblur-mode.md)) the library will apply during the detection process when dealing with blurry images/frames. |
32+
| [`localizationModes`](#localizationmodes) | *List\<EnumLocalizationMode\>* | Defines which localization modes (as [`EnumLocalizationMode`](../enum/localization-mode.md)) the barcode reader will use during the detection process. |
33+
| [`deblurModes`](#deblurmodes) | *List<EnumDeblurMode>* | Sets which deblur algorithms (as [`EnumDeblurMode`](../enum/deblur-mode.md)) the library will apply during the detection process when dealing with blurry images/frames. |
3434
| [`minResultConfidence`](#minresultconfidence) | *int* | Specifies the minimum barcode result confidence to help filter out inaccurate results. |
3535
| [`minBarcodeTextLength`](#minbarcodetextlength) | *int* | Sets the minimum barcode text length (in characters) for the barcode result to be considered valid. |
3636
| [`barcodeTextRegExPattern`](#barcodetextregexpattern) | *String* | Defines a regular expression pattern that the barcode text must match to be considered valid. |
3737
| [`maxThreadsInOneTask`](#maxthreadsinonetask) | *int* | Establishes the maximum number of threads available for a single detection task. |
38-
| [`grayscaleTransformationModes`](#grayscaletransformationmodes) | *List\<EnumGrayscaleTransformationMode\>* | Determines which grayscale transformation modes (as [`EnumGrayscaleTransformationMode`](./enum/grayscale-transformation-mode.md)) the barcode reader will apply before the detection process. |
39-
| [`grayscaleEnhancementModes`](#grayscaleenhancementmodes) | *List\<EnumGrayscaleEnhancementMode\>* | Sets which grayscale enhancement modes (as [`EnumGrayscaleEnhancementModes`](./enum/grayscale-enhancement-mode.md)) the library will apply before the detection process. |
38+
| [`grayscaleTransformationModes`](#grayscaletransformationmodes) | *List\<EnumGrayscaleTransformationMode\>* | Determines which grayscale transformation modes (as [`EnumGrayscaleTransformationMode`](../enum/grayscale-transformation-mode.md)) the barcode reader will apply before the detection process. |
39+
| [`grayscaleEnhancementModes`](#grayscaleenhancementmodes) | *List\<EnumGrayscaleEnhancementMode\>* | Sets which grayscale enhancement modes (as [`EnumGrayscaleEnhancementModes`](../enum/grayscale-enhancement-mode.md)) the library will apply before the detection process. |
4040
| [`scaleDownThreshold`](#scaledownthreshold) | *int* | Defines the threshold for scaling down the image/frame before processing to help with memory overhead. |
4141

4242
### barcodeFormatIds
4343

44-
Specifies which barcode format(s) (as [EnumBarcodeFormat](./enum/barcode-format.md)) the Barcode Reader will target. To learn more on how to set the barcode formats, please refer to the [Foundational Guide](../foundational-user-guide.md#specify-barcode-formats-and-count).
44+
Specifies which barcode format(s) (as [`EnumBarcodeFormat`](../enum/barcode-format.md)) the Barcode Reader will target. To learn more on how to set the barcode formats, please refer to the [Foundational Guide](../../foundational-user-guide.md#specify-barcode-formats-and-count).
4545

4646
```dart
4747
EnumBarcodeFormat barcodeFormatIds;
@@ -63,24 +63,28 @@ int expectedBarcodesCount;
6363

6464
### localizationModes
6565

66-
Defines which localization modes (as a list of [`EnumLocalizationMode`](./enum/localization-mode.md)) the barcode reader will use during the detection process. Each [`EnumLocalizationMode`](./enum/localization-mode.md)) represents a different localization method, some of which are more optimized for certain barcode formats over others.
66+
Defines which localization modes (as a list of [`EnumLocalizationMode`](../enum/localization-mode.md)) the barcode reader will use during the detection process. Each [`EnumLocalizationMode`](../enum/localization-mode.md)) represents a different localization method, some of which are more optimized for certain barcode formats over others.
6767

6868
```dart
6969
List<EnumLocalizationMode> localizationModes;
7070
```
7171

7272
**Remarks**
7373

74-
Certain localization modes are specially optimized for certain barcode formats. For example, `lines` is designed primarily for 1D and PDF417 barcodes, while `statisticsMarks` is optimized for DPM codes. If you want to further improve the read rate of certain barcode types, please go through [EnumLocalizationMode](enum/localization-mode.md) page to learn which modes to apply based on the targeted barcode format(s).
74+
Certain localization modes are specially optimized for certain barcode formats. For example, `lines` is designed primarily for 1D and PDF417 barcodes, while `statisticsMarks` is optimized for DPM codes. If you want to further improve the read rate of certain barcode types, please go through the [`EnumLocalizationMode`](../enum/localization-mode.md) page to learn which modes to apply based on the targeted barcode format(s).
7575

7676
### deblurModes
7777

78-
Sets which deblur algorithms (as [`EnumDeblurMode`](./enum/deblur-mode.md)) the library will apply during the detection process when dealing with blurry images/frames.
78+
Sets which deblur algorithms (as [`EnumDeblurMode`](../enum/deblur-mode.md)) the library will apply during the detection process when dealing with blurry images/frames.
7979

8080
```dart
8181
List<EnumDeblurMode> deblurModes;
8282
```
8383

84+
**Remarks**
85+
86+
If you would like to learn about the different modes in depth, please visit this [page]({{ site.dcvb_parameters }}reference/barcode-reader-task-settings/deblur-modes.html#candidate-modes-introduction).
87+
8488
### minResultConfidence
8589

8690
Specifies the minimum barcode result confidence to help filter out inaccurate results. Confidence is a measure of a barcode result's accuracy, so by setting this parameter to a higher value, you ensure that the library will relay only the more accurate results.
@@ -119,34 +123,38 @@ int maxThreadsInOneTask;
119123

120124
### grayscaleTransformationModes
121125

122-
Determines which grayscale transformation modes (as [`EnumGrayscaleTransformationMode`](./enum/grayscale-transformation-mode.md)) the barcode reader will apply before the detection process. *This parameter controls the library's ability to read inverted barcodes.*
126+
Determines which grayscale transformation modes (as [`EnumGrayscaleTransformationMode`](../enum/grayscale-transformation-mode.md)) the barcode reader will apply before the detection process. **This parameter controls the library's ability to read inverted barcodes.**
123127

124128
```dart
125129
List<EnumGrayscaleTransformationMode> grayscaleTransformationModes;
126130
```
127131

128132
**Remarks**
129133

130-
- [ GTM_ORIGINAL ]: Process original coloured barcodes only.
131-
- [ GTM_INVERTED ]: Process inverted coloured barcodes only.
132-
- [ GTM_ORIGINAL, GTM_INVERTED ]: Process both original and inverted coloured barcodes. The library will search for the original coloured barcodes first.
133-
- [ GTM_INVERTED, GTM_ORIGINAL ]: Process both original and inverted coloured barcodes. The library will search for the inverted coloured barcodes first.
134+
The order in which the transformations modes is set will determine the priority that the library will follow when searching for barcodes. Please see the table below for more info.
135+
136+
- [ .original ]: Process original coloured barcodes only.
137+
- [ .inverted ]: Process inverted coloured barcodes only.
138+
- [ .original, .inverted ]: Process both original and inverted coloured barcodes. The library will search for the original coloured barcodes first.
139+
- [ .inverted, .original ]: Process both original and inverted coloured barcodes. The library will search for the inverted coloured barcodes first.
134140

135141
### grayscaleEnhancementModes
136142

137-
Sets which grayscale enhancement modes (as [`EnumGrayscaleEnhancementModes`](./enum/grayscale-enhancement-mode.md)) the library will apply before the detection process.
143+
Sets which grayscale enhancement modes (as [`EnumGrayscaleEnhancementModes`](../enum/grayscale-enhancement-mode.md)) the library will apply before the detection process.
138144

139145
```dart
140146
List<EnumGrayscaleEnhancementMode> grayscaleEnhancementModes;
141147
```
142148

143-
Remarks
149+
**Remarks**
144150

151+
The grayscaleEnhancementModes are image processing methods that help enhance the quality of the grayscale image, which is an essential part of the detection process. By default, the library doesn't do any image preprocessing. Therefore, if your image has some distortion or is of lower quality, using the right image preprocessing methods can help produce a higher quality grayscale image and improve the readability of the image or frame.
145152

153+
To learn more about the different grayscale enhancement modes and what each of them does, please visit this [page]({{ site.dcvb_parameters }}reference/image-parameter/grayscale-enhancement-modes.html#candidate-modes-introduction).
146154

147155
### scaleDownThreshold
148156

149-
Defines the threshold for scaling down the image/frame before processing to help with memory overhead. If both the width and height are larger than the threshold, the image is shrinked by half.
157+
Defines the threshold for scaling down the image/frame before processing to help with memory overhead. If both the width and height are larger than the threshold, the image is shrunk by half.
150158

151159
```dart
152160
int scaleDownThreshold;

0 commit comments

Comments
 (0)