Beyond Linux® From Scratch (System V Edition) - Version 12.0

Chapter 25. Graphical Environment Libraries

gdk-pixbuf-2.42.10

Introduction to Gdk Pixbuf

The Gdk Pixbuf package is a toolkit for image loading and pixel buffer manipulation. It is used by GTK+ 2 and GTK+ 3 to load and manipulate images. In the past it was distributed as part of GTK+ 2 but it was split off into a separate package in preparation for the change to GTK+ 3.

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

Package Information

Gdk Pixbuf Dependencies

Required

GLib-2.76.4, libjpeg-turbo-3.0.0, libpng-1.6.40, and shared-mime-info-2.2

Recommended

docutils-0.20.1, librsvg-2.56.3 (runtime dependency, needed for loading symbolic icons) and libtiff-4.5.1

Optional (Required if building GNOME)

gobject-introspection-1.76.1

Optional

gdk-pixbuf-xlib-2.40.2 (runtime dependency, needed for loading XPM images), Gi-DocGen-2023.1 (to generate documentation), libavif-0.11.1 (runtime dependency, needed for loading AVIF images), and webp-pixbuf-loader-0.2.4 (runtime dependency, needed for loading WebP images)

Installation of Gdk Pixbuf

Install Gdk Pixbuf by running the following commands: 

mkdir build &&
cd    build &&

meson setup ..            \
      --prefix=/usr       \
      --buildtype=release \
      --wrap-mode=nofallback &&
ninja

If you have Gi-DocGen-2023.1 installed and wish to build the API documentation for this package, issue: 

sed "/docs_dir =/s@\$@ / 'gdk-pixbuf-2.42.10'@" -i ../docs/meson.build &&
meson configure -Dgtk_doc=true                                         &&
ninja

To test the results, issue: ninja test. The tests make a heavy use of disk.

Now, as the root user: 

ninja install
[Note]

Note

If you installed the package on to your system using a “DESTDIR” method, an important file was not installed and should be copied and/or generated. Generate it using the following command as the root user: 

gdk-pixbuf-query-loaders --update-cache

Command Explanations

--buildtype=release: Specify a buildtype suitable for stable releases of the package, as the default may produce unoptimized binaries.

--wrap-mode=nofallback: This switch prevents meson from using subproject fallbacks for any dependency declarations in the build files, stopping it downloading any optional dependency which is not installed on the system.

-Dman=false: Use this option if you do not want to generate manual pages, or if you do not want to install docutils-0.20.1.

Contents

Installed Programs: gdk-pixbuf-csource, gdk-pixbuf-pixdata, gdk-pixbuf-query-loaders, and gdk-pixbuf-thumbnailer
Installed Libraries: libgdk_pixbuf-2.0.so
Installed Directories: /usr/{include,lib}/gdk-pixbuf-2.0, /usr/libexec/installed-tests/gdk-pixbuf, /usr/share/installed-tests/gdk-pixbuf, /usr/share/gtk-doc/html/gdk-pixbuf, and /usr/share/thumbnailers

Short Descriptions

gdk-pixbuf-csource

is a small utility that generates C code containing images, used for compiling images directly into programs

gdk-pixbuf-pixdata

is a tool used to convert GdkPixbuf to GdkPixdata

gdk-pixbuf-query-loaders

collects information about loadable modules for Gdk Pixbuf and writes it to the default cache file location, or to stdout

gdk-pixbuf-thumbnailer

creates thumbnails of pictures for use in other applications

libgdk_pixbuf-2.0.so

contains functions used to load and render images