allegro5

¡Bienvenido a Allegro!

Allegro es una biblioteca multiplataforma dirigida principalmente a videojuegos y programación multimedia. Maneja tareas comunes y de bajo nivel, como crear ventanas, aceptar la entrada del usuario, cargar datos, dibujar imágenes, reproducir sonidos, etc. y, en general, abstraer la plataforma subyacente. Sin embargo, Allegro no es un motor de juego: eres libre de diseñar y estructurar tu programa como quieras.

Allegro 5 tiene las siguientes características adicionales:

• Compatible con Windows, Linux, Mac OSX, iPhone y Android
• API C intuitiva e intuitiva utilizable de C ++ y muchos otros lenguajes de programación
• Soporte de mapa de bits acelerado de hardware y soporte gráfico de dibujo primitivo (a través de OpenGL o Direct3D)
• Soporte de grabación de audio
• Carga y dibujo de fuentes
• Reproducción de video
• Abstracciones sobre sombreadores y dibujo de polígono de bajo nivel
• ¡Y más!

Este readMe contiene información general que se aplica a todas las plataformas en las que Allegro se basa.

ReadMe_cmake.txt analiza algunas opciones de compilación para CMake.

ReadMe_MSVC.TXT analiza la compilación en Windows con Microsoft Visual C/C ++.

ReadMe_Make.txt analiza la compilación con GNU. Esto se aplica a sistemas operativos similares a UNIX como Linux, MacOS X y Mingw en Windows.

ReadMe_macosx.txt tiene algunas notas adicionales para MacOS X.

ReadMe_iphone.txt analiza los sistemas operativos de iPhone.

Requisitos

Suponemos que tiene compiladores C y C ++ instalados y funcionando. Apoyamos GCC, Clang y MSVC.

Allegro también requiere que Cmake 3.0 o posterior se construya. Puede descargarlo desde http://www.cmake.org/

Dependencia de la biblioteca

Allegro se divide en una biblioteca central y varias bibliotecas de complementos. La biblioteca central depende de ciertas bibliotecas para funcionar. Si no tienes eso, nada funcionará. Estos son necesarios para la biblioteca central:

• DirectX SDK (solo Windows)

  Puede obtener esto para MSVC desde el sitio web de Microsoft (descarga grande).

  Alternativamente, las descargas más pequeñas para MSVC y MINGW están disponibles aquí: http://liballeg.org/download.html#miscelanous-files. Algunas distribuciones MingW vienen con suficientes DirectX SDK para admitir la compilación de Allegro.

• Bibliotecas de desarrollo X11 (solo Linux/UNIX) Las bibliotecas serán parte de su distribución de Linux, pero es posible que deba instalarlas explícitamente.

• Bibliotecas de desarrollo de OpenGL (opcional solo en Windows)

Los complementos también pueden requerir bibliotecas adicionales. Dado que los complementos son estrictamente opcionales, no están obligados a construir Allegro, pero se puede deshabilitar mucha funcionalidad si no están presentes.

Los usuarios de Windows pueden encontrar algunos binarios precompilados para las bibliotecas adicionales de http://gnuwin32.sourceforge.net/. Necesitas obtener los paquetes bin y lib . Los paquetes bin contienen DLL, y los paquetes lib contienen los encabezados y las bibliotecas de importación.

Los usuarios de Mac pueden encontrar algunas dependencias en Homebrew, Fink o MacPorts. http://brew.sh/, http://www.finkproject.org/ y http://www.macports.org/

Los usuarios de Linux probablemente ya tengan todas las dependencias, excepto PhysicsFS y Dumb. Si su distribución utiliza paquetes de desarrollo separados, deberá instalarse. Los paquetes probablemente se llamen *-dev o *-DEVEL.

Estas son las dependencias necesarias para los complementos:

