GroupDocs Customer Newsletter – May 2015

GroupDocs logo Monthly Newsletter
May, 2015

Display 50+ Common Document Types on Your Kentico Site

Kentico is a popular CMS largely focused on document management. Recently we have released a plugin that allows Kentico developers to seamlessly integrate GroupDocs.Viewer for .NET library into their sites. With this integration, you can let your users view documents of all common business formats, including PDF and Microsoft Office, directly within your Kentico site all without having to install any Microsoft Office software.

Find Out More

Document Viewer for Kentico
Product News
GroupDocs.Viewer for .NET: improved search capability and streams handling API

This month we have released two minor versions of the GroupDocs.Viewer for .NET library: 2.10.1 and 2.11.0. Each includes a number of fixes and optimizations, these include:

1. Fixed behavior of the SearchForSeparateWords method in the HTML-based rendering mode. Now if set to true, the viewer searches for and highlights all of the keywords specified in the search form, irrespective of the words order. Contrary, if the SearchForSeparateWords method is set to false, then the viewer searches for the exact phrase specified in the search form.

2. Previously, GroupDocs.Viewer tried to determine the document type by reading the signature at the beginning of the file. But this approach has shown to be problematic. In the latest GroupDocs.Viewer for .NET version we have implemented the fileExtension parameter as a mandatory Stream method, which allowed us to remove the file type detection to make this functionality more reliable.

3. Another API improvement was made to how the viewer generates stream names. Previously, GroupDocs.Viewer tried to generate a unique, but reproducible stream name by using its length. A more reliable approach could be to generate a hash of file contents. But it appeared to be very slow. As a result, we’ve removed the file name creation operation and set the fileName parameter of the Stream method as mandatory. For more details on this recent release and to download the library, please visit this page.

GroupDocs.Conversion for .NET: improved conversion accuracy

In GroupDocs.Conversion for .NET version 1.9.0 we improved handling of complex objects when converting PDF files to Microsoft Word documents (e.g. tables with background colors and text within cells). Now you get even more accurate and clear results in the output of the “PDF to Word” conversion operations. In addition to that, accuracy was improved for the “XPS to TXT” and “PDF to JPEG” conversion operations. For more details on this recent release and to download the library, please visit this page.

GroupDocs.Total for Cloud: improved handling of documents loaded from URLs

Several minor updates have also been implemented in GroupDocs.Total for Cloud. Among others, we would like to outline an enhancement that makes file loading from URLs more reliable. With this update we fixed an issue that in rare occurrences caused an error when trying to view a document loaded from the web.

From The Library
GroupDocs.Viewer for .NET: working with the front-end using a JavaScript widget

GroupDocs.Viewer for .NET comes with an out-of-the-box GUI that can be easily customized and embedded on your website. The GUI includes a number of controls that allow end users to easily navigate documents in a web-browser. To name a few, they are: download, print, search, rotate, zoom, view mode, page turning, etc. In this guide we list all JavaScript methods that allow developers to have complete control over widget’s behavior. Go to the guide.

GroupDocs.Viewer for Java: getting started quickly

GroupDocs.Viewer for Java can be downloaded in “slim" and "fat” packages. The “fat” one includes all required dependencies along with the library itself bundled in a single JAR, while the “slim” package includes the library only. Depending on your preferences, you can either use the “fat” package, or set all the required dependencies manually for the “slim” version. Whatever method you choose, please refer to this page for a detailed guide on how to install the library and download samples we’ve prepared to help you get started quickly.

Feedback
How Can We Help You?

Do you have ideas for what you'd like to see us do in 2015? Take a minute to tell us.

Product Releases And Updates

GroupDocs.Total for .NET: the latest versions of our .NET products packaged into one product suite.

 

GroupDocs.Total for Java: the latest versions of our Java products packaged into one product suite.

GroupDocs.Viewer for .NET 2.11.0: improved search capability and streams handling API; other minor improvements.

 

GroupDocs.Viewer for Java 2.9.1: improved PPTX files rendering speed; minor improvements and bug fixes.

GroupDocs.Comparison for .NET 2.3.3: minor improvements and bug fixes.

   

GroupDocs.Conversion for .NET 1.9.0: improved “PDF to Word”, “XPS to TXT” and “PDF to JPEG” conversion accuracy; other minor improvements and bug fixes.

 

 

