heic support #3244

ethaniel · 2022-12-26T11:47:44Z

ethaniel
Dec 26, 2022

Hello!

I have vips 8.13.1 installed from Centos packages. If I understand correctly, it doesn't support images stored in the heic format:
magick2vips: libMagick error: no decode delegate for this image format HEIC @ error/constitute.c/ReadImage/576

vips --vips-config shows:

HEIC/AVIF load/save with libheif: no (dynamic module: no)

I was wondering if it's possible to enable this feature by installing additional libraries?
Or do I need to compile vips from source?

jcupitt · 2022-12-26T12:30:34Z

jcupitt
Dec 26, 2022
Maintainer

Hello, I would find an rpm with this feature enabled. I think Remi's build of libvips has this turned on:

https://rpms.remirepo.net/

Or build from source yourself, of course.

0 replies

ethaniel · 2022-12-26T12:36:08Z

ethaniel
Dec 26, 2022
Author

Yup, ended up using this manual: https://blog.remirepo.net/post/2019/05/22/HEIC-HEIF-images-support
Thank you!

0 replies

ivanbarlog · 2025-03-08T13:11:53Z

ivanbarlog
Mar 8, 2025

Hi there!

I've built the libvips from source trying to add libheif support. I ended up with this:

The Meson build system
Version: 0.63.3
Source dir: /opt/vips-8.15.3
Build dir: /opt/vips-8.15.3/build
Build type: native build
Project name: vips
Project version: 8.15.3
C compiler for the host machine: cc (gcc 11.4.1 "cc (GCC) 11.4.1 20230605 (Red Hat 11.4.1-2)")
C linker for the host machine: cc ld.bfd 2.39-6
C++ compiler for the host machine: c++ (gcc 11.4.1 "c++ (GCC) 11.4.1 20230605 (Red Hat 11.4.1-2)")
C++ linker for the host machine: c++ ld.bfd 2.39-6
Host machine cpu family: aarch64
Host machine cpu: aarch64
Compiler for C supports arguments -Werror=pointer-arith: YES 
Found pkg-config: /usr/bin/pkg-config (1.8.0)
Run-time dependency glib-2.0 found: YES 2.82.2
Run-time dependency gio-2.0 found: YES 2.82.2
Run-time dependency gobject-2.0 found: YES 2.82.2
Run-time dependency gmodule-no-export-2.0 found: YES 2.82.2
Run-time dependency expat found: YES 2.6.3
Run-time dependency threads found: YES
Library m found: YES
Compiler for C supports link arguments -Wl,-z,nodelete: YES 
Compiler for C supports function attribute visibility:hidden: YES 
Checking if "Has vector arithmetic" with dependency -lm compiles: YES 
Checking if "Has signed constants in vector templates" with dependency -lm compiles: YES 
Checking if "Has target_clones attribute" runs: DID NOT COMPILE
Checking for function "vsnprintf" : YES 
Checking for function "_aligned_malloc" : NO 
Checking for function "posix_memalign" : YES 
Checking for function "memalign" : YES 
Checking for function "cbrt" with dependency -lm: YES 
Checking for function "hypot" with dependency -lm: YES 
Checking for function "atan2" with dependency -lm: YES 
Checking for function "asinh" with dependency -lm: YES 
Checking for function "pthread_setattr_default_np" with dependency threads: YES 
Run-time dependency zlib found: YES 1.2.11
Found CMake: /usr/bin/cmake (3.22.2)
Run-time dependency libarchive found: NO (tried pkgconfig and cmake)
Run-time dependency fftw3 found: NO (tried pkgconfig and cmake)
Run-time dependency magickcore found: NO (tried pkgconfig and cmake)
Run-time dependency imagemagick found: NO (tried pkgconfig and cmake)
Run-time dependency cfitsio found: NO (tried pkgconfig and cmake)
Run-time dependency imagequant found: NO (tried pkgconfig and cmake)
Run-time dependency quantizr found: NO (tried pkgconfig and cmake)
Run-time dependency libexif found: YES 0.6.22
Has header "exif-data.h" with dependency libexif: NO 
Run-time dependency libjpeg found: YES 2.1.4
Checking for function "jpeg_c_bool_param_supported" with dependency libjpeg: NO 
Run-time dependency spng found: NO (tried pkgconfig and cmake)
Run-time dependency libspng found: NO (tried pkgconfig and cmake)
Run-time dependency libpng found: YES 1.6.37
Checking for function "png_set_chunk_malloc_max" with dependency libpng: YES 
Run-time dependency libwebp found: YES 1.4.0
Run-time dependency libwebpmux found: YES 1.4.0
Run-time dependency libwebpdemux found: YES 1.4.0
Run-time dependency pangocairo found: NO (tried pkgconfig and cmake)
Run-time dependency pangoft2 found: NO (tried pkgconfig and cmake)
Run-time dependency fontconfig found: YES 2.13.94
Run-time dependency libtiff-4 found: YES 4.4.0
Fetching value of define "COMPRESSION_WEBP" with dependency libtiff-4: 50001 
Run-time dependency librsvg-2.0 found: YES 2.54.6
Run-time dependency cairo found: YES 1.18.0
Run-time dependency openslide found: NO (tried pkgconfig and cmake)
Run-time dependency matio found: NO (tried pkgconfig and cmake)
Run-time dependency lcms2 found: YES 2.12
Run-time dependency openexr found: NO (tried pkgconfig and cmake)
Run-time dependency libopenjp2 found: NO (tried pkgconfig and cmake)
Run-time dependency libhwy found: NO (tried pkgconfig and cmake)
Run-time dependency orc-0.4 found: NO (tried pkgconfig and cmake)
Run-time dependency pdfium found: NO (tried pkgconfig and cmake)
Run-time dependency libheif found: YES 1.18.2
Checking for function "heif_image_handle_get_raw_color_profile" with dependency libheif: YES 
Checking for function "heif_context_set_maximum_image_size_limit" with dependency libheif: YES 
Checking whether type "struct heif_decoding_options" has member "convert_hdr_to_8bit" with dependency libheif: YES 
Checking whether type "struct heif_encoding_options" has member "output_nclx_profile" with dependency libheif: YES 
Run-time dependency libjxl found: NO (tried pkgconfig and cmake)
Run-time dependency libjxl_threads found: NO (tried pkgconfig and cmake)
Run-time dependency poppler-glib found: NO (tried pkgconfig and cmake)
Run-time dependency niftiio found: NO (tried pkgconfig)
Run-time dependency nifti found: NO (tried cmake)
Has header "sys/file.h" : YES 
Has header "sys/param.h" : YES 
Has header "sys/mman.h" : YES 
Has header "unistd.h" : YES 
Has header "io.h" : NO 
Has header "direct.h" : NO 
Checking for function "ngettext" : YES 
Checking for function "bind_textdomain_codeset" : YES 
Configuring config.h using configuration
Program g-ir-scanner found: YES (/usr/bin/g-ir-scanner)
Program glib-mkenums found: YES (/usr/bin/glib-mkenums)
Program glib-mkenums found: YES (/usr/bin/glib-mkenums)
Configuring version.h using configuration
Found pkg-config: /usr/bin/pkg-config (1.8.0)
Program glib-genmarshal found: YES (/usr/bin/glib-genmarshal)
Run-time dependency gobject-introspection-1.0 found: YES 1.82.0
Dependency gobject-introspection-1.0 found: YES 1.82.0 (cached)
Program g-ir-scanner found: YES (/usr/bin/g-ir-scanner)
Dependency gobject-introspection-1.0 found: YES 1.82.0 (cached)
Program g-ir-compiler found: YES (/usr/bin/g-ir-compiler)
Program msgfmt found: YES (/usr/bin/msgfmt)
Program msginit found: YES (/usr/bin/msginit)
Program msgmerge found: YES (/usr/bin/msgmerge)
Program xgettext found: YES (/usr/bin/xgettext)
Program python3 found: YES (/usr/bin/python3)
Configuring variables.sh using configuration
Library FuzzingEngine found: NO
Build targets in project: 51

