Release Notes - JavaScript 3.x

3.2.30 (05/15/2024)

Highlights

• Added confusable character distinguishing: this feature enhances the library’s ability to distinguish between common confusable character sets including {0, o, O}, {1, I, l}, and {5, s, S}, across popular fonts like Arial, Times New Roman, and Verdana, etc.
• Supported confusable character set customization: leveraging the new caching mechanism in the CaptureVisionRouter (CVR) module, the library now enables users to customize confusable character sets to meet the needs of specific scenarios.

New

• Updated the template system
  • Added new LabelRecognizerTaskSettings parameters.
    • Added ConfusableCharactersPath to define the path of the resource files that store the confusable characters’ information.
    • Added ClusterSamplesCountThreshold to specify the lowest required sample count for clustering.
  • Added new TextLineSpecification parameters.
    • Added ConfusableCharactersCorrection to define which confusable characters you are going to distinguish. You can also specify the font type of the characters.
  • Added ExpectedGroupCount to define the count of TextLineGroups that might exist on the image.
  • Added StringLengthRange for TextDetectionMode.
  • 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 new APIs for users to obtain the cached character items and the character clusters:
  • A new interface BufferedCharacterItemSet to represent a collection of buffered character items and cluster information.
  • A new interface BufferedCharacterItem to represent a basic item of the buffered characters with its image and features information.
  • A new interface CharacterCluster to represent a character cluster generated from the collected buffered character items.
  • Added a new class BufferedItemsManager to manage the buffered character items.
• Added a new property GetSpecificationName to the TextLineResultItem interface to get the name of the TextLineSpecificationobject that generated this TextLineResultItem.
• Added a new property GetSpecificationName to the RecognizedTextLineElement interface to get the name of the TextLineSpecificationobject that generated this RecognizedTextLineElement.
• 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.

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.

Improved

• Security update for DynamsoftLabelRecognizer library and other corresponding libraries.

Fixed

• Fixed the issue of camera not opening in iOS 17.4.
• Fixed the issue where some intermediate results could not be retrieved correctly.

3.0.30 (02/02/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 LabelRecognizer is 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 LabelRecognizer 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.

• Recognized text results are returned via the CapturedResultReceiver (CRR) interface.