GroupDocs.Annotation for Java Add-on for Concrete5 Is Now Available for Download

Today we’re pleased to announce the release of an add-on that allows Concrete5 developers to seamlessly integrate the Java version of the GroupDocs.Annotation library into their sites. GroupDocs.Annotation lets your users annotate over 50 common document and image types straight from within your Concrete5 site and without having to install any office software or browser plugins. Among supported file formats are: PDF and Microsoft documents, Excel spreadsheets, PowerPoint presentations, Visio diagrams, raster images (JPEG, GIF, TIFF, BMP, PNG) and many more.

Key features at a glance:

  1. Browser-agnostic – documents can be viewed and annotated using any modern web-browser, including Internet Explorer 8+, Chrome, Mozilla Firefox, Safari 5+.
  2. Easy deployment – there is no need to download or install anything on the client side.
  3. A comprehensive set of annotation tools: sticky notes, rectangle, polyline, arrow, text underline/strikethrough, redaction, watermarks, etc.
  4. Support for native PDF and Microsoft Word annotations.
  5. Multi-user annotation sessions allow several users collaboratively review and annotate the same document simultaneously.

This new add-on is the third in a series – Concrete5 developers now have a choice to integrate any of the available GroupDocs.Annotation versions: an on-demand cloud service or .NET and Java libraries that can be deployed on-premises. For more feature details and installation guides, please visit corresponding add-on pages in the official Concrete5 marketplace:

GroupDocs.Annotation for .NET
GroupDocs.Annotation for Java
GroupDocs.Annotation for Cloud

GroupDocs.Annotation for .NET Can Now Be Easily Integrated into Orchard Sites

GroupDocs.Annotation for .NET Library logoGood news for Orchard developers and site owners – after a successful release of the module that integrates GroupDocs.Viewer for .NET into Orchard CMS, we’re pleased to inform you that we’ve recently released yet another module - this time for integrating the .NET version of the GroupDocs.Annotation library.

Like GroupDocs.Viewer, the GroupDocs.Annotation for .NET library supports all common business document formats, provides cross-platform compatibility and doesn’t require any installations on the client side. In addition to that, the library provides comprehensive document annotation functionality that allows your users collaboratively review and annotate documents on your Orchard site.

GroupDocs.Annotation for .NET features 14+ annotation tools (including sticky notes, polyline, rectangle, arrow, text underline and strikethrough, redaction, watermarks, ruler, etc.), supports native PDF and Microsoft Word annotations and allows several uses to annotate the same document simultaneously.

With this new module, Orchard developers now have a choice between two deployment options:

  • On-premises - by installing the downloadable GroupDocs.Annotation for .NET library.
  • SaaS – by integrating the cloud version of the annotator.

Users who already have a GroupDocs.Annotation for .NET license can use this new Orchard module for free. If you don’t have a license yet, but would like to test the annotator on your Orchard site, please feel free to contact GroupDocs sales for a 30-day trial license, or simply download an evaluation copy of the library.

For more details on the GroupDocs.Annotation for .NET module, please visit the Orchard gallery.

Display PDF, Microsoft Office and 50+ Other Document Types on Your Kentico Site

GroupDocs.Viewer for .NETKentico is quite a popular CMS focused largely on document management. At GroupDocs we create APIs that allow developers to enhance their applications and sites with convenient document collaboration tools. One of such tools is a multi-format, cross-platform compatible document viewer – GroupDocs.Viewer. It allows end users to view over 50 types of documents and images from any modern web-browser and without having to install any office software or plugins.

To name just a few, the file formats that the viewer supports include: PDF and Microsoft Word documents, Excel spreadsheets, PowerPoint presentations, Visio diagrams, Outlook messages, CAD drawings, multipage TIFF files and a lot more.

Another important feature – is the ability to display documents in a “read-only” mode. GroupDocs.Viewer allows you to prevent unauthorized copying of your documents while still sharing them with others. You can disable print, download and text copy options for specified documents and add watermarks to protect documents from screen-grabbing.

Currently GroupDocs.Viewer exists in different forms: it is available as a .NET class library (DLL), Java library (JAR) and as a Cloud API (SaaS). Earlier we already released a plugin that allows Kentico developers and site owners to seamlessly integrate the Cloud (SaaS) version of GroupDocs.Viewer into their sites. The plugin can be found on the Kentico marketplace.

