Extension:ZoomableImages

From MediaWiki.org
Jump to navigation Jump to search
MediaWiki extensions manual
Crystal Clear action run.svg
ZoomableImages
Release status: experimental
Zoomable images - Libre Pathology.gif
Implementation Tag
Description Allows zoomable images using the OpenSeadragon viewer
Author(s) Michael Bonert (Nephrontalk)
Latest version 0.17 (2016-11-05)
MediaWiki 1.27+
Database changes No
License GNU General Public License 2.0 or later
Download
Translate the ZoomableImages extension if it is available at translatewiki.net
Check usage and version matrix.

The ZoomableImages extension allows use of zoomable images using the OpenSeadragon viewer.

Installation[edit]

Zoomable images reside in the directory: $IP/images/zimages/

OpenSeadragon can be download here: https://openseadragon.github.io/#download

The OpenSeadragon files have to be in a directory called openseadragon that resides in the ZoomableImages directory; the location of the script openseadragon.min.js has to be: $IP/extensions/ZoomableImages/openseadragon/openseadragon.min.js

Configuration[edit]

To install this extension, add the following to LocalSettings.php:

require_once "$IP/extensions/ZoomableImages/ZoomableImages.php";

Usage[edit]

To add a zoomable image to your MediaWiki installation add the following:

<zoomableimage name="zimage.dzi"/>

Options[edit]

The width and height can be specified:

<zoomableimage name="zimage.dzi" width=800 height=600/>

A viewport can be added:

<zoomableimage name="zimage.dzi" viewport='true'/>

The image can be rotated an arbitrary amount:

<zoomableimage name="zimage.dzi" initrotate=25/>

Image rotation controls can be displayed:

<zoomableimage name="zimage.dzi" showrotctrls='true'/>

See also[edit]

External links[edit]