referencia > articulos > instalar_sdl
Relacionados

Guia de instalación de las bibliotecas SDL en GNU/Linux

Créditos

  • Autor: Hugo Ruscitti
  • Fecha: 6 de Febrero de 2005

Introducción:

Algunas distribuciones de GNU/Linux incluyen las bibliotecas SDL y todo lo necesario entre sus archivos de instalación. Con lo cual la instalación en esos sistemas es demasiado sencilla para crear un documento de instalación.

Lo primero que debe hacer es buscar los archivos que muestro a continuación en su distribución, ya sea en formato RPM, deb... desde CDROMs oficiales o Internet. Si no encuentra esos archivos o quiere seguir leyendo, adelante.

En esta guia explico otro procedimiento de instalación, que funciona con cualquier distribución: Instalaremos las bibliotecas compilando sus archivos fuente.

Requisitos

Compilador de lenguaje C

Lo primero que necesita tener es el compilador de lenguaje C (gcc) y sus bibliotecas, generalmente estos requisitos están cubiertos por todas las distribuciones de GNU/Linux.

Puede verificar si tiene instalado el compilador gcc ejecutando:

gcc -version

Se obtiene un mensaje como el siguiente:

gcc (GCC) 3.3.4 (Debian 1:3.3.4-13)Copyright (C) 2003 Free Software Foundation, Inc.Esto es software libre; vea el código para las condiciones de copia. NO hay garantía; ni siquiera para MERCANTIBILIDAD o IDONEIDAD PARA UN PROPÓSITO EN PARTICULAR

También es recomendable instalar un compilador de lenguaje C++, la mayoría de nuestros trabajos se desarrollan en este lenguaje.

Para verificar si tiene este compilador ejecute:

g++ -version

La salida es similar a la anterior:

g++ (GCC) 3.3.4 (Debian 1:3.3.4-13)Copyright (C) 2003 Free Software Foundation, Inc.Esto es software libre; vea el código para las condiciones de copia. NO hay garantía; ni siquiera para MERCANTIBILIDAD o IDONEIDAD PARA UN PROPÓSITO EN PARTICULAR

Requerimientos

Por último debe tener los archivos de código fuente de las bibliotecas:

  • libSDL
  • libSDL_image
  • libSDL_mixer
  • libpng
  • libjpeg
  • zlib

Nota: zlib, libpng y libjpeg son necesarias para libSDL_image, antes de descargarlas busquelas en su sistema, seguramente las tendrá y podrá evitar instalarlas nuevamente.

Obtener las Bibliotecas:

Si bien solo es realmente necesaria la biblioteca libSDL, el resto de las bibliotecas brindan mayores funcionalidades que utilizamos con frecuencia. Por ejemplo libSDL, solo tiene soporte para imágenes de tipo BMP, mientras que libSDL_image añade la posibilidad de cargar imágenes png, jpeg, pcx, etc.

Puede obtener las bibliotecas desde sus sitios oficiales o desde nuestro sitio. Si tiene tiempo para buscar, le recomiendo que visite los sitios oficiales para obtener las versiones mas recientes.

Biblioteca Bajar desde Bajar desde Visitar
libSDL Sitio Oficial Sitio Oficial
libSDL_image Sitio Oficial Sitio Oficial
libSDL_mixer Sitio Oficial Sitio Oficial
libpng Este Sitio Sitio Oficial
libjpeg Este Sitio Sitio Oficial
zlib Este Sitio Sitio Oficial

Descompresión

Vamos a suponer que guardó todos estos archivos en un directorio llamado 'descargas' y pide un listado de archivos:

lsjpegsrc.v6b.tar.gzSDL-1.2.8.tar.gzSDL_mixer-1.2.6.tar.gzlibpng-1.2.8-config.tar.gzSDL_image-1.2.4.tar.gzzlib-1.2.1.tar.gz

Todos los archivos están comprimidos con gzip. Si tiene alguna duda de ello recuerde que el comando 'file' le informa acerca del contenido de un archivo sin verificar la extensión del mismo:

file SDL-1.2.3.tar.gzSDL-1.2.8.tar.gz: gzip compressed data, from Unix

Para terminar este paso solo resta descomprimir cada una de los archivos:

tar xzvf jpegsrc.v6b.tar.gztar xzvf SDL-1.2.8.tar.gztar xzvf SDL_mixer-1.2.6.tar.gztar xzvf libpng-1.2.8-config.tar.gztar xzvf SDL_image-1.2.4.tar.gztar xzvf zlib-1.2.1.tar.gz
Consejo: con la tecla de tabulación (TAB ->) el interprete de comandos habitual de GNU/Linux (bash) auto-completa los nombres de ficheros y comandos, pruebe 'tar xzvf zl'.

Configurar e instalar:

Luego de la descompresión se genera un directorio por cada archivo tar.gz, con ficheros de desarrollo y documentación como README o INSTALL, léalos si tiene la posibilidad:

lsSDL-1.2.8SDL_mixer-1.2.6zlib-1.2.1jpeg-6blibpng-1.2.8-configSDL_image-1.2.4

Tiene que entrar en cada uno de estos directorios (cd 'directorio') respetando el orden de la lista anterior y ejecutar en cada uno de estos comandos:

./configuremakesu (solo si no es el usuario administrador = root)make installexit (si ejecutó 'su' anteriormente)

Si todo salió bien tendrá algunos comandos nuevos como 'sdl-config'.

¿ Donde están los nuevos archivos ?

Los mas importantes están en:

  • /usr/local/include/SDL - ficheros de cabecera
  • /usr/local/bin - sdl-config
  • /usr/local/lib - bibliotecas
  • /usr/local/man - paginas de manuales

Verificando si funciona

Hasta aquí todo debería funcionar correctamente, puede compilar uno de nuestros juegos o intentar con un ejemplo como el siguiente:

Genere un archivo llamado main.c con el siguiente código:

#include <SDL/SDL.h>
#include <stdio.h>
#include <stdlib.h>

int main (int argc, char * argv [])
{
        SDL_Surface *screen;
        SDL_Event event;

        if (SDL_Init(SDL_INIT_VIDEO) == -1)
        {
                printf("Error en SDL_Init: %s\n", SDL_GetError());
                return 1;
        }

        atexit(SDL_Quit);

        screen = SDL_SetVideoMode(320, 200, 16, SDL_ANYFORMAT);

        if (screen == NULL)
        {
                printf("Error en SDL_SetVideoMode: %s\n", SDL_GetError());
                return 1;
        }

        SDL_WM_SetCaption("Ejemplo base", NULL)

        while (1)
        {
                while (SDL_PollEvent(& event))
                {
                        if (event.type == SDL_QUIT)
                                return 0;
                }
        }

        return 0;
}

Una vez generado el archivo tiene que compilarlo, le proponemos dos formas:

gcc -o test main.c -lSDL -lpthread

o bien

gcc -o test main.c `sdl-config --libs`

y para ejecutar la demostración:

./test

con este ejemplo solo vemos que la biblioteca SDL funciona, pero nos falta SDL_image y SDL_mixer, compilemos nuevamente:

gcc -o test main.c -lSDL -lpthread -lSDL_mixer -lSDL_image

Si bien no modificamos los fuentes para agregar la funcionalidad extra que nos proveen estas bibliotecas, compilando nuevamente sabremos si al menos la instalación fue correcta.

© 2006 Hugo Ruscitti