INSTALL: more info about HEIF support.

It looks like packagers have regular issues with this support. Also I
added info about the fact we also support JPEG2000-in-HEIF (HEJ2) now.
And I made clearer that there may be other encoders/decoders possible
for a given format (though for AV1, we have a clear AOM preference in
our code).

Finally I add info about an environment variable which may be useful
probably in cases when the run prefix differs from the build prefix.
Cf. a case which was recently happening in the Snap package.
See: https://github.com/snapcrafters/gimp/issues/390
This commit is contained in:
Jehan 2025-04-11 11:16:16 +02:00
parent 93c3d83dd0
commit 23d4c6fda9

View file

@ -200,10 +200,22 @@ help in that regard:
https://github.com/strukturag/libheif
Make sure you build libheif with libde265 and libx265 support (for
respectively decoding and encoding of HEVC, i.e. HEIC files), and
libaom decoder and encoder (for AV1, i.e. AVIF files), otherwise
the plug-in is mostly useless.
GIMP supports several HEIF variants (different coding formats in
the HEIF container), so you should make sure you build libheif with
proper encoders and decoders for these:
* HEIC: e.g. libde265 and libx265 support (for
respectively decoding and encoding of HEVC).
* AVIF: e.g. libaom decoder and encoder (for AV1 encoding and
decoding), prefered over rav1e.
* HEJ2: OpenJPEG (for JPEG2000 inside HEIF).
If you don't compile libheif with the correct flags (see libheif
README which has a table of supported codecs), the plug-in is
mostly useless.
If HEIF support doesn't look like it works on relocatable
environments, the environment variable LIBHEIF_PLUGIN_PATH may be
what you are looking for.
15. GObject Introspection requires the following dependencies to be
built and installed with introspection as well: babl, cairo,