Skip to the content
Documentation
Help Start
Reading in:
  • German: 9,059 of 9,059 pages
About the help in other languages
All help pages

image.ini [MIMETypeSettings]

The settings of [MIMETypeSettings] in image.ini: OverrideList, Quality, ConversionRules

Download as PDF

Address: https://doc.exponential.earth/exphelp/viewer/examples/ini-settings/image/MIMETypeSettings.md

On this page

image.ini [MIMETypeSettings]

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

According to the RSS 1.0 / RSS 2.0 specification:
maximum value for width is 144, default value is 88,
maximum value for height is 400, default value is 31.
Optional image alias used in rss feed items if you specify image
attribute as source for description tag, 'rss' is used instead if disabled

[rssitem]
Reference=reference
Filters[]=geometry/scaledownonly=128;128
An example alias which converts the image to grayscale

[gray]
Reference=large
Filters[]
Filters[]=colorspace/gray
An example alias which crops the image to specific size
and adds a border.

[zoom]
Reference=reference
Filters[]
Filters[]=geometry/crop=200;200;155;155
Filters[]=border/color=0;0;0
Filters[]=border=4;4

-------- Image MIME type settings --------

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

OverrideList

A list of settings which override certain MIME types
The overrides can define allowed and disallowed filters
as well as extra filters.l

Default: a list of 2: AnimatedGIF, LayeredPhotoshop.

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

Quality

A list of mimetypes and their image quality value
The value varies from mime type to mime type.
Set JPEG quality from 0 (worst quality, smallest file) to 100 (best quality, biggest file)

Default: a list of 1: image/jpeg;75.

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

ConversionRules

The global conversion rules
Most will be converted to jpeg except gif and xpms

Default: a list of 4: image/webp;image/png, image/gif;image/png, image/x-xpixmap;image/png, *;image/jpeg.

<?php /* #?ini charset="utf-8"?
# settings/override/image.ini.append.php
[MIMETypeSettings]
# an empty "ConversionRules[]" first replaces the shipped list; without it the items are added
ConversionRules[]
ConversionRules[]=image/webp;image/png
ConversionRules[]=image/gif;image/png
ConversionRules[]=image/x-xpixmap;image/png
ConversionRules[]=*;image/jpeg
*/ ?>

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.

Something wrong on this page? Report an error

Documentation license

This documentation is free documentation, licensed under the GNU Free Documentation License 1.3 or later.

Exponential Copyright © 1998-2026 Exponential Foundation and 7x