Skip to content

Commit 80cf7a0

Browse files
Merge pull request #87 from dynamsoft-docs/preview
update to internal commit a5c16df6
2 parents ca93b4c + ced5cea commit 80cf7a0

File tree

30 files changed

+657
-331
lines changed

30 files changed

+657
-331
lines changed

_includes/sidelist-programming/programming-java.html

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,14 +10,16 @@
1010
<li><a href="{{ site.dcvb_java_api }}capture-vision-router/single-file-processing.html" class="otherLinkColour">Single-File Processing</a></li>
1111
<li><a href="{{ site.dcvb_java_api }}capture-vision-router/multiple-file-processing.html" class="otherLinkColour">Multiple-File Processing</a></li>
1212
<li><a href="{{ site.dcvb_java_api }}capture-vision-router/settings.html" class="otherLinkColour">Settings</a></li>
13+
<li><a href="{{ site.dcvb_java_api }}capture-vision-router/intermediate-result.html" class="otherLinkColour">Intermediate Result</a></li>
14+
<li><a href="{{ site.dcvb_java_api }}capture-vision-router/buffered-items.html" class="otherLinkColour">Buffered Items</a></li>
1315
<li><a href="{{ site.dcvb_java_api }}capture-vision-router/auxiliary-methods.html" class="otherLinkColour">Auxiliary Methods</a></li>
1416
</ul>
1517
</li>
1618
<li><a>Classes</a>
1719
<ul>
1820
<li><a href="{{ site.dcvb_java_api }}capture-vision-router/auxiliary-classes/buffered-items-manager.html" class="otherLinkColour">BufferedItemsManager</a></li>
1921
<li><a href="{{ site.dcvb_java_api }}capture-vision-router/capture-vision-error.html" class="otherLinkColour">CaptureVisionError</a></li>
20-
<li><a href="{{ site.dcvb_java_api }}capture-vision-router/capture-vision-execption.html" class="otherLinkColour">CaptureVisionException</a></li>
22+
<li><a href="{{ site.dcvb_java_api }}capture-vision-router/capture-vision-exception.html" class="otherLinkColour">CaptureVisionException</a></li>
2123
<li><a href="{{ site.dcvb_java_api }}capture-vision-router/auxiliary-classes/capture-vision-router-module.html" class="otherLinkColour">CaptureVisionRouterModule</a></li>
2224
<li><a href="{{ site.dcvb_java_api }}capture-vision-router/auxiliary-classes/captured-result-filter.html" class="otherLinkColour">CapturedResultFilter</a></li>
2325
<li><a href="{{ site.dcvb_java_api }}capture-vision-router/auxiliary-classes/captured-result-receiver.html" class="otherLinkColour">CapturedResultReceiver</a></li>

_includes/sidelist-programming/programming-python.html

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,6 +19,7 @@
1919
<li><a href="{{ site.dcvb_python_api }}capture-vision-router/settings.html" class="otherLinkColour">Settings</a></li>
2020
<li><a href="{{ site.dcvb_python_api }}capture-vision-router/buffered-items.html" class="otherLinkColour">Buffered Items</a></li>
2121
<li><a href="{{ site.dcvb_python_api }}capture-vision-router/intermediate-result.html" class="otherLinkColour">Intermediate Result</a></li>
22+
<li><a href="{{ site.dcvb_python_api }}capture-vision-router/auxiliary-methods.html" class="otherLinkColour">Auxiliary Methods</a></li>
2223
</ul>
2324
</li>
2425
<li><a>Classes</a>

_includes/sidelist-programming/sidelist-parameter-reference.html

Lines changed: 0 additions & 302 deletions
This file was deleted.

