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