Change Log

4.6.1 (2019-12-05)

Additions

Added dependency to @juggle/resize-observer library.

Changes

Switched to ResizeObserver to more accurately and efficiently monitor and react to changes in size of the BarcodePicker element and its contained camera video feed.
Specified library side effects (CSS styles only) for better tree-shaking size reductions.

Fixes

Fixed incorrect update of BarcodePicker's camera video feed element display caused by screen orientation changes in some scenarios.
Fixed incorrect/missing update of BarcodePicker's camera video feed resolution caused by screen orientation changes, which in turn might have resulted in wrong GUI being displayed and wrong/partial video frame data being processed.
Fixed active camera's currentResolution property not being updated when screen orientation changes.

Updates

Updated external Scandit Engine library to version 5.13.3.
Updated @babel/runtime-corejs2 library to version 7.7.4.

4.6.0 (2019-10-31)

Additions

Added new ScanSettings.setProperty() and ScanSettings.getProperty() functions to control internal properties of the external Scandit Engine library.

Changes

Default camera selection improved for devices with multiple environment/back facing cameras.

Fixes

Fixed domain name information retrieval on licensing ScanditEngineError throw triggering another error in Firefox.

Updates

Updated external Scandit Engine library to version 5.13.
Updated @babel/runtime-corejs2 library to version 7.6.3.

4.5.1 (2019-10-01)

Additions

Added dependency to js-cookie library.
Added domain name information when the relative licensing ScanditEngineError is thrown.

Fixes

Fixed cookies for storing (completely random) device IDs not being set at the root path of the website, possibly causing multiple cookies with different values to be set if the library was used on different paths. Note however that we still correctly cached when a device was being activated in IndexedDB, meaning that the different cookies would not be used.

Updates

Updated @babel/runtime-corejs2 library to version 7.6.2.

4.5.0 (2019-09-12)

Additions

Device model usage information (when available) is now transmitted and accessible via the Scandit dashboard for analytics information.
Domain name usage information is now transmitted and accessible via the Scandit dashboard for analytics information.

Changes

Greatly reduced main library code size.
Improved memory usage and WebWorker operations, leading to up to 25% processing performance improvements in Firefox (desktop/mobile).
Improved memory usage between BarcodePicker/Scanner and WebWorker in Safari, leading to lower memory requirements.

Fixes

Fixed rare "out of memory" generic JavaScript errors and improved memory usage in Firefox mobile and Safari.
Fixed bug causing an incorrect sleep of a few milliseconds after each processed frame even when not needed.
Fixed BarcodePicker.create's targetScanningFPS option (including the default value of 30) and BarcodePicker.setTargetScanningFPS() function not correctly limiting the framerate to values higher or equal to 30 when the camera feed's framerate is higher than 30.
Fixed incorrect domain name detection and verification for IPv6 URLs.
Fixed incorrect hash checksum verification of fetched external Scandit Engine library JS/WASM files.
Fixed typo in humanized symbology name for UPC-E.

Updates

Updated external Scandit Engine library to version 5.12.
Updated webrtc-adapter library to version 7.3.0.

4.4.2 (2019-08-06)

Fixes

Fixed missing type information in order to support older typescript versions.

Updates

Updated @babel/runtime-corejs2 library to version 7.5.5.
Updated webrtc-adapter library to version 7.2.9.

4.4.1 (2019-08-05)

Fixes

Fixed rare failure to obtain initial video frames right after the camera has been initialized in Safari.

4.4.0 (2019-07-11)

Additions

Scanner.processImage() now accepts image data passed as an HTMLImageElement (Image) in addition to the already existing Uint8ClampedArray possibility.
Added new BarcodePicker.on() and BarcodePicker.addListener() (alternative name for the same functionality) functions to more easily add BarcodePicker event listeners in a standard way by passing event name and listener function.
Added a new BarcodePicker.removeListener() function to more easily remove BarcodePicker event listeners in a standard way by passing event name and listener function.
Added a new BarcodePicker.removeAllListeners() function to more easily remove all BarcodePicker event listeners in a standard way by passing an event name.
Added new Scanner.on() and Scanner.addListener() (alternative name for the same functionality) functions to more easily add Scanner event listeners in a standard way by passing event name and listener function.
It's now possible to remove listeners added for BarcodePicker's ready event via the new BarcodePicker.removeListener("scan") or BarcodePicker.removeAllListeners("scan") functions.

Changes

