Beyond Linux® From Scratch - Version 7.7

Chapter 25. X Libraries

GTK+-3.14.8

Introduction to GTK+ 3

The GTK+ 3 package contains the libraries used for creating graphical user interfaces for applications.

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

Package Information

GTK+ 3 Dependencies

Required

at-spi2-atk-2.14.1, gdk-pixbuf-2.31.2, and Pango-1.36.8

Optional (Required if building GNOME)

gobject-introspection-1.42.0

Optional

Colord-1.2.9, Cups-2.0.2, DocBook-utils-0.6.14, GTK-Doc-1.21, JSON-GLib-1.0.2, rest, libxkbcommon, and Wayland

User Notes: http://wiki.linuxfromscratch.org/blfs/wiki/gtk3

Installation of GTK+ 3

[Note]

Note

GTK+ 3 will overwrite gtk-update-icon-cache from GTK+-2.24.26 if it is installed. There is nothing wrong about that assuming that both programs provide same functionality. If you wish to keep one from GTK+ 2 you can add --enable-gtk2-dependency to the configure command.

Install GTK+ 3 by running the following commands: 

./configure --prefix=/usr             \
            --sysconfdir=/etc         \
            --enable-broadway-backend \
            --enable-x11-backend      \
            --disable-wayland-backend &&
make

Some tests fail if /usr/share/glib-2.0/schemas/gschemas.compiled is not found. If you wish to run the test suite, create (or update) the file using the following command as the root user: 

glib-compile-schemas /usr/share/glib-2.0/schemas

To test the results you need a graphical session, then issue make check.

Now, as the root user: 

make install
[Note]

Note

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

gtk-query-immodules-3.0 --update-cache
[Note]

Note

If you installed the package to your system using a “DESTDIR” method, /usr/share/glib-2.0/schemas/gschemas.compiled was not updated/created. Create (or update) the file using the following command as the root user: 

glib-compile-schemas /usr/share/glib-2.0/schemas

Command Explanations

--enable-broadway-backend: switch enables the HTML5 GTK backend.

--enable-x11-backend: switch enables the X11 GDK backend.

--disable-wayland-backend: switch disables the Wayland GDK backend because Wayland isn't available in BLFS.

--enable-gtk-doc: Use this parameter if GTK-Doc is installed and you wish to rebuild and install the API documentation.

Configuring GTK+ 3

Config Files

~/.config/gtk-3.0/settings.ini and /etc/gtk-3.0/settings.ini

Configuration Information

GTK+ 3 themes change the way a GTK+ 3 application looks. An icon theme can be used to change the icons that appear on the application's toolbar. If you have installed a GTK+ 3 theme (eg gnome-themes-standard-3.14.2.3 or an icon theme (such as adwaita-icon-theme-3.14.1) you can set your prefences in ~/.config/gtk-3.0/settings.ini. Eg: 

mkdir -p ~/.config/gtk-3.0 &&
cat > ~/.config/gtk-3.0/settings.ini << "EOF"
[Settings]
gtk-theme-name = Adwaita
gtk-fallback-icon-theme = gnome
EOF

There are many more themes available at http://gnome-look.org/ and other places.

Once you've settled on themes you like, you can (as the root user) make them the default system wide: 

cat > /etc/gtk-3.0/settings.ini << "EOF"
[Settings]
gtk-theme-name = Clearwaita
gtk-fallback-icon-theme = elementary
EOF

Contents

Installed Programs: broadwayd, gtk3-demo, gtk3-demo-application, gtk3-icon-browser, gtk3-widget-factory, gtk-encode-symbolic-svg, gtk-launch, gtk-query-immodules-3.0, and gtk-update-icon-cache
Installed Libraries: libgailutil-3.so, libgdk-3.so, and libgtk-3.so
Installed Directories: /etc/gtk-3.0, /usr/include/gail-3.0, /usr/include/gtk-3.0, /usr/lib/gtk-3.0, /usr/share/gtk-3.0, /usr/share/gtk-doc/html/{gail-libgail-util3,gdk3,gtk3}, and /usr/share/themes/{Default,Emacs}/gtk-3.0

Short Descriptions

broadwayd

provides support for displaying GTK+ 3 applications in a web browser, using HTML5 and web sockets.

gtk-encode-symbolic-svg

converts symbolic svg icons into specially prepared png files. GTK+ 3 can load and recolor these pngs, just like original svgs, but loading them is much faster.

gtk-launch

launches an application using the given name. The name should match application desktop file name, as residing in /usr/share/application, with or without the '.desktop' suffix.

gtk-query-immodules-3.0

collects information about loadable input method modules for GTK+ 3 and writes it to the default cache file location, or to standard output.

gtk-update-icon-cache

is an icon theme caching utility that creates mmap()able cache files for icon themes.

gtk3-demo

is a simple program that demonstrates some of the things that can be done with GTK+ 3

gtk3-demo-application

is a simple GTK+ 3 application.

gtk3-icon-browser

is a utility to explore the icons in the current icon theme. It shows icons in various sizes, their symbolic variants where available, as well as a description of the icon and its context.

gtk3-widget-factory

is a program to view GTK+ 3 themes and widgets.

libgailutil-3.so

contains functions that implements the accessibility interfaces defined by the GNOME Accessibility Toolkit.

libgdk-3.so

contains functions that act as a wrapper around the low-level drawing and windowing functions provided by the underlying graphics system.

libgtk-3.so

contains functions that provide an API to implement graphical user interfaces.

Last updated on 2015-02-22 14:34:08 -0800