diff --git a/Documentation/Gifbuilder/Examples.rst b/Documentation/Gifbuilder/Examples.rst index c096b601a..d9da32974 100644 --- a/Documentation/Gifbuilder/Examples.rst +++ b/Documentation/Gifbuilder/Examples.rst @@ -9,6 +9,25 @@ Examples .. contents:: :local: +.. _gifbuilder-examples-avif: + +Using the AVIF format +===================== + +.. versionadded:: 13.3 + +AVIF is an image format, that is supported by most modern browsers, and usually +has a better compression (= smaller file size) than jpg files. + +.. important:: + + Before using this feature, please check whether the used operating system + actually supports de/encoding AVIF files. Especially Debian 11 (Bullseye) + and older or systems forked from that may lack AVIF support. + +.. literalinclude:: _snippets/_avif.typoscript + :caption: EXT:config/sites/my_site/setup.typoscript + Masking semi-transparent images (Logos) onto other images ========================================================= diff --git a/Documentation/Gifbuilder/Properties.rst b/Documentation/Gifbuilder/Properties.rst index b7aa228ad..f0536904e 100644 --- a/Documentation/Gifbuilder/Properties.rst +++ b/Documentation/Gifbuilder/Properties.rst @@ -153,15 +153,9 @@ charRangeMap format ====== -.. versionchanged:: 13.0 - The default format is now "png". Before TYPO3 v13.0 this was "gif". - -.. versionadded:: 13.0 - Support for WebP has been added. - .. confval:: format :name: gifbuilder-properties-format - :type: "gif" / "jpg" / "jpeg" / "png" / "webp" + :type: "gif" / "jpg" / "jpeg" / "png" / "webp" / "avif" :Default: png File type of the output image. @@ -170,9 +164,16 @@ format * :ref:`$TYPO3_CONF_VARS['GFX']['jpg_quality'] ` for a JPG image * :ref:`$TYPO3_CONF_VARS['GFX']['webp_quality'] ` for a WebP image + * :ref:`$TYPO3_CONF_VARS['GFX']['avif_quality'] ` for a AVIF image or via the :ref:`gifbuilder-properties-quality` property on a per-image basis. + .. versionchanged:: 13.0 + The default format is now "png". Before TYPO3 v13.0 this was "gif". + + .. versionadded:: 13.0 + Support for WebP and AVIF have been added. + .. _gifbuilder-properties-maxHeight: @@ -231,6 +232,18 @@ quality .. _"lossless" compression: https://developers.google.com/speed/webp/docs/compression#lossless_webp +.. _gifbuilder-properties-speed: + +speed +===== + +.. confval:: speed + :name: gifbuilder-properties-speed + :type: integer + + Set the "speed" for files in format AVIF (See + https://www.php.net/manual/en/function.imageavif.php for more details). + .. _gifbuilder-properties-transparentBackground: diff --git a/Documentation/Gifbuilder/_snippets/_avif.typoscript b/Documentation/Gifbuilder/_snippets/_avif.typoscript new file mode 100644 index 000000000..64888edae --- /dev/null +++ b/Documentation/Gifbuilder/_snippets/_avif.typoscript @@ -0,0 +1,15 @@ +page.10 = IMAGE +page.10 { + file = GIFBUILDER + file { + backColor = yellow + XY = 1024,199 + format = avif + quality = 44 + speed = 1 + + 10 = IMAGE + 10.offset = 10,10 + 10.file = 1:/my-image.jpg + } +}