_includes/sidelist-programming/sidelist-parameters-organization.html

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -181,6 +181,7 @@
181181
<li><a href="{{ site.dcvb_parameters_reference }}label-recognizer-task-settings/stage-localize-text-lines.html" class="otherLinkColour">LocalizeTextLinesStage Object</a>
182182
<ul>
183183
<li><a href="{{ site.dcvb_parameters_reference }}label-recognizer-task-settings/stage-localize-text-lines.html#stage" class="otherLinkColour">Stage</a></li>
184+
<li><a href="{{ site.dcvb_parameters_reference }}label-recognizer-task-settings/localization-modes.html" class="otherLinkColour">LocalizationModes</a></li>
184185
</ul>
185186
</li>
186187
</ul>
@@ -438,7 +439,9 @@
438439
<li><a href="{{ site.dcvb_parameters_reference }}barcode-format-specification/enable-addon-code.html" class="otherLinkColour">EnableAddOnCode</a></li>
439440
<li><a href="{{ site.dcvb_parameters_reference }}barcode-format-specification/enable-data-matrix-ecc000-140.html" class="otherLinkColour">EnableDataMatrixECC000-140</a></li>
440441
<li><a href="{{ site.dcvb_parameters_reference }}barcode-format-specification/enable-qr-code-model-1.html" class="otherLinkColour">EnableQRCodeModel1</a></li>
442+
<li><a href="{{ site.dcvb_parameters_reference }}barcode-format-specification/expected-barcodes-count.html" class="otherLinkColour">ExpectedBarcodesCount</a></li>
441443
<li><a href="{{ site.dcvb_parameters_reference }}barcode-format-specification/find-uneven-module-barcode.html" class="otherLinkColour">FindUnevenModuleBarcode</a></li>
444+
<li><a href="{{ site.dcvb_parameters_reference }}barcode-format-specification/has-vertical-quietzone.html" class="otherLinkColour">HasVerticalQuietZone</a></li>
442445
<li><a href="{{ site.dcvb_parameters_reference }}barcode-format-specification/head-module-ratio.html" class="otherLinkColour">HeadModuleRatio</a></li>
443446
<li><a href="{{ site.dcvb_parameters_reference }}barcode-format-specification/include-implied-ai01.html" class="otherLinkColour">IncludeImpliedAI01</a></li>
444447
<li><a href="{{ site.dcvb_parameters_reference }}barcode-format-specification/include-trailing-check-digit.html" class="otherLinkColour">IncludeTrailingCheckDigit</a></li>
@@ -497,7 +500,8 @@
497500
</li>
498501
<li><a href="{{ site.dcvb_parameters }}file/auxiliary/global-parameter.html" class="otherLinkColour">Global Parameter</a>
499502
<ul>
500-
<li><a href="{{ site.dcvb_parameters_reference }}global-parameter/max-total-image-dimension.html" class="otherLinkColour">MaxTotalImageDimension</a></li>
503+
<li><a href="{{ site.dcvb_parameters }}file/auxiliary/global-parameter.html#maxtotalimagedimension" class="otherLinkColour">MaxTotalImageDimension</a></li>
504+
<li><a href="{{ site.dcvb_parameters }}file/auxiliary/global-parameter.html#intraopnumthreads" class="otherLinkColour">IntraOpNumThreads</a></li>
501505
</ul>
502506
</li>
503507
<li><a href="{{ site.dcvb_parameters }}file/semantic-processing/index.html" class="otherLinkColour">SemanticProcessing Object</a>

programming/cplusplus/api-reference/capture-vision-router/auxiliary-methods.md

Lines changed: 47 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -12,31 +12,36 @@ breadcrumbText: CVR C++ Auxiliary Methods
1212

