Allegro

Allegro is a cross-platform library mainly aimed at video game and multimedia programming. It handles common, low-level tasks such as creating windows, accepting user input, loading data, drawing images, playing sounds, etc. and generally abstracting away the underlying platform. However, Allegro is not a game engine: you are free to design and structure your program as you like. Allegro 5 has the following additional features: Supported on Windows, Linux, Mac OSX, iPhone and Android User-friendly, intuitive C API usable from C++ and many other programming languages Hardware accelerated bitmap and graphical primitive drawing support (via OpenGL or Direct3D) Audio recording support Font loading and drawing Video playback Abstractions over shaders and low-level polygon drawing And more! This readme contains general information which applies to all platforms that Allegro builds on. README make.txt discusses compilation with GNU make. This applies to Unix-like operating systems such as Linux, MacOS X and MinGW on Windows. We assume you have C and C++ compilers installed and functioning. We support gcc, clang and MSVC. Allegro is divided into a core library and a number of addon libraries. The core library depends on certain libraries to function. If you don't have those, nothing will work. These are required for the core library: DirectX SDK (Windows only) You can get this for MSVC from the Microsoft web site (large download). Alternatively, smaller downloads for MSVC and MinGW are available here: . Some MinGW distributions come with sufficient DirectX SDK to support compiling Allegro. X11 development libraries (Linux/Unix only) The libraries will be part of your Linux distribution, but you may have to install them explicitly. OpenGL development libraries (optional only on Windows) The addons, too, may require additional libraries. Since the addons are strictly optional, they are not required to build Allegro, but a lot of functionality may be disabled if they are not present. Windows users may find some precompiled binaries for the additional libraries from . You need to get the bin and lib packages. The bin packages contain DLLs, and the lib packages contain the headers and import libraries. Mac users may find some dependencies in Homebrew, Fink or MacPorts. , and Linux users likely have all the dependencies already, except PhysicsFS and DUMB. If your distribution uses separate development packages, they will need to be installed. The packages are probably named -dev or -devel. On Windows/Mac OS X/iPhone/Android, PNG image support is available by using the native facilities on the respective operating systems, so libpng is not required. libjpeg, for JPEG image support (Unix and older MinGW only) Home page: Windows binaries: On Windows/Mac OS X/iPhone/Android, JPEG image support is available by using the native facilities on the respective operating systems, so libjpeg is not required. libwebp, for WebP image support Home page: On Windows it may be a pain to place all these libraries such that they can be found. Please see the README cmake.txt section on the "deps subdirectory" when the time comes. To build the documentation you will need Pandoc. Pandoc's home page is Installing Pandoc from source can be challenging, but you can build Allegro without building the documentation. Building with CMake is a two step process. During the configuration step, cmake will detect your compiler setup and find the libraries which are installed on your system. At the same time, you may select options to customise your build. If you are unsure of what you are doing, leave all the options at the defaults. Once the configuration step is successful, you will invoke another tool to build Allegro. The tool depends on your compiler, but is usually either make , or your IDE.