Improved and simplified camera access on iOS, ensuring promises are resolved exactly when the camera is actually ready.
Removed explicit caching of compiled WebAssembly code: the needed features have been removed from all browsers (see here). Browsers already now support or will support implicit caching: automatic caching of compiled WebAssembly code when a correctly served (standard HTTP caching headers and statuses) scandit-engine-sdk.wasm file is used.
Improved BarcodePicker and Scanner events documentation.

Fixes

Fixed failure to compile external Scandit Engine library WebAssembly on the latest iOS 13 beta (and Safari Technology Preview).
Fixed NoCameraAvailableError rarely being thrown (with no actual consequences) while accessing or switching the camera.
Fixed active camera's currentResolution property not being set/updated yet in some situations when the camera was just accessed.

Deprecations

Deprecated BarcodePicker.onReady() in favor of BarcodePicker.on("ready").
Deprecated BarcodePicker.onScan() in favor of BarcodePicker.on("scan").
Deprecated BarcodePicker.onSubmitFrame() in favor of BarcodePicker.on("submitFrame").
Deprecated BarcodePicker.onProcessFrame() in favor of BarcodePicker.on("processFrame").
Deprecated BarcodePicker.onScanError() in favor of BarcodePicker.on("scanError").
Deprecated BarcodePicker.removeScanListener() in favor of BarcodePicker.removeListener("scan").
Deprecated BarcodePicker.removeSubmitFrameListener() in favor of BarcodePicker.removeListener("submitFrame").
Deprecated BarcodePicker.removeProcessFrameListener() in favor of BarcodePicker.removeListener("processFrame").
Deprecated BarcodePicker.removeScanErrorListener() in favor of BarcodePicker.removeListener("scanError").
Deprecated BarcodePicker.removeScanListeners() in favor of BarcodePicker.removeAllListeners("scan").
Deprecated BarcodePicker.removeSubmitFrameListeners() in favor of BarcodePicker.removeAllListeners("submitFrame").
Deprecated BarcodePicker.removeProcessFrameListeners() in favor of BarcodePicker.removeAllListeners("processFrame").
Deprecated BarcodePicker.removeScanErrorListeners() in favor of BarcodePicker.removeAllListeners("scanError").
Deprecated Scanner.onReady() in favor of Scanner.on("ready").

Updates

Updated @babel/runtime-corejs2 library to version 7.5.4.
Updated eventemitter3 library to version 4.0.0.
Updated objectFitPolyfill library to version 2.3.0.
Updated tslib library to version 1.10.0.
Updated ua-parser-js library to version 0.7.20.
Updated webrtc-adapter library to version 7.2.6.

4.3.0 (2019-06-05)

Additions

Added a new ScanResult.rejectCode() function to reject a barcode in listeners registered with BarcodePicker.onProcessFrame() or BarcodePicker.onScan(): if all codes in the result are rejected, sound, vibration and GUI flashing will be suppressed.

Changes

ScanResult is now a class instead of a simple object (with the same available properties as before).

Updates

Updated external Scandit Engine library to version 5.11.4.
Updated @babel/runtime-corejs2 library to version 7.4.5.
Updated eventemitter3 library to version 3.1.2.

4.2.2 (2019-04-30)

Changes

Improved initial camera access performance: BarcodePicker creation (or first delayed access to camera) will happen faster in most scenarios thanks to quicker camera feed access. As an added bonus some browsers like Firefox mobile will also make less permission requests to the user.
Improved external Scandit Engine library loading behaviour: better error handling and automatic retry of network requests to retrieve the necessary files.

Fixes

Fixed the internal engine rarely stopping working immediately after initialization due to missing GPU features.
Fixed incorrect back camera identification for some devices.

Updates

Updated external Scandit Engine library to version 5.11.2.
Updated @babel/runtime-corejs2 library to version 7.4.4.
Updated adapter library to version 7.2.3.
Updated howler library to version 2.1.2.

4.2.1 (2019-04-11)

Fixes

Fixed the internal engine rarely randomly stopping working immediately after initialization due to failed GPU access.
Fixed camera access sometimes causing the webpage / web application to crash and reload on some devices in Safari.
Fixed incorrect back camera identification for some devices.

Updates

Updated external Scandit Engine library to version 5.11.1.

4.2.0 (2019-04-04)

Additions

