Extension:VipsScaler

MediaWiki extensions manual

VipsScaler Release status: beta
Implementation	Media
Description	Allows to scale PNG and JPEG images using VIPS
Author(s)	Bryan Tong Minh (Bryantalk)
MediaWiki	1.19+
Database changes	No
License	MIT
Download	Download snapshot (Git master) Git [?]: repo summary browse file tree commit history README
Parameters $wgVipsCommand $wgVipsOptions
Added rights vipsscaler-test
Hooks used BitmapHandlerTransform BitmapHandlerCheckImageArea
Translate the VipsScaler extension if it is available at translatewiki.net
Check usage and version matrix; code metrics
Bugs: list open list all report

The VipsScaler extension is a wrapper around VIPS, a free image processing software. VIPS is a set of image manipulation tools specially designed for speed and low memory usage. This is useful for resizing large PNGs, and it improves the appearance of shrunken JPEGs.

The extension shells out to the vips binary. It can be configured to scale only certain files (for example: big PNGs) by configuring $wgVipsConditions.

VIPS installation

Install VIPS. It can be downloaded from http://www.vips.ecs.soton.ac.uk/.

After downloading VipsScaler, add it to your extensions/ directory, then add require_once("$IP/extensions/VipsScaler/VipsScaler.php"); If you'd like to add the Special:VipsTest test page, also add require_once("$IP/extensions/VipsScaler/VipsTest.php");

Debian / Ubuntu

$ apt-get install libvips-tools

If you want to build from source have a look at upstream documentation: http://www.vips.ecs.soton.ac.uk/index.php?title=Build_on_Ubuntu

(Wikimedia has packaged and uses a more recent version for Ubuntu 12.04 at apt.wikimedia.org)

Mac OS X

homebrew

brew install homebrew/science/vips

binary symlink is /usr/local/bin/vips

Configuration

$wgVipsCommand : path to the vips command (default: vips).

$wgVipsOptions : scaler conditions, to be documented.