GleamTech.DocumentUltimate 7.0.0

• .NETFramework 4.7.2

  • GleamTech.Common (>= 6.0.0)

• .NETStandard 2.0

  • GleamTech.Common (>= 6.0.0)
  • System.Drawing.Common (>= 5.0.3)
  • System.Security.Cryptography.Xml (>= 4.7.1)
  • System.Text.Encoding.CodePages (>= 5.0.0)

## Version 7.0.0 - July 16, 2024

 - **Changed:** License keys are changed so please go to https://www.gleamtech.com/upgrade and acquire a new license
   key if you want to use this version (or higher). If your one year maintenance has not ended, you will receive a
   new free license key on the same page.

 - **Changed:** AssemblyVersion is changed so recompile your project against the new DLLs (drop in to bin folder will not work).
   There are some deprecated APIs but your project will still compile and run as same.
   Over time, you can replace deprecated usage with new usage to get rid of compile warnings.
 
 - **Added**: New redesigned Document Viewer with new modern UI and new features.
   We now based our Document Viewer on the best PDF viewer "pdfjs".

   pdfjs is a great open-source project which is frequently updated and
   new features are being added to, however looks-wise it's ugly, or
   maybe let's say it looks outdated. How about getting the latest
   PDF features and fixes from pdfjs but having a slick look on the presentation side?

   Our pdf viewer is unobtrusive, we don't directly change code of pdfjs,
   we just include pdfjs in an iframe and at runtime override HTML, JS and CSS
   to offer  a slick modern look and better ui structure and usability and new features.
   This way we can always update pdfjs to the latest version easily and
   get all bug fixes and improvements.

   Other pdf viewers based on pdfjs usually don't update the default look,
   and the ones that does usually miss functionality due to separating
   into components but partially implementing them or offer a bad/partial API.

 - **Added** Document Viewer now supports 3 built-in themes: "slate", "classic-light", "classic-dark".
   When two values separated by comma is set, the second value will be the dark theme.
   Dark theme is used when a user indicates their preference through an operating system setting (e.g. light or dark mode) or a user agent setting.
   When single value is provided, dark theme is disabled, i.e. the only provided theme will be used always even when user prefers dark mode.
   Note that you can emulate prefers-color-scheme via browser's F12 dev tools to test dark mode which is normally activated according to user's OS preferences.

 - **Improved:** Mobile viewer is removed, instead same viewer will use large UI sizing for mobile devices.
   DocumentViewer.MobileMode property now specifies on which mobile device type to use large UI sizing.
   Note that device features are not detected, instead browser's viewport size is used to decide the UI sizing.
   So if you manually resize the browser window (or emulate a device via browser's F12 dev tools),
   phone or tablet size can be triggered.

 - **Added** DocumentViewer.DisplayMode now supports Window, Panel and Viewport values.
 
 - **Added** Document Viewer now supports 111 language files which are bundled with pdfjs project.
   However for some few custom text which are not inside those language files,
   DocumentViewer.Translations property is used to override.

 - **Improved:** As our new Document Viewer is PDF based, we only need one conversion step from now on,
   i.e. we no longer need the second step PDF -> XPZ, we will not need XPZ format and we will display PDF format directly.
   This will improve the stability and performance of Document Viewer beause some reported errors
   mostly occured when converting specific documents to XPZ format in second step.
   Converting to PDF in first step was usually stable.
   This will solve most of the weird native DLL crashes.
   In later versions, we will also try to ditch native DLL and go full managed for conversion to PDF.
   DocumentCache will trim unused .xpz files over time so you don't need to remove them manually.

 - **Changed:** For supporting new modern UI, browser requirements are changed.
   Browsers released in the last 2 years are okay, e.g. Chrome 98+, Safari 16.4+
   Legacy browsers like IE are no longer supported.

 - API changes:
   - Deprecated DocumentViewer/DocumentViewerControl properties:
     - PageLayoutMode is deprecated, use ScrollMode and SpreadMode instead.
     - PageFitMode is deprecated, use ZoomMode instead.
     - PageZoomLevel is deprecated, use ZoomLevel instead.
     - PageRotationMode is deprecated, use RotationMode instead.
     - SidePaneVisible is deprecated, use SidebarVisible instead.
     - SidePaneTabsAtBottom is deprecated, as it's no longer useful.
     - LoadingMessage is deprecated, use Translations instead.
   - DocumentViewerClientEvents.PrintProgress is deprecated, this event is removed as it's not useful.
   - DocumentViewerMatchOptions.UseWildcard is deprecated, as it's no longer useful.
   - DocumentViewerPageFitMode is deprecated, use DocumentViewerZoomMode instead.
   - DocumentViewerPageLayoutMode is deprecated, use DocumentViewerScrollMode and DocumentViewerSpreadMode instead.
   - DocumentViewerPageRotationMode is deprecated, use DocumentViewerRotationMode instead.
   - Deprecated DocumentViewerPermissions properties:
     - NavigateHistory is deprecated, this permission is removed as it's not useful.
     - ChangeFitMode is deprecated, use ChangeZoomMode instead.
     - ChangeLayoutMode is deprecated, use ChangeSpreadMode and ChangeScrollMode instead.
     - ViewBookmarks is deprecated, use ViewOutlines instead.
     - Search is deprecated, use Find instead.
   - Deprecated DocumentViewerPrintOptions properties:
     - HighQuality is deprecated, use Resolution instead.
     - HighQualityLevel is deprecated, use Resolution instead.
     - Grayscale is deprecated, as it's no longer useful.
     - IncludeComments is deprecated, as it's no longer useful.
     - SkipDialog is deprecated, as it's no longer useful.
     - PageRange is deprecated, as it's no longer useful.