The cloud version of the viewer simply creates an iframe on a web-page and redirects all input documents to the cloud API. Hence, documents have to be hosted on GroupDocs servers.

Although we use secure Amazon EC2 infrastructure, there are cases when you need to keep your documents in-house and avoid any external requests to them or deploy the viewer on your intranet. If that is the case, you may be interested in a new plugin that we’ve just released for the .NET version of the viewer. This version can be deployed on-premises and doesn’t require any external API calls.

The plugin has been tested by Kentico and is now officially published on the Kentico marketplace. This new version of the plugin is free for customers who own a GroupDocs.Viewer for .NET license. If you don’t have one, you can test the viewer on your site in an evaluation mode, or request a free fully-functional 30-day trial simply by contacting our support team. For more details on GroupDocs.Viewer for .NET, please visit its homepage. Also please visit our documentation portal for a detailed guide on how to deploy the viewer on your Kentico site.

GroupDocs Customer Newsletter – April 2015

GroupDocs logo Monthly Newsletter
April, 2015

Merge Document Templates With Your Data Sources

GroupDocs.Assembly for .NET is a powerful library that allows developers to generate hundreds of custom documents on-the-fly by automatically combining document templates with data obtained from a database, datasource file or user input.

GroupDocs.Assembly for .NET can be used to generate invoices, bills, order quotes, insurance policies and any other documents in a PDF, Microsoft Word, Excel or PowerPoint format.

Find Out More

Document Assembly - .NET Library
Product News
GroupDocs.Viewer for Java: support for new file formats, plus enhanced API for custom cache configuration

This month we’ve managed to release two new versions of the GroupDocs.Viewer for Java library - version 2.8.0 and 2.9.0. In these two releases we’ve added support for 5 new file formats, including: ICO, PSD, ODP, PPS and PPSX. Another major update – is the extended CacheDataHandlerinterface, which allows you to configure and manage custom caching rules. You can now control what data, how and when you’d like the viewer to cache on the server. For example, you can configure the library to add only encrypted data to cache and set your custom storage path. Please read this guide for details on how the interface works.

In the version 2.9.0 we’ve also added support for hyperlinks in textual documents. For more details on these and numerous other improvements, please see release notes and download the latest version from the downloads section of our website.

GroupDocs.Conversion for Java: merge two different document types to a single PDF file

With the latest release of GroupDocs.Conversion for Java library version 1.1.0, you can now convert two or more different document types supported by the library to a single merged PDF file. In addition, the new version supports Microsoft Word bookmarks. You can configure the library to include bookmarks to output files when converting Word documents to PDFs. For more details on this recent release and to download the library, please visit this page.

From The Library
Secure ASP.NET PDF viewer – a C# sample built using GroupDocs.Viewer for .NET library

Without doubt, one of the most popular document formats our customers deal with is PDF. Generally, it is quite easy to find a solution to display PDFs on an ASP.NET site. While that is the case, things become a lot more complicated when your customer needs to protect the displayed PDF from unauthorized copying. In this C# sample we discover key benefits and a security approach used in the ASP.NET PDF viewer built on GroupDocs.Viewer for .NET library. Read more.

GroupDocs.Viewer for .NET library: working with the Groupdocs.Web.UI.Viewer class

The Groupdocs.Web.UI.Viewer class contains a number of methods that allow you to set several crucial application-wide parameters for the GroupDocs.Viewer for .NET library. In particular, this is where you can set custom storage paths for your documents, cache and product license. Recently we’ve updated our documentation for the Groupdocs.Web.UI.Viewer class and are welcoming everyone who uses GroupDocs.Viewer for .NET to explore the guide.

Feedback
How Can We Help You?

Do you have ideas for what you'd like to see us do in 2015? Take a minute to tell us.

Product Releases And Updates

GroupDocs.Total for .NET: the latest versions of our .NET products packaged into one product suite.

 

GroupDocs.Total for Java: the latest versions of our Java products packaged into one product suite.

GroupDocs.Viewer for .NET 2.10.0: added the ability to select text when displaying documents in WinForms applications.

 

GroupDocs.Viewer for Java 2.9.0: added support for ICO, PSD, ODP, PPS and PPSX formats, implemented the ability to configure custom cache handler and storage path.

