Jump to content

Manual:$wgCustomConvertCommand

From mediawiki.org
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

Details

[edit]

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

[edit]

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

[edit]

$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 .