"sphinx.ext.imgconverter" -- A reference image converter using Imagemagick
**************************************************************************

New in version 1.6.

This extension converts images in your document to appropriate format
for builders.  For example, it allows you to use SVG images with LaTeX
builder. As a result, you don't mind what image format the builder
supports.

By default the extension uses ImageMagick to perform conversions, and
will not work if ImageMagick is not installed.

Note:

  ImageMagick rasterizes a SVG image on conversion.  As a result, the
  image becomes not scalable.  To avoid that, please use other image
  converters like sphinxcontrib-svg2pdfconverter (which uses Inkscape
  or "rsvg-convert").


Configuration
=============

image_converter

   A path to a conversion command.  By default, the imgconverter finds
   the command from search paths.

   On Unix platforms, the command **convert** is used by default.

   On Windows, the command **magick** is used by default.

   Changed in version 3.1: Use **magick** command by default on
   windows

image_converter_args

   Additional command-line arguments to give to **convert**, as a
   list. The default is an empty list "[]".

   On Windows, it defaults to "["convert"]".

   Changed in version 3.1: Use "["convert"]" by default on Windows