GroupDocs.Assembly for .NET 1.3.0: updated API to simplify data merge configuration; numerous minor improvements and optimizations.

 

GroupDocs.Annotation for Java 1.9.0: added the ability to configure custom colors for the Ruler tool; implemented several API improvements.

GroupDocs.Signature for .NET 1.9.0: implemented the ability to verify unique reference IDs applied to signed documents.

 

GroupDocs.Conversion for Java 1.1.0: added support for Microsoft Word bookmarks; two different document types can now be merged into a single PDF file.

GroupDocs.Comparison for .NET 2.3.2: minor improvements and bug fixes.

 

A Web-Based PDF Viewer Sample Built Using the GroupDocs.Viewer for Java Library

GroupDocs.Viewer for JavaGroupDocs.Viewer for Java is a multi-format document viewer library that allows developers to seamlessly enhance their Java applications with the capability to display over 50 document and image types. Designed based on the client-server architecture, GroupDocs.Viewer doesn’t transfer documents to client machines during view sessions. Instead, the library converts documents to web-compatible content, transfers it to clients and then renders in a web-browser. This client-server architecture provides you with the following benefits:

1. End users see only web copies of the shared documents, while original files stay on the server. Combined with the in-built Digital Rights Management feature, this allows you to share documents in a “read-only” mode. You have complete control over documents security and can easily prevent unauthorized content copying.

2. Since documents are converted to pure HTML, CSS and SVG or raster images, they can be rendered in any standard web-browser. You don’t have to worry about whether end-users have the software required to open and view a document.

3. There is no need to install and maintain any 3rd party software on the client side, which significantly reduces IT overhead.

Recently we’ve created a new Java PDF viewer sample built using the GroupDocs.Viewer for Java library and dropwizard framework. The sample allows you to quickly explore key features of the viewer and get an idea of how the viewer can be customized and integrated into your web-based Java app or website.

For more information on GroupDocs.Viewer for Java and supported file formats, please see its homepage, while the sample project along with its description can be found on the codeplex website.

Integrate GroupDocs.Annotation for .NET into Your GetSimple Website

GroupDocs.Annotation for .NET Library logoWe’re pleased to announce the release of a plugin that lets GetSimple developers and site owners to seamlessly integrate the GroupDocs.Annotation for .NET library into their websites. Once deployed, the library enables end users to view and collaboratively annotate 50+ types of documents and images straight on your website. To name a few, supported file formats include: PDF and Microsoft Word documents, Excel spreadsheets, PowerPoint presentations, CAD drawings and raster images (TIFF, JPEG, PNG, GIF and BMP).

How does GroupDocs.Annotation for .NET work?
The library converts documents to a web-compatible content (HTML/CSS + images) on the server and then renders it on your website within a document view widget along with an annotation toolbar. End users can view and annotate such embedded documents from any standard web-browser. You don’t have to worry about whether your users have the software required to open a document.

The same document can be annotated by several invited users simultaneously. Each user can add annotations, see others’ comments/markups and reply to them in real time. As a result, all involved parties can get a fast feedback on reviewed documents, discuss the necessary updates and get documents approved in a breeze.

GroupDocs.Annotation for .NET has been built from the ground up with security in mind. Original documents embedded to web-pages are not downloaded to user machines during view/annotation sessions, but stay on your server and behind your firewalls. End users only see web-copies of the shared documents. Although available by default, the copy, print and download options can be disabled for specific documents, so that they are shared in a “read-only” mode.

Currently we offer two deployment options: on-premises and SaaS. This new plugin integrates the downloadable .NET library that can be deployed on your own server and allows you to store and host documents locally. We also offer a plugin that integrates our cloud version of the GroupDocs.Annotation app. It doesn’t require any server-side installations, but documents need to be stored on our servers. We use Amazon EC2 servers to guarantee the security of the service.

For more details on the plugins, please visit the GetSimple marketplace:

For more details on the GroupDocs.Annotation for .NET library and to download a free evaluation copy, please visit its homepage.

C# Demo Project of an ASP.NET PDF Viewer Built Based on the GroupDocs.Viewer for .NET Library

ASP.NET PDF Viewer - C# Sample