Implemented and enabled by default blurry recognition to allow accurate scanning capabilities for out-of-focus (1D) codes. If enabled, more advanced algorithms are executed (and more resources/time is spent) every frame in order to successfully decode/scan difficult codes.
Added a new blurryRecognition option to ScanSettings's constructor and relative functions ScanSettings.isBlurryRecognitionEnabled() and ScanSettings.setBlurryRecognitionEnabled() to enable/disable blurry recognition.
Added a new laserArea option to BarcodePicker.create() and relative function BarcodePicker.setLaserArea() to manually set the area of the laser displayed when the GUI style is set to laser (the laser will match the width and be vertically centered).
Added a new viewfinderArea option to BarcodePicker.create() and relative function BarcodePicker.setViewfinderArea() to manually set the area of the viewfinder displayed when the GUI style is set to viewfinder.

Changes

Greatly reduced and stabilized memory usage in Firefox, also improved general memory usage in Chrome/Edge.
By default the BarcodePicker's laser will now automatically match the current ScanSettings's searchArea option, showing the area where codes are localized and scanned.
By default the BarcodePicker's viewfinder will now automatically match the current ScanSettings's searchArea option, showing the area where codes are localized and scanned.
BarcodePicker.reassignOriginElement() now verifies the passed originElement and throws an error if it's invalid.

Fixes

Fixed several possible issues causing errors on failed GPU initialization.
Fixed BrowserHelper incorrectly instantiating/leaking new WebGL contexts on each call, which could result in "Too many active WebGL contexts. Oldest context will be lost." warnings/errors depending on how often it was called.
Fixed some remaining rare errors of type SourceUnavailableError that can happen when accessing the camera not being correctly mapped to the more recent type: NotReadableError.
Fixed BarcodePicker failing to initialize in particular iframe context due to incorrect originElement validation.

Updates

Updated external Scandit Engine library to version 5.11.
Updated @babel/runtime-corejs2 library to version 7.4.3.
Updated objectFitPolyfill library to version 2.2.0.
Updated adapter library to version 7.2.2.

4.1.1 (2019-02-05)

Fixes

Fixed "single image mode" not working correctly since the previous library version.

Updates

Updated @babel/runtime-corejs2 library to version 7.3.1.
Updated adapter library to version 7.2.0.

4.1.0 (2019-01-22)

Additions

Implemented GPU acceleration on browsers supporting WebGL and OffscreenCanvas (currently Chrome only), this allows for faster and more accurate barcode localization at challenging positions and angles. GPU acceleration is automatically used if the browser supports it.
Added a new gpuAcceleration option to ScanSettings's constructor and relative functions ScanSettings.isGpuAccelerationEnabled() and ScanSettings.setGpuAccelerationEnabled() to control GPU acceleration.
Added new possible BrowserCompatibility.Feature entries in the missingFeatures property of BrowserCompatibility regarding GPU acceleration: WEBGL and OFFSCREEN_CANVAS. Note that these do not affect compatibility with the general scanning process.
Exposed static BrowserHelper.checkBrowserCompatibility() function to manually retrieve a built BrowserCompatibility object for the used OS/Browser.
In case a common CDN URL (UNPKG, jsDelivr) is used for the external engine location, the library now automatically generates the correct URL for the matching version. This ensures correct feature compatibility and also optimal resource caching thanks to direct links being used in all cases, resulting in much faster subsequent library loads.
Added a runtime check to verify hash checksum of fetched external Scandit Engine library JS/WASM files to ensure the correct version matching the main library is used.
Added new Scanner.clearSession() and BarcodePicker.clearSession() functions to remove all recognized barcodes from the scanner session and allow them to be scanned again in case a custom codeDuplicateFilter was set in the ScanSettings.

Fixes

Fixed library incorrectly depending on / polluting the browser global scope for some objects (like Promise) by correctly creating and using a sandboxed and polyfilled core-js environment.
Fixed the BarcodePicker occasionally processing video frames recorded just before being hidden, shortly after being shown again (and possibly triggering "old" scan results) in Safari.
Fixed BarcodePicker "submitFrame" listeners being incorrectly called while scanning is paused.
Fixed BarcodePicker GUI incorrectly flashing when being shown after being hidden, if a code was previously scanned.

Updates

Updated external Scandit Engine library to version 5.10.1.
Switched @babel/runtime library with @babel/runtime-corejs2.
Updated adapter library to version 7.1.1.
Updated howler library to version 2.1.1.

4.0.0 (2018-12-07)

Additions

Added new Micro QR symbology support and relative Barcode.Symbology.MICRO_QR enumeration value.
Added new LAPA4SC (Posti LAPA 4 State Code) symbology support and relative Barcode.Symbology.LAPA4SC enumeration value.
Added better error handling and clearer console error messages in case the scandit-engine-sdk.wasm file cannot be retrieved correctly.
Added new Scanner.getImageSettings() and Scanner.getScanSettings() functions to respectively get the currently used ImageSettings and ScanSettings objects (use BarcodePicker.getScanner() to retrieve its internally used Scanner intance).

