True type font tests

If the two images below do not look the same, please check your FreeType 2 module.

Convert image formats to jpg

This verifies that your ImageMagick installation is able to read the default formats jpg, gif, png, tif, pdf and ai. The tool identify is used to read the pixeldimensions of non-web formats and 'convert' is used to read the image and convert it to jpg.

In case the images appear remarkably darker than the reference images, try to set
$GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_colorspace'] = sRGB.

Read jpg

Read gif

Read png

Read tif

Read pdf

Read ai

Writing gif and png

This verifies that ImageMagick is able to write GIF and PNG files. The GIF-file is attempted compressed with LZW by the \TYPO3\CMS\Core\Imaging\GraphicalFunctions::gifCompress() function.

Write gif

Write png

Scaling images

This shows how ImageMagick reacts when scaling transparent GIF and PNG files.

gif to gif

png to png

gif to jpg

Combining images

This verifies that the ImageMagick tools, combine, composite, are able to combine two images through a grayscale mask.

Combine using a GIF mask with only black and white

Combine using a JPG mask with graylevels


This verifies that the GDLib installation works properly.

Create simple image

Create image from file

Render text with TrueType font

Render text with TrueType font using 'niceText' option

'niceText' is a concept that tries to improve the antialiasing of the rendered type by actually rendering the textstring in double size on a black/white mask, downscaling the mask and masking the text onto the image through this mask. This involves ImageMagick 'combine'/'composite' and 'convert'.

Render 'niceText' with a shadow under

This test makes sense only if the above test had a correct output. But if so, you may not see a soft dropshadow from the third text string as you should. In that case you are most likely using ImageMagick 5 and should set the flag $GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_effects'].

{imageProcessingProcessor} enabled: {f:if(condition:imageProcessingEnabled, then:'Yes', else:'No')}
ImageMagick or GraphicsMagick: {imageProcessingProcessor}
{imageProcessingProcessor} path: {imageProcessingPath}
{imageProcessingProcessor} version: {imageProcessingVersion}
{imageProcessingProcessor} effects enabled: {imageProcessingEffects} (Blurring/Sharpening with {imageProcessingProcessor})
GDLib enabled: {f:if(condition:imageProcessingGdlibEnabled, then:'Yes', else:'No')}
GDLib using PNG: {f:if(condition:imageProcessingGdlibPng, then:'Yes', else:'No')}
File Formats: {imageProcessingFileFormats}

Verify test results

This page performs image processing and displays the result. It's a thorough check that everything you've configured is working correctly.

It's quite simple to verify your installation; Just look down the page, the images in pairs should look like each other. If some images are not alike, something is wrong. You may also notice warnings and errors if this tool found signs of any problems.

The image to the left is the reference image (how it should be) and to the right the image made by your server.

TYPO3 is known for its ability to process images on the server.

In the backend interface (TBE) thumbnails are automatically generated as well as icons, menu items and pane tabs (by GDLib). In the frontend all kinds of graphical elements are processed. Typically images are scaled down to fit the pages (by ImageMagick) and menu items, graphical headers and such are generated automatically (by GDLib + ImageMagick). In addition TYPO3 is able to handle many file formats (thanks to ImageMagick), for example TIF, BMP, PCX, TGA, AI and PDF in addition to the standard web formats; JPG, GIF, PNG.

In order to do this, TYPO3 uses two sets of tools:

ImageMagick / GraphicsMagick:

For conversion of non-web formats to webformats, combining images with alpha-masks, performing image-effects like blurring and sharpening.

ImageMagick is a collection of external programs on the server called by the exec() function in PHP. TYPO3 uses three of these, namely 'convert' (converting fileformats, scaling, effects), 'combine'/'composite' (combining images with masks) and 'identify' (returns image information). GraphicsMagick is an alternative to ImageMagick and can be enabled by setting [GFX][processor] to 'GraphicsMagick'. This is recommended and enabled by default. Because ImageMagick and Graphicsmagick are external programs, a requirement must be met: The programs must be installed on the server and working. ImageMagick is available for both Windows and Unix. The current version is 6+. ImageMagick homepage is at


For drawing boxes and rendering text on images with truetype fonts. Also used for icons, menuitems and generally the TypoScript GIFBUILDER object is based on GDlib, but extensively utilizing ImageMagick to process intermediate results.

GDLib is accessed through internal functions in PHP, you'll need a version of PHP with GDLib compiled in. Also in order to use TrueType fonts with GDLib you'll need FreeType compiled in as well.

Test-Image by Rotkaeppchen68 (in de.wikipedia) [GFDL or CC-BY-SA-3.0], via Wikimedia Commons