diff --git a/_includes/sidelist-programming/programming-javascript.html b/_includes/sidelist-programming/programming-javascript.html index e2adfaed..1bd1de63 100644 --- a/_includes/sidelist-programming/programming-javascript.html +++ b/_includes/sidelist-programming/programming-javascript.html @@ -920,18 +920,89 @@ > @@ -1334,6 +1405,13 @@ >ModuleName +
  • + MeasureUnit +
  • AllModuleDeviation
  • AustralianPostEncodingTable
    • +
  • AutoDetectColorInversion
  • BarcodeAngleRangeArray
  • BarcodeBytesLengthRangeArray
  • BarcodeHeightRangeArray
    • diff --git a/programming/javascript/release-notes/index.md b/programming/javascript/release-notes/index.md index aff9bd29..6ce6c3f3 100644 --- a/programming/javascript/release-notes/index.md +++ b/programming/javascript/release-notes/index.md @@ -9,6 +9,7 @@ breadcrumbText: Release Notes # DBR JavaScript SDK - Release Notes +- [11.6.2000 (08/13/2026)](js-11.html#1162000-08132026) - [11.4.3000 (07/02/2026)](js-11.html#1143000-07022026) - [11.4.2001 (04/24/2026)](js-11.html#1142001-04242026) - [11.4.2000 (04/21/2026)](js-11.html#1142000-04212026) diff --git a/programming/javascript/release-notes/js-11.md b/programming/javascript/release-notes/js-11.md index cf44fe8b..1df28946 100644 --- a/programming/javascript/release-notes/js-11.md +++ b/programming/javascript/release-notes/js-11.md @@ -10,6 +10,53 @@ noTitleIndex: true # Release Notes for Dynamsoft Barcode Reader JavaScript SDK +## 11.6.2000 (08/13/2026) + +### Highlights + +#### DataMatrix Color Inversion Detection + +- **Handle normal and inverted DataMatrix more efficiently** - Added [`AutoDetectColorInversion`]({{ site.dcvb_parameters }}barcode-format-specification/auto-detect-color-inversion.html) to automatically handle both normal and inverted DataMatrix barcodes. Instead of processing the whole image twice, the SDK applies dual-polarity handling only to localized DataMatrix regions, which makes processing faster in dual-polarity scenarios. + +#### Barcode Layout Analysis + +- **Decode dense grid barcodes more completely** - Added [`LayoutAnalyzer`]({{ site.dcvb_js_api }}utility/layout-analyzer.html) to organize barcode locations into logical line or matrix layouts and infer unrecognized barcode regions when gaps exist, enabling workflows such as fast first-pass decoding, missing-region inference, and targeted second-pass decoding on dense N*M barcode layouts. + +#### Cross-Version License Support + +- **Use a single license across SDK versions** - Full License 1.0 keys (starting with "f") that are non-perpetual are no longer version-checked, so the same key can be used across SDK versions without reactivation. + +### New + +- Added support for Micro PDF417-specific decoding mode. + +- Added [`AutoDetectColorInversion`]({{ site.dcvb_parameters }}barcode-format-specification/auto-detect-color-inversion.html) parameter for `BarcodeFormatSpecification` to support automatic color-inversion detection for DataMatrix barcodes. + +- Added [`LayoutAnalyzer`]({{ site.dcvb_js_api }}utility/layout-analyzer.html) class with [`analyze()`]({{ site.dcvb_js_api }}utility/layout-analyzer.html#analyze) static method for quadrilateral layout analysis. + +- Added [`LayoutPattern`]({{ site.dcvb_js_api }}utility/enum-layout-pattern.html) enumeration with values `LP_UNKNOWN`, `LP_LINES`, and `LP_MATRIX`. + +- Added [`LayoutElementSource`]({{ site.dcvb_js_api }}utility/enum-layout-element-source.html) enumeration with values `LES_NONE`, `LES_INPUT`, and `LES_INFERRED`. + +- Added [`MeasureUnit`]({{ site.dcvb_js_api }}core/enum-measure-unit.html) enumeration with values `MU_PIXEL` and `MU_PERCENTAGE`. + +- Added [`LayoutAxis`]({{ site.dcvb_js_api }}utility/layout-axis.html), [`LayoutAnalysisParameter`]({{ site.dcvb_js_api }}utility/layout-analysis-parameter.html), [`LayoutElement`]({{ site.dcvb_js_api }}utility/layout-element.html), and [`LayoutAnalysisResult`]({{ site.dcvb_js_api }}utility/layout-analysis-result.html) for layout analysis configuration and results. + +- Added a new `GridBarcodeScanner` sample (with `sample_grid.png`) to demonstrate how to use [`LayoutAnalyzer`]({{ site.dcvb_js_api }}utility/layout-analyzer.html) for barcode grid layout detection and logical row/column mapping. + +### Changed + +- [`MaxParallelTasks`]({{ site.dcvb_parameters }}capture-vision-template/max-parallel-tasks.html) now controls the total number of Work-level threads in the CVR thread pool. For DBR tasks, each Localization Work and Decoding Work occupies one thread slot. DLR and DDN tasks continue to occupy one thread per task. + +- [`set_device_friendly_name()`]({{ site.dcvb_js_api }}license/license-manager.html#set_device_friendly_name) now enforces parameter constraints: maximum 64 characters, allowed characters are letters (a-z, A-Z), digits (0-9), hyphen (-), underscore (_), and period (.), and must start and end with a letter or digit. Returns [`EC_PARAMETER_VALUE_INVALID`]({{ site.dcvb_js_api }}core/enum-error-code.html) if constraints are not met. + + +### Fixed + +- Fixed an issue in GS1-Databar AI `17` (YYMMDD) results where the month field could be missing a leading zero. +- Fixed an issue where minImageCaptureInterval was not reset correctly when resetSettings() was called. +- Fixed several known crash issues. + ## 11.4.3000 (07/02/2026) Updated third-party libraries to incorporate the latest security fixes. diff --git a/programming/javascript/user-guide/index.md b/programming/javascript/user-guide/index.md index 12da73f0..e24f2fc9 100644 --- a/programming/javascript/user-guide/index.md +++ b/programming/javascript/user-guide/index.md @@ -48,7 +48,7 @@ The complete code of the "Hello World" example is shown below
    - + + ``` - UNPKG ```html - + ``` @@ -190,9 +190,9 @@ The simplest way to include the SDK is to use either the [jsDelivr](https://jsde - In frameworks like React, Vue and Angular, you may want to add the package as a dependency. ```sh - npm i dynamsoft-barcode-reader-bundle@11.4.3000 -E + npm i dynamsoft-barcode-reader-bundle@11.6.2000 -E # or - yarn add dynamsoft-barcode-reader-bundle@11.4.3000 -E + yarn add dynamsoft-barcode-reader-bundle@11.6.2000 -E ``` NOTE that in frameworks, you need to [specify the location of the engine files](#2-optional-specify-the-location-of-the-engine-files). @@ -205,14 +205,14 @@ Besides using the public CDN, you can also download the SDK and host its files o - From the website - [Download Dynamsoft Barcode Reader JavaScript Package](https://www.dynamsoft.com/barcode-reader/downloads/?ver=11.4.30&utm_source=guide&product=dbr&package=js) + [Download Dynamsoft Barcode Reader JavaScript Package](https://www.dynamsoft.com/barcode-reader/downloads/?ver=11.6.20&utm_source=guide&product=dbr&package=js) The resources are located at the path `dynamsoft-barcode-reader-js-{version-number}/dist/`. - From npm ```sh - npm i dynamsoft-barcode-reader-bundle@11.4.3000 -E + npm i dynamsoft-barcode-reader-bundle@11.6.2000 -E ``` The resources are located at the path `node_modules/`, without `@`. You must copy "dynamsoft-xxx" packages elsewhere and add `@`. The `` can be obtained from `package.json` of each package. Another thing to do is to [specify the engineResourcePaths](#2-optional-specify-the-location-of-the-engine-files) so that the SDK can correctly locate the resources. @@ -221,7 +221,7 @@ Besides using the public CDN, you can also download the SDK and host its files o You can typically include SDK like this: ```html - + ```
    @@ -253,23 +253,23 @@ To enable the SDK's functionality, you must provide a valid license. Utilize the Dynamsoft.License.LicenseManager.initLicense("DLS2eyJvcmdhbml6YXRpb25JRCI6IjIwMDAwMSJ9"); ``` -As previously stated, the key "DLS2eyJvcmdhbml6YXRpb25JRCI6IjIwMDAwMSJ9" serves as a test license valid for 24 hours, applicable to any newly authorized browser. To test the SDK further, you can request a 30-day free trial license via the Request a Trial License link. +As previously stated, the key "DLS2eyJvcmdhbml6YXRpb25JRCI6IjIwMDAwMSJ9" serves as a test license valid for 24 hours, applicable to any newly authorized browser. To test the SDK further, you can request a 30-day free trial license via the Request a Trial License link. > Upon registering a Dynamsoft account and obtaining the SDK package from the official website, Dynamsoft will automatically create a 30-day free trial license and embed the corresponding license key into all the provided SDK samples. #### 2. [Optional] Specify the location of the "engine" files -This step is generally necessary when utilizing frameworks such as Angular, React, Vue, or when managing the hosting of resource files yourself. +This step is optional and is only necessary if you need to specify a custom location for the engine files, such as when hosting these resources yourself or when your project's build setup does not automatically resolve them from the default location. The purpose is to tell the SDK where to find the engine files (\*.worker.js, \*.wasm.js and \*.wasm, etc.). ```ts -// in framework +// In an ES Module import { CoreModule } from "dynamsoft-barcode-reader-bundle"; CoreModule.engineResourcePaths.rootDirectory = "https://cdn.jsdelivr.net/npm/"; ``` ```js -// in pure js +// Using the global namespace Dynamsoft.Core.CoreModule.engineResourcePaths.rootDirectory = "https://cdn.jsdelivr.net/npm/"; ``` This code uses the jsDelivr CDN as an example, feel free to change it to your own location. @@ -540,7 +540,7 @@ await cvRouter.startCapturing("ReadSingleBarcode"); The preset templates have many more settings that can be customized to suit your use case best. If you [download the SDK from Dynamsoft website](https://www.dynamsoft.com/barcode-reader/downloads/1000003-confirmation/), you can find the templates under -* "/dynamsoft-barcode-reader-js-11.4.3000/dist/templates/" +* "/dynamsoft-barcode-reader-js-11.6.2000/dist/templates/" Upon completing the template editing, you can invoke the `initSettings` method and provide it with the template path as an argument. @@ -642,7 +642,7 @@ The UI is part of the auxiliary SDK "Dynamsoft Camera Enhancer", read more on ho ### API Reference You can check out the detailed documentation about the APIs of the SDK at -[https://www.dynamsoft.com/barcode-reader/docs/web/programming/javascript/api-reference/?ver=11.4.3000](https://www.dynamsoft.com/barcode-reader/docs/web/programming/javascript/api-reference/?ver=11.4.3000). +[https://www.dynamsoft.com/barcode-reader/docs/web/programming/javascript/api-reference/?ver=11.6.2000](https://www.dynamsoft.com/barcode-reader/docs/web/programming/javascript/api-reference/?ver=11.6.2000).