1313
| API Name | Description |
1414
| ------------------------------------------------------------- | --------------------------------------------------------- |
15-
| [`FreeString`](#freestring) | Frees the memory allocated for a string. |
16-
| [`AppendModelBuffer`](#appendmodelbuffer) | Appends a model to the model buffer. |
15+
| [`SetGlobalIntraOpNumThreads`](#setglobalintraopnumthreads) | Sets the global number of threads used internally for model execution. |
16+
| [`AppendDLModelBuffer`](#appenddlmodelbuffer) | Appends a deep learning model to the memory buffer. |
17+
| [`ClearDLModelBuffers`](#cleardlmodelbuffers) | Clears all deep learning models from buffer to free up memory. |
18+
| [`FreeString`](#freestring) | Deprecated. Will be removed in future versions. Use [`CoreModule::FreeBytes`]({{ site.dcvb_cpp_api }}core/basic-structures/core-module.html#freebytes) instead.|
19+
| [`AppendModelBuffer`](#appendmodelbuffer) | Deprecated. Will be removed in future versions. Use `AppendDLModelBuffer` instead. |
1720

18-
## FreeString
1921

20-
Frees the memory allocated for a string. The function is *deprecated*, use [`CoreModule::FreeBytes`]({{ site.dcvb_cpp_api }}core/basic-structures/core-module.html#freebytes) instead.
22+
## SetGlobalIntraOpNumThreads
23+
24+
Sets the global number of threads used internally for model execution.
2125

2226
```cpp
23-
static void FreeString(char* content);
27+
static void SetGlobalIntraOpNumThreads(int intraOpNumThreads = 0);
2428
```
2529
2630
**Parameters**
2731
28-
`[in] content` The string whose memory needs to be freed.
32+
`[in] intraOpNumThreads` Number of threads used internally for model execution. Valid range: [0, 256].
33+
If the value is outside the range [0, 256], it will be treated as 0 (default).
2934
30-
**Return Value**
35+
**Remarks**
3136
32-
This function does not return a value. It simply frees the memory allocated for the input string.
37+
- Introduced in Dynamsoft Barcode Reader SDK version 11.2.1000 and Dynamsoft Capture Vision version 3.2.1000.
3338
34-
## AppendModelBuffer
39+
## AppendDLModelBuffer
3540
36-
Appends a model to the model buffer.
41+
Appends a deep learning model to the memory buffer.
3742
3843
```cpp
39-
static int AppendModelBuffer(const char* modelName, const unsigned char* modelBytes, int modelBytesLength, int maxModelInstances);
44+
static int AppendDLModelBuffer(const char* modelName, const unsigned char* modelBytes, int modelBytesLength, int maxModelInstances);
4045
```
4146

4247
**Parameters**
@@ -52,3 +57,34 @@ static int AppendModelBuffer(const char* modelName, const unsigned char* modelBy
5257
**Return Value**
5358

5459
Returns 0 if succeeds, nonzero otherwise.
60+
61+
**Remarks**
62+
63+
- Introduced in Dynamsoft Barcode Reader SDK version 11.2.1000 and Dynamsoft Capture Vision version 3.2.1000.
64+
65+
## ClearDLModelBuffers
66+
67+
Clears all deep learning models from buffer to free up memory.
68+
69+
```cpp
70+
static void ClearDLModelBuffers();
71+
```
72+
73+
**Remarks**
74+
75+
- After calling this function, all `CaptureVisionRouter` instances created before the function call will not be able to use model-related features.
76+
77+
- Introduced in Dynamsoft Barcode Reader SDK version 11.2.1000 and Dynamsoft Capture Vision version 3.2.1000.
78+
79+
## FreeString
80+
81+
Deprecated. Will be removed in future versions. Use [`CoreModule::FreeBytes`]({{ site.dcvb_cpp_api }}core/basic-structures/core-module.html#freebytes) instead.
82+
83+
84+
## AppendModelBuffer
85+
86+
Deprecated. Will be removed in future versions. Use `AppendDLModelBuffer` instead.
87+
88+
**Remarks**
89+
90+
- Deprecated in Dynamsoft Barcode Reader SDK version 11.2.1000 and Dynamsoft Capture Vision version 3.2.1000.

programming/cplusplus/api-reference/capture-vision-router/capture-vision-router.md

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -68,6 +68,7 @@ class CCaptureVisionRouter
6868
| [`ResetSettings`](settings.md#resetsettings) | Resets all templates to factory settings. |
6969
| [`GetParameterTemplateCount`](settings.md#getparametertemplatecount) | Retrieves the total number of available parameter templates. |
7070
| [`GetParameterTemplateName`](settings.md#getparametertemplatename) | Retrieves the name of a specific parameter template by its index. |
71+
| [`SwitchCapturingTemplate`](settings.md#switchcapturingtemplate) | Switches the capturing template during the image processing workflow. |
7172
7273
## Intermediate Result
7374
@@ -87,5 +88,8 @@ The following method returns an `CIntermediateResultManager` object which allows
8788
8889
| API Name | Description |
8990
| --------------------------------------------- | --------------------------------------------------------- |
90-
| [`FreeString`](auxiliary-methods.md#freestring) | Frees the memory allocated for a string. The function is *deprecated*, use [`CoreModule::FreeBytes`]({{ site.dcvb_cpp_api }}core/basic-structures/core-module.html#freebytes) instead. |
91-
| [`AppendModelBuffer`](auxiliary-methods.md#appendmodelbuffer) | Appends a model to the model buffer. |
91+
| [`FreeString`](auxiliary-methods.md#freestring) | The function is *deprecated*, use [`CoreModule::FreeBytes`]({{ site.dcvb_cpp_api }}core/basic-structures/core-module.html#freebytes) instead. |
92+
| [`SetGlobalIntraOpNumThreads`](auxiliary-methods.md#setglobalintraopnumthreads) | Sets the global number of threads used internally for model execution. |
93+
| [`AppendDLModelBuffer`](auxiliary-methods.md#appenddlmodelbuffer) | Appends a deep learning model to the memory buffer. |
94+
| [`ClearDLModelBuffers`](auxiliary-methods.md#cleardlmodelbuffers) | Clears all deep learning models from buffer to free up memory. |
95+
| [`AppendModelBuffer`](auxiliary-methods.md#appendmodelbuffer) | Deprecated. Will be removed in future versions. Use `AppendDLModelBuffer` instead. |

programming/cplusplus/api-reference/capture-vision-router/settings.md

Lines changed: 25 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,6 @@ description: This page introduces APIs related to the Settings of the CCaptureVi
55
keywords: capture vision, router, settings, api reference, c++
66
needAutoGenerateSidebar: true
77
needGenerateH3Content: false
8-
breadcrumbText: CVR C++ Settings
98
---
109

1110
# Settings
@@ -21,6 +20,7 @@ breadcrumbText: CVR C++ Settings
2120
| [`ResetSettings`](#resetsettings) | Resets all templates to factory settings. |
2221
| [`GetParameterTemplateCount`](#getparametertemplatecount) | Retrieves the total number of available parameter templates. |
2322
| [`GetParameterTemplateName`](#getparametertemplatename) | Retrieves the name of a specific parameter template by its index. |
23+
| [`SwitchCapturingTemplate`](#switchcapturingtemplate) | Switches the capturing template during the image processing workflow. |
2424

2525
## InitSettings
2626

@@ -268,3 +268,27 @@ int GetParameterTemplateName(const int index, char nameBuffer[], int nameBufferL
268268
**Return value**
269269
270270
Returns an error code. Zero indicates success.
271+
272+
## SwitchCapturingTemplate
273+
274+
Switches the capturing template during the image processing workflow.
275+
276+
```cpp
277+
int SwitchCapturingTemplate(const char* templateName, char errorMsgBuffer[] = NULL, const int errorMsgBufferLen = 0);
278+
```
279+
280+
**Parameters**
281+
282+
`[in] templateName` The name of the new capturing template to apply.
283+
284+
`[in] errorMsgBuffer` A buffer for error messages.
285+
286+
`[in] errorMsgBufferLen` The length of the error message buffer.
287+
288+
**Return value**
289+
290+
Returns an error code. Zero indicates success.
291+
292+
**Remarks**
293+
294+
- Introduced in Dynamsoft Barcode Reader SDK version 11.2.1000 and Dynamsoft Capture Vision version 3.2.1000.

programming/cplusplus/index.md

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -55,6 +55,9 @@ For embedded or ARM-based platforms, we recommend using a device with performanc
5555
- 4 GB RAM
5656
- Linux-based OS (e.g., Raspberry Pi OS, Ubuntu Server)
5757

58+
> [!NOTE]
59+
> Other architectures and operating systems, such as ESP32, MIPS, FreeRTOS, and Micrium uC/OS, are not supported.
60+
5861
## API Reference
5962

6063
For an overview of the APIs, see the [API Reference]({{ site.dcvb_cpp_api }}).

programming/cplusplus/release-notes/cpp-3.md

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,66 @@ needGenerateH3Content: false
88

99
# Release Notes for C++ Edition - 3.x
1010

11+
## 3.2.1000 (10/14/2025)
12+
13+
🎉 **Milestone Release** - This version introduces groundbreaking AI-powered enhancements that significantly improve accuracy and performance across all barcode and MRZ processing scenarios.
14+
15+
### ✨ Key Highlights
16+
17+
**AI-Powered Barcode Detection & Decoding**
18+
- 🧠 **First-to-Market AI Localization**: Revolutionary `OneDLocalization` and `DataMatrixQRCodeLocalization` neural network models for superior detection of **blurred/low-resolution 1D codes** and **DataMatrix/QR codes with missing or damaged finder patterns**
19+
-**Specialized Decoders**: Cutting-edge `EAN13Decoder` and `Code128Decoder` models deliver unprecedented accuracy for **blurred and long-distance** scenarios
20+
- 🔍 **Enhanced Clarity Processing**: Completely redesigned `OneDDeblur` model with superior **motion blur and focus blur** recovery algorithms
21+
- 🎯 **Flexible Model Configuration**: Advanced `ModelNameArray` parameter enables on-demand model loading and precise selection for specific barcode scenarios
22+
23+
**Precision Control**
24+
- ⚙️ **Granular Deblur Methods**: Fine-tuned `DM_DEEP_ANALYSIS` with specialized method control - `OneDGeneral`, `TwoDGeneral`, and `EAN13Enhanced` for targeted optimization
25+
- 🎯 **Smart Barcode Counting**: New `ExpectedBarcodesCount` parameter enables **format-specific quantity control** and **early termination optimization** for known-quantity scenarios
26+
- 🔍 **Advanced Region Detection**: New `RPM_GRAY_CONSISTENCY` mode enables precise region detection based on **grayscale uniformity** and **local consistency** for document and label processing
27+
28+
29+
**Enhanced Text Processing**
30+
- 🚀 **High-Speed and Precise MRZ Region Detection**: Revolutionary neural network `MRZLocalization` model delivers **42.7% faster processing** with enhanced region detection accuracy for passport and ID workflows
31+
- 🎛️ **Advanced Localization**: New `LocalizationModes` parameter provides unprecedented control over text line detection algorithms
32+
33+
34+
**Smart Document Capture**
35+
- 🎥 **Clarity-Based Frame Selection**: Intelligent frame selection automatically chooses the sharpest, highest-quality document images
36+
- 🔄 **Enhanced Cross-Frame Verification**: Advanced cross-frame verification algorithms significantly improve result reliability and accuracy
37+
38+
39+
### 💡 What This Means for You
40+
41+
**For Challenging Barcode Scenarios**
42+
- **Blurred conditions**: 26.5% better read rates with 44% faster processing - ideal for handheld scanning and moving objects
43+
- **Extended distance capability**: Breakthrough support for reading distances beyond 75cm - revolutionizing warehouse automation and high-shelf scanning
44+
- **Damaged 2D codes**: Enhanced detection of DataMatrix and QR codes with missing or damaged finder patterns - perfect for manufacturing and logistics applications
45+
46+
**For Document Processing Applications**
47+
- **Real-time video streams**: Optimized performance maintains smooth user experience in live capture scenarios
48+
- **Document quality assessment**: Intelligent clarity-based frame selection ensures highest quality document captures
49+
50+
**For Enterprise Integration**
51+
- **Retail environments**: Enhanced performance for blurred handheld scanning and long-distance shelf reading
52+
- **Logistics & shipping**: Improved recognition for package tracking with better blur and long-distance scanning capabilities
53+
- **Manufacturing QC**: Improved 2D code reading on printed/etched parts with wear damage
54+
- **Security applications**: Faster MRZ processing for high-throughput identity verification
55+
56+
**For Developers**
57+
- **Backward Compatible**: Seamless upgrade with existing code and easy migration path
58+
- **Flexible Configuration**: Extensive parameter customization for specific use cases and comprehensive model configuration options
59+
- **Enterprise Ready**: Battle-tested stability for production environments
60+
61+
62+
### Changed
63+
64+
- Updated the default value of parameter [`MaxThreadsInOneTask`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/max-threads-in-one-task.html) from 4 to 0 (auto-detection).
65+
- Updated the default value of parameter [`IncludeTrailingCheckDigit`]({{ site.dcvb_parameters_reference }}barcode-format-specification/include-trailing-check-digit.html) from 1 to 0.
66+
- Deprecated argument `DeblurModelNameArray` of parameter [`DeblurModes`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/deblur-modes.html), use `ModelNameArray` instead.
67+
- Deprecated method `AppendModelBuffer` of class [`CaptureVisionRouter`]({{ site.dcvb_cpp_api }}capture-vision-router/capture-vision-router.html), use [`AppendDLModelBuffer`]({{ site.dcvb_cpp_api }}capture-vision-router/auxiliary-methods.html#appenddlmodelbuffer) instead.
68+
69+
70+
1171
## 3.0.6000 (08/06/2025)
1272

1373
### Changed

programming/cplusplus/release-notes/index.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -9,6 +9,7 @@ noTitleIndex: true
99

1010
# Release Notes - Dynamsoft Capture Vision CPP
1111

12+
- [3.2.1000 (10/14/2025)]({{ site.dcvb_cpp_release_notes_v3 }}cpp-3.html#321000-10142025)
1213
- [3.0.6000 (08/06/2025)]({{ site.dcvb_cpp_release_notes_v3 }}cpp-3.html#306000-08062025)
1314
- [3.0.4000 (07/15/2025)]({{ site.dcvb_cpp_release_notes_v3 }}cpp-3.html#304000-07152025)
1415
- [3.0.3000 (05/13/2025)]({{ site.dcvb_cpp_release_notes_v3 }}cpp-3.html#303000-05132025)

0 commit comments

Comments
 (0)