Building a simple ASP.NET PDF viewer is quite a trivial task. There are tens of different open source projects across the web that offer a quick and free solution to display PDF documents in both ASP.NET MVC and Web Forms. Often a simple implementation of a PDF viewer is all you actually need. But things become a lot more complicated when the viewer needs to meet your customer’s business requirements. The most common are:

1. Security. This obvious business demand creates great challenges for developers when implementing a PDF viewer. Businesses demand uncompromised security for their confidential documents. You need to prevent any access to source PDFs from the client-side and limit or totally restrict viewers from being able to download, print or copy the shared PDF documents.

2. Cross-Platform Compatibility. Businesses require being able to share PDFs with customers, partners and team members without worrying about whether they have the software needed to open the documents. Hence, you need to be sure that end users can access and view the shared PDF documents from any web-enabled device and regardless of the browser used.

3. Usability. Finally, businesses want to have tools delivered by standard office software, such as Adobe Reader, to be able to seamlessly browse and collaborate on PDF documents from a web-browser.

If you’ve been looking for an ASP.NET PDF viewer that meets all the mentioned requirements, you may be interested to try out this C# demo which is built based on the GroupDocs.Viewer for .NET library. The demo helps you quickly setup, configure and explore key features and functionality of the out-of-the-box PDF viewer for ASP.NET.

Before proceeding, I’d like to clarify that the GroupDocs.Viewer for .NET is a commercial library and is not free or open source. The C# demo includes a free evaluation copy of the library that has several functional restrictions. However, I’d strongly encourage you to contact GroupDocs support for a free 30-day license to be able to test the ASP.NET PDF viewer without any restrictions.

So, here we go. First, let’s look into how the library works:

Back-End

GroupDocs.Viewer for .NET is a downloadable library (DLL) that allows you to display different types of documents (including PDF) on the web. What makes it stand out from other web-based PDF viewers is its client-server (or “thin client”) architecture.

Unlike client-based viewers, GroupDocs.Viewer for .NET doesn’t download source PDFs to end user machines. Instead, the library converts original documents stored on the server into a set of HTML markup, CSS and images. Once converted, a web-compatible copy of the PDF document is streamed to clients and rendered in web-browsers just like a regular web-page. Web copies look exactly like the original PDFs. Layouts are retained and fonts are sharp.

Such “thin client” architecture allows you to build an ASP.NET PDF viewer that meets both of the two core business requirements – security and cross-platform compatibility. End users can view PDF documents using a standard web-browser and without having to install Adobe Reader, Flash or any other plugins. For sure, PDF documents can be properly displayed in Chrome, Mozilla Firefox, Safari5+, Opera and, what is important, in commonly used by large organizations – Internet Explorer 8+.

The original PDF files are not downloaded to user machines during view sessions, but stay secure on your server and behind your firewalls. Combined with the in-built Digital Rights Management (DRM) features, this allows businesses to share PDF documents in a “read-only” mode. DRM controls all document copy options available in a web-browser, including downloading, printing and text copy/pasting. It allows users to decide on their own which PDFs to share in the “read-only” mode and which – with full access rights.

When displaying PDF documents in a web-browser there is another potential security flaw, called “Print Screen”. This is where even DRM won’t help. To deal with the issue, we’ve implemented a capability to add watermarks over the displayed PDF documents. The watermarks are only rendered as a separate layer on top of the displayed documents, so that your original PDFs are not altered.

Now, what about usability?

Front-End

GroupDocs.Viewer for .NET comes with an out-of-the-box GUI which can be seamlessly white-labeled and integrated into any ASP.NET site. The GUI provides end users with tools needed for convenient viewing and navigation of PDF documents in a browser. Our sample PDF viewer for ASP.NET provides all the most commonly used UI controls available in native Adobe Reader’s plugin, including:

  • Scroll view, one page in a row, two pages in a row view, double page flipping
  • Page rotation and zooming
  • Page thumbnails
  • Text selection and copying to the clipboard
  • Text search with different match types
  • Document downloading and printing

The GUI can be seamlessly customized and embedded straight to your ASP.NET site. Alternatively, you can build your own GUI from scratch to meet your customer’s requirements.

But enough with words – let’s take a look how this works. Below is an example of how your ASP.NET PDF viewer built based on the GroupDocs.Viewer for .NET library may look:

