Beyond Linux® From Scratch (systemd Edition) - Version r13.0-1289

Chapter 10. Graphics and Font Libraries

libheif-1.23.1

Introduction to libheif

The libheif package is an HEIF and AVIF file format decoder and encoder.

[Note]

Note

This package is known to build and work properly using an LFS 13.1 platform.

Package Information

libheif Dependencies

Recommended

libaom-3.14.1, libde265-1.1.1, and x265-4.2

Optional

Brotli-1.2.0, dav1d-1.5.4, Doxygen-1.18.0, FFmpeg-9.0.1, gdk-pixbuf-2.44.7, libjpeg-turbo-3.2.0, libpng-1.6.58, tiff-4.7.2, libwebp-1.6.0, OpenJPEG-2.5.4, sdl2-compat-2.32.70, SVT-AV1-4.2.0, x264-20250815, kvaaar, openh264, openjph, uvg266, vvdec, vvenc, and rav1e

Installation of libheif

Install libheif by running the following commands: 

mkdir build &&
cd    build &&

cmake -D CMAKE_INSTALL_PREFIX=/usr \
      -D CMAKE_BUILD_TYPE=Release  \
      -D WITH_GDK_PIXBUF=OFF       \
      -D WITH_OpenH264_DECODER=OFF \
      -G Ninja ..                  &&
ninja

To test the results, issue: ninja test.

Now, as the root user: 

ninja install

Command Explanations

-D WITH_GDK_PIXBUF=OFF: This option disables building the gdk-pixbuf loader, as gdk-pixbuf-2.44.7 is supposed to use this package via glycin-2.1.5 instead of the loader.

-D WITH_DAV1D=ON: This option allows using dav1d-1.5.4 to decode AV1 data in AVIF files.

-D WITH_FFMPEG_DECODER=ON: This option allows using FFmpeg-9.0.1 to decode H.265 data in HEIC files.

-D WITH_JPEG_ENCODER=ON -D WITH_JPEG_DECODER=ON: These options allow using libjpeg-turbo-3.2.0 to encode and decode HEIF files with JPEG data.

-D WITH_OpenJPEG_ENCODER=ON -D WITH_OpenJPEG_DECODER=ON: These options allow using OpenJPEG-2.5.4 to encode and decode HEIF files with JPEG 2000 data.

-D WITH_SvtEnc=ON: This option allows using SVT-AV1-4.2.0 to encode AV1 data for AVIF files.

Contents

Installed Programs: heif-convert (symlink to heif-dec), heif-dec, heif-enc, heif-info, heif-thumbnailer (if libpng is available), and heif-view (if SDL2 is available)
Installed Library: libheif.so
Installed Directory: /usr/include/libheif, /usr/lib/libheif, and /usr/lib/cmake/libheif

Short Descriptions

heif-dec

decodes a HEIC/HEIF image

heif-enc

converts an image to HEIC/HEIF

heif-info

shows information about a HEIC/HEIF file

heif-thumbnailer

creates thumbnails from HEIC/HEIF files

heif-view

displays an image in HEIC/HEIF format with SDL2

libheif.so

is an ISO/IEC 23008-12:2017 HEIF and AVIF (AV1 Image File Format) file format decoder and encoder