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 / GraphicsMagick installation is able to read the default formats jpg, gif, png, tif, pdf and ai, webp and avif. The tool identify is used to read the pixel dimensions 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 webp

Read avif

Read tif

Read pdf

Read ai

Writing gif, png, webp, avif

This verifies that ImageMagick / GraphicsMagick is able to write GIF, PNG, WEBP and AVIF files.

Write gif

Write png

Write webp

Write avif

Scaling images

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

gif to gif

png to png

gif to jpg

Special image formats

This shows how ImageMagick /GraphicsMagicks reacts when converting to image formats like WEBP and AVIF.

jpg to webp

jpg to avif

png to webp

png to avif

Combining images

This verifies that the ImageMagick / GraphicsMagick 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

GDlib

This verifies that the GDLib installation works properly.

Create simple image

Create image with box from file

Create webp image with box from webp file

Create avif image with box 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 / GraphicsMagick '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 drop-shadow 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/GraphicsMagick) and menu items, graphical headers and such are generated automatically (by GDLib + ImageMagick/GraphicsMagick). In addition, TYPO3 is able to handle many file formats (thanks to ImageMagick/GraphicsMagick), for example TIF, BMP, PCX, TGA, AI and PDF in addition to the standard web formats; JPG, GIF, PNG. Additional image formats like WEBP and AVIF are available depending on installed codecs on the system.

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

ImageMagick / GraphicsMagick:

For conversion of non-web formats to web formats, 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 file formats, 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 https://www.imagemagick.org/

GDLib:

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