Extension:PagedTiffHandler/pl

The PagedTiffHandler extension allows to upload and display tiff-files into your wiki. It can handle multi-paged images and render them into thumbnails on per page basis.

Usage
You can embed images using standard image syntax. Additionally, there are two new parameters:

Required
Type the following in your shell to see if you have the above installed first:

Required (optionally)
For additional performance on very large TIFF files, you might want to install and configure Extension:VipsScaler.

Type the following in your shell to see if you have the above installed first:

Configuration
PagedTiffHandler depends on various external programs in order to process Tiff images.


 * ImageMagick is used to reject/accept the image and render thumbail images. This is mandatory, PagedTiffHandler will not work without ImageMagick.
 * tiffinfo can be used to reject/accept the image instead of ImageMagick, but it does not provide rendering (optional).
 * Exiv2 is used to extract image metadata (optional).
 * Extension:VipsScaler can be used for fast processing of large image files (optional).

Example configuration:

When thumbnailing very large images to very small sizes, it can be better better to downscale to an intermediary size first, instead of resizing in one go. By default PagedTiffHandler will downsize images larger than $wgTiffIntermediaryScaleStep (2048 pixels wide by default) first to $wgTiffIntermediaryScaleStep before downsizing to even smaller dimensions.

Example configuration:

PagedTiffHandler rejects images based on error messages of ImageMagick or tiffinfo. There are three options:


 * Images are rejected if the error message matches $wgTiffIdentifyRejectMessages or $wgTiffTiffinfoRejectMessages
 * Images are accepted without moaning if the error message matches $wgTiffIdentifyBypassMessages or $wgTiffTiffinfoBypassMessages
 * In other cases, images are accepted but the error message is recorded in the image metadata.

Example configuration (all of the parameters show the default configuration):

PagedTiffHandler also checks a few parameters of the image in order to be able to control the necessary processing time.

Example configuration:

When thumbnailing fails for an image, PagedTiffHandler will not try again to render this image for some time. The setting below controls after how many seconds thumbnailing may be tried again.

Example configuration:

All of the above shown parameters are set as default in the configuration of the extension.
 * Defaults