Requirements

  • Being a “thin client” solution, GroupDocs.Viewer for .NET doesn’t require any downloads or installations on the client side. End users can view PDF documents from any standard web-browser, including IE8+, Mozilla Firefox, Chrome, Opera, Safari5+ and their mobile versions.
  • To deploy and properly configure the sample on the server, you will need a .NET Framework version 4.0+ and a “.NET-compatible” web-server: IIS, IIS Express or ASP.NET Development Server (Cassini).
  • The viewer works with both ASP.NET Web Forms and ASP.NET MVC version 3+ frameworks.

Running the Sample

To help you setup and run the ASP.NET PDF viewer quickly, we’ve prepared a quick start guide. Please refer to this page for further instructions, as well as to download the C# demo itself.

For more details on the GroupDocs.Viewer for .NET library and the list of all supported file formats, please go to the products homepage.

GroupDocs Customer Newsletter – March 2015

GroupDocs logo Monthly Newsletter
March, 2015

GroupDocs.Viewer: Burn in Watermarks to Protect the Documents You Share

Not a long time ago, we’ve implemented an ability to share documents in a PDF format. When enabled, viewers can download only a PDF copy of your original document. Today, we’re pleased to announce an enhancement to this feature.

Starting from version 2.8.0, you can set GroupDocs.Viewer for .NET to burn in custom watermarks to PDF copies of shared documents, while your original documents stored on the server stay intact.

Find Out More >>>

Product News
New and Coming Soon to GroupDocs.Signature for .NET

In the latest release we've implemented a capability of verifying unique reference IDs applied to signed documents. This allows you to control whether a document was actually signed using the GroupDocs.Signature interface / library, or via some other application or tool. Here is how this works:

1. A unique reference ID is generated automatically upon signing a document. The ID is burned into the signed document as metadata and also streamed to your server using the sign method, so that you can save it.

2. Once you receive a signed document, you can verify whether the document was signed using the GroupDocs.Signature interface by checking your saved reference IDs with one in the document’s metadata.

As you may already know, GroupDocs.Signature can be used either programmatically, as a document e-signature engine, or in conjunction with an out-of-the-box UI that comes with the library. In case you use it as a pure engine, the reference ID is returned by the sign method. And when using the library along with the in-built UI, the reference ID is also saved to a database for the corresponding document. Grab the latest GroupDocs.Signature for .NET release from here.

New and Coming Soon to GroupDocs.Conversion for .NET

In this months release we've added resize functionality for document page images, when the input is from a file or an input stream. Also we've added new Image Save Options to allow users to define the output image resolution, and new Html Conversion Options which give users 2 different rendering engine options when converting HTML files to other file formats. Grab the latest GroupDocs.Conversion for .NET release from here.

From The Library
GroupDocs.Viewer for .NET Library Version 2.8.0 – Discover New Features and Enhancements in this Release

This month we've implemented several new useful features in the GroupDocs.Viewer for .NET libary, including: faster and smoother page scrolling when viewing large documents (>100 pages); Italian localization support and new document page layouts, optimized for books - learn more.

Improved API and New Features in the GroupDocs.Viewer for Java Library Version 2.7.0

In this release, we've updated the InputDataHandler interface which makes the process of handling documents from custom storage sources a breeze. We've also added the ability to rotate document pages in the image-based rendering mode. A detailed description for all new features implemented in this release along with download URLs for the latest sample projects can be found here.

Feedback
How Can We Help You?

Do you have ideas for what you'd like to see us do in 2015? Take a minute to tell us.

Product Releases And Updates
GroupDocs.Total for .NET – The latest versions of our .NET products packaged into one product suite. GroupDocs.Total for Java – The latest versions of our Java products packaged into one product suite.
GroupDocs.Viewer for .NET 2.8.0 - Intellisense XML documentation, new double page layout, Italian localization, improved scrolling for large documents, improved printing of PDF's. GroupDocs.Annotation for Java 1.8.2 - Search improvements, along with numerous small updates and bug fixes.
GroupDocs.Conversion for .NET 1.8.0 - Resize document page images, job progress notifications, image conversion resolution options, security enhancements and more.  

GroupDocs.Viewer for .NET Library Version 2.8.0 – New Page Layout, Smoother Scrolling and Enhanced Document Sharing Security

GroupDocs.Viewer for .NETRecently we’ve updated our GroupDocs.Viewer for .NET library up to the version 2.8.0. In this post I’d like to discover some of the most remarkable updates implemented in this latest version:

