Release Notes for Dynamsoft Barcode Reader JavaScript SDK
10.4.3100 (01/03/2025)
New
- Added the
ShortlineDetectionMode
andLineAssemblyMode
parameters for more flexible and precise configuration. - Added the
getTemplateNames
function to theCaptureVisionRouter
class to improve accessibility and usability of templates.
Fixed
- Fixed a bug that could cause a crash when using specific templates.
- Fixed a bug in DPM mode where the
isMirrored
value in theBarcodeResultItem
was not correctly assigned. - Fixed a bug where DotCode could not be decoded in certain scenarios.
10.4.2002 (10/24/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
to0xFFFFFFFEFFFFFFFF
, 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
andstartCapturing
methods to clearly report errors specifically related to licensing issues. - Added a new callback function,
OnRawTextLinesReceived
, to theIntermediateResultReceiver
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 theEnumIntermediateResultUnitType
.
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
forTextDetectionMode
. - Added Argument
BarcodeFormat
forDPMCodeReadingModes
. Currently, you can specify “BF_DATAMATRIX” or “BF_QR_CODE” for the parameter. - Added
ReferenceTaskNameArray
underLocation.ReferenceObjectFilter
to filter the reference objects generated by the task name. - Added the support of the
OutputTaskSetting
definition. The following sub-parameters are available inOutputTaskSetting
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
- Added
- 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 theIntermediateResultReceiver
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 usingTextZone
interface to record text zone data. - Update
CandidateBarcodeZonesUnit
interface, now usingCandidateBarcodeZone
to record candidate barcode zone data instead ofQuadrilateral
. - Update
DeformationResistedBarcodeImageUnit
interface, now usingDeformationResistedBarcode
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 fromDynamsoftCore
module toDynamsoftCaptureVisionRouter
module. - Changed the logic of the
capturedResultItemTypes
setting ofSimplifiedCaptureVisionSettings
:- If the result item types don’t match the specified template, the method
updateSettings
will return the error codeEC_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 theCRIT_BARCODE
,CRIT_TEXT_LINE
,CRIT_DETECTED_QUAD
,CRIT_NORMALIZED_IMAGE
. Otherwise, the methodupdateSettings
will return the error codeEC_PARAMETER_VALUE_INVALID
with the message “The captured result item types should contain at least one task result type”.
- If the result item types don’t match the specified template, the method
- 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
andBarcodeScanner
are removed and its functionalities are now incorporated into the newly added ClassCaptureVisionRouter
. -
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 acceptsDynamsoftCameraEnhancer(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.