SDL2-2.0.9

#### Beyond Linux® From Scratch - Version 2019-02-27

### Chapter 42. Multimedia Libraries and Drivers

- Prev

  SDL-1.2.15

- Next

  SoundTouch-2.1.0

- Up
- Home

# SDL2-2.0.9

## Introduction to SDL2

The Simple DirectMedia Layer Version 2 (SDL2 for short) is a cross-platform library designed to make it easy to write multimedia software, such as games and emulators.

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

### Package Information

- Download (HTTP): http://www.libsdl.org/release/SDL2-2.0.9.tar.gz

- Download MD5 sum: f2ecfba915c54f7200f504d8b48a5dfe

- Download size: 5.0 MB

- Estimated disk space required: 164 MB (with docs)

- Estimated build time: 0.4 SBU (using parallelism=4; with docs)

### SDL2 Dependencies

#### Optional

ALSA-1.1.8, Doxygen-1.8.15 (to create documentation), ibus-1.5.19, NASM-2.14.02, PulseAudio-12.2, X Window System, DirectFB, and fcitx

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

## Installation of SDL2

Install SDL2 by running the following commands:

    ./configure --prefix=/usr &&
    make

If you have Doxygen-1.8.15 installed and want to build the html documentation, run the following commands:

    pushd docs  &&
      doxygen   &&
    popd

### Note

If you wish to build and run the package regression tests, do not delete the static libraries below until after the tests are built.

Now, as the `root` user:

    make install              &&
    rm -v /usr/lib/libSDL2*.a

If you built the documentation, install it as the `root` user:

    install -v -m755 -d        /usr/share/doc/SDL2-2.0.9/html &&
    cp -Rv  docs/output/html/* /usr/share/doc/SDL2-2.0.9/html

## Testing SDL2

If you wish to, test the installation of SDL2 using the included test programs. None of the resulting binaries need to be installed. Issue the following commands to build the test programs:

    cd test &&
    ./configure &&
    make

Each of the test programs (they are listed in the `README` file in this directory) will need to be run individually. Many of them will need to be manually killed. Additionally, speakers need to be on with the volume at a suitable level.

## Command Explanations

rm -v /usr/lib/libSDL2*.a: Normally static libraries can be disabled with a `--disable-static` option to configure, but that breaks the build in this package.

`--disable-alsa-shared`: This switch disables dynamically loading ALSA shared libraries.

`--disable-sdl-dlopen`: This switch disables using dlopen for shared object loading. Loading image backend libraries like libpng dynamically on the fly does not work.

`--disable-x11-shared`: This switch disables dynamically loading X11 shared libraries.

## Configuring SDL

### Configuration Information

As with most libraries, there is no configuration to do, save that the library directory, i.e., `/opt/lib` or `/usr/local/lib` should appear in `/etc/ld.so.conf` so that ldd can find the shared libraries. After checking that this is the case, /sbin/ldconfig should be run while logged in as `root`.

## Contents

Installed Program: sdl2-config
Installed Libraries: libSDL2.so
Installed Directories: /usr/include/SDL2 and /usr/share/doc/SDL-2.0.9

### Short Descriptions

sdl2-config | determines the compile and linker flags that should be used to compile and link programs that use `libSDL2`.
`libSDL2.so` | library provides low level access to audio, keyboard, mouse, joystick, 3D hardware via OpenGL, and 2D frame buffer across multiple platforms.

Last updated on 2019-02-17 15:55:58 -0600

- Prev

  SDL-1.2.15

- Next

  SoundTouch-2.1.0

- Up
- Home