Changes

BREAKING: Removed ScanditSDK.configure()'s preloadCameras and preloadEngineLibrary options and ScanditSDK.loadEngineLibrary function. Their functionality has been superseded by the (already previously existing) better possibility of calling ScanditSDK.CameraAccess.getCameras() (camera preloading) or creating and reusing a BarcodePicker/Scanner object in the background (engine library preloading); as explained in the README file.
BREAKING: Replaced CameraSettings.ResolutionPreference numerical enumeration values in favor of string values for optional easier JavaScript usage (ex. CameraSettings.ResolutionPreference.FULL_HD is now "full-hd" instead of 0).
Optimized external Scandit Engine library (WebAssembly) code size and structure, resulting in much faster loading times (more than twice as fast in some cases).
Optimized scandit-engine-sdk.wasm retrieval: in case the file is served with incorrect MIME type, an additional network request to the server is not needed anymore and previously downloaded data is reused for WebAssembply compilation.

Fixes

Fixed internal WebAssembly FileSystem sync issue causing increased resource usage and console messages to appear when under load.
Fixed incorrect video feed display when the BarcodePicker's containing element is changed or resized in Edge.
Fixed BarcodePicker.isMirrorImageEnabled() function to correctly return camera feed video mirroring status in all situations depending on camera access.
Fixed BarcodePicker.setMirrorImageEnabled() function to correctly apply and store camera feed video mirroring preferences per camera in all situations.

Updates

Updated external Scandit Engine library to version 5.10-beta.1.
Updated @babel/runtime library to version 7.2.0.
Updated adapter library to version 6.4.8.

3.2.0 (2018-10-26)

Additions

Added new Code 32 symbology support and relative Barcode.Symbology.CODE32 enumeration value.

Fixes

Fixed failure to access the camera on mac OS in Safari 12.
Fixed failure to access the camera on some specific mobile devices in Chrome.
Fixed failure to correctly detect the browser as unsupported (and crashing instead) in some older browsers, like Internet Explorer.

Updates

Updated external Scandit Engine library to version 5.9.2.
Updated adapter library to version 6.4.4.
Updated ua-parser-js library to version 0.7.19.

3.1.3 (2018-10-12)

Fixes

Fixed BarcodePicker.create() resolving to the picker before the camera is accessed when camera access is enabled.
Fixed BarcodePicker.resumeScanning(), BarcodePicker.accessCamera(), BarcodePicker.setActiveCamera() and BarcodePicker.applyCameraSettings() triggering unnecessary camera access operations when called while the camera is currently being accessed for other reasons.
Fixed CameraAccess.getCameras() triggering unnecessary camera access operations when called while the camera is currently being accessed for other reasons.
Fixed incorrect or missing video feed display in some situations in Edge.

Updates

Updated @babel/runtime library to version 7.1.2.
Updated adapter library to version 6.4.0.
Updated howler library to version 2.0.15.

3.1.2 (2018-08-29)

Fixes

Fixed important memory leak happening only in Safari that caused ever increasing memory usage and page crashes. Now memory usage remains stable and crashes are avoided.
Fixed Safari on iOS not correctly resuming camera video after the user exernally pauses and resumes the camera via the browser's camera access button.
Fixed Safari on iOS not correctly resuming camera video after an incoming call or other OS level interruption.
Fixed missing type information when trying to use the library in a TypeScript project.

3.1.1 (2018-08-16)

Additions

Added a new example_background.html file showing how to initialize a BarcodePicker object before it's needed and then start it on command.

Changes

Online license verification now only needs network calls on first usage of the library, subsequent loads use cached information and don't require network calls anymore. This also makes library loading faster.

Fixes

Fixed camera access sometimes failing in Safari with a generic "Invalid constraint" error.
Fixed incorrect camera being accessed in some situations by the BarcodePicker in Firefox.
Fixed CameraAccess.getCameras() returning camera objects with empty labels in Firefox when called multiple times.
Fixed CameraAccess.getCameras() not returning up-to-date camera objects.

Updates

Updated external Scandit Engine library to version 5.8.2.

3.1.0 (2018-07-27)

Additions

Added a new BarcodePicker.onSubmitFrame() function to register a listener to get a ScanResult whenever a frame is submitted for processing, making it possible to retrieve the frame before scanning is performed.
Added new BarcodePicker.removeSubmitFrameListener() and BarcodePicker.removeSubmitFrameListeners() functions to remove the new "submitFrame" listeners.

Changes