vips 8.15.3

  Build options
    enable debug                      : NO
    enable deprecated                 : YES
    enable modules                    : YES
    enable gtk-doc                    : NO
    enable doxygen                    : NO
    enable introspection              : YES
    enable examples                   : YES
    enable cplusplus                  : YES
    enable RAD load/save              : YES
    enable Analyze7 load/save         : YES
    enable PPM load/save              : YES
    enable GIF load                   : YES

  Optional external packages
    use fftw for FFTs                 : NO
    SIMD support with highway         : NO
    accelerate loops with ORC         : NO
    ICC profile support with lcms     : YES
    zlib                              : YES
    text rendering with pangocairo    : NO
    font file support with fontconfig : NO
    EXIF metadata support with libexif: YES

  External image format libraries
    JPEG load/save with libjpeg       : YES
    JXL load/save with libjxl         : NO (dynamic module: NO)
    JPEG2000 load/save with OpenJPEG  : NO
    PNG load/save with libspng        : NO
    PNG load/save with libpng         : YES
    selected quantisation package     : none
    TIFF load/save with libtiff       : YES
    image pyramid save with libarchive: NO
    HEIC/AVIF load/save with libheif  : YES (dynamic module: NO)
    WebP load/save with libwebp       : YES
    PDF load with PDFium              : NO
    PDF load with poppler-glib        : NO (dynamic module: NO)
    SVG load with librsvg             : YES
    EXR load with OpenEXR             : NO
    OpenSlide load                    : NO (dynamic module: NO)
    Matlab load with libmatio         : NO
    NIfTI load/save with niftiio      : NO
    FITS load/save with cfitsio       : NO
    GIF save with cgif                : NO
    selected Magick package           : none (dynamic module: NO)
    Magick API version                : none
    Magick load                       : NO
    Magick save                       : NO

  User defined options
    buildtype                         : release
    libdir                            : /usr/local/lib
    prefix                            : /usr/local
    heif                              : enabled
    heif-module                       : disabled
    lcms                              : enabled

