Manual:$wgCustomConvertCommand

The printable version is no longer supported and may have rendering errors. Please update your browser bookmarks and please use the default browser print function instead.

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

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 .