image.ini [reference] #

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

AliasList[]=rssitem
AliasList[]=gray
AliasList[]=zoom
Example of an image alias, the group is called the same as the alias name
[myalias]

Tells the system to use the original alias as reference image. The reference
image is the base of conversion and filtering. original is the default and
can be omitted
Reference=reference

The MIME type of the output image. Can be specified if you want a specific
format for the alias, if not skip it and let the image system decide.
A useful application for this is screenshots, normally you don't want
to use image/jpeg for screenshot but rather image/png or image/gif.
MIMEType=image/png

Override quality by MIME type for this alias only
This follows the pattern from the global [MIMETypeSettings] settings
Quality[]
Quality[]=image/jpeg;80

A list of filters to run, each filter must be supported by the active image converters
Filters[]=geometry/scale=300;300
reference, small, medium and large for backwards compatability
You can for instance remove the reference if don't want the extra disk usage
By defining the 'original' alias and setting some filters
or changing the MIME type you can even force a conversion of
the originally uploaded image.
This is useful to save space or make sure the image is in a specific format
[original]
Filters[]
Filters[]=colorspace/gray
[original]
Filters[]
Filters[]=filter/swirl=210

MIMEType=image/png #

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

Filters #

Default: a list of 1: geometry/scaledownonly=600;600.

<?php /* #?ini charset="utf-8"?
# settings/override/image.ini.append.php
[reference]
# an empty "Filters[]" first replaces the shipped list; without it the items are added
Filters[]
Filters[]=geometry/scaledownonly=600;600
*/ ?>

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.