It says HEIC/AVIF load/save with libheif : YES (dynamic module: NO) but for some reason I still get this error when trying to transform the image:

source: bad seek to 28955\nheif: Invalid input: Unspecified: Bitstream not supported by this decoder (2.0)

Am I missing something here?

10 replies

jcupitt Mar 8, 2025
Maintainer

I suppose you're setting PKG_CONFIG_PATH?

ivanbarlog Mar 8, 2025

Yes.

PREFIX_PATH=/usr/local
LIB_PATH=${PREFIX_PATH}/lib

export PKG_CONFIG_PATH=${LIB_PATH}/pkgconfig:${PKG_CONFIG_PATH}

ivanbarlog Mar 8, 2025

I am able to read other file types though. Eg I only have problems with heic/heif.

jcupitt Mar 8, 2025
Maintainer

What's the output of libheif configure? Can it see the two libraries?

ivanbarlog Mar 8, 2025

Sure. Here you go, not sure what are we looking for:

cmake -DCMAKE_INSTALL_LIBDIR=${LIB_PATH} --preset=release ..
Preset CMake variables:

  BUILD_SHARED_LIBS="ON"
  BUILD_TESTING="OFF"
  CMAKE_BUILD_TYPE="Release"
  ENABLE_PLUGIN_LOADING="ON"
  WITH_AOM_DECODER="ON"
  WITH_AOM_DECODER_PLUGIN="ON"
  WITH_AOM_ENCODER="ON"
  WITH_AOM_ENCODER_PLUGIN="ON"
  WITH_DAV1D="ON"
  WITH_DAV1D_PLUGIN="ON"
  WITH_EXAMPLES="ON"
  WITH_FFMPEG_DECODER="ON"
  WITH_FFMPEG_DECODER_PLUGIN="ON"
  WITH_FUZZERS="OFF"
  WITH_HEADER_COMPRESSION="ON"
  WITH_JPEG_DECODER="ON"
  WITH_JPEG_DECODER_PLUGIN="ON"
  WITH_JPEG_ENCODER="ON"
  WITH_JPEG_ENCODER_PLUGIN="ON"
  WITH_KVAZAAR="ON"
  WITH_KVAZAAR_PLUGIN="ON"
  WITH_LIBDE265="ON"
  WITH_LIBDE265_PLUGIN="ON"
  WITH_LIBSHARPYUV="ON"
  WITH_OPENJPH_ENCODER="ON"
  WITH_OpenJPEG_DECODER="ON"
  WITH_OpenJPEG_DECODER_PLUGIN="ON"
  WITH_OpenJPEG_ENCODER="ON"
  WITH_OpenJPEG_ENCODER_PLUGIN="ON"
  WITH_RAV1E="ON"
  WITH_RAV1E_PLUGIN="ON"
  WITH_REDUCED_VISIBILITY="ON"
  WITH_SvtEnc="ON"
  WITH_SvtEnc_PLUGIN="ON"
  WITH_UNCOMPRESSED_CODEC="ON"
  WITH_X265="ON"
  WITH_X265_PLUGIN="ON"