Improved scanning speed in "single image mode".
Improved barcode recognition for common large barcode scenarios in "single image mode".
Improved "single image mode" button area for easier clicking/tapping.
Improved "single image mode" button visibility in some situations.
Improved "single image mode" button display and resizing at different dimensions.

Fixes

Fixed "single image mode" occasionally triggering a ScanResult event with empty barcodes and unexpected imageData/imageSettings followed by a correctly populated ScanResult event when some barcodes are successfully scanned.
Fixed missing font color information for "single image mode" button.
Fixed incorrect typing information for BarcodePicker.removeScanErrorListener().
Fixed failure to compile TypeScript version of the library.

Updates

Updated external Scandit Engine library with a fix for a rare bug that could cause the same barcode to be reported twice in the scan results.
Updated adapter library to version 6.3.0.

3.0.0 (2018-07-18)

Additions

Implemented a new "single image mode" for the BarcodePicker configured via the singleImageMode option on creation. This mode is meant as an alternative/fallback mode (provided by default as fallback) for a BarcodePicker to provide single camera pictures to be scanned. It still performs all operations locally in the browser, but trades off continuous camera stream access for (more high quality) single snapshot scanning; this results in less browser features needed for the library to work and extended browser support. In "single image mode" a specially set UI is provided which enables users to click/tap to directly take a picture with the camera (mobile/tablet) or upload a file (desktop), this picture is then scanned and the results are provided. In this mode special camera access permissions don't have to be requested.

Changes

BREAKING: UnsupportedBrowserError now has a new data property containing more details regarding the compatibility level of the used OS/browser in a new BrowserCompatibility object. The message property in the error object is now always the same generic message.
BREAKING: Deprecated errors of type SourceUnavailableError that can happen on some older browsers when accessing the camera are now automatically mapped to the more recent type: NotReadableError.
BREAKING: Removed previously deprecated BarcodePicker.GUIStyle numerical enumeration values.
BREAKING: Removed previously deprecated Camera.Type numerical enumeration values.
Improved handling of camera access failures in some situations to prevent unhandled exceptions.
Implemented cache busting mechanism to ensure the external Scandit Engine library JS and WASM files are refreshed and downloaded from the server when a new version of the library is released.

Fixes

Fixed very rare internal engine errors that could happen when converting between number representations (causing "Out of bounds Trunc operation" errors).
Fixed BarcodePicker GUI disappearing when the source element has a CSS transformation applied to it.
Fixed incorrect behaviour due to engine location configuration causing an error when trying to load cached compiled WebAssembly code.
Fixed rare condition where slow camera access could cause an error and stop the scanning process before it could start.

Updates

Updated external Scandit Engine library to version 5.8.1.
Updated eventemitter3 library to version 3.1.0.
Updated howler library to version 2.0.13.
Updated tslib library to version 1.9.3.

2.5.1 (2018-07-02)

Fixes

Fixed a bug that caused the library to fail when showing video output in some browsers.

Updates

Updated external Scandit Engine library with a fix for a rare QR code bug.

2.5.0 (2018-06-29)

Additions

Added a new BarcodePicker.setCameraSwitcherEnabled() function to dynamically show or hide the GUI button to switch between different cameras, plus a relative BarcodePicker.isCameraSwitcherEnabled() function to get the current status.
Added a new BarcodePicker.setTorchToggleEnabled() function to dynamically show or hide a GUI button to toggle device torch on/off, plus a relative BarcodePicker.isTorchToggleEnabled() function to get the current status.
Added a new BarcodePicker.setTapToFocusEnabled() function to dynamically enable or disable manual camera focus when clicking/tapping on the video, plus a relative BarcodePicker.isTapToFocusEnabled() function to get the current status.
Added a new BarcodePicker.setPinchToZoomEnabled() function to dynamically enable or disable camera zoom control via pinching gesture on the video, plus a relative BarcodePicker.isPinchToZoomEnabled() function to get the current status.
Added a new BarcodePicker.getScanner() function to retrieve the initialized (and possibly configured) Scanner object internally used by the BarcodePicker instance.
Added a new scanner option to BarcodePicker.create() to pass and use an already initialized (and possibly configured) Scanner object on creation. Using this when needed can lead to faster component initalization thanks to the reuse of the already available external Scandit Engine library in the object.
Added a new destroyScanner argument (enabled by default) to the BarcodePicker.destroy() function, allowing to prevent Scanner destruction on BarcodePicker destruction.

Changes

Changed BarcodePicker.setActiveCamera()'s camera argument to be optional: when not provided the default camera is selected.
Improved error reporting when getting/setting symbology settings for invalid symbologies.
Documented new Samsung Internet Browser 7+ support.

