Das Open Source CMS TYPO3 zeichnet sich durch die Fähigkeit aus, Grafiken direkt auf dem Server zu erstellen und zu bearbeiten. Dadurch können beispielsweise grafische Titel und Navigationselemente generiert, Vorschaubilder (Thumbnails) erzeugt oder Bilder mit Wasserzeichen versehen werden.
Für das so genannte Image Processing greift TYPO3 auf zwei Komponenten zurück: auf ImageMagick und auf die GD Library (kurz GDlib, inkl. FreeType) Das Zusammenspiel mit diesen beiden Komponenten ist nicht immer ganz einfach. Dies gilt insbesondere für ImageMagick, das je nach Version unterschiedlich (und unterschiedlich gut) funktioniert, so dass für TYPO3 phasenweise nur noch die veraltete Version 4.2.9 bzw. das alternative GraphicsMagick empfohlen wurde. Auch von der GD Library (seit der Version 4.3.0 Teil der offiziellen PHP-Distribution) gibt es eine Version 1.x und eine Version 2.x, die von TYPO3 unterschiedlich angesprochen werden müssen. (Nachtrag: Ab TYPO3 Version 4.4 wird nur noch GDlib 2.x unterstützt.)
Entscheidend dafür, dass das Image Processing korrekt funktioniert, sind die Einstellungen, die über die Konfigurationsparameter der Gruppe $TYPO3_CONF_VARS[‘GFX’] gemacht werden. Diese Parameter können entweder über das Install Tool (Abschnitt 5: All Configuration) oder aber direkt in der Datei typo3conf/localconf.php gesetzt werden. Allerdings ist nicht immer ganz einfach zu verstehen, was die einzelnen Konfigurationseinstellungen bewirken.
Nachdem ich selbst viele Stunden vergeblich nach einer vernünftigen Dokumentation gesucht habe, habe ich mich entschlossen, selbst eine solche so verfassen. Sie enthält einerseits eine Einführung, welche insbesondere auch die Testfunktionen des Install Tools im TYPO3 Backend beleuchtet, andererseits eine knapp gefasste Referenz für alle Konfigurationsparameter der Gruppe $TYPO3_CONF_VARS[‘GFX’] mit den erlaubten und empfohlenen Parameterwerten.
Die Dokumentation Konfiguration des TYPO3 Image Processing (ImageMagick und GD Library): Eine Referenz für die Konfigurationsparameter $TYPO3_CONF_VARS[‘GFX’] steht im PDF-Format zur Verfügung und untersteht einer Creative-Commons-Lizenz. Kommentare, Ergänzungen und Korrekturen sind willkommen – am liebsten im untenstehenden Kommentarfeld.