image.ini

Written by Balazs Halasy, 02/23/2005 Updated 11/05/2026 by Graham Brookins Maintainers: Frederik Holljen, Ester Heylen

[AliasSettings]

Setting	Summary
AliasList	Sets the list of aliases.

[AnalyzerSettings]

Setting	Summary
AnalyzerMIMEList	Sets formats which need extra analysis.
ExtensionList	Sets the extensions which have analyzers.
ImageAnalyzerAlias	Lists aliases for the analyzer
ImageAnalyzers	Lists the active analyzers
RepositoryList	Sets where to look for analyzers.

[AnimatedGIF]

Setting	Summary
AllowedFilters	Sets the allowed filters.
DisallowedFilters	Sets the filters that are not allowed.
ExtraFilters	Lists the extra filters.
Match	Lists the matches needed to use this override.
MIMEType	Sets this overrides MIME Type.
OverrideMIMEType	Sets the override MIME type.

[EXIFAnalyzer]

Setting	Summary
Handler	Sets the handler to use
MIMEList	Lists the MIME types

[FileSettings]

Setting	Summary
DirPermissions	Sets the access permissions for the new image directories.
ImagePermissions	Sets the access permissions for the new images.
PublishedImages	Sets which sub-directory to use for published images.
TemporaryDir	Sets which sub-directory to use for temporary image files.
VersionedImages	Sets which sub-directory to use for unpublished images.

[GDSettings]

Setting	Summary
HasGD2	If GD2 is installed, this setting can allow your system to use the GD2's advanced functionality.

[GD]

Setting	Summary
Filters	Lists the filters to be used by the GD image converter.
Handler	Sets the PHP Handler to use.
IsEnabled	Sets if this Handler should be used.
Name	Sets the name of the converter.

[GIFAnalyzer]

Setting	Summary
Handler	Sets the handler to use.
MIMEList	Lists the MIME types.

[gray]

Setting	Summary
Filters	Lists the filters for the "gray" alias.
Reference	This setting will tell the system which alias to use as reference image for "gray" images.

[ImageConverterSettings]

Setting	Summary
ImageConverters	Lists the converters to use.

[ImageMagick]

Setting	Summary
Executable	Sets the name of the executable
ExecutablePath	Sets the path to the executable.
Executable{OS}	Sets the executable that must be used for a specific operating system.
Filters	Sets the filters supported by ImageMagick.
FrameRangeParameters	Set frame range parameters to handle PSD files with ImageMagick.
Handler	Sets the PHP Handler that needs to be used.
InputMIMEList	List the Input MIME types
IsEnabled	Sets if the handler set in this configuration group should be used.
MIMETagMap	Sets the MIME type tag.
Name	Sets the name of the converter.
OutputMIMEList	MIME types that the converter can generate
PostParameters	List the parameters that must be run last.
PreParameters	List the parameters that must be run first.
QualityParameters	Sets the quality parameters of MIME Type
UseTypeTag	Sets whether the destination name should be prefixed with a TAG name.

[large]

Setting	Summary
Filters	Lists the filters to be used for the "large" alias.
Reference	This setting will tell the system which alias to use as reference image for "large" images.

[LayeredPhotoshop]

Setting	Summary
ExtraFilters	Sets the extra filters.
MIMEType	Lists the MIME types.

[medium]

Setting	Summary
Filters	Lists the filters to be used for the "medium" alias.
Reference	This setting will tell the system which alias to use as reference image for "medium" images

[MIMETypeSettings]

Setting	Summary
ConversionRules	Sets the global conversion rules for formats that are not listed in [OutputSettings] AllowedOutputFormats.
OverrideList	Sets the override settings for MIME types.
Quality	Sets the image quality value.

[MyCustomConverter]

Setting	Summary
ExtensionList	DEPRECATED (not needed or supported in 4.1 for autoload based handler loading)
ImageConverters	Lists the converters to use.
ImageHandlerAlias	DEPRECATED (not needed/supported in 4.1 for autoload based handler loading)
LockTimeout	Sets the time lockout.
RepositoryList	DEPRECATED (not needed or supported in 4.1 for autoload based handler loading)

[original]

Setting	Summary
Filters	Sets filters to be used for the “original” alias.
MIMEType	Sets the MIME type of the output image.

[OutputSettings]

Setting	Summary
AllowedOutputFormat	lists the MIME types which are allowed as output type.

[reference]

Setting	Summary
Filters	Lists the filters to be used for the "reference" alias.
Reference	This setting will tell the system which alias to use as reference image for "reference" images.

[rssitem]

Setting	Summary
Filters	Lists the filters to be used for the "rssitem" alias.
Reference	This setting will tell the system which alias to use as reference image for "rssitem" images.

[rss]

Setting	Summary
Filters	Lists the filters for the "rss" alias.
Reference	This setting will tell the system which alias to use as reference image for "rss" images.

[ShellSettings]

Setting	Summary
ConvertPath	Sets the path to the converter.

[small]

Setting	Summary
Filters	Lists the filters to be used for the "small" alias.
Reference	This setting will tell the system which alias to use as reference image for "small" images.

[tiny]

Setting	Summary
Filters	Lists the filters for the "tiny" alias.
Reference	This setting will tell the system which alias to use as reference image for "tiny" images.

[zoom]

Setting	Summary
Filters	Lists the filters for the "zoom" alias.
Reference	This setting will tell the system which alias to use as reference image for "zoom" images.

[{myalias}]

Setting	Summary
Filters	Sets a list of filters to run.
MIMEType	Sets the MIME type of the output image.
Reference	This setting will tell the system which alias to use as reference image.

Added for Exponential 6.0.15: groups

The groups of settings/image.ini in Exponential 6.0.15 that the 4.x reference did not describe:

Group	Summary
[ImageUploadSettings]	Which uploaded files are accepted as images: the image datatype (edit form, upload module, rich text editor upload, AJAX uploader, WebDAV, imports) and the ...

In this section

[ImageUploadSettings] Available since Exponential 6.0.15 (in development, not in a release yet). Summary Which uploaded files are accepted as images: the image datatype (edit...

Contributors

Balazs Halasy Author 02/23/2005
Ester Heylen Maintainer
Frederik Holljen Maintainer
Massimiliano Bariola Commenter 01/28/2006
Adrien Commenter 05/28/2008
Graham Brookins Updated 11/05/2026

Comments (2 historical)

Written by readers of the earlier documentation sites, kept as they were.

Link to old doc with filter explanation

Massimiliano Bariola · 01/28/2006 12:35 pm

http://ez.no/download/ez_publish/...logs/ez_publish_3_3/new_image_system
Quality

Adrien · 05/28/2008 01:49 pm
```
[MIMETypeSettings]
Quality[]
Quality[]=image/jpeg;90
```
As Quality is defined here, we can't define an alias for jpeg 80x60,50% and one for 800x600,90%. True? Quality shouldn't be a global value but a finest one as part of the AliasSettings.

Comments

Add a comment