Skip to content
Merged
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
13 changes: 13 additions & 0 deletions admin_manual/configuration_files/previews_configuration.rst
Original file line number Diff line number Diff line change
Expand Up @@ -31,6 +31,19 @@ and ``OC\Preview\MSOfficeDoc`` require LibreOffice. Image formats handled
through ImageMagick, such as ``OC\Preview\Illustrator``, ``OC\Preview\SVG``
and ``OC\Preview\TIFF``, require the corresponding ImageMagick support.

Installing the ``imagick`` PHP extension is not on its own enough for those providers.
ImageMagick also has to carry the delegate for the format, which is a separate build
option and often a separate distribution package: ``OC\Preview\JP2`` needs the OpenJPEG
delegate, and ``OC\Preview\HEIC`` and ``OC\Preview\AVIFImagick`` need an HEIF one,
usually libheif. A provider whose delegate is missing is never registered, so those
files keep their mimetype icon rather than producing a broken preview.

``OC\Preview\AVIF`` is the one enabled-by-default provider with a build dependency of
its own. It decodes with GD, which handles AVIF only if PHP was built against a libgd
that supports it. Where it was not, enable ``OC\Preview\AVIFImagick`` alongside it:
both answer for AVIF, GD is asked first, and ImageMagick is asked after it if GD
returns nothing.

Parameters
----------

Expand Down
Loading