Beyond Linux® From Scratch (systemd Edition) - Version 11.3

Chapter 25. Graphical Environment Libraries

Cogl-1.22.8

Introduction to Cogl

Cogl is a modern 3D graphics API with associated utility APIs designed to expose the features of 3D graphics hardware using a direct state access API design, as opposed to the state-machine style of OpenGL.

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

Package Information

Cogl Dependencies

Required

Cairo-1.17.6, gdk-pixbuf-2.42.10, GLU-9.0.2, Mesa-22.3.5, Pango-1.50.12, and Wayland-1.21.0

Recommended

gobject-introspection-1.74.0

Optional

gst-plugins-base-1.22.0, GTK-Doc-1.33.2, SDL-1.2.15, and SDL2-2.26.3

User Notes: https://wiki.linuxfromscratch.org/blfs/wiki/cogl

Installation of Cogl

Install Cogl by running the following commands:

[Note]

Note

This package may occasionally fail when building with multiple processors. See Using Multiple Processors for more information. 

./configure --prefix=/usr  \
            --enable-gles1 \
            --enable-gles2 \
            --enable-{kms,wayland,xlib}-egl-platform \
            --enable-wayland-egl-server              &&
make

To test the results, issue: make check. The tests should be run from an X terminal on the hardware accelerated Xorg Server. A few tests will use all CPUs in parallel, regardless of parallellism settings.

Now, as the root user: 

make install

Command Explanations

--enable-gles1: This switch enables support for OpenGL ES 1.1.

--enable-gles2: This switch enables support for OpenGL ES 2.0.

--enable-{kms,wayland,xlib}-egl-platform: These switches enable support for KMS, Wayland and Xlib EGL platforms. They are required for GNOME Wayland support.

--enable-wayland-egl-server: This switch enables Cogl's Wayland Server API which is required for GNOME Wayland support.

--enable-cogl-gst: This switch enables gstreamer support.

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

Contents

Installed Programs: None
Installed Libraries: libcogl-gles2.so, libcogl-pango.so, libcogl-path.so, and libcogl.so, and optional libraries libcogl-gst.so and /usr/lib/gstreamer-1.0/libgstcogl.so
Installed Directories: /usr/include/cogl and /usr/share/cogl

Short Descriptions

libcogl-gles2.so

is the OpenGL ES 2.0 integration library for Cogl

libcogl-pango.so

is the Pango integration library for Cogl

libcogl.so

is an object oriented GL/GLES Abstraction/Utility Layer library