Fixes

Fixed BarcodePicker.pauseScanning() not pausing camera input if the relative argument is passed and the BarcodePicker is already in a paused state.
Fixed BarcodePicker.accessCamera() not re-accessing the camera when camera access was previously paused via BarcodePicker.pauseScanning().

Updates

Updated external Scandit Engine library to version 5.8.0.

2.4.5 (2018-06-13)

Fixes

Fixed an important bug causing the external Scandit Engine library to regularly block while making network requests on startup and regularly after scanning a barcode, this is now correctly handled in the background. Now startup times are slightly faster, online status is not required after library initialization and subsequent scans of barcodes are smoother and without interruptions (network conditions don't affect all these scenarios anymore).

2.4.4 (2018-06-05)

Changes

Correctly throw UnsupportedBrowserError in case one of the WebAssembly-bugged iOS versions is used (11.2.2/11.2.5/11.2.6).
Show alerts about internal engine errors by default only when running on a local IP address (still always logged to console).

Updates

Updated adapter library to version 6.2.1.
Updated howler library to version 2.0.12.
Updated tslib library to version 1.9.2.

2.4.3 (2018-05-31)

Changes

Removed automatic WebView classification as unsupported in Android, as actual support might work depending on the containing app.

2.4.2 (2018-05-22)

Changes

Reduced external Scandit Engine library (WebAssembly) code size.
Improved general frame processing speed.

Updates

Updated external Scandit Engine library to version 5.8-beta.2.

2.4.1 (2018-04-27)

Fixes

Fixed incorrect behaviour of some browsers causing an error when trying to load cached compiled WebAssembly code.

Updates

Updated external Scandit Engine library to version 5.7.2.

2.4.0 (2018-04-25)

Additions

Implemented caching of compiled WebAssembly code on browsers that support this (currently only Firefox), this makes subsequent loads of the library much faster and don't require re-downloading WebAssembly files.
Implemented functionality to retrieve image data information whenever a frame is processed by a BarcodePicker.
Added a new imageData property to the ScanResult object, containing the raw image byte data of the processed frame.
Added a new imageSettings property to the ScanResult object, containing the image settings used to parse the image data of the processed frame.
Added a new BarcodePicker.onProcessFrame() function to register a listener to get a ScanResult whenever a frame is processed, independently from the number of recognized barcodes.
Added new BarcodePicker.removeProcessFrameListener() and BarcodePicker.removeProcessFrameListeners() functions to remove the new "processFrame" listeners.

Changes

Improved detection of missing browser / OS functionality in WebView scenarios on Android devices.
Improved CHANGELOG format.

Updates

Updated adapter library to version 6.1.5.

2.3.0 (2018-04-12)

Additions

Implemented object fit options for BarcodePicker objects, to set the video feed to "cover" or "contain" and thus be resized differently inside the given origin element.
Added a new videoFit option to BarcodePicker.create() to set video element fit type on creation.
Added a new BarcodePicker.setVideoFit() function to set fit type dynamically for the video element.
Added a new BarcodePicker.ObjectFit enumeration to list the different types of object fit types available.

Changes

Improved localization and scanning performance of challenging 1D codes in the center of the video frame.

Fixes

Fixed and improved camera enumeration and selection in Firefox.
Fixed incorrect video feed display in some situations in Edge.
Fixed incorrect application of scanning search area settings in some edge cases.

Deprecations

Deprecated BarcodePicker.GUIStyle numerical enumeration values in favor of string values for optional easier JavaScript usage (ex. BarcodePicker.GUIStyle.LASER is now "laser" instead of 1).
Deprecated Camera.Type numerical enumeration values in favor of string values for optional easier JavaScript usage (ex. Camera.Type.FRONT is now "front" instead of 0).

2.2.1 (2018-04-04)

Fixes

Fixed failing camera video feed recovery after unexpected camera identifier changes in Safari.

2.2.0 (2018-03-28)

Additions

Implemented scanning speed throttling functionality to allow tradeoffs between scan performance and power usage.
Added a new targetScanningFPS option to BarcodePicker.create to set target frames per second to be processed/scanned.
Added a new BarcodePicker.setTargetScanningFPS() function to set target frames per second to be processed/scanned.

Changes

Improved documentation.

2.1.1 (2018-03-22)

Fixes

Fixed incorrect domain name detection and verification in some particular local testing environments.

Updates

Updated external Scandit Engine library to version 5.7.

2.1.0 (2018-03-19)

Additions

Implemented pinch-to-zoom camera functionality for devices supporting it (currently available only in Chrome).
Added a new enablePinchToZoom option to BarcodePicker.create() to enable/disable pinch-to-zoom (when available).
Added a new BarcodePicker.setZoom() function to manually set zoom level (when available).

Fixes

Fixed tap-to-focus functionality failing to work on some devices.

2.0.0 (2018-03-15)

Additions

Added functionalities for easier/better usage of single-instance background BarcodePickers that don't acccess cameras all the time and are shared for different elements.
Added a new pauseCamera option to BarcodePicker.pauseScanning() to also pause camera input, allowing to interrupt (and later resume) the current camera stream.
Added a new BarcodePicker.reassignOriginElement() function to re-assign the BarcodePicker to a different HTML element.

Changes

BREAKING: BarcodePicker.resumeScanning() function now returns a promise resolving to the object instance instead of directly to the instance; this is due to the fact that the function might need to access the camera again.
BREAKING: Removed previously deprecated BarcodePicker.UIStyle enumeration.
BREAKING: Removed previously deprecated BarcodePicker.UIStyle.SCANLINE enumeration value.
BREAKING: Removed previously deprecated BarcodePicker.create()'s uiStyle option.

Updates

Updated external Scandit Engine library to version 5.7-beta.1.
Updated adapter library to version 6.1.4.

1.4.7 (2018-03-05)

Fixes

Fixed BarcodePicker trying to access again the camera after being destroyed.
Fixed BarcodePicker still referencing the used camera as the active camera after being destroyed.

1.4.6 (2018-02-23)

Changes

Greatly improved external Scandit Engine library loading times, especially on iOS devices.
Reduced external Scandit Engine library (WebAssembly) code size.
Improved camera initialization for slower devices.

Fixes

Fixed external Scandit Engine library failing to load in Edge.

1.4.5 (2018-02-22)

Fixes

Fixed camera initialization failing in Edge.
Fixed camera initialization failing for some combinations of browsers/devices incorrectly reporting camera failures.
Fixed BarcodePicker instances not being correctly destroyed when never accessing a camera.

1.4.4 (2018-02-14)

Updates

Updated external Scandit Engine library to version 5.6.2.
Updated adapter library to version 6.1.1.
Updated howler library to version 2.0.9.
Updated tslib library to version 1.9.0.

1.4.3 (2018-02-08)

Fixes

Fixed incorrect back camera identification for some devices.

1.4.2 (2018-01-12)

Changes

Added documentation note about problems with iOS 11.2.2/11.2.5/11.2.6.

Updates

Updated external Scandit Engine library to version 5.6.

1.4.1 (2018-01-11)

Fixes

Switched external Scandit Engine library to allow memory growth in order to prevent random memory allocation failures.

1.4.0 (2018-01-08)

Additions

Implemented Scandit Parser Library support to parse data string into structured data. For details refer to the new Parser object and the Scandit Parser Library's documentation.
Added new BarcodePicker.createParserForFormat() and Scanner.createParserForFormat() functions to create and use Parser objects.

Changes

Improved documentation.

1.3.2 (2017-12-21)

Fixes

Fixed external Scandit Engine library still already registering a device activation on initial configuration in some cases.
Fixed bug preventing scan settings to be changed after the initial setup for Scanner and BarcodePicker objects.
Improved memory usage and speed when modifying scan settings.

Updates

Updated external Scandit Engine library to version 5.6-beta.2.
Updated howler library to version 2.0.7.

1.3.1 (2017-12-19)

Fixes

Fixed external Scandit Engine library registering a device activation on initial configuration: now a device registered only at the time the first frame is processed. This means that unused Scanner objects or BarcodePicker objects starting in a paused state or with no camera access will no longer trigger registrations.

1.3.0 (2017-12-15)

Additions

Implemented functionality to delay camera access (and thus possible user permission requests) to after a BarcodePicker has been created, allowing for early external Scandit Engine library initialization.
Added a new accessCamera option to BarcodePicker.create() to enable/disable camera access on BarcodePicker creation.
Added a new BarcodePicker.accessCamera() function to access the camera after creation (if disabled on creation).

Updates

Updated adapter library to version 6.0.3.
Updated eventemitter3 library to version 3.0.0.
Updated tslib library to version 1.8.1.

1.2.2 (2017-12-05)

Fixes

Fixed possible problems during camera detection for some older browsers.
Fixed camera initialization failing for some combinations of browsers/devices incorrectly reporting camera failures.
Fixed camera initialization sometimes failing in Safari mobile on iOS 11.0 - 11.0.2.
Fixed BarcodePicker element sometimes overflowing its given origin element by 1 pixel.

1.2.1 (2017-11-29)

Fixes

Fixed BarcodePicker not getting hidden when the relative option or function is provided/called.
Fixed incorrect BarcodePicker visibility option and function only partially hiding the containing element.
Fixed BarcodePicker's originElement being left in an inconsistent state after being destroyed.
Fixed incorrect camera front/back detection on some devices set to a system language different from english.

1.2.0 (2017-11-27)

Additions

Added a new BarcodePicker.setGuiStyle() function to set the GUI after creation.

Changes

Improved README documentation.
Improved BarcodePicker documentation.

Fixes

Correctly detect failed camera initialization in various situations due to unforeseen hardware issues and reject promises with a NotReadableError error plus close the video stream when it's the case.
Fixed broken camera selection in BarcodePicker when one of the cameras cannot be accessed.

Deprecations

Deprecated BarcodePicker.UIStyle in favor of BarcodePicker.GuiStyle to be consistent with other existing Scandit SDKs.
Deprecated BarcodePicker.create()'s uiStyle option in favor of guiStyle.
Deprecated BarcodePicker.UIStyle.SCANLINE in favor of BarcodePicker.GuiStyle.LASER to be consistent with other existing Scandit SDKs.

1.1.0 (2017-11-17)

Additions

Implemented tap-to-focus camera functionality for devices supporting it (currently available only in Chrome).
Implemented device torch/torchlight toggle functionality and relative button for devices supporting it (currently available only in Chrome).
Added a new enableTapToFocus option to BarcodePicker.create() to enable/disable tap-to-focus (when available).
Added a new enableTorchToggle option to BarcodePicker.create() to enable/disable torch toggle button (when available).
Added a new BarcodePicker.setTorchEnabled() function to enable/disable torch (when available).

Changes

Improved BarcodePicker buttons and touch events responsiveness.
Improved README documentation.
Improved CHANGELOG format.
Improved documentation navigation.

Fixes

Fixed missing camera switcher button when preselecting a camera on BarcodePicker creation.
Fixed incorrect domain name detection and verification in Firefox.
Fixed buttons and touch events sometimes not being triggered on mobile devices.

Updates

Updated adapter library to version 6.0.2.

1.0.8 (2017-11-15)

Additions

Implemented automatic regularly triggered focus procedure for cameras not supporting continuous focus mode (but supporting at least manual focus); this greatly increases usability and scanning performance. Currently available only in Chrome.

Changes

Improved BarcodePicker documentation.

Fixes

Fixed incorrect domain name detection and verification in Edge.

1.0.7 (2017-11-13)

Fixes

Fixed ScanditSDK.configure() not rejecting in case of unsupported browsers when not performing any of the preloading functions, now the promise is correctly rejected.
Fixed incorrect error thrown on ScanditSDK.configure calls in case of unsupported browsers, now the promise is correctly rejected with said error.
Fixed incorrect error thrown on ScanditSDK.loadEngineLibrary calls in case of unsupported browsers, now the promise is correctly rejected with said error.
Fixed incorrect error thrown when a code containing data in non-UTF-8 format is scanned, now the barcode result is correctly created with an empty parsed data string.

1.0.6 (2017-11-10)

Fixes

Fixed incorrect camera initialization and metadata storage in Firefox mobile.

1.0.5 (2017-11-10)

Additions

Added a small shadow to the camera switcher button to make it more visible on bright backgrounds.

Changes

Altered function call (same functionality) to make the library correctly parsable by Internet Explorer 11, and more graciously fail with built-in errors later.
Improved README documentation.
Minor CHANGELOG formatting changes.

1.0.4 (2017-11-09)

Fixes

Fixed camera feed being interrupted in Safari when BarcodePicker element or page loses and regains visibility.
Fixed rare broken camera access in Safari when switching between cameras or setting camera options in the BarcodePicker.

Updates

Updated adapter library to version 6.0.0.

1.0.3 (2017-11-08)

Fixes

Fixed BarcodePicker video feed randomly freezing when switching between multiple cameras.
Fixed searchArea limitation not being correctly applied to all code types in ScanSettings.

1.0.2 (2017-11-08)

Changes

Improved ScanSettings documentation.
Improved README documentation.

Fixes

Fixed Barcode object to correctly contain location information as Quadrilateral object instead of array.

1.0.1 (2017-11-07)

Additions

Added missing external Scandit Engine library files to the build folder.

1.0.0 (2017-11-07)

Initial release.