New Page Layout Options

So far, when viewing documents, you had the following page layout options:

  • Scroll view – pages are placed in a continuous chain, one after another.
  • One page in a row – one page fit to client’s screen. No page turn animation.
  • Double page flip – two adjacent pages fit to client’s screen, plus flipping page animation (available in the image-based rendering mode only).

Starting with this new version, you have a choice between two more options:

  • Two pages in a row - two adjacent pages fit to client’s screen. No flipping page animation. This layout is available in both the images-based and the HTML-based rendering modes. This layout is especially useful when viewing documents on a widescreen display, as it allows users to cover unused screen space appearing when viewing documents with the scroll view or one page in a row layout.
  • One more layout added in this release is actually a modification of the above one – a cover and then two pages in a row. This is useful when reading books, as the cover page can be placed apart from the subsequent adjacent pages.

All the options can be configured by end users on their own, straight from the viewer’s GUI. You can also set a default layout using the Layout method from the GroupDocs.Viewer widget. This method accepts a Groupdocs.Web.UI.ViewerMode enumeration, which has the following values: ScrollView, DoublePageFlip, OnePageInRow, TwoPagesInRow, CoverThenTwoPagesInRow.

Italian Localization

The geography of clients using the viewer grows rapidly. This time we have good news for our customers from Italy – an Italian GUI localization has been finally added in this build. The following are all GUI localizations currently available:

  • ar-AE - Arabic (U.A.E.)
  • en-US - American English, the default
  • es-ES - Spanish
  • it-IT - Italian (Standard)
  • nb-NO - Norwegian
  • pl-PL - Polish
  • pt-PT - Portuguese
  • ru-RU – Russian

The default localization is en-US. You can change it to any other from the list above by using the Locale method from the GroupDocs.Viewer widget. There are two overloads of this method: the first one accepts the needed locale as a string code, while the second one accepts an enumeration value. They are completely equal, so you can use any of them.

Virtual Scrolling

The new virtual scrolling feature improves page scrolling speed in client browsers. This is useful when displaying large documents of more than 1k pages. When enabled, the viewer streams to the DOM tree only the pages that are currently visible in the browser. New pages are added to the DOM only when the document is actually scrolled to those exact pages. This way, instead of rendering all document pages, the viewer needs to handle only a few pages at a time.

An accompanying effect of this feature is the ability to get rid of the "Script hanging" message, which occasionally appears when opening or closing large documents (>1k pages). The message was caused by the JavaScript code used to render wrappers for each individual page within a document, or when deleting the wrappers upon switching to another document.

To enable the virtual scrolling feature, you should apply the true Boolean value for the UseVirtualScrolling method in the GroupDocs.Viewer widget. When set to false, the virtual scrolling feature is off.

Faster Word Documents Rendering

A new parameter has been added – embedImagesIntoHtmlForWordFiles – to the UseHtmlBasedEngine method. When set to true, it forces the viewer to convert documents to HTML with SVG or raster images embedded straight into the HTML markup as Base64. Otherwise, images are stored as external files. Embedding images into the HTML markup significantly increases browsers’ rendering speed of Word documents that have a lot of images in them. Naturally, this parameter is available only in the HTML-based rendering mode.

Share Documents with Watermarks

Now you can let viewers to print or download a PDF copy of the original documents you share, along with watermarks burned in. This is useful when you want to prevent users from copying your content, while still need to share it with others. When enabled, viewers can print or download only a PDF copy of your original document with your custom watermarks in them. While viewers get a PDF copy with watermarks, your original documents stored on the server stay intact.

In order to enable this feature, you should apply watermarks, using the Watermark method from the GroupDocs.Viewer widget, and set the true value for the last parameter - printWithWatermark. Please note that this feature is disabled by default! You need to set it explicitly.

Other Enhancements

  • Added an XML documentation file (called Groupdocs.Viewer.XML) into installers to enable IntelliSense in Visual Studio.
  • A new SupportListOfContentControls option added. It allows you to display content controls with their headers, similar to what Microsoft Word does. Currently this option is available only in the HTML-based rendering mode.
  • Numerous code optimizations and bug fixes.

The new version of the GroupDocs.Viewer for .NET library is already available in our files archive, so you are welcome to download it, test it and report any issues or suggestions in our forum.


Back to top