GFX - graphics configuration¶
The following configuration variables can be used to configure settings for the handling of images and graphics:
Note
The configuration values listed here are keys in the global PHP array
$GLOBALS['TYPO3_CONF_VARS']['GFX'].
This variable can be set in one of the following files:
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']¶
- 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']¶
- 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']¶
- 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_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']¶
- Type
bool
- Default
true
Enables the use of Image- or GraphicsMagick.
processor_path¶
- $GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_path']¶
- Type
text
- Default
'/usr/bin/'
Path to the IM tools convert, combine, identify.
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']¶
- Type
bool
- Default
false
If enabled, apply blur and sharpening in ImageMagick/GraphicMagick functions
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']¶
- 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']¶
- 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']¶
- 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¶
- $GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_stripColorProfileCommand']¶
- Type
text
- Default
+profile '*'
Specifies the command to strip the profile information, which can reduce thumbnail size up to 60KB. Command can differ in IM/GM, IM also know the -strip command. See imagemagick.org for details
processor_colorspace¶
- $GLOBALS['TYPO3_CONF_VARS']['GFX']['processor_colorspace']¶
- Type
text
- Default
RGB
Specifes 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']¶
- 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']¶
- Type
int
- Default
85
Default JPEG generation quality