Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 19 additions & 0 deletions Documentation/Gifbuilder/Examples.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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
=========================================================
Expand Down
27 changes: 20 additions & 7 deletions Documentation/Gifbuilder/Properties.rst
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand All @@ -170,9 +164,16 @@ format

* :ref:`$TYPO3_CONF_VARS['GFX']['jpg_quality'] <t3coreapi:typo3ConfVars_gfx_jpg_quality>` for a JPG image
* :ref:`$TYPO3_CONF_VARS['GFX']['webp_quality'] <t3coreapi:typo3ConfVars_gfx_webp_quality>` for a WebP image
* :ref:`$TYPO3_CONF_VARS['GFX']['avif_quality'] <t3coreapi:typo3ConfVars_gfx_webp_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:

Expand Down Expand Up @@ -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:

Expand Down
15 changes: 15 additions & 0 deletions Documentation/Gifbuilder/_snippets/_avif.typoscript
Original file line number Diff line number Diff line change
@@ -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
}
}
Original file line number Diff line number Diff line change
Expand Up @@ -5,5 +5,5 @@
ExtensionManagementUtility::registerPageTSConfigFile(
'extension_name',
'Configuration/TsConfig/Page/myPageTSconfigFile.tsconfig',
'My special config'
'My special config',
);
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@
declare(strict_types=1);

namespace UsingSettingTSconfig\_PhpApi;

final class _MyBackendLoggedInController
{
public function isUserToggleEnabled(): bool
Expand Down
Loading