-- The C compiler identification is GNU 11.4.1
-- The CXX compiler identification is GNU 11.4.1
-- Detecting C compiler ABI info
-- Detecting C compiler ABI info - done
-- Check for working C compiler: /usr/bin/cc - skipped
-- Detecting C compile features
-- Detecting C compile features - done
-- Detecting CXX compiler ABI info
-- Detecting CXX compiler ABI info - done
-- Check for working CXX compiler: /usr/bin/c++ - skipped
-- Detecting CXX compile features
-- Detecting CXX compile features - done
-- Looking for unistd.h
-- Looking for unistd.h - found
-- Performing Test has_potentially_evaluated_expression
-- Performing Test has_potentially_evaluated_expression - Failed
-- Found LIBDE265 
-- Found LIBDE265: /usr/local/include (found version "1.0.15") 
-- Found X265 
-- Found X265: /usr/local/include (found version "209") 
CMake Warning at cmake/modules/LibFindMacros.cmake:267 (message):
  WARNING: MISSING PACKAGE

  We could not find development headers for KVAZAAR.  Do you have the
  necessary dev package installed? This package is NOT REQUIRED and you may
  ignore this warning but by doing so you may miss some functionality of
  libheif.

  Relevant CMake configuration variables:

    KVAZAAR_INCLUDE_DIR=<not found>
    KVAZAAR_LIBRARY=<not found>

  You may use CMake GUI, cmake -D or ccmake to modify the values.  Delete
  CMakeCache.txt to discard all values and force full re-detection if
  necessary.

Call Stack (most recent call first):
  cmake/modules/Findkvazaar.cmake:19 (libfind_process)
  CMakeLists.txt:120 (find_package)


-- Performing Test HAVE_KVAZAAR_ENABLE_LOGGING
-- Performing Test HAVE_KVAZAAR_ENABLE_LOGGING - Failed
-- Could NOT find kvazaar (missing: KVAZAAR_INCLUDE_DIR KVAZAAR_LIBRARIES) 
CMake Warning at cmake/modules/LibFindMacros.cmake:267 (message):
  WARNING: MISSING PACKAGE

  We could not find development headers for DAV1D.  Do you have the necessary
  dev package installed? This package is NOT REQUIRED and you may ignore this
  warning but by doing so you may miss some functionality of libheif.

  Relevant CMake configuration variables:

    DAV1D_INCLUDE_DIR=<not found>
    DAV1D_LIBRARY=<not found>

  You may use CMake GUI, cmake -D or ccmake to modify the values.  Delete
  CMakeCache.txt to discard all values and force full re-detection if
  necessary.

Call Stack (most recent call first):
  cmake/modules/FindDAV1D.cmake:17 (libfind_process)
  CMakeLists.txt:168 (find_package)


