Changes Introduced != "release notes"
Please note, this document is intended to "go beyond" the basic release notes and give more details where needed. Such as Release notes may say "new feature - added single page view to WDV" where the Changes Introduced will tell you more useful information such as "to enable this feature you need to set the singlepage config option to true here..."
For basic Release notes, please see
INFO: 11.4 Full Release Notes
Changes in Fix Packs
Some changes are introduced in Fix packs and Service packs after initial release. We note those here when they require changes/ add features that were not present
MAJOR Fix for Certificate Errors in WebCapture in Chrome
Changes in Google Chrome caused WingScan (WebCapture) service to become unreachable due to errors regarding certificates. This has been addressed in
11.4.0.4.0.828
A.K.A. 11.4 FixPack 4
If you are using WebCapture (WingScan) please immediately upgrade to 11.4.0.4 or newer to avoid this issue in Google Chrome on Windows.
HOWTO: Upgrade / Update DotImage - Including Web Apps Using WebDocumentViewer and/or WebCapture
A fix for Chrome on MacOS scanning is tentatively scheduled for FixPack 5 coming in early 2023
Download 11.4.0.4 on our official site: (May not be available until December - use Alternate Download Links below if needed)
ALTERNATE Download Link for 11.4.0.4 (available immediately)
SECONDARY ALTERNATE Download Link for 11.4.0.4 (available until official link is live)
NOTE: If you are using NuGet / NPM packages, these can lag as much as 2 weeks behind official publication due to the extended publishing process.
QRCodeOptions for Mirrored Codes
In FixPack 3 (11.4.0.3) we added a new property to QRCodeOptions to tell the engine to attempt to look for mirrored (horizontal) codes.
The reason for this is that some customers were seeing QR codes that look valid but would not read - the source was determined to be that the code was captured on a mobile device using a "back camera" which was using a mirror image.
Mirrored codes are technically not to the QR specification and so, not reading them is the "correct" result. However, mirrored images for QR codes are common due to QR codes ubiquity in situations where mobile devices cameras are the input device.. Enabling this new property will cause some performance hit as the memory and processing needed to do the Mirror operation, plus the processing needed for a second pass at detection. Thus, the default setting will be false and it will need to be explicitly set in your ReadOpts.QRCodeOptions if you want this automatic extra processing
The property name is DetectMirroredQRCodes
PDF option Now Added to DeliverablesConfig For WebCapture
"pdf" is now an additional supported option for DeliverablesConfig.format in WebCapture
Proper use is format: 'pdf'
NEW Features
.NET Core
In 11.4 we have begun shipping DLLs marked as "5.0" ( C:\Program Files (x86)\Atalasoft\DotImage 11.4\bin\5.0 )
These are DLLs for targeting .NET 5 / .NET 6 (Also known as .NET core) NOTE that we do not support .NET Core 3.1 or older with these dlls)
There will be more to come here, please check back in this space soon for links to articles and/or sample apps.
IMPORTANT NOTE about .NET Core and WinForms Designer
Unfortunately, our .NET 5 / .NET 6 components do not work with the Visual Studio WinForms forms designer. This is due to a known issue in Visual studio handling of .NET 5 and forms designer. We are currently investigating if /when the issue is addressed in .NET 6 and hope to be able to offer full support for WinForms designer mode when targeting .NET 6 in the future
For the time being, your options are
- Target .NET Framework instead of .NET 5 or .NET 6 - (This is your best option for full functionality)
- Target .NET Framework to do your designer work then up convert your project to target .NET 6 - (This is possible but the up convert is one-way (you can't back it down to .NET framework) meaning the designer will be set/not able to render with our controls - so any updates/fixes will have to then be done by adjusting the designer created code
- Manually handle the code for placing and configuring the controls in code - (This is possible but tedious - you'd need to essentially manually write al the code that the form designer would usually write on your behalf - it's not really a valid solution for any but the most experienced WinForms developers who don't mind not having a visual designer)
NON-BREAKING Changes
These are important changes but ones that don't directly require code changes or other large rewrites
Documentation / Help Files
In previous versions, the ApiReference.chm and DevelopersGuide.pdf were installed to a folder named help to:
C:\Program Files (x86)\Atalasoft\DotImage 11.x\Help\
These files are now provided as download links in the DotImage 11.4 start menu folder
Developers Guide
START->All Programs->Atalasoft DotImage 11.4->DevelopersGuide
Direct Download
.NET API Reference
START->All Programs->Atalasoft DotImage 11.4->ApiReference
Direct Download
WebDocumentViewer (clientside) API Reference
https://atalasoft.github.io/web-document-viewer/
WebCapture (Clientside) API Reference
https://atalasoft.github.io/web-capture-service/
BREAKING Changes
These are larger changes that may require code changes/ rewrites or where features/support was dropped or removed
Web App / IIS licensing
NOTE: this issue should be addressed in 11.4.0.3 which has a tentative ETA of early October
A recent regression has come to light - Customers deploying .NET Framework web applications IIS may find that there's an issue with "Unable to find license file in the folllowing locations" even though they've placed their license files (correctly) in the app bin directory as before.
The root issue is that starting in 11.4.0.0, the licensing is looking in the temp cache files generated for the app. This is an issue under ongoing investigation, and we plan to resolve it in an upcoming fixpack.
WorkAround
The recommended workaround is to create a license directory on the server in question which the IIS process has rights to and use the BaseAssemblyPath Registry key value to point to this location per:
HOWTO: Configure your deployment to use Atalasoft license files in a custom location
Please pay special attention to the key path - there are two - one is for x64 (default IIS) HKLM\Software\Atalasoft\DotImage\{version}\ and the other is for 32 bit (uncommon) HKLM\Software\Wow6432Node\Atalasoft\DotImage\{version}\
DLL Restructuring
In 11.4 you may notice some DLLs are "missing" versus previous versions. This is by design.
We distribute our SDK in sets based on Framework
our dlls for targeting .NET Framework 3.5 are in
C:\Program Files (x86)\Atalasoft\DotImage 11.4\bin\3.5
Our DLLs for targeting .NET Framework 4.5.2 through 4.8.x are in
C:\Program Files (x86)\Atalasoft\DotImage 11.4\bin\4.5.2
Our DLLs for .NET 5 and .NET 6 are in
C:\Program Files (x86)\Atalasoft\DotImage 11.4\bin\5.0
for the 5.0 distributions of DLLs, we've removed
Atalasoft.DotAnnotate.Ink.dll
Atalasoft.dotImage.WebControls.Mvc.dll
These components may also be removed for the .NET Framework versions in future releases (support for Ink annotations and MVC legacy web controls are deprecated as are the Legacy web controls - new application development for web based projects should exclusively use our WebDocumentViewer (modern HTML5) web controls.
Dropped Support
MS Internet Explorer (11 and older), and non-chromium versions of MS Edge
We can no longer officially support MS IE 11 or older, and we can not support MS Edge if you're using a non-Chromium based version.
Your legacy apps MAY continue to work with these outdated browsers and if so that's OK but if you report a bug/issue with our web controls if must be replicible in Current versions of Google Chrome, MS Edge (Chromium based), and/or FireFox; or in the current Safari release for MACOS machines.
MACOS Mojave and older dropped
This applies to the Web Capture client-side component. The installable MACOS package that clients using pages with WebCapture need to install. The package no longer supports MACOS Mojave and older
INK Annotation Support Removed
MS Ink annotation support is being removed. Its not part of the new .NET 5 dlls and may be removed from 3.5 and4.5.2 dlls in future. This was a seldom used feature as our Freehand annotations work very well to handle what they provided without needing a whole separate MS infrastructure