GFX - graphics configuration

The following configuration variables can be used to configure settings for the handling of images and graphics:

thumbnails

$GLOBALS['TYPO3_CONF_VARS']['GFX']['thumbnails']

$GLOBALS['TYPO3_CONF_VARS']['GFX']['thumbnails']
type

bool

Default

true

Enables the use of thumbnails in the backend interface.

thumbnails_png

$GLOBALS['TYPO3_CONF_VARS']['GFX']['thumbnails_png']

$GLOBALS['TYPO3_CONF_VARS']['GFX']['thumbnails_png']
type

bool

Default

true

If disabled, thumbnails from non-image files will be converted to gif, otherwise png (default).

gif_compress

$GLOBALS['TYPO3_CONF_VARS']['GFX']['gif_compress']

$GLOBALS['TYPO3_CONF_VARS']['GFX']['gif_compress']
type

bool

Default

true

Enables the use of the \TYPO3\CMS\Core\Imaging\GraphicalFunctionsgifCompress() workaround function for compressing .gif files made with GD or IM, which probably use only RLE or no compression at all.

imagefile_ext

$GLOBALS['TYPO3_CONF_VARS']['GFX']['imagefile_ext']

$GLOBALS['TYPO3_CONF_VARS']['GFX']['imagefile_ext']
type

list

Default

'gif,jpg,jpeg,tif,tiff,bmp,pcx,tga,png,pdf,ai,svg'

Comma-separated list of file extensions perceived as images by TYPO3. List should be set to 'gif,png,jpeg,jpg' if IM is not available. Lowercase and no spaces between!

gdlib

$GLOBALS['TYPO3_CONF_VARS']['GFX']['gdlib']

$GLOBALS['TYPO3_CONF_VARS']['GFX']['gdlib']
type

bool

Default

true

Enables the use of GD.

gdlib_png

$GLOBALS['TYPO3_CONF_VARS']['GFX']['gdlib_png']

$GLOBALS['TYPO3_CONF_VARS']['GFX']['gdlib_png']
type

bool

Default

false

Enables the use of GD, with PNG only. This means that all items normally generated as gif-files will be png-files instead!

processor_enabled

$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_enabled']

$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_enabled']
type

bool

Default

true

Enables the use of Image- or GraphicsMagick.

processor_path

$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_path']

$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_path']
type

text

Default

'/usr/bin/'

Path to the IM tools convert, combine, identify.

$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_path_lzw']

processor_path_lzw

processor_path_lzw
Path

$GLOBALS['TYPO3_CONF_VARS']['GFX']

type

text

Default

'/usr/bin/'

Path to the IM tool convert with LZW enabled! See gif_compress. If your version 4.2.9 of ImageMagick is compiled with LZW you may leave this field blank AND disable the flag gif_compress.

processor

$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor']

$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor']
type

dropdown

Default

'ImageMagick'

allowedValues
ImageMagick
Choose ImageMagick for processing images
GraphicsMagick
Choose GraphicsMagick for processing images

Select which external software on the server should process images - see also the preset functionality to see what is available.

processor_effects

$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_effects']

$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_effects']
type

bool

Default

false

If enabled, apply blur and sharpening in ImageMagick/GraphicMagick functions

processor_allowUpscaling

$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_allowUpscaling']

$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_allowUpscaling']
type

bool

Default

true

If set, images can be scaled up if told so (in \TYPO3\CMS\Core\Imaging\GraphicalFunctions )

processor_allowFrameSelection

$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_allowFrameSelection']

$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_allowFrameSelection']
type

bool

Default

true

If set, the [x] frame selector is appended to input filenames in stdgraphic. This speeds up image processing for PDF files considerably. Disable if your image processor or environment cant cope with the frame selection.

processor_allowTemporaryMasksAsPng

$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_allowTemporaryMasksAsPng']

$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_allowTemporaryMasksAsPng']
type

bool

Default

false

This should be set if your processor supports using PNGs as masks as this is usually faster.

processor_stripColorProfileByDefault

$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_stripColorProfileByDefault']

$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_stripColorProfileByDefault']
type

bool

Default

true

If set, the processor_stripColorProfileCommand is used with all processor image operations by default. See tsRef for setting this parameter explicitly for IMAGE generation.

processor_stripColorProfileCommand

Changed in version 11.5.35

$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_stripColorProfileCommand']

$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_stripColorProfileCommand']
type

string

This option expected a string of command line parameters. The defined parameters had to be shell-escaped beforehand, while the new option processor_stripColorProfileParameters expects an array of strings that will be shell-escaped by TYPO3 when used.

The existing configuration will continue to be supported. Still, it is suggested to use the new configuration format, as the Install Tool is adapted to allow modification of the new configuration option only:

// Before
$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_stripColorProfileCommand'] = '+profile \'*\'';

// After
$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_stripColorProfileParameters'] = [
    '+profile',
    '*'
];
Copied!

processor_stripColorProfileParameters

New in version 11.5.35

$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_stripColorProfileParameters']

$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_stripColorProfileParameters']
type

array of strings

Default

['+profile', '*']

Specifies the parameters to strip the profile information, which can reduce thumbnail size up to 60KB. Command can differ in IM/GM, IM also knows the -strip command. See imagemagick.org for details.

processor_colorspace

$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_colorspace']

$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_colorspace']
type

text

Default

RGB

Specifies the colorspace to use. Some ImageMagick versions (like 6.7.0 and above) use the sRGB colorspace, so all images are darker then the original.

Possible Values: CMY, CMYK, Gray, HCL, HSB, HSL, HWB, Lab, LCH, LMS, Log, Luv, OHTA, Rec601Luma, Rec601YCbCr, Rec709Luma, Rec709YCbCr, RGB, sRGB, Transparent, XYZ, YCbCr, YCC, YIQ, YCbCr, YUV

processor_interlace

$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_interlace']

$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_interlace']
type

text

Default

'None'

Specifies the interlace option to use. The result differs in different GM / IM versions. See manual of GraphicsMagick or ImageMagick for right option.

Possible values: None, Line, Plane, Partition

jpg_quality

$GLOBALS['TYPO3_CONF_VARS']['GFX']['jpg_quality']

$GLOBALS['TYPO3_CONF_VARS']['GFX']['jpg_quality']
type

int

Default

85

Default JPEG generation quality