• Libpng y Zlib, para soporte de imagen PNG (UNIX y Mingw más antiguo) Página de inicio: http://www.libpng.org/pub/png/ binarios de Windows: http://gnuwin32.sourceforge.net/packages/libpng.htm

  En Windows/Mac OS X/iPhone/Android, el soporte de imagen PNG está disponible utilizando las instalaciones nativas en los sistemas operativos respectivos, por lo que no se requiere libpng.

• libjpeg, para soporte de imagen JPEG (UNIX y más antiguo Mingw) Página de inicio: http://www.ijg.org/ binarios de Windows: http://gnuwin32.sourceforge.net/packages/jpeg.htm

  En Windows/Mac OS X/iPhone/Android, el soporte de imagen JPEG está disponible utilizando las instalaciones nativas en los sistemas operativos respectivos, por lo que no se requiere libjpeg.

• libwebp, para la página de inicio de soporte de imagen webp: https://developers.google.com/speed/webp/

  En Android, el soporte de imagen WebP está disponible mediante el uso de las instalaciones nativas del sistema operativo, por lo que no se requiere libwebp.

• FreeType, para el soporte de fuentes TrueType. Página de inicio: http://freetype.sourceforge.net/ binarios de Windows: http://gnuwin32.sourceforge.net/packages/freetype.htm

• OGG Vorbis, un formato de audio de pérdida libre. (libogg, libvorbis, libvorbisfile) Página de inicio: http://www.vorbis.com/

• Opus, un códec de audio sin pérdida. (Libogg, Libopus, Libopusfile) Página de inicio: http://www.opus-codec.org/

• FLAC, un códec de audio sin pérdidas gratis. (libflac, libogg) Página de inicio: http://flac.sourceforge.net/

• Dumb, An IT, XM, S3M y Mod Player Library. (libdumb) Página de inicio: http://dumb.sourceforge.net/

• Openal, una API de audio 3D. El complemento de audio puede usar Openal, aunque no se usan las capacidades 3D. http://kcat.strangesoft.net/openal.html

  En Mac OS X, se requiere Openal, pero de todos modos debe venir con el sistema operativo.

  En Linux y Windows, Openal solo se utilizará si lo solicita, por lo tanto, no hay razón para instalarlo específicamente.

• Physicsfs, proporciona acceso a archivos, por ejemplo, archivos .zip. Página de inicio: http://icculus.org/physfs/

En Windows puede ser un dolor colocar todas estas bibliotecas de tal manera que se puedan encontrar. Consulte la sección ReadMe_cmake.txt en el "Subdirectorio DEPS" cuando llegue el momento.

Documentación de API

Para construir la documentación, necesitará PANDOC. La página de inicio de Pandoc es http://johnmacfarlane.net/pandoc/

Instalar pandoc desde la fuente puede ser un desafío, pero puede construir Allegro sin construir la documentación.

La documentación en línea está disponible en el sitio web de Allegro: http://docs.liballeg.org/

Edificio con cmake

Construir con Cmake es un proceso de dos pasos. Durante el paso de configuración , CMake detectará la configuración de su compilador y encontrará las bibliotecas que están instaladas en su sistema. Al mismo tiempo, puede seleccionar opciones para personalizar su compilación. Si no está seguro de lo que está haciendo, deje todas las opciones en los valores predeterminados.

Debe configurar Allegro con un directorio de compilación por separado. Por ejemplo,

 mkdir build
cd build
cmake ..

Si configura Allegro para construir en el directorio de origen (es decir, cmake . Recibirá un mensaje de error. Eliminar CMakeCache.txt y el directorio CMakeFiles y volver a configurar como se describió anteriormente.

Una vez que el paso de configuración sea exitoso, invocará otra herramienta para construir Allegro. La herramienta depende de su compilador, pero generalmente se make o de su IDE.

Para evitar problemas, desempaquete a Allegro en un directorio sin espacios u otros personajes "extraños" en el camino . Este es un problema conocido.

Ahora lea ReadMe_Msvc.txt, readme_make.txt o readme_macosx.txt.