How to edit the TIFF Viewer Chrome/Edge extension configuration XML file

The TIFF Viewer Chrome / Edge web browser extension configuration XML file can be edited with any text editor, such as Notepad.

In the configuration XML file, one will see Icons, Styles and DefaultSettings sections.

Under Icons, one can hide and show icons on the extension user interface. An icon usually has the following attributes in the configuration XML file:

(The yellow values can be changed)

·         The Name attribute contains the descriptive name of the icon. The Name is also displayed as tooltip on the user interface of the extension.

·         The ID contains an identifier for the icon. Do not change the ID attribute.

·         The Visible attribute defines if the icon should be visible or not.

If the Visible attribute is true, then the icon will be visible.

If the Visible attribute is false, then the icon will not be visible.

Under Styles, one can customize colors on the extension user interface. A style usually has the following attributes in the configuration XML file:

(The yellow values can be changed)

·         The Description attribute contains the descriptive name of the style.

·         The ID contains an identifier for the style. Do not change the ID attribute.

·         The Value attribute defines the HTML Color Code of the style. 

Under DefaultSettings, one can customize the default behavior of the extension. A Setting usually has the following attributes in the configuration XML file:

(The yellow values can be changed)

·         The Description attribute contains the descriptive name of the setting. This helps users to understand the setting.

·         The ID contains an identifier for the setting. Do not change the ID attribute.

·         The Enabled attribute defines if the setting/feature will be enabled or disabled by default.

If the Enabled attribute is true, then the feature will be enabled by default.

If the Enabled attribute is false, then the feature will be disabled by default.

The DefaultSettings section has the following features to configure:

[ThumbnailViewMode]

Activates the Thumbnail View Mode when opening a TFF file automatically. Thumbnail View Mode allows users to navigate between pages faster.

By default, the [ThumbnailViewMode] is disabled/False.

[DisplayFooterAndCopyright]

Hides the Footer on the extension user interface. This option helps customers to maximize the view area by hiding the footer.

By default, the [DisplayFooterAndCopyright] is disabled/False.

[LogEnabled]

Enables logging in the extension. This option can help collecting information for troubleshooting occurring issues.

By default, the [LogEnabled] is disabled/False.

[DeleteDownloadedFilesAfterOpen]

In order to open TIFF files, the TIFF Viewer extension lets the browser to download the TIFF file. By default, the files used by the extension are downloaded into the following directory:

c:\Users\<<USERNAME>>\Downloads\tv_extension\

If this option is set to true, the TIFF Viewer extension will delete the downloaded file immodestly from the computer, once the file has been opened in the TIFF Viewer extension.

By default, the [DeleteDownloadedFilesAfterOpen] is enabled/True.

[ForceNewTab]

If the ForceNewTab option is enabled, then the extension will open each file in a new browser tab automatically. This option can be useful for document management systems, where users has to browse and open multiple documents.

By default, the [ForceNewTab] is disabled/False.

[OpenPDF]

Enables opening PDF files in the TIFF Viewer extension, instead of the Chrome / Edge built-in PDF viewer.

By default, the [OpenPDF] is enabled/True.

[FlattenPDF]

Flatten the PDF documents when opening it in the extension. This option is useful to prevent editing/filling interactive PDF forms.

By default, the [FlattenPDF] is disabled/False.

[EnablePDFJavaScript]

Enables the JavaScript support in PDF documents. In most cases, JavaScript in PDF documents is used for validating interactive forms.

By default, the [EnablePDFJavaScript] is enabled/True.

[OpenZIP]

Enables opening TIFF and PDF documents from ZIP archives. If the user downloads a ZIP document, the extension will examine the files within the archive based on their extension and will extract and open the TIFF and PDF files on a new browser tab.

The extension will identify ZIP archives if the MIME Type is one of the following: application/zip, application/x-zip-compressed.

By default, this option is disabled/False.

[OverwriteOnExtractZIP]

Enables overwriting existing files when extracting TIFF and PDF files from ZIP archives.

By default, this option is disabled/False.

[OpenMODCA]

Enables opening IOCA and MO:DCA files.

The extension will identify IOCA, MO:DCA files if the MIME Type is image/x-ioca.

By default, this option is disabled/False.

[OpenAFP]

Enables opening “application/afp” files in the TIFF Viewer Browser Extension.

