Manual:$wgCustomConvertCommand

Images: $wgCustomConvertCommand
Use another resizing converter, e.g. GraphicMagick.
Introduced in version:	1.6.0 (r13244)
Removed in version:	Still in use
Allowed values:	(string) or false
Default value:	false
Other settings: Alphabetical | By function

Details

To use another resizing converter, e.g. GraphicMagick, set this variable to the command-line string required to launch the executable. If no string is specified, then MediaWiki's internal resizing code will be used.

In the command-line string, the following variables will be expanded:

• %s will be replaced with the source path
• %d will be replaced with the destination
• %w will be replaced with the width
• %h will be replaced with the height

This setting is overridden by $wgUseImageMagick . If your custom converter is not being invoked, check that $wgUseImageMagick is not set to true.

Examples

This is the command you would set for GraphicMagick:

$wgCustomConvertCommand = "gm convert %s -resize %wx%h %d";

This is the command you would set for using ImageMagick to overlay your files in tiles with e.g. a watermark file:

$wgCustomConvertCommand = "/usr/bin/convert %s | /usr/bin/composite -tile /path/to/file/watermark.png %s -resize %wx%h %d";

Bitmaps vs. SVG

$wgCustomConvertCommand is only used for Bitmaps. If you're looking for an alternative to ImageMagick to convert your SVG files, you need to use $wgSVGConverter .