diff --git a/_includes/sidelist-programming/programming-cpp.html b/_includes/sidelist-programming/programming-cpp.html index 019b394..553d43c 100644 --- a/_includes/sidelist-programming/programming-cpp.html +++ b/_includes/sidelist-programming/programming-cpp.html @@ -113,6 +113,7 @@
  • CDecodedBarcodesUnit
  • CDeformationResistedBarcodeImageUnit
  • CDeformationResistedBarcode
    • +
  • CECISegment
  • CExtendedBarcodeResult
  • CLocalizedBarcodeElement
  • CLocalizedBarcodesUnit
    • diff --git a/_includes/sidelist-programming/programming-dotnet.html b/_includes/sidelist-programming/programming-dotnet.html index 9bed812..7962859 100644 --- a/_includes/sidelist-programming/programming-dotnet.html +++ b/_includes/sidelist-programming/programming-dotnet.html @@ -110,6 +110,7 @@
  • DecodedBarcodesUnit
  • DeformationResistedBarcodeImageUnit
  • DeformationResistedBarcode
    • +
  • ECISegment
  • ExtendedBarcodeResult
  • LocalizedBarcodeElement
  • LocalizedBarcodesUnit
    • diff --git a/_includes/sidelist-programming/programming-java.html b/_includes/sidelist-programming/programming-java.html index 0dca19d..e2fbddd 100644 --- a/_includes/sidelist-programming/programming-java.html +++ b/_includes/sidelist-programming/programming-java.html @@ -79,7 +79,6 @@
  • CapturedResult
  • IntermediateResultManager
  • IntermediateResultReceiver
    • -
  • PresetTemplate
  • SimplifiedCaptureVisionSettings
    • @@ -93,6 +92,7 @@ @@ -115,6 +115,7 @@
  • DecodedBarcodesUnit
  • DeformationResistedBarcodeImageUnit
  • DeformationResistedBarcode
    • +
  • ECISegment
  • ExtendedBarcodeResult
  • LocalizedBarcodeElement
  • LocalizedBarcodesUnit
    • diff --git a/_includes/sidelist-programming/programming-python.html b/_includes/sidelist-programming/programming-python.html index 2b04d85..609a87d 100644 --- a/_includes/sidelist-programming/programming-python.html +++ b/_includes/sidelist-programming/programming-python.html @@ -109,6 +109,7 @@
  • DecodedBarcodesUnit
  • DeformationResistedBarcodeImageUnit
  • DeformationResistedBarcode
    • +
  • ECISegment
  • ExtendedBarcodeResult
  • LocalizedBarcodeElement
  • LocalizedBarcodesUnit
    • diff --git a/_includes/sidelist-programming/sidelist-parameters-organization.html b/_includes/sidelist-programming/sidelist-parameters-organization.html index 4b8c348..89e538a 100644 --- a/_includes/sidelist-programming/sidelist-parameters-organization.html +++ b/_includes/sidelist-programming/sidelist-parameters-organization.html @@ -254,6 +254,7 @@
  • BarcodeWidthRangeArray
  • BarcodeZoneBarCountRangeArray
  • BarcodeZoneMinDistanceToImageBorders
    • +
  • BarcodeZoneWidthToHeightRatioRangeArray
  • Code128Subset
  • DataMatrixModuleIsotropic
  • DataMatrixSizeOptions
    • diff --git a/programming/cplusplus/api-reference/barcode-result-item.md b/programming/cplusplus/api-reference/barcode-result-item.md index 6e664d9..29aeecc 100644 --- a/programming/cplusplus/api-reference/barcode-result-item.md +++ b/programming/cplusplus/api-reference/barcode-result-item.md @@ -38,6 +38,8 @@ class CBarcodeResultItem : public CCapturedResultItem | [`IsDPM`](#isdpm) | Gets whether the decoded barcode is a DPM code. | | [`IsMirrored`](#ismirrored) | Gets whether the decoded barcode is a mirrored barcode. | | [`SetLocation`](#setlocation) | Set the location of the barcode item. | +| [`GetECISegmentsCount`](#getecisegmentscount) | Gets the number of ECI segments in the barcode. | +| [`GetECISegment`](#getecisegment) | Gets the ECI segment at the specified index. | | **Methods Inherited from [CCapturedResultItem]({{ site.dcvb_cpp_api }}core/basic-structures/captured-result-item.html):** | | | [`GetType`]({{ site.dcvb_cpp_api }}core/basic-structures/captured-result-item.html#gettype) | Gets the type of the captured result item. | | [`GetReferenceItem`]({{ site.dcvb_cpp_api }}core/basic-structures/captured-result-item.html#getreferenceitem) | Gets a pointer to the referenced item in the captured result. | @@ -87,6 +89,12 @@ virtual const char* GetText() const = 0; Returns the text result of the decoded barcode. +**Remarks** + +The text result is returned in UTF-8 encoding. The SDK will automatically attempt to detect and convert the barcode bytes to UTF-8 based on ECI information or common character encodings. + +If the returned text contains unexpected characters, it may indicate that the automatic encoding detection did not match the actual encoding of the barcode data. In this case, you should use [`GetBytes`](#getbytes) to retrieve the raw byte data and convert it to the appropriate character encoding yourself. + ### GetBytes It is used to get the text bytes of the decoded barcode result. @@ -231,3 +239,43 @@ Returns an error code. Zero indicates success. **See Also** [CQuadrilateral]({{ site.dcvb_cpp_api }}core/basic-structures/quadrilateral.html) + +### GetECISegmentsCount + +Gets the number of ECI segments in the barcode. + +```cpp +virtual int GetECISegmentsCount() const = 0; +``` + +**Return value** + +Returns the count of ECI segments. Returns 0 if no ECI information is present. + +**Remarks** + +Introduced in Dynamsoft Barcode Reader SDK version 11.4.1000 and Dynamsoft Capture Vision version 3.4.1000. + +### GetECISegment + +Gets the ECI segment at the specified index. + +```cpp +virtual const CECISegment* GetECISegment(int index) const = 0; +``` + +**Parameters** + +`[in] index` The zero-based index of the ECI segment to retrieve. + +**Return value** + +Returns a pointer to the [`CECISegment`]({{ site.dbr_cpp_api }}eci-segment.html) object, or NULL if the index is out of range. + +**See Also** + +[CECISegment]({{ site.dbr_cpp_api }}eci-segment.html) + +**Remarks** + +Introduced in Dynamsoft Barcode Reader SDK version 11.4.1000 and Dynamsoft Capture Vision version 3.4.1000. diff --git a/programming/cplusplus/api-reference/decoded-barcode-element.md b/programming/cplusplus/api-reference/decoded-barcode-element.md index 44072f3..02304fd 100644 --- a/programming/cplusplus/api-reference/decoded-barcode-element.md +++ b/programming/cplusplus/api-reference/decoded-barcode-element.md @@ -41,6 +41,8 @@ class CDecodedBarcodeElement : public CRegionObjectElement | [`SetText`](#settext) | Sets the text of the decoded barcode. | | [`SetBytes`](#setbytes)| Sets the raw bytes of the decoded barcode.| | [`SetConfidence`](#setconfidence) | Sets the confidence score of the barcode recognition result. | +| [`GetECISegmentsCount`](#getecisegmentscount) | Gets the number of ECI segments in the barcode. | +| [`GetECISegment`](#getecisegment) | Gets the ECI segment at the specified index. | | **Methods Inherited from [CRegionObjectElement]({{ site.dcvb_cpp_api }}core/intermediate-results/region-object-element.html):** | | | [`GetLocation`]({{ site.dcvb_cpp_api }}core/intermediate-results/region-object-element.html#getlocation) | Gets the location of the region object element. | | [`GetReferencedElement`]({{ site.dcvb_cpp_api }}core/intermediate-results/region-object-element.html#getreferencedelement) | Gets a pointer to a referenced region object element. | @@ -281,3 +283,42 @@ virtual void SetConfidence(int confidence) = 0; `[in] confidence` The confidence of the barcode. +### GetECISegmentsCount + +Gets the number of ECI segments in the barcode. + +```cpp +virtual int GetECISegmentsCount() const = 0; +``` + +**Return value** + +Returns the count of ECI segments. Returns 0 if no ECI information is present. + +**Remarks** + +Introduced in Dynamsoft Barcode Reader SDK version 11.4.1000 and Dynamsoft Capture Vision version 3.4.1000. + +### GetECISegment + +Gets the ECI segment at the specified index. + +```cpp +virtual const CECISegment* GetECISegment(int index) const = 0; +``` + +**Parameters** + +`[in] index` The zero-based index of the ECI segment to retrieve. + +**Return value** + +Returns a pointer to the [`CECISegment`]({{ site.dbr_cpp_api }}eci-segment.html) object, or NULL if the index is out of range. + +**See Also** + +[CECISegment]({{ site.dbr_cpp_api }}eci-segment.html) + +**Remarks** + +Introduced in Dynamsoft Barcode Reader SDK version 11.4.1000 and Dynamsoft Capture Vision version 3.4.1000. diff --git a/programming/cplusplus/api-reference/eci-segment.md b/programming/cplusplus/api-reference/eci-segment.md new file mode 100644 index 0000000..eae51cb --- /dev/null +++ b/programming/cplusplus/api-reference/eci-segment.md @@ -0,0 +1,70 @@ +--- +layout: default-layout +title: CECISegment Class - Dynamsoft Barcode Reader C++ Edition API Reference +description: This page shows CECISegment class definition of Dynamsoft Barcode Reader SDK C++ Edition. +keywords: CECISegment, ECI, Extended Channel Interpretation, api reference +--- + +# CECISegment Class + +The `CECISegment` class represents the Extended Channel Interpretation (ECI) information within a barcode. Each ECI segment specifies the character encoding used for a portion of the decoded bytes. The charset names follow the IANA character set registry (e.g. "UTF-8", "ISO-8859-1"). + +**Remarks** + +Introduced in Dynamsoft Barcode Reader SDK version 11.4.1000 and Dynamsoft Capture Vision version 3.4.1000. + +## Definition + +*Namespace:* dynamsoft::dbr + +*Assembly:* DynamsoftBarcodeReader + +```cpp +class CECISegment +``` + +## Attributes + +| Attribute | Type | Description | +| --------- | ---- | ----------- | +| [`eciValue`](#ecivalue) | *int* | ECI assignment number as defined by ISO/IEC 15424. | +| [`charsetEncoding`](#charsetencoding) | *const char\** | Charset encoding name defined by IANA. | +| [`startIndex`](#startindex) | *int* | Start index of this ECI segment in the decoded barcode bytes. | +| [`length`](#length) | *int* | Length (in bytes) of this segment within the decoded barcode bytes. | + +### eciValue + +ECI assignment number as defined by ISO/IEC 15424. + +```cpp +int eciValue +``` + +### charsetEncoding + +Charset encoding name defined by IANA (e.g. "UTF-8", "ISO-8859-1"). + +```cpp +const char* charsetEncoding +``` + +### startIndex + +Start index of this ECI segment in the decoded barcode bytes. + +```cpp +int startIndex +``` + +### length + +Length (in bytes) of this segment within the decoded barcode bytes. + +```cpp +int length +``` + +## See Also + +- [`CBarcodeResultItem`]({{ site.dbr_cpp_api }}barcode-result-item.html) +- [`CDecodedBarcodeElement`]({{ site.dbr_cpp_api }}decoded-barcode-element.html) diff --git a/programming/cplusplus/api-reference/index.md b/programming/cplusplus/api-reference/index.md index 860517a..fb9fe0d 100644 --- a/programming/cplusplus/api-reference/index.md +++ b/programming/cplusplus/api-reference/index.md @@ -58,6 +58,7 @@ needAutoGenerateSidebar: false - [`CDecodedBarcodesUnit`]({{ site.dbr_cpp_api }}decoded-barcodes-unit.html) - [`CDeformationResistedBarcode`]({{ site.dbr_cpp_api }}deformation-resisted-barcode.html) - [`CDeformationResistedBarcodeImageUnit`]({{ site.dbr_cpp_api }}deformation-resisted-barcode-image-unit.html) +- [`CECISegment`]({{ site.dbr_cpp_api }}eci-segment.html) - [`CExtendedBarcodeResult`]({{ site.dbr_cpp_api }}extended-barcode-result.html) - [`CLocalizedBarcodeElement`]({{ site.dbr_cpp_api }}localized-barcode-element.html) - [`CLocalizedBarcodesUnit`]({{ site.dbr_cpp_api }}localized-barcodes-unit.html) diff --git a/programming/cplusplus/release-notes/cpp-11.md b/programming/cplusplus/release-notes/cpp-11.md index e3a726b..47a8cdc 100644 --- a/programming/cplusplus/release-notes/cpp-11.md +++ b/programming/cplusplus/release-notes/cpp-11.md @@ -8,6 +8,68 @@ needGenerateH3Content: false # Release Notes for C++ Edition - 11.x +## 11.4.1000 (02/05/2026) + +### Highlights + +#### AI-Powered Barcode Detection and Decoding + +- **PDF417 Localization Model** – Introduces the [`PDF417Localization`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/localization-modes.html#modelnamearray) neural network model for improved detection of PDF417 barcodes, especially under challenging conditions. + +- **Code39/ITF Decoding Model** – Adds the [`Code39ITFDecoder`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/deblur-modes.html#modelnamearray) model for enhanced decoding of Code 39 and ITF barcodes under blurred or low-resolution conditions. + +- **Deblur Models for 2D Barcodes** – Adds the [`DataMatrixQRCodeDeblur`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/deblur-modes.html#modelnamearray) and [`PDF417Deblur`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/deblur-modes.html#modelnamearray) models to provide more effective recovery from motion and focus blur for DataMatrix, QR Code, and PDF417 barcodes. + +#### ECI (Extended Channel Interpretation) Support + +- **ECI Information Return** – Adds support for retrieving Extended Channel Interpretation (ECI) data from barcodes. The new [`CECISegment`]({{ site.dbr_cpp_api }}eci-segment.html) class, along with the `GetECISegmentsCount()` and `GetECISegment()` methods in the [`CBarcodeResultItem`]({{ site.dbr_cpp_api }}barcode-result-item.html#getecisegment) and [`CDecodedBarcodeElement`]({{ site.dbr_cpp_api }}decoded-barcode-element.html#getecisegment) classes, enables access to character encoding information embedded in barcodes. + +- **ECI-Based Text Interpretation** – Adds support for interpreting ECI segments during barcode decoding, improving compatibility with international character sets. + +#### Performance Improvements + +- **On-Demand Model Loading** – Implements lazy loading for AI models, reducing initialization time by loading models only when first needed. + +- **Smart Model Selection** – Models are now loaded based on configured barcode formats, minimizing memory usage by excluding unused models. + +- **Improved Confidence Scoring** – Enhances confidence score calculation for results from neural network models, providing more accurate quality indicators. + +- **DPM Barcode Optimization** – Improves recognition rate for Direct Part Marking (DPM) barcodes commonly used in industrial and manufacturing environments. + +### New + +- Added [`BarcodeZoneWidthToHeightRatioRangeArray`]({{ site.dcvb_parameters_reference }}barcode-format-specification/barcode-zone-width-to-height-ratio-range-array.html) parameter for filtering barcodes based on aspect ratio constraints. + +- Added [`SetResultCrossVerificationCriteria()`]({{ site.dcvb_cpp_api }}utility/multi-frame-result-cross-filter.html#setresultcrossverificationcriteria) and [`GetResultCrossVerificationCriteria()`]({{ site.dcvb_cpp_api }}utility/multi-frame-result-cross-filter.html#getresultcrossverificationcriteria) methods to `CMultiFrameResultCrossFilter` for configurable multi-frame result verification. + +### Changed + +- `CaptureMultiPages` now returns results sorted by page number. + +- Barcode text encoding fallback changed from UTF-8 to ISO-8859-1 when no ECI information is present in the barcode. + +- Updated default value of `compensation` parameter in [`CImageProcessor::ConvertToBinaryLocal()`]({{ site.dcvb_cpp_api }}utility/image-processor.html#converttobinarylocal) from 0 to 10. + +- [`ConvertToBinaryGlobal()`]({{ site.dcvb_cpp_api }}utility/image-processor.html#converttobinaryglobal) and [`ConvertToBinaryLocal()`]({{ site.dcvb_cpp_api }}utility/image-processor.html#converttobinarylocal) of `CImageProcessor` class now support color, binary and grayscale images as input. + +### Improved + +- Improved license binding stability on macOS devices. + +### Removed + +- Removed `DataMatrixModuleIsotropic` parameter – use [`BarcodeZoneWidthToHeightRatioRangeArray`]({{ site.dcvb_parameters_reference }}barcode-format-specification/barcode-zone-width-to-height-ratio-range-array.html) instead. + +- Removed `MinRatioOfBarcodeZoneWidthToHeight` parameter – use [`BarcodeZoneWidthToHeightRatioRangeArray`]({{ site.dcvb_parameters_reference }}barcode-format-specification/barcode-zone-width-to-height-ratio-range-array.html) instead. + +### Fixed + +- Fixed incorrect coordinate in barcode result when using neural network models with a specified region. + +- Fixed crash and hang issues that could occur in certain scenarios. + +- Fixed various minor bugs and improved overall stability. + ## 11.2.5000 (12/16/2025) This release includes security maintenance updates to ensure continued protection of the product. diff --git a/programming/cplusplus/release-notes/index.md b/programming/cplusplus/release-notes/index.md index b76cd53..6416537 100644 --- a/programming/cplusplus/release-notes/index.md +++ b/programming/cplusplus/release-notes/index.md @@ -8,6 +8,7 @@ needAutoGenerateSidebar: false # Release Notes - C++ Edition +- [11.4.1000 (02/05/2026)]({{ site.dbr_cpp_release_notes_v11 }}cpp-11.html#1141000-02052026) - [11.2.5000 (12/16/2025)]({{ site.dbr_cpp_release_notes_v11 }}cpp-11.html#1125000-12162025) - [11.2.1000 (10/14/2025)]({{ site.dbr_cpp_release_notes_v11 }}cpp-11.html#1121000-10142025) - [11.0.6000 (08/06/2025)]({{ site.dbr_cpp_release_notes_v11 }}cpp-11.html#1106000-08062025) diff --git a/programming/dotnet/api-reference/barcode-result-item.md b/programming/dotnet/api-reference/barcode-result-item.md index 575ad29..fd7fd83 100644 --- a/programming/dotnet/api-reference/barcode-result-item.md +++ b/programming/dotnet/api-reference/barcode-result-item.md @@ -37,6 +37,7 @@ public class BarcodeResultItem : CapturedResultItem | [`IsMirrored`](#ismirrored) | Gets whether the decoded barcode is a mirrored barcode. | | [`GetCapturedResultItemType`](#getcapturedresultitemtype) | Gets the type of the captured result item. | | [`GetReferenceItem`](#getreferenceitem) | Gets the referenced item in the captured result item. | +| [`GetECISegments`](#getecisegments) | Gets all the ECI segments in the barcode. | ### GetFormat @@ -222,3 +223,24 @@ Returns the referenced item in the captured result item. **See Also** [CapturedResultItem]({{ site.dcvb_dotnet_api }}core/basic-classes/captured-result-item.html) + +### GetECISegments + +Gets all the ECI segments in the barcode. + +```csharp +ECISegment[] GetECISegments() +``` + +**Return Value** + +Returns an array of [`ECISegment`]({{ site.dbr_dotnet_api }}eci-segment.html) objects. Returns an empty array if no ECI information is present. + +**See Also** + +[ECISegment]({{ site.dbr_dotnet_api }}eci-segment.html) + +**Remarks** + +Introduced in Dynamsoft Barcode Reader SDK version 11.4.1000 and Dynamsoft Capture Vision version 3.4.1000. + diff --git a/programming/dotnet/api-reference/decoded-barcode-element.md b/programming/dotnet/api-reference/decoded-barcode-element.md index c0003d2..6023ca7 100644 --- a/programming/dotnet/api-reference/decoded-barcode-element.md +++ b/programming/dotnet/api-reference/decoded-barcode-element.md @@ -42,6 +42,7 @@ class DecodedBarcodeElement : RegionObjectElement | [`SetBytes`](#setbytes)| Sets the raw bytes of the decoded barcode.| | [`SetConfidence`](#setconfidence) | Sets the confidence score of the barcode recognition result. | | [`SetLocation`](#setlocation) | Sets the location of the current object. | +| [`GetECISegments`](#getecisegments) | Gets all the ECI segments in the barcode. | ### Inherited Methods @@ -307,3 +308,24 @@ void SetLocation(Quadrilateral location) **See Also** [Quadrilateral]({{ site.dcvb_dotnet_api }}core/basic-classes/quadrilateral.html) + +### GetECISegments + +Gets all the ECI segments in the barcode. + +```csharp +ECISegment[] GetECISegments() +``` + +**Return Value** + +Returns an array of [`ECISegment`]({{ site.dbr_dotnet_api }}eci-segment.html) objects. Returns an empty array if no ECI information is present. + +**See Also** + +[ECISegment]({{ site.dbr_dotnet_api }}eci-segment.html) + +**Remarks** + +Introduced in Dynamsoft Barcode Reader SDK version 11.4.1000 and Dynamsoft Capture Vision version 3.4.1000. + diff --git a/programming/dotnet/api-reference/eci-segment.md b/programming/dotnet/api-reference/eci-segment.md new file mode 100644 index 0000000..ccd4fe8 --- /dev/null +++ b/programming/dotnet/api-reference/eci-segment.md @@ -0,0 +1,68 @@ +--- +layout: default-layout +title: ECISegment Class - Dynamsoft Barcode Reader Module .NET Edition API Reference +description: This page shows ECISegment class definition of Dynamsoft Barcode Reader Module .NET Edition. +keywords: ECISegment, ECI, Extended Channel Interpretation, api reference +--- + +# ECISegment Class + +The `ECISegment` class represents the Extended Channel Interpretation (ECI) information within a barcode. Each ECI segment specifies the character encoding used for a portion of the decoded bytes. The charset names follow the IANA character set registry (e.g. "UTF-8", "ISO-8859-1"). + +**Remarks** + +Introduced in Dynamsoft Barcode Reader SDK version 11.4.1000 and Dynamsoft Capture Vision version 3.4.1000. + +## Definition + +*Namespace:* Dynamsoft.DBR + +```csharp +public class ECISegment +``` + +## Attributes + +| Attribute | Type | Description | +| --------- | ---- | ----------- | +| [`eciValue`](#ecivalue) | *int* | ECI assignment number as defined by ISO/IEC 15424. | +| [`charsetEncoding`](#charsetencoding) | *string* | Charset encoding name defined by IANA. | +| [`startIndex`](#startindex) | *int* | Start index of this ECI segment in the decoded barcode bytes. | +| [`length`](#length) | *int* | Length (in bytes) of this segment within the decoded barcode bytes. | + +### eciValue + +ECI assignment number as defined by ISO/IEC 15424. + +```csharp +public int eciValue +``` + +### charsetEncoding + +Charset encoding name defined by IANA (e.g. "UTF-8", "ISO-8859-1"). + +```csharp +public string charsetEncoding +``` + +### startIndex + +Start index of this ECI segment in the decoded barcode bytes. + +```csharp +public int startIndex +``` + +### length + +Length (in bytes) of this segment within the decoded barcode bytes. + +```csharp +public int length +``` + +## See Also + +- [`BarcodeResultItem`]({{ site.dbr_dotnet_api }}barcode-result-item.html) +- [`DecodedBarcodeElement`]({{ site.dbr_dotnet_api }}decoded-barcode-element.html) diff --git a/programming/dotnet/api-reference/index.md b/programming/dotnet/api-reference/index.md index 7f09d57..eaa6442 100644 --- a/programming/dotnet/api-reference/index.md +++ b/programming/dotnet/api-reference/index.md @@ -57,6 +57,7 @@ needAutoGenerateSidebar: false - [`DecodedBarcodesUnit`]({{ site.dbr_dotnet_api }}decoded-barcodes-unit.html) - [`DeformationResistedBarcodeImageUnit`]({{ site.dbr_dotnet_api }}deformation-resisted-barcode-image-unit.html) - [`DeformationResistedBarcode`]({{ site.dbr_dotnet_api }}deformation-resisted-barcode.html) +- [`ECISegment`]({{ site.dbr_dotnet_api }}eci-segment.html) - [`ExtendedBarcodeResult`]({{ site.dbr_dotnet_api }}extended-barcode-result.html) - [`LocalizedBarcodeElement`]({{ site.dbr_dotnet_api }}localized-barcode-element.html) - [`LocalizedBarcodesUnit`]({{ site.dbr_dotnet_api }}localized-barcodes-unit.html) diff --git a/programming/dotnet/release-notes/dotnet-11.md b/programming/dotnet/release-notes/dotnet-11.md index d6c90af..0514d84 100644 --- a/programming/dotnet/release-notes/dotnet-11.md +++ b/programming/dotnet/release-notes/dotnet-11.md @@ -8,6 +8,68 @@ needGenerateH3Content: false # Release Notes for .NET Edition - 11.x +## 11.4.1000 (02/05/2026) + +### Highlights + +#### AI-Powered Barcode Detection and Decoding + +- **PDF417 Localization Model** – Introduces the [`PDF417Localization`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/localization-modes.html#modelnamearray) neural network model for improved detection of PDF417 barcodes, especially under challenging conditions. + +- **Code39/ITF Decoding Model** – Adds the [`Code39ITFDecoder`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/deblur-modes.html#modelnamearray) model for enhanced decoding of Code 39 and ITF barcodes under blurred or low-resolution conditions. + +- **Deblur Models for 2D Barcodes** – Adds the [`DataMatrixQRCodeDeblur`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/deblur-modes.html#modelnamearray) and [`PDF417Deblur`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/deblur-modes.html#modelnamearray) models to provide more effective recovery from motion and focus blur for DataMatrix, QR Code, and PDF417 barcodes. + +#### ECI (Extended Channel Interpretation) Support + +- **ECI Information Return** – Adds support for retrieving Extended Channel Interpretation (ECI) data from barcodes. The new [`ECISegment`]({{ site.dbr_dotnet_api }}eci-segment.html) class, along with the `GetECISegmentsCount()` and `GetECISegment()` methods in the [`BarcodeResultItem`]({{ site.dbr_dotnet_api }}barcode-result-item.html#getecisegment) and [`DecodedBarcodeElement`]({{ site.dbr_dotnet_api }}decoded-barcode-element.html#getecisegment) classes, enables access to character encoding information embedded in barcodes. + +- **ECI-Based Text Interpretation** – Adds support for interpreting ECI segments during barcode decoding, improving compatibility with international character sets. + +#### Performance Improvements + +- **On-Demand Model Loading** – Implements lazy loading for AI models, reducing initialization time by loading models only when first needed. + +- **Smart Model Selection** – Models are now loaded based on configured barcode formats, minimizing memory usage by excluding unused models. + +- **Improved Confidence Scoring** – Enhances confidence score calculation for results from neural network models, providing more accurate quality indicators. + +- **DPM Barcode Optimization** – Improves recognition rate for Direct Part Marking (DPM) barcodes commonly used in industrial and manufacturing environments. + +### New + +- Added [`BarcodeZoneWidthToHeightRatioRangeArray`]({{ site.dcvb_parameters_reference }}barcode-format-specification/barcode-zone-width-to-height-ratio-range-array.html) parameter for filtering barcodes based on aspect ratio constraints. + +- Added [`SetResultCrossVerificationCriteria()`]({{ site.dcvb_dotnet_api }}utility/multi-frame-result-cross-filter.html#setresultcrossverificationcriteria) and [`GetResultCrossVerificationCriteria()`]({{ site.dcvb_dotnet_api }}utility/multi-frame-result-cross-filter.html#getresultcrossverificationcriteria) methods to `MultiFrameResultCrossFilter` for configurable multi-frame result verification. + +### Changed + +- `CaptureMultiPages` now returns results sorted by page number. + +- Barcode text encoding fallback changed from UTF-8 to ISO-8859-1 when no ECI information is present in the barcode. + +- Updated default value of `compensation` parameter in [`ImageProcessor.ConvertToBinaryLocal()`]({{ site.dcvb_dotnet_api }}utility/image-processor.html#converttobinarylocal) from 0 to 10. + +- [`ConvertToBinaryGlobal()`]({{ site.dcvb_dotnet_api }}utility/image-processor.html#converttobinaryglobal) and [`ConvertToBinaryLocal()`]({{ site.dcvb_dotnet_api }}utility/image-processor.html#converttobinarylocal) of `ImageProcessor` class now support color, binary and grayscale images as input. + +### Improved + +- Improved license binding stability on macOS devices. + +### Removed + +- Removed `DataMatrixModuleIsotropic` parameter – use [`BarcodeZoneWidthToHeightRatioRangeArray`]({{ site.dcvb_parameters_reference }}barcode-format-specification/barcode-zone-width-to-height-ratio-range-array.html) instead. + +- Removed `MinRatioOfBarcodeZoneWidthToHeight` parameter – use [`BarcodeZoneWidthToHeightRatioRangeArray`]({{ site.dcvb_parameters_reference }}barcode-format-specification/barcode-zone-width-to-height-ratio-range-array.html) instead. + +### Fixed + +- Fixed incorrect coordinate in barcode result when using neural network models with a specified region. + +- Fixed crash and hang issues that could occur in certain scenarios. + +- Fixed various minor bugs and improved overall stability. + ## 11.2.5000 (12/16/2025) This release includes security maintenance updates to ensure continued protection of the product. diff --git a/programming/dotnet/release-notes/index.md b/programming/dotnet/release-notes/index.md index ac2cf64..946ffe6 100644 --- a/programming/dotnet/release-notes/index.md +++ b/programming/dotnet/release-notes/index.md @@ -8,6 +8,7 @@ needAutoGenerateSidebar: false # Release Notes for .NET Edition +- [11.4.1000 (02/05/2026)]({{ site.dbr_dotnet_release_notes_v11 }}dotnet-11.html#1141000-02052026) - [11.2.5000 (12/16/2025)]({{ site.dbr_dotnet_release_notes_v11 }}dotnet-11.html#1125000-12162025) - [11.2.1000 (10/14/2025)]({{ site.dbr_dotnet_release_notes_v11 }}dotnet-11.html#1121000-10142025) - [11.0.6000 (08/06/2025)]({{ site.dbr_dotnet_release_notes_v11 }}dotnet-11.html#1106000-08062025) diff --git a/programming/java/api-reference/barcode-result-item.md b/programming/java/api-reference/barcode-result-item.md index 0870b0b..d247fbe 100644 --- a/programming/java/api-reference/barcode-result-item.md +++ b/programming/java/api-reference/barcode-result-item.md @@ -37,6 +37,7 @@ public class BarcodeResultItem extends CapturedResultItem | [`setLocation`](#setlocation) | Sets the location of the decoded barcode. | | [`setText`](#settext) | Sets the text of the decoded barcode. | | [`setBytes`](#setbytes) | Sets the bytes of the decoded barcode. | +| [`getECISegments`](#getecisegments) | Gets all the ECI segments in the barcode. | ## Method Details @@ -237,3 +238,23 @@ public void setBytes(byte[] bytes) `bytes`: The bytes of the decoded barcode. +### getECISegments + +Gets all the ECI segments in the barcode. + +```java +public ECISegment[] getECISegments() +``` + +**Return Value** + +Returns an array of [`ECISegment`]({{ site.dbr_java_api }}eci-segment.html) objects. Returns an empty array if no ECI information is present. + +**See Also** + +[ECISegment]({{ site.dbr_java_api }}eci-segment.html) + +**Remarks** + +Introduced in Dynamsoft Barcode Reader SDK version 11.4.1000 and Dynamsoft Capture Vision version 3.4.1000. + diff --git a/programming/java/api-reference/decoded-barcode-element.md b/programming/java/api-reference/decoded-barcode-element.md index d5eb6ad..64fcc1b 100644 --- a/programming/java/api-reference/decoded-barcode-element.md +++ b/programming/java/api-reference/decoded-barcode-element.md @@ -41,6 +41,7 @@ public class DecodedBarcodeElement extends RegionObjectElement | [`setBytes`](#setbytes)| Sets the raw bytes of the decoded barcode.| | [`setConfidence`](#setconfidence) | Sets the confidence score of the barcode recognition result. | | [`setLocation`](#setlocation) | Sets the location of the decoded barcode. | +| [`getECISegments`](#getecisegments) | Gets all the ECI segments in the barcode. | ### DecodedBarcodeElement @@ -305,3 +306,23 @@ public void setLocation(Quadrilateral location) throws BarcodeReaderException [BarcodeReaderException]({{ site.dbr_java_api }}barcode-reader-exception.html) +### getECISegments + +Gets all the ECI segments in the barcode. + +```java +public ECISegment[] getECISegments() +``` + +**Return Value** + +Returns an array of [`ECISegment`]({{ site.dbr_java_api }}eci-segment.html) objects. Returns an empty array if no ECI information is present. + +**See Also** + +[ECISegment]({{ site.dbr_java_api }}eci-segment.html) + +**Remarks** + +Introduced in Dynamsoft Barcode Reader SDK version 11.4.1000 and Dynamsoft Capture Vision version 3.4.1000. + diff --git a/programming/java/api-reference/eci-segment.md b/programming/java/api-reference/eci-segment.md new file mode 100644 index 0000000..3ea89a9 --- /dev/null +++ b/programming/java/api-reference/eci-segment.md @@ -0,0 +1,68 @@ +--- +layout: default-layout +title: ECISegment Class - Dynamsoft Barcode Reader Java Edition API Reference +description: This page shows ECISegment class definition of Dynamsoft Barcode Reader SDK Java Edition. +keywords: ECISegment, ECI, Extended Channel Interpretation, api reference +--- + +# ECISegment Class + +The `ECISegment` class represents the Extended Channel Interpretation (ECI) information within a barcode. Each ECI segment specifies the character encoding used for a portion of the decoded bytes. The charset names follow the IANA character set registry (e.g. "UTF-8", "ISO-8859-1"). + +**Remarks** + +Introduced in Dynamsoft Barcode Reader SDK version 11.4.1000 and Dynamsoft Capture Vision version 3.4.1000. + +## Definition + +*Package:* com.dynamsoft.dbr + +```java +public class ECISegment +``` + +## Attributes + +| Attribute | Type | Description | +| --------- | ---- | ----------- | +| [`eciValue`](#ecivalue) | *int* | ECI assignment number as defined by ISO/IEC 15424. | +| [`charsetEncoding`](#charsetencoding) | *String* | Charset encoding name defined by IANA. | +| [`startIndex`](#startindex) | *int* | Start index of this ECI segment in the decoded barcode bytes. | +| [`length`](#length) | *int* | Length (in bytes) of this segment within the decoded barcode bytes. | + +### eciValue + +ECI assignment number as defined by ISO/IEC 15424. + +```java +public int eciValue +``` + +### charsetEncoding + +Charset encoding name defined by IANA (e.g. "UTF-8", "ISO-8859-1"). + +```java +public String charsetEncoding +``` + +### startIndex + +Start index of this ECI segment in the decoded barcode bytes. + +```java +public int startIndex +``` + +### length + +Length (in bytes) of this segment within the decoded barcode bytes. + +```java +public int length +``` + +## See Also + +- [`BarcodeResultItem`]({{ site.dbr_java_api }}barcode-result-item.html) +- [`DecodedBarcodeElement`]({{ site.dbr_java_api }}decoded-barcode-element.html) diff --git a/programming/java/api-reference/index.md b/programming/java/api-reference/index.md index e426985..b5105e4 100644 --- a/programming/java/api-reference/index.md +++ b/programming/java/api-reference/index.md @@ -55,6 +55,7 @@ needAutoGenerateSidebar: false - [`DecodedBarcodesUnit`]({{ site.dbr_java_api }}decoded-barcodes-unit.html) - [`DeformationResistedBarcodeImageUnit`]({{ site.dbr_java_api }}deformation-resisted-barcode-image-unit.html) - [`DeformationResistedBarcode`]({{ site.dbr_java_api }}deformation-resisted-barcode.html) +- [`ECISegment`]({{ site.dbr_java_api }}eci-segment.html) - [`ExtendedBarcodeResult`]({{ site.dbr_java_api }}extended-barcode-result.html) - [`LocalizedBarcodeElement`]({{ site.dbr_java_api }}localized-barcode-element.html) - [`LocalizedBarcodesUnit`]({{ site.dbr_java_api }}localized-barcodes-unit.html) diff --git a/programming/java/release-notes/index.md b/programming/java/release-notes/index.md index 8924d67..761be8e 100644 --- a/programming/java/release-notes/index.md +++ b/programming/java/release-notes/index.md @@ -8,6 +8,7 @@ needAutoGenerateSidebar: false # Release Notes for Java Edition +- [11.4.1000 (02/05/2026)]({{ site.dbr_java_release_notes_v11 }}java-11.html#1141000-02052026) - [11.2.5000 (12/16/2025)]({{ site.dbr_java_release_notes_v11 }}java-11.html#1125000-12162025) - [11.2.1100 (10/28/2025)]({{ site.dbr_java_release_notes_v11 }}java-11.html#1121100-10282025) - [11.2.1000 (10/14/2025)]({{ site.dbr_java_release_notes_v11 }}java-11.html#1121000-10142025) diff --git a/programming/java/release-notes/java-11.md b/programming/java/release-notes/java-11.md index c4428dd..506cbce 100644 --- a/programming/java/release-notes/java-11.md +++ b/programming/java/release-notes/java-11.md @@ -8,6 +8,68 @@ needGenerateH3Content: false # Release Notes for Java Edition - 11.x +## 11.4.1000 (02/05/2026) + +### Highlights + +#### AI-Powered Barcode Detection and Decoding + +- **PDF417 Localization Model** – Introduces the [`PDF417Localization`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/localization-modes.html#modelnamearray) neural network model for improved detection of PDF417 barcodes, especially under challenging conditions. + +- **Code39/ITF Decoding Model** – Adds the [`Code39ITFDecoder`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/deblur-modes.html#modelnamearray) model for enhanced decoding of Code 39 and ITF barcodes under blurred or low-resolution conditions. + +- **Deblur Models for 2D Barcodes** – Adds the [`DataMatrixQRCodeDeblur`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/deblur-modes.html#modelnamearray) and [`PDF417Deblur`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/deblur-modes.html#modelnamearray) models to provide more effective recovery from motion and focus blur for DataMatrix, QR Code, and PDF417 barcodes. + +#### ECI (Extended Channel Interpretation) Support + +- **ECI Information Return** – Adds support for retrieving Extended Channel Interpretation (ECI) data from barcodes. The new [`ECISegment`]({{ site.dbr_java_api }}eci-segment.html) class, along with the `getECISegments()` method in the [`BarcodeResultItem`]({{ site.dbr_java_api }}barcode-result-item.html#getecisegments) and [`DecodedBarcodeElement`]({{ site.dbr_java_api }}decoded-barcode-element.html#getecisegments) classes, enables access to character encoding information embedded in barcodes. + +- **ECI-Based Text Interpretation** – Adds support for interpreting ECI segments during barcode decoding, improving compatibility with international character sets. + +#### Performance Improvements + +- **On-Demand Model Loading** – Implements lazy loading for AI models, reducing initialization time by loading models only when first needed. + +- **Smart Model Selection** – Models are now loaded based on configured barcode formats, minimizing memory usage by excluding unused models. + +- **Improved Confidence Scoring** – Enhances confidence score calculation for results from neural network models, providing more accurate quality indicators. + +- **DPM Barcode Optimization** – Improves recognition rate for Direct Part Marking (DPM) barcodes commonly used in industrial and manufacturing environments. + +### New + +- Added [`BarcodeZoneWidthToHeightRatioRangeArray`]({{ site.dcvb_parameters_reference }}barcode-format-specification/barcode-zone-width-to-height-ratio-range-array.html) parameter for filtering barcodes based on aspect ratio constraints. + +- Added [`setResultCrossVerificationCriteria()`]({{ site.dcvb_java_api }}utility/multi-frame-result-cross-filter.html#setresultcrossverificationcriteria) and [`getResultCrossVerificationCriteria()`]({{ site.dcvb_java_api }}utility/multi-frame-result-cross-filter.html#getresultcrossverificationcriteria) methods to `MultiFrameResultCrossFilter` for configurable multi-frame result verification. + +### Changed + +- `captureMultiPages` now returns results sorted by page number. + +- Barcode text encoding fallback changed from UTF-8 to ISO-8859-1 when no ECI information is present in the barcode. + +- Updated default value of `compensation` parameter in [`ImageProcessor.convertToBinaryLocal()`]({{ site.dcvb_java_api }}utility/image-processor.html#converttobinarylocal) from 0 to 10. + +- [`convertToBinaryGlobal()`]({{ site.dcvb_java_api }}utility/image-processor.html#converttobinaryglobal) and [`convertToBinaryLocal()`]({{ site.dcvb_java_api }}utility/image-processor.html#converttobinarylocal) of `ImageProcessor` class now support color, binary and grayscale images as input. + +### Improved + +- Improved license binding stability on macOS devices. + +### Removed + +- Removed `DataMatrixModuleIsotropic` parameter – use [`BarcodeZoneWidthToHeightRatioRangeArray`]({{ site.dcvb_parameters_reference }}barcode-format-specification/barcode-zone-width-to-height-ratio-range-array.html) instead. + +- Removed `MinRatioOfBarcodeZoneWidthToHeight` parameter – use [`BarcodeZoneWidthToHeightRatioRangeArray`]({{ site.dcvb_parameters_reference }}barcode-format-specification/barcode-zone-width-to-height-ratio-range-array.html) instead. + +### Fixed + +- Fixed incorrect coordinate in barcode result when using neural network models with a specified region. + +- Fixed crash and hang issues that could occur in certain scenarios. + +- Fixed various minor bugs and improved overall stability. + ## 11.2.5000 (12/16/2025) This release includes security maintenance updates to ensure continued protection of the product. diff --git a/programming/python/api-reference/aztec-details.md b/programming/python/api-reference/aztec-details.md index a8ce45a..aaf683f 100644 --- a/programming/python/api-reference/aztec-details.md +++ b/programming/python/api-reference/aztec-details.md @@ -11,7 +11,7 @@ The `AztecDetails` class represents a barcode in Aztec format. It inherits from ## Definition -*Module:* dynamsoft_barcode_reader +*Module:* dbr *Inheritance:* [BarcodeDetails]({{ site.dbr_python_api }}barcode-details.html) -> AztecDetails diff --git a/programming/python/api-reference/barcode-details.md b/programming/python/api-reference/barcode-details.md index c07110d..fa1538c 100644 --- a/programming/python/api-reference/barcode-details.md +++ b/programming/python/api-reference/barcode-details.md @@ -11,7 +11,7 @@ The `BarcodeDetails` class represents the details of a barcode. It is an abstrac ## Definition -*Module:* dynamsoft_barcode_reader +*Module:* dbr ```python class BarcodeDetails diff --git a/programming/python/api-reference/barcode-reader-module.md b/programming/python/api-reference/barcode-reader-module.md index 69965f6..3e6dad5 100644 --- a/programming/python/api-reference/barcode-reader-module.md +++ b/programming/python/api-reference/barcode-reader-module.md @@ -13,7 +13,7 @@ The `BarcodeReaderModule` class defines general functions in the barcode reader ## Definition -*Module:* dynamsoft_barcode_reader +*Module:* dbr ```python class BarcodeReaderModule diff --git a/programming/python/api-reference/barcode-result-item.md b/programming/python/api-reference/barcode-result-item.md index 7251873..16d29b0 100644 --- a/programming/python/api-reference/barcode-result-item.md +++ b/programming/python/api-reference/barcode-result-item.md @@ -11,7 +11,7 @@ The `BarcodeResultItem` class represents a barcode result item decoded by barcod ## Definition -*Module:* dynamsoft_barcode_reader +*Module:* dbr *Inheritance:* [CapturedResultItem]({{ site.dcvb_python_api }}core/basic-classes/captured-result-item.html) -> BarcodeResultItem @@ -34,6 +34,7 @@ class BarcodeResultItem(dynamsoft_core.CapturedResultItem) | [`get_details`](#get_details) | Gets the details of the decoded barcode result. | | [`is_dpm`](#is_dpm) | Gets whether the decoded barcode is a DPM code. | | [`is_mirrored`](#is_mirrored) | Gets whether the decoded barcode is a mirrored barcode. | +| [`get_eci_segments`](#get_eci_segments) | Gets all the ECI segments in the barcode. | ### get_format @@ -188,3 +189,23 @@ def is_mirrored(self) -> bool: Returns whether the decoded barcode is mirrored. +### get_eci_segments + +Gets all the ECI segments in the barcode. + +```python +def get_eci_segments(self) -> List[ECISegment]: +``` + +**Return Value** + +Returns a list of [`ECISegment`]({{ site.dbr_python_api }}eci-segment.html) objects. Returns an empty list if no ECI information is present. + +**See Also** + +[ECISegment]({{ site.dbr_python_api }}eci-segment.html) + +**Remarks** + +Introduced in Dynamsoft Barcode Reader SDK version 11.4.1000 and Dynamsoft Capture Vision version 3.4.1000. + diff --git a/programming/python/api-reference/candidate-barcode-zone.md b/programming/python/api-reference/candidate-barcode-zone.md index 21e0e83..7943594 100644 --- a/programming/python/api-reference/candidate-barcode-zone.md +++ b/programming/python/api-reference/candidate-barcode-zone.md @@ -10,7 +10,7 @@ The `CandidateBarcodeZone` class represents a candidate zone for barcode detecti ## Definition -*Module:* dynamsoft_barcode_readers +*Module:* dbr ```python class CandidateBarcodeZone diff --git a/programming/python/api-reference/candidate-barcode-zones-unit.md b/programming/python/api-reference/candidate-barcode-zones-unit.md index 427ace7..dbb5926 100644 --- a/programming/python/api-reference/candidate-barcode-zones-unit.md +++ b/programming/python/api-reference/candidate-barcode-zones-unit.md @@ -10,7 +10,7 @@ The `CandidateBarcodeZonesUnit` class represents a unit that contains candidate ## Definition -*Module:* dynamsoft_barcode_readers +*Module:* dbr *Inheritance:* [IntermediateResultUnit]({{ site.dcvb_python_api }}core/intermediate-results/intermediate-result-unit.html) -> CandidateBarcodeZonesUnit diff --git a/programming/python/api-reference/complemented-barcode-image-unit.md b/programming/python/api-reference/complemented-barcode-image-unit.md index 3ff0aba..8b950e8 100644 --- a/programming/python/api-reference/complemented-barcode-image-unit.md +++ b/programming/python/api-reference/complemented-barcode-image-unit.md @@ -9,7 +9,7 @@ The `ComplementedBarcodeImageUnit` class represents a unit that contains complem ## Definition -*Module:* dynamsoft_barcode_readers +*Module:* dbr *Inheritance:* [IntermediateResultUnit]({{ site.dcvb_python_api }}core/intermediate-results/intermediate-result-unit.html) -> ComplementedBarcodeImageUnit diff --git a/programming/python/api-reference/datamatrix-details.md b/programming/python/api-reference/datamatrix-details.md index 61a1410..2c18213 100644 --- a/programming/python/api-reference/datamatrix-details.md +++ b/programming/python/api-reference/datamatrix-details.md @@ -10,7 +10,7 @@ The `DataMatrixDetails` class represents the details of a DataMatrix barcode. It ## Definition -*Module:* dynamsoft_barcode_reader +*Module:* dbr *Inheritance:* [BarcodeDetails]({{ site.dbr_python_api }}barcode-details.html) -> DataMatrixDetails diff --git a/programming/python/api-reference/decoded-barcode-element.md b/programming/python/api-reference/decoded-barcode-element.md index 54894b1..8ba9d4b 100644 --- a/programming/python/api-reference/decoded-barcode-element.md +++ b/programming/python/api-reference/decoded-barcode-element.md @@ -10,7 +10,7 @@ The `DecodedBarcodeElement` class represents a decoded barcode element. It inher ## Definition -*Module:* dynamsoft_barcode_readers +*Module:* dbr *Inheritance:* [RegionObjectElement]({{ site.dcvb_python_api }}core/intermediate-results/region-object-element.html) -> DecodedBarcodeElement @@ -39,6 +39,7 @@ class DecodedBarcodeElement(RegionObjectElement) | [`set_text`](#set_text) | Sets the text of the decoded barcode. | | [`set_bytes`](#set_bytes)| Sets the raw bytes of the decoded barcode.| | [`set_confidence`](#set_confidence) | Sets the confidence score of the barcode recognition result. | +| [`get_eci_segments`](#get_eci_segments) | Gets all the ECI segments in the barcode. | ### \_\_init\_\_ @@ -265,3 +266,23 @@ def set_confidence(self, confidence: int) -> None: `confidence` The confidence of the barcode. +### get_eci_segments + +Gets all the ECI segments in the barcode. + +```python +def get_eci_segments(self) -> List[ECISegment]: +``` + +**Return Value** + +Returns a list of [`ECISegment`]({{ site.dbr_python_api }}eci-segment.html) objects. Returns an empty list if no ECI information is present. + +**See Also** + +[ECISegment]({{ site.dbr_python_api }}eci-segment.html) + +**Remarks** + +Introduced in Dynamsoft Barcode Reader SDK version 11.4.1000 and Dynamsoft Capture Vision version 3.4.1000. + diff --git a/programming/python/api-reference/decoded-barcodes-result.md b/programming/python/api-reference/decoded-barcodes-result.md index 96ebf92..bb8e7e9 100644 --- a/programming/python/api-reference/decoded-barcodes-result.md +++ b/programming/python/api-reference/decoded-barcodes-result.md @@ -10,7 +10,7 @@ The `DecodedBarcodesResult` class represents the result of a barcode reading pro ## Definition -*Module:* dynamsoft_barcode_reader +*Module:* dbr *Inheritance:* [CapturedResultBase]({{ site.dcvb_python_api }}core/basic-classes/captured-result-base.html) -> DecodedBarcodesResult diff --git a/programming/python/api-reference/decoded-barcodes-unit.md b/programming/python/api-reference/decoded-barcodes-unit.md index 3499080..9d24286 100644 --- a/programming/python/api-reference/decoded-barcodes-unit.md +++ b/programming/python/api-reference/decoded-barcodes-unit.md @@ -10,7 +10,7 @@ The `DecodedBarcodesUnit` class represents a unit that contains decoded barcode ## Definition -*Module:* dynamsoft_barcode_readers +*Module:* dbr *Inheritance:* [IntermediateResultUnit]({{ site.dcvb_python_api }}core/intermediate-results/intermediate-result-unit.html) -> DecodedBarcodesUnit diff --git a/programming/python/api-reference/deformation-resisted-barcode-image-unit.md b/programming/python/api-reference/deformation-resisted-barcode-image-unit.md index 48ea56b..83fb9c1 100644 --- a/programming/python/api-reference/deformation-resisted-barcode-image-unit.md +++ b/programming/python/api-reference/deformation-resisted-barcode-image-unit.md @@ -10,7 +10,7 @@ The `DeformationResistedBarcodeImageUnit` class represents a unit that contains ## Definition -*Module:* dynamsoft_barcode_readers +*Module:* dbr *Inheritance:* [IntermediateResultUnit]({{ site.dcvb_python_api }}core/intermediate-results/intermediate-result-unit.html) -> DeformationResistedBarcodeImageUnit diff --git a/programming/python/api-reference/deformation-resisted-barcode.md b/programming/python/api-reference/deformation-resisted-barcode.md index 14bb912..ae065d2 100644 --- a/programming/python/api-reference/deformation-resisted-barcode.md +++ b/programming/python/api-reference/deformation-resisted-barcode.md @@ -10,7 +10,7 @@ The `DeformationResistedBarcode` class represents a deformation resisted barcode ## Definition -*Module:* dynamsoft_barcode_readers +*Module:* dbr ```python class DeformationResistedBarcode diff --git a/programming/python/api-reference/eci-segment.md b/programming/python/api-reference/eci-segment.md new file mode 100644 index 0000000..22374a1 --- /dev/null +++ b/programming/python/api-reference/eci-segment.md @@ -0,0 +1,68 @@ +--- +layout: default-layout +title: ECISegment Class - Dynamsoft Barcode Reader Module Python Edition API Reference +description: This page shows ECISegment class definition of Dynamsoft Barcode Reader Module Python Edition. +keywords: ECISegment, ECI, Extended Channel Interpretation, api reference +--- + +# ECISegment Class + +The `ECISegment` class represents the Extended Channel Interpretation (ECI) information within a barcode. Each ECI segment specifies the character encoding used for a portion of the decoded bytes. The charset names follow the IANA character set registry (e.g. "UTF-8", "ISO-8859-1"). + +**Remarks** + +Introduced in Dynamsoft Barcode Reader SDK version 11.4.1000 and Dynamsoft Capture Vision version 3.4.1000. + +## Definition + +*Module:* dbr + +```python +class ECISegment() +``` + +## Properties + +| Property | Type | Description | +| --------- | ---- | ----------- | +| [`eci_value`](#eci_value) | *int* | ECI assignment number as defined by ISO/IEC 15424. | +| [`charset_encoding`](#charset_encoding) | *str* | Charset encoding name defined by IANA. | +| [`start_index`](#start_index) | *int* | Start index of this ECI segment in the decoded barcode bytes. | +| [`length`](#length) | *int* | Length (in bytes) of this segment within the decoded barcode bytes. | + +### eci_value + +ECI assignment number as defined by ISO/IEC 15424. + +```python +eci_value: int +``` + +### charset_encoding + +Charset encoding name defined by IANA (e.g. "UTF-8", "ISO-8859-1"). + +```python +charset_encoding: str +``` + +### start_index + +Start index of this ECI segment in the decoded barcode bytes. + +```python +start_index: int +``` + +### length + +Length (in bytes) of this segment within the decoded barcode bytes. + +```python +length: int +``` + +## See Also + +- [`BarcodeResultItem`]({{ site.dbr_python_api }}barcode-result-item.html) +- [`DecodedBarcodeElement`]({{ site.dbr_python_api }}decoded-barcode-element.html) diff --git a/programming/python/api-reference/extended-barcode-result.md b/programming/python/api-reference/extended-barcode-result.md index 7f655d5..2936774 100644 --- a/programming/python/api-reference/extended-barcode-result.md +++ b/programming/python/api-reference/extended-barcode-result.md @@ -10,7 +10,7 @@ The `ExtendedBarcodeResult` class represents an extended barcode result in a dec ## Definition -*Module:* dynamsoft_barcode_readers +*Module:* dbr *Inheritance:* [DecodedBarcodeElement]({{ site.dbr_python_api }}decoded-barcode-element.html) -> ExtendedBarcodeResult diff --git a/programming/python/api-reference/index.md b/programming/python/api-reference/index.md index 6ac61a9..724768b 100644 --- a/programming/python/api-reference/index.md +++ b/programming/python/api-reference/index.md @@ -55,6 +55,7 @@ needAutoGenerateSidebar: false - [`DecodedBarcodesUnit`]({{ site.dbr_python_api }}decoded-barcodes-unit.html) - [`DeformationResistedBarcodeImageUnit`]({{ site.dbr_python_api }}deformation-resisted-barcode-image-unit.html) - [`DeformationResistedBarcode`]({{ site.dbr_python_api }}deformation-resisted-barcode.html) +- [`ECISegment`]({{ site.dbr_python_api }}eci-segment.html) - [`ExtendedBarcodeResult`]({{ site.dbr_python_api }}extended-barcode-result.html) - [`LocalizedBarcodeElement`]({{ site.dbr_python_api }}localized-barcode-element.html) - [`LocalizedBarcodesUnit`]({{ site.dbr_python_api }}localized-barcodes-unit.html) diff --git a/programming/python/api-reference/localized-barcode-element.md b/programming/python/api-reference/localized-barcode-element.md index a40d57d..ec94853 100644 --- a/programming/python/api-reference/localized-barcode-element.md +++ b/programming/python/api-reference/localized-barcode-element.md @@ -10,7 +10,7 @@ The `LocalizedBarcodeElement` class represents a localized barcode element detec ## Definition -*Module:* dynamsoft_barcode_reader +*Module:* dbr *Inheritance:* [RegionObjectElement]({{ site.dcvb_python_api }}core/intermediate-results/region-object-element.html) -> LocalizedBarcodeElement diff --git a/programming/python/api-reference/localized-barcodes-unit.md b/programming/python/api-reference/localized-barcodes-unit.md index f2c15a4..a2a29cd 100644 --- a/programming/python/api-reference/localized-barcodes-unit.md +++ b/programming/python/api-reference/localized-barcodes-unit.md @@ -10,7 +10,7 @@ The `LocalizedBarcodesUnit` class represents a unit that contains localized barc ## Definition -*Module:* dynamsoft_barcode_readers +*Module:* dbr *Inheritance:* [IntermediateResultUnit]({{ site.dcvb_python_api }}core/intermediate-results/intermediate-result-unit.html) -> LocalizedBarcodesUnit diff --git a/programming/python/api-reference/oned-code-details.md b/programming/python/api-reference/oned-code-details.md index 6e575fc..0394eeb 100644 --- a/programming/python/api-reference/oned-code-details.md +++ b/programming/python/api-reference/oned-code-details.md @@ -10,7 +10,7 @@ The `OneDCodeDetails` class represents detailed information about a one-dimensio ## Definition -*Module:* dynamsoft_barcode_reader +*Module:* dbr *Inheritance:* [BarcodeDetails]({{ site.dbr_python_api }}barcode-details.html) -> OneDCodeDetails diff --git a/programming/python/api-reference/pdf417-details.md b/programming/python/api-reference/pdf417-details.md index 87cfd0d..bf73e61 100644 --- a/programming/python/api-reference/pdf417-details.md +++ b/programming/python/api-reference/pdf417-details.md @@ -10,7 +10,7 @@ The `PDF417Details` class represents a barcode in PDF417 format. It inherits fro ## Definition -*Module:* dynamsoft_barcode_reader +*Module:* dbr *Inheritance:* [BarcodeDetails]({{ site.dbr_python_api }}barcode-details.html) -> PDF417Details diff --git a/programming/python/api-reference/qr-code-details.md b/programming/python/api-reference/qr-code-details.md index 5cc7bc4..6540bdf 100644 --- a/programming/python/api-reference/qr-code-details.md +++ b/programming/python/api-reference/qr-code-details.md @@ -10,7 +10,7 @@ The `QRCodeDetails` class represents the details of a QR Code. It is derived fro ## Definition -*Module:* dynamsoft_barcode_reader +*Module:* dbr *Inheritance:* [BarcodeDetails]({{ site.dbr_python_api }}barcode-details.html) -> QRCodeDetails diff --git a/programming/python/api-reference/scaled-barcode-image-unit.md b/programming/python/api-reference/scaled-barcode-image-unit.md index 728ded2..43620a9 100644 --- a/programming/python/api-reference/scaled-barcode-image-unit.md +++ b/programming/python/api-reference/scaled-barcode-image-unit.md @@ -10,7 +10,7 @@ The `ScaledBarcodeImageUnit` class represents a unit that contains scaled up bar ## Definition -*Module:* dynamsoft_barcode_readers +*Module:* dbr *Inheritance:* [IntermediateResultUnit]({{ site.dcvb_python_api }}core/intermediate-results/intermediate-result-unit.html) -> ScaledBarcodeImageUnit diff --git a/programming/python/api-reference/scaled-up-barcode-image-unit.md b/programming/python/api-reference/scaled-up-barcode-image-unit.md index 9a80325..b9bfd4f 100644 --- a/programming/python/api-reference/scaled-up-barcode-image-unit.md +++ b/programming/python/api-reference/scaled-up-barcode-image-unit.md @@ -10,7 +10,7 @@ The `ScaledUpBarcodeImageUnit` class represents a unit that contains scaled up b ## Definition -*Module:* dynamsoft_barcode_readers +*Module:* dbr *Inheritance:* [IntermediateResultUnit]({{ site.dcvb_python_api }}core/intermediate-results/intermediate-result-unit.html) -> ScaledUpBarcodeImageUnit diff --git a/programming/python/api-reference/simplified-barcode-reader-settings.md b/programming/python/api-reference/simplified-barcode-reader-settings.md index ec68a11..a03c156 100644 --- a/programming/python/api-reference/simplified-barcode-reader-settings.md +++ b/programming/python/api-reference/simplified-barcode-reader-settings.md @@ -13,7 +13,7 @@ The `SimplifiedBarcodeReaderSettings` class contains settings for barcode decodi ## Definition -*Module:* dynamsoft_barcode_reader +*Module:* dbr ```python class SimplifiedBarcodeReaderSettings diff --git a/programming/python/release-notes/index.md b/programming/python/release-notes/index.md index 906ca24..a88ca26 100644 --- a/programming/python/release-notes/index.md +++ b/programming/python/release-notes/index.md @@ -8,6 +8,7 @@ needAutoGenerateSidebar: false # Release Notes for Python Edition +- [11.4.1000 (02/05/2026)]({{ site.dbr_python_release_notes_v11 }}python-11.html#1141000-02052026) - [11.2.5000 (12/16/2025)]({{ site.dbr_python_release_notes_v11 }}python-11.html#1125000-12162025) - [11.2.1000 (10/14/2025)]({{ site.dbr_python_release_notes_v11 }}python-11.html#1121000-10142025) - [11.0.6000 (08/06/2025)]({{ site.dbr_python_release_notes_v11 }}python-11.html#1106000-08062025) diff --git a/programming/python/release-notes/python-11.md b/programming/python/release-notes/python-11.md index d29e9e3..b87d5ff 100644 --- a/programming/python/release-notes/python-11.md +++ b/programming/python/release-notes/python-11.md @@ -8,6 +8,70 @@ needGenerateH3Content: false # Release Notes for Python Edition - 11.x +## 11.4.1000 (02/05/2026) + +### Highlights + +#### AI-Powered Barcode Detection and Decoding + +- **PDF417 Localization Model** – Introduces the [`PDF417Localization`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/localization-modes.html#modelnamearray) neural network model for improved detection of PDF417 barcodes, especially under challenging conditions. + +- **Code39/ITF Decoding Model** – Adds the [`Code39ITFDecoder`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/deblur-modes.html#modelnamearray) model for enhanced decoding of Code 39 and ITF barcodes under blurred or low-resolution conditions. + +- **Deblur Models for 2D Barcodes** – Adds the [`DataMatrixQRCodeDeblur`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/deblur-modes.html#modelnamearray) and [`PDF417Deblur`]({{ site.dcvb_parameters_reference }}barcode-reader-task-settings/deblur-modes.html#modelnamearray) models to provide more effective recovery from motion and focus blur for DataMatrix, QR Code, and PDF417 barcodes. + +#### ECI (Extended Channel Interpretation) Support + +- **ECI Information Return** – Adds support for retrieving Extended Channel Interpretation (ECI) data from barcodes. The new [`ECISegment`]({{ site.dbr_python_api }}eci-segment.html) class, along with the `get_eci_segments()` method in the [`BarcodeResultItem`]({{ site.dbr_python_api }}barcode-result-item.html#get_eci_segments) and [`DecodedBarcodeElement`]({{ site.dbr_python_api }}decoded-barcode-element.html#get_eci_segments) classes, enables access to character encoding information embedded in barcodes. + +- **ECI-Based Text Interpretation** – Adds support for interpreting ECI segments during barcode decoding, improving compatibility with international character sets. + +#### Performance Improvements + +- **On-Demand Model Loading** – Implements lazy loading for AI models, reducing initialization time by loading models only when first needed. + +- **Smart Model Selection** – Models are now loaded based on configured barcode formats, minimizing memory usage by excluding unused models. + +- **Improved Confidence Scoring** – Enhances confidence score calculation for results from neural network models, providing more accurate quality indicators. + +- **DPM Barcode Optimization** – Improves recognition rate for Direct Part Marking (DPM) barcodes commonly used in industrial and manufacturing environments. + +### New + +- Added support for Python 3.14. + +- Added [`BarcodeZoneWidthToHeightRatioRangeArray`]({{ site.dcvb_parameters_reference }}barcode-format-specification/barcode-zone-width-to-height-ratio-range-array.html) parameter for filtering barcodes based on aspect ratio constraints. + +- Added [`set_result_cross_verification_criteria()`]({{ site.dcvb_python_api }}utility/multi-frame-result-cross-filter.html#set_result_cross_verification_criteria) and [`get_result_cross_verification_criteria()`]({{ site.dcvb_python_api }}utility/multi-frame-result-cross-filter.html#get_result_cross_verification_criteria) methods to `MultiFrameResultCrossFilter` for configurable multi-frame result verification. + +### Changed + +- `capture_multi_pages` now returns results sorted by page number. + +- Barcode text encoding fallback changed from UTF-8 to ISO-8859-1 when no ECI information is present in the barcode. + +- Updated default value of `compensation` parameter in [`ImageProcessor.convert_to_binary_local()`]({{ site.dcvb_python_api }}utility/image-processor.html#convert_to_binary_local) from 0 to 10. + +- [`convert_to_binary_global()`]({{ site.dcvb_python_api }}utility/image-processor.html#convert_to_binary_global) and [`convert_to_binary_local()`]({{ site.dcvb_python_api }}utility/image-processor.html#convert_to_binary_local) of `ImageProcessor` class now support color, binary and grayscale images as input. + +### Improved + +- Improved license binding stability on macOS devices. + +### Removed + +- Removed `DataMatrixModuleIsotropic` parameter – use [`BarcodeZoneWidthToHeightRatioRangeArray`]({{ site.dcvb_parameters_reference }}barcode-format-specification/barcode-zone-width-to-height-ratio-range-array.html) instead. + +- Removed `MinRatioOfBarcodeZoneWidthToHeight` parameter – use [`BarcodeZoneWidthToHeightRatioRangeArray`]({{ site.dcvb_parameters_reference }}barcode-format-specification/barcode-zone-width-to-height-ratio-range-array.html) instead. + +### Fixed + +- Fixed incorrect coordinate in barcode result when using neural network models with a specified region. + +- Fixed crash and hang issues that could occur in certain scenarios. + +- Fixed various minor bugs and improved overall stability. + ## 11.2.5000 (12/16/2025) This release includes security maintenance updates to ensure continued protection of the product.