Release Notes for Dynamsoft Barcode Reader JavaScript SDK

10.4.2001 (10/17/2024)

New

• Added support for decoding add-on codes (also known as Extension Codes) for UPC-A, UPC-E, EAN-8 and EAN-13 codes.

  

• Added new properties to the QRCodeDetails interface including:

  • dataMaskPattern
  • codewords

Improved

• Improved the read rate and processing speed for the following barcode formats:
  • EAN-13
  • DotCode

Changed

• Updated the enumeration value of EnumBarcodeFormat.BF_ALL to 0xFFFFFFFEFFFFFFFF, which no longer includes non-standard barcodes.

Fixed

• Fixed a bug that could prevent the reading of GS1_DATABAR_EXPANDED_STACKED barcodes.

Changes to other support modules

DynamsoftCameraEnhancer

• A new preset UI template has been added, which can be used and modified as needed.

DynamsoftCaptureVisionRouter

• Updated error handling logic for the capturing and startCapturing methods to clearly report errors specifically related to licensing issues.
• Added a new callback function, OnRawTextLinesReceived, to the IntermediateResultReceiver interface.
• Added EnumPresetTemplate, an enumeration of all preset template names.

DynamsoftCore

• Optimized the path auto-filling mechanism, now allowing the definition of only the root path without the need to separately define the resource file locations for each submodule. Read more about engineResourcePaths.
• Added new error codes
  • -10076: The license is initialized successfully but detected invalid content in the key.
  • -30063: [Barcode Reader] No license found.
• Added a new enumeration member IRUT_RAW_TEXT_LINES to the EnumIntermediateResultUnitType.

DynamsoftLicense

• Introduced a new charging method, TimeSliceCount, which tracks usage based on time.
• Improved duplicate license handling: after successfully creating an instance, setting the same license again no longer causes an exception.
• Updated the error messages for the initLicense method, providing more detailed feedback if license initialization fails. Warnings are now shown if the license is initialized successfully but part of the key is invalid.

DynamsoftImageProcessing

• Fixed a crash caused by the use of RegEx.

DynamsoftUtility

• Fixed an issue where the method CaptureVisionRouter.startCapturing() would mistakenly halt the fetching process when running, resulting in unnecessary stops and restarts.

10.2.10 (04/03/2024)

New

• Updated the template system
  • Added StringLengthRange for TextDetectionMode.
  • Added Argument BarcodeFormat for DPMCodeReadingModes. Currently, you can specify “BF_DATAMATRIX” or “BF_QR_CODE” for the parameter.
  • Added ReferenceTaskNameArray under Location.ReferenceObjectFilter to filter the reference objects generated by the task name.
  • Added the support of the OutputTaskSetting definition. The following sub-parameters are available in OutputTaskSetting object:
    • OutputCondition
    • TaskResultArray
    • TargetROIDefName
    • TaskSettingNameArray
    • BackwardReferenceOutput
    • ReferenceTaskNameArray
    • ReferenceResultTypeArray
    • Operator
  • Offset parameter is optimized.
    • Added ReferenceObjectType to specify whether the reference object is an atomic object or the whole image.
    • Added ReferenceXAxis & ReferenceYAxis to define the X & Y axis.
    • Modified FirstPoint, SecondPoint, ThirdPoint & FourthPoint. You can specify whether the X or Y coordinate of the point is measured by percentage.
    • Deprecated ReferenceObjectSize Type.
• Added the following new error codes
  • EC_IMAGE_SIZE_NOT_MATCH
  • EC_IMAGE_PIXEL_FORMAT_NOT_MATCH
  • EC_SECTION_LEVEL_RESULT_IRREPLACEABLE
  • EC_AXIS_DEFINITION_INCORRECT
  • EC_TEXT_LINE_GROUP_LAYOUT_CONFLICT
  • EC_TEXT_LINE_GROUP_REGEX_CONFLICT
• Added ObservationParameters interface for allowing the configuration of intermediate result observation.
• Added a new call back function onShortLinesUnitReceived to the IntermediateResultReceiver class.
• Added a new supported image pixel format, binary 8 inverted. The corresponding enumeration member is added to the EnumImagePixelFormat.
• Update MultiFrameResultCrossFilter class to allow string type for resultItemType.
• Update TextZonesUnit interface, now using TextZone interface to record text zone data.
• Update CandidateBarcodeZonesUnit interface, now using CandidateBarcodeZone to record candidate barcode zone data instead of Quadrilateral.
• Update DeformationResistedBarcodeImageUnit interface, now using DeformationResistedBarcode interface to record deformation resisted barcode data.

Improved

• Updated the security of the DynamsoftBarcodeReader library and other corresponding dependent libraries.

Fixed

• Fix the issue of camera not opening in iOS 17.4.

Breaking Changes

• The interface CapturedResult is migrated from DynamsoftCore module to DynamsoftCaptureVisionRouter module.
• Changed the logic of the capturedResultItemTypes setting of SimplifiedCaptureVisionSettings:
  • If the result item types don’t match the specified template, the method updateSettings will return the error code EC_PARAMETER_VALUE_INVALID with the message “The captured result item types do not match the task configurations in the template”.
  • Based on the capturedResultItemTypes setting, the irrelevant tasks will be removed from the template.
  • The capturedResultItemTypes should include at least one of the CRIT_BARCODE, CRIT_TEXT_LINE, CRIT_DETECTED_QUAD, CRIT_NORMALIZED_IMAGE. Otherwise, the method updateSettings will return the error code EC_PARAMETER_VALUE_INVALID with the message “The captured result item types should contain at least one task result type”.
• Refactored the Contour interface. Please view API reference - Contour interface for more information.

10.0.21 (02/05/2024)

Improved

• Introduced dbr.bundle.js to include packages that are required on running Dynamsoft Barcode Reader to reduce the complexity of the code.

10.0.20 (01/29/2024)

Changelog

In this version, the SDK has been refactored under the DynamsoftCaptureVision (DCV) architecture. To learn more about the architecture, please see Architecture of Dynamsoft Capture Vision. The following highlights the major changes:

• The class BarcodeReader and BarcodeScanner are removed and its functionalities are now incorporated into the newly added Class CaptureVisionRouter.

• License-related functions are handled by class Dynamsoft.License.LicenseManager.

• Camera-related functions are handled by DynamsoftCameraEnhancer(DCE). Please note that the following features are grouped together as enhanced features that require a license:
  • Enhanced-focus.
  • Auto-zoom.
  • Tap-to-focus.

• This version of BarcodeReader only accepts DynamsoftCameraEnhancer(DCE) version 4.0.1 and above, which has been refactored to be compliant with the ImageSourceAdapter (ISA) interface, as a valid image source.

• Decoded barcode results are returned via the CapturedResultReceiver (CRR) interface.

• For the full list of API changes, please refer to the v9 to v10 Upgrade Guide.