Applicability

Applies to: DotImage 10.7.0 and newer (Atalasoft.dotImage.Office.dll with the Perceptive Document Filters)

Background

Each DotImage build is built and tested against one specific version of the Perceptive Document Filters. The filter DLLs are not backward compatible or forward compatible. A filter version that is older or newer than the one your Atalasoft.dotImage.Office.dll shipped with is not a supported combination.

Not every new DotImage build changed the filter version. DotImage 11.5.0.8 through 2026.2.5 all ship 25.2.0.5427, so moving between those builds leaves the filter files as they are. Moving from 11.5.0.7 to 11.5.0.8 changes the filter version from 24.3.0.5160 to 25.2.0.5427, so the filter files must change as well.

This is important when you migrate a solution from one DotImage version to another and the solution does both of the following:

• references Atalasoft.dotImage.Office.dll, and
• copies the Perceptive filter DLLs into its bin folder (the filter DLLs cannot be added as project references, so they are copied by hand or through a copy-local build step).

When the target build ships a different filter version, updating the Office DLL reference while the old filter DLLs stay in place leaves the solution with a mismatched pair which will throw an exception. Because the filter DLLs are copied outside of the normal reference system, a project update will not replace them for you.

Summary

The OfficeDecoder in Atalasoft DotImage (Atalasoft.dotImage.Office.dll) renders Word, Excel and PowerPoint documents as images. Starting with DotImage 10.7.0, the decoder relies on a set of Perceptive Document Filter DLLs that ship in the SDK under bin\PerceptiveDocumentFilters.

The filter DLLs carry their own version numbers, and those numbers do not match the DotImage version. For example, DotImage 11.0 through 11.2.0.10 ship a filter whose version begins with 11.4, while DotImage 11.4 ships filter version 22.1.0.4255. Use the table below to find the filter version for your DotImage build.

Across the 89 DotImage builds that include the filters, there are 14 distinct filter versions. The filters did not change with every DotImage release. One filter version is shared by as many as 16 consecutive builds (22.1.0.4255, DotImage 11.4.0.0 through 11.4.0.15), and the average is about six builds per filter version.

History

Perceptive filter version by DotImage build

Listed in release order. "Builds" counts the DotImage builds that ship that filter version. The full build-by-build list is in the appendix.

Notes

• The 10.7.0.x and 11.0.0.x releases overlapped in time. Both lines picked up filter versions 11.4.0.2543 and 11.4.0.2600 around the same period, so rows 5 and 6 list builds from both.
• The filter version changes in the middle of a release line, at a feature pack boundary. For example, 11.5.0.2 ships 24.1.0.4978, 11.5.0.3 ships 24.3.0.5160, and 11.5.0.8 ships 25.2.0.5427. Look up the exact build, not only the major.minor release.
• The filter version numbers (11.3, 11.4, 21.2 and so on) are Perceptive version numbers. Filter version 11.4.0.2822 does not belong to DotImage 11.4.

How to find the filter version in your solution

Check the version of the Perceptive.DocumentFilters.dll that your application actually deploys. In Windows Explorer, right-click the file, choose Properties, and open the Details tab. The File version and Product version match. From PowerShell:

(Get-Item '.\bin\PerceptiveDocumentFilters\intel-64\Perceptive.DocumentFilters.dll').VersionInfo.FileVersion

To find every copy of the filter DLL under an application folder (stray or stale copies are a common cause of mismatches):

Get-ChildItem -Path '.\MyApp' -Recurse -Filter 'Perceptive.DocumentFilters.dll' |
    Select-Object FullName, @{ n = 'Version'; e = { $_.VersionInfo.FileVersion } }

The intel-32 and intel-64 folders of a given DotImage build carry the same filter version. The files are named identically, so you do need to take care that you match "bitness" to your application platform target.

Migration checklist

• Look up the filter version for your current DotImage build and for your target build in the tables on this page.
• If the two versions are the same, the filter files do not need to change. Update the Atalasoft.dotImage.Office.dll reference to the target build and select the correct framework and bitness.
• If the versions differ, copy the full filter set from the target build's bin\PerceptiveDocumentFilters\intel-32 or intel-64 folder (matching your application's bitness). Replace every filter DLL in your project and deployment output. The set is ISYS11df.dll, ISYSreaders.dll, ISYSreadershd.dll and Perceptive.DocumentFilters.dll.
• Search your project, installer, build output folders and deployment packages for old copies of the filter DLLs (see the PowerShell command above) and remove them.
• Confirm the deployed Perceptive.DocumentFilters.dll reports the version you expect.
• Test rendering of Word, Excel and PowerPoint documents in the target environment before you release.

Keep the Office DLL and the filter DLLs together. Take both from the same DotImage build, or from builds that ship the same filter version according to the tables on this page.

Appendix

Filter version for every DotImage build

DotImage version is the product version of Atalasoft.dotImage.dll for that build (the product version shown in the Details tab).

See also

• HOWTO: Correctly Reference, License and Configure OfficeDecoder and Dependencies
• HOWTO: Safely Change / Set Resolution of OfficeDecoder

Last Update

2026-11-12 - TD - (Updated for 2026.2.5)