-- Could NOT find DAV1D (missing: DAV1D_INCLUDE_DIR DAV1D_LIBRARIES) 
-- Looking for AOM_USAGE_GOOD_QUALITY
-- Looking for AOM_USAGE_GOOD_QUALITY - found
-- Found AOM 
-- Found AOM: /usr/local/include  
CMake Warning at cmake/modules/LibFindMacros.cmake:267 (message):
  WARNING: MISSING PACKAGE

  We could not find development headers for SvtEnc.  Do you have the
  necessary dev package installed? This package is NOT REQUIRED and you may
  ignore this warning but by doing so you may miss some functionality of
  libheif.

  Relevant CMake configuration variables:

    SvtEnc_INCLUDE_DIR=<not found>
    SvtEnc_LIBRARY=<not found>

  You may use CMake GUI, cmake -D or ccmake to modify the values.  Delete
  CMakeCache.txt to discard all values and force full re-detection if
  necessary.

Call Stack (most recent call first):
  cmake/modules/FindSvtEnc.cmake:17 (libfind_process)
  CMakeLists.txt:191 (find_package)


-- Could NOT find SvtEnc (missing: SvtEnc_INCLUDE_DIR SvtEnc_LIBRARIES) 
CMake Warning at cmake/modules/LibFindMacros.cmake:267 (message):
  WARNING: MISSING PACKAGE

  We could not find development headers for RAV1E.  Do you have the necessary
  dev package installed? This package is NOT REQUIRED and you may ignore this
  warning but by doing so you may miss some functionality of libheif.

  Relevant CMake configuration variables:

    RAV1E_INCLUDE_DIR=<not found>
    RAV1E_LIBRARY=<not found>

  You may use CMake GUI, cmake -D or ccmake to modify the values.  Delete
  CMakeCache.txt to discard all values and force full re-detection if
  necessary.

Call Stack (most recent call first):
  cmake/modules/FindRAV1E.cmake:17 (libfind_process)
  CMakeLists.txt:198 (find_package)


-- Could NOT find RAV1E (missing: RAV1E_INCLUDE_DIR RAV1E_LIBRARIES) 
-- Found JPEG: /usr/lib64/libjpeg.so (found version "62") 
CMake Warning at CMakeLists.txt:214 (find_package):
  By not providing "FindOpenJPEG.cmake" in CMAKE_MODULE_PATH this project has
  asked CMake to find a package configuration file provided by "OpenJPEG",
  but CMake did not find one.

  Could not find a package configuration file provided by "OpenJPEG"
  (requested version 2) with any of the following names:

    OpenJPEGConfig.cmake
    openjpeg-config.cmake

  Add the installation prefix of "OpenJPEG" to CMAKE_PREFIX_PATH or set
  "OpenJPEG_DIR" to a directory containing one of the above files.  If
  "OpenJPEG" provides a separate development package or SDK, be sure it has
  been installed.


-- Could NOT find FFMPEG (missing: FFMPEG_INCLUDE_DIRS FFMPEG_LIBRARIES avcodec avutil) 
CMake Warning at cmake/modules/LibFindMacros.cmake:267 (message):
  WARNING: MISSING PACKAGE

  We could not find development headers for OPENJPH.  Do you have the
  necessary dev package installed? This package is NOT REQUIRED and you may
  ignore this warning but by doing so you may miss some functionality of
  libheif.

  Relevant CMake configuration variables:

    OPENJPH_INCLUDE_DIR=<not found>
    OPENJPH_LIBRARY=<not found>

  You may use CMake GUI, cmake -D or ccmake to modify the values.  Delete
  CMakeCache.txt to discard all values and force full re-detection if
  necessary.

Call Stack (most recent call first):
  cmake/modules/FindOPENJPH.cmake:17 (libfind_process)
  CMakeLists.txt:229 (find_package)


-- Could NOT find OPENJPH (missing: OPENJPH_INCLUDE_DIR OPENJPH_LIBRARY) 

=== Summary of compiled codecs ===
libde265 HEVC decoder           : + separate plugin
FFMPEG HEVC decoder (HW acc)    : - not found
x265 HEVC encoder               : + separate plugin
Kvazaar HEVC encoder            : - not found
AOM AV1 decoder                 : + separate plugin
AOM AV1 encoder                 : + separate plugin
Dav1d AV1 decoder               : - not found
SVT AV1 encoder                 : - not found
Rav1e AV1 encoder               : - not found
JPEG decoder                    : + separate plugin
JPEG encoder                    : + separate plugin
OpenJPEG J2K decoder            : - not found
OpenJPEG J2K encoder            : - not found
OpenJPH HT-J2K encoder          : - not found
uvg266 VVC enc. (experimental)  : - disabled
vvenc VVC enc. (experimental)   : - disabled
vvdec VVC dec. (experimental)   : - disabled

=== Supported formats ===
format        decoding   encoding
HEIC            YES        YES
AVIF            YES        YES
VVC             NO         NO 
JPEG            YES        YES
JPEG2000        NO         NO 
JPEG2000-HT     NO         NO 
Uncompressed    YES        YES

-- Found LIBSHARPYUV 
-- Found libsharpyuv: /usr/local/include/webp  
libsharpyuv: found
-- Found ZLIB: /usr/lib64/libz.so (found version "1.2.11") 
zlib found
-- Found Brotli: /usr/lib64/libbrotlicommon.so  
Brotli found
-- Looking for _LIBCPP_VERSION
-- Looking for _LIBCPP_VERSION - not found
-- Performing Test HAVE_JPEG_WRITE_ICC_PROFILE
-- Performing Test HAVE_JPEG_WRITE_ICC_PROFILE - Success
-- Found PNG: /usr/lib64/libpng.so (found version "1.6.37") 
-- Found TIFF: /usr/lib64/libtiff.so (found version "4.4.0")  

=== Active input formats for heif-enc ===
JPEG: active
PNG:  active
TIFF: active

-- Could NOT find Doxygen (missing: DOXYGEN_EXECUTABLE) 
Doxygen tool needs to be installed to generate the API documentation
Compiling 'x265' as dynamic plugin
Compiling 'libde265' as dynamic plugin
Not compiling 'dav1d' backend
Compiling 'aomdec' as dynamic plugin
Compiling 'aomenc' as dynamic plugin
Not compiling 'svtenc' backend
Not compiling 'rav1e' backend
Compiling 'jpegdec' as dynamic plugin
Compiling 'jpegenc' as dynamic plugin
Not compiling 'j2kdec' backend
Not compiling 'j2kenc' backend
Not compiling 'kvazaar' backend
Not compiling 'ffmpegdec' backend
Not compiling 'jphenc' backend
Not compiling 'uvg266' backend
Not compiling 'vvdec' backend
Not compiling 'vvenc' backend
Compiling in 'libsharpyuv'
-- Looking for pthread.h
-- Looking for pthread.h - found
-- Performing Test CMAKE_HAVE_LIBC_PTHREAD
-- Performing Test CMAKE_HAVE_LIBC_PTHREAD - Success
-- Found Threads: TRUE  
-- Found PkgConfig: /usr/bin/pkg-config (found version "1.8.0") 
-- Checking for module 'gdk-pixbuf-2.0'
--   Found gdk-pixbuf-2.0, version 2.42.10
-- Configuring done
-- Generating done
-- Build files have been written to: /opt/openh264-2.6.0/libheif-1.18.2/build

Probably this?

Compiling 'x265' as dynamic plugin
Compiling 'libde265' as dynamic plugin

Uh oh!

heic support #3244

Uh oh!

Uh oh!

ethaniel Dec 26, 2022

Replies: 3 comments · 10 replies

Uh oh!

jcupitt Dec 26, 2022 Maintainer

Uh oh!

ethaniel Dec 26, 2022 Author

Uh oh!

ivanbarlog Mar 8, 2025

Uh oh!

jcupitt Mar 8, 2025 Maintainer

Uh oh!

ivanbarlog Mar 8, 2025

Uh oh!

ivanbarlog Mar 8, 2025

Uh oh!

jcupitt Mar 8, 2025 Maintainer

Uh oh!

Uh oh!

ivanbarlog Mar 8, 2025

ethaniel
Dec 26, 2022

Replies: 3 comments 10 replies

jcupitt
Dec 26, 2022
Maintainer

ethaniel
Dec 26, 2022
Author

ivanbarlog
Mar 8, 2025

jcupitt Mar 8, 2025
Maintainer

jcupitt Mar 8, 2025
Maintainer