From 23d4c6fda92eb1ab813166f72a18f1c51f41b0a2 Mon Sep 17 00:00:00 2001 From: Jehan Date: Fri, 11 Apr 2025 11:16:16 +0200 Subject: [PATCH] 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 --- INSTALL.in | 20 ++++++++++++++++---- 1 file changed, 16 insertions(+), 4 deletions(-) diff --git a/INSTALL.in b/INSTALL.in index d4f21b2a1a..526e7b3b66 100644 --- a/INSTALL.in +++ b/INSTALL.in @@ -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,