image.ini [ImageConverterSettings] #

The block [ImageConverterSettings] of settings/image.ini, with 2 setting(s).

Never edit settings/image.ini itself: an update replaces it. Put the settings you change in an override, which wins over the shipped file:

• settings/override/image.ini.append.php for every siteaccess,
• settings/siteaccess/<siteaccess>/image.ini.append.php for one siteaccess,
• extension/<extension>/settings/image.ini.append.php in an extension (read when the extension is active).

ImageConverters #

List of converters to use, each entry is the name of the converter
which is defined in a ini block.
You can use ImageMagick and GD handlers by default.
The order of the convertes are important since the first
applicable converter will be used. The last handler is
usually a fallback converter which can take care of most formats.

GD comes first: it is the image extension built into PHP, so it
converts in process, without starting an external program for
every image, and needs nothing installed beside PHP. It reads and
writes JPEG, PNG, GIF and WBMP and supports every geometry filter
the default aliases use.
ImageMagick stays in the list as the fallback. It is used for the
formats GD cannot read (for example PSD, TIFF, PDF or WebP) and for
the filters only it supports (for example flatten, resize,
filter/swirl or filter/noise), and it takes over completely when the
GD extension is missing or [GD] IsEnabled=false.
To prefer ImageMagick again, override the list in
settings/override/image.ini.append.php:
ImageConverters[]
ImageConverters[]=ImageMagick
ImageConverters[]=GD
The list can also contain converters which cannot work
on the installed server, the converter should check this
and tell the image system to not use it.

For any other converter make sure you have a INI section
with the same name as your converter's

For example :
ImageConverters[]=MyCustomConverter
[MyCustomConverter]
with the same INI variables as GD or ImageMagick INI sections

Default: a list of 2: GD, ImageMagick.

<?php /* #?ini charset="utf-8"?
# settings/override/image.ini.append.php
[ImageConverterSettings]
# an empty "ImageConverters[]" first replaces the shipped list; without it the items are added
ImageConverters[]
ImageConverters[]=GD
ImageConverters[]=ImageMagick
*/ ?>

LockTimeout #

Waiting time for processes in queue to get an exclusive writing lock
for writing a specific image alias.

If a process spends longer than this time waiting, the process holding the lock
will be ended, and the waiting process will continue, generating the image alias.

Default: 60.

<?php /* #?ini charset="utf-8"?
# settings/override/image.ini.append.php
[ImageConverterSettings]
LockTimeout=60
*/ ?>

Related #

• All blocks of image.ini
• All INI files
• The settings page

Generated by ./console exp:help:examples from settings/image.ini. Do not edit this page: change the source and generate again (how). Free documentation: GFDL 1.3 or later.