If the two images below do not look the same, please check your FreeType 2 module.
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';
.
This verifies that ImageMagick is able to write GIF and PNG and WEBP files.
The GIF-file is attempted compressed by the
\TYPO3\CMS\Core\Imaging\GraphicalFunctions::gifCompress()
function.
This shows how ImageMagick reacts when scaling transparent GIF and PNG files.
This verifies that the ImageMagick tools, combine
, composite
, are able to
combine two images through a grayscale mask.
This verifies that the GDLib installation works properly.
'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'.
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} |
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 http://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