By default, this option is disabled/False.

[ForceDefaultSettings]

If this option is enabled, the extension will force the Default Settings (The settings, located in the TIFF Viewer Installation directory) for every user. This feature is useful for Administrators to prevent users from changing any settings in the Edge/Chrome extension.

By default, the default settings are located in the following file:

<<TIFF Viewer Installation directory>>\nativeChromeHost\BITV_Extension_config.xml

By default, this option is disabled/False.

[EnableJpegCompression]

If this option is enabled, the extension will open the documents in lossy JPEG compression, instead of lossless PNG compression. This option is recommended for opening very large documents, as it can significantly decrease memory usage. Please also see the JpegQuality setting on this page, for also decreasing the JPEG quality.

By default, this option is disabled/False.

[EnablePrintOutScaling]

If this option is enabled, the browser extension will proportionally scale down / resize the printout if the printed content is larger than the page size of the destination printer.

If this option is disabled, no scaling / resizing will be applied to the printout.

By default, this option is disabled/False.

[SaveViewModeAutomatically]

If this option is enabled, the Extension will automatically Save the last used selected View Mode.

By default, this option is enabled/True.

[EnableEnhancedPDFSelection]

If this option is enabled, the Extension will use an enhanced selection mode for PDF documents, allowing users to select text easily with a rubber band selection.

By default, this option is enabled/True.

[RememberPositionAndSize]

If this option is enabled, the Extension will always open the new window in the same position and size, as the previous one.

By default, this option is disabled/False.

[EnableHQThumbnails]

If this option is enabled, the Extension will display high-quality thumbnails when opening multipage documents. This feature is useful if you would like to navigate between pages by looking at the thumbnails.

Please note that high-quality thumbnails consume more system resources. If you opening very large documents, or experience performance issues, please try to disable this feature.

By default, this option is enabled/True.

[ShowAnnotationTutorial]

If this option is enabled, the Extension will show an Annotation Tutorial when you place an annotation to the document. Users are allowed to close the tutorial, which will no longer shown for the given users.

By default, this option is enabled/True.

[HamburgerMenu]

Turns the toolbar into a Hamburger Menu below 670 pixels width. This feature is useful for embedding the Extension in an IFRAME or using the Extension on a low-resolution display.

By default, this option is disabled/False.

[AutoFlattenPDFSave]

If this option is enabled, the Extension will flatten (burn-in) annotations and interactive forms automatically when saving PDF files.

By default, this option is disabled/False.

[OpenFilesWithoutDownload]

If this feature is enabled, the Extension will attempt to open supported documents from XHR (XMLHttpRequest) responses, even if the file is not downloaded. This feature can be useful in opening documents in the Extension without downloading.

By default, this option is enabled/True.

Under JpegQuality, one can customize the quality of the pages when opening documents and using the EnableJpegCompression option. The lower the JpegQuality is, the less memory will be used for opening documents.

CAUTION: JPEG is a lossy compression, which means the quality of the document will decrease if you re-save the document with EnableJpegCompression.

The JpegQuality usually has the following attributes in the configuration XML file:

(The yellow values can be changed)

Under ProxyAuthentication, one can customize the default proxy username and password used on the computer. A proxy authentication usually has the following attributes in the configuration XML file:

(The yellow values can be changed)

·         The Username is the username for the proxy server.

·         The Password is the password for the specified username.

NOTE: If a proxy server is configured on the computer, the TIFF Viewer extension will use the proxy automatically. If the proxy requires no authentication, then the Username/Password in the ProxyAuthentication area is not has to be specified.

Once finished modifying the configuration XML file, save the file and refresh the extension in the browser to apply the changes.

Under ViewMode, one can customize the view mode when the extension starts. The ViewMode usually has the following attributes in the configuration XML file:

(The yellow values can be changed)

The Mode can have the following values:

0: Zoom Percentage

1: Actual Size

2: Fit to Width

3: Fit to Height

4: Auto Size (default)

Under Zoom, one can customize the default zoom percentage when the extension starts. Only takes effect if the ViewMode is 0. The Zoom usually has the following attributes in the configuration XML file:

(The yellow values can be changed)

Under IframeID, one can customize ID attribute of the iframe HTML element where the extension should be loaded into. The IframeID usually has the following attributes in the configuration XML file: