allegro5

Bem -vindo ao Allegro!

Allegro é uma biblioteca de plataformas cruzadas, principalmente para videogame e programação multimídia. Ele lida com tarefas comuns e de baixo nível, como criar janelas, aceitar a entrada do usuário, carregar dados, desenhar imagens, reproduzir sons etc. e geralmente abstrair a plataforma subjacente. No entanto, Allegro não é um mecanismo de jogo: você é livre para projetar e estruturar seu programa como quiser.

Allegro 5 tem os seguintes recursos adicionais:

• Suportado no Windows, Linux, Mac OSX, iPhone e Android
• API I intuitiva e amigável, utilizável de C ++ e muitas outras linguagens de programação
• Bitmap acelerado de hardware e suporte gráfico de desenho primitivo (via OpenGL ou Direct3D)
• Suporte de gravação de áudio
• Carregamento e desenho de fontes
• Reprodução de vídeo
• Abstrações sobre shaders e desenho de polígonos de baixo nível
• E mais!

Este ReadMe contém informações gerais que se aplica a todas as plataformas nas quais o Allegro se baseia.

Readme_cmake.txt discute algumas opções de construção para cmake.

Readme_MSVC.txt discute a compilação no Windows com o Microsoft Visual C/C ++.

Readme_Make.txt discute a compilação com o GNU Make. Isso se aplica a sistemas operacionais do tipo UNIX, como Linux, MacOS X e Mingw no Windows.

Readme_macosx.txt possui algumas notas adicionais para o macOS x.

Readme_iphone.txt discute os sistemas operacionais do iPhone.

Requisitos

Assumimos que você possui compiladores C e C ++ instalados e funcionando. Apoiamos o GCC, CLANG e MSVC.

Allegro também requer CMake 3.0 ou posterior para construir. Você pode baixá -lo em http://www.cmake.org/

Dependências da biblioteca

Allegro é dividido em uma biblioteca principal e várias bibliotecas de addon. A biblioteca principal depende de determinadas bibliotecas para funcionar. Se você não tem isso, nada funcionará. Estes são necessários para a biblioteca principal:

• DirectX SDK (somente Windows)

  Você pode obter isso para MSVC no site da Microsoft (download grande).

  Alternativamente, downloads menores para MSVC e Mingw estão disponíveis aqui: http://liballeg.org/download.html#miscellane-files. Algumas distribuições Mingw vêm com SDK DirectX suficiente para apoiar a compilação do Allegro.

• Bibliotecas de desenvolvimento X11 (somente Linux/UNIX) As bibliotecas farão parte da sua distribuição Linux, mas você pode precisar instalá -las explicitamente.

• Bibliotecas de Desenvolvimento OpenGL (opcionais apenas no Windows)

Os complementos também podem exigir bibliotecas adicionais. Como os complementos são estritamente opcionais, eles não são obrigados a construir o Allegro, mas muitas funcionalidades podem ser desativadas se não estiverem presentes.

Os usuários do Windows podem encontrar alguns binários pré -compilados para as bibliotecas adicionais em http://gnuwin32.sourceforge.net/. Você precisa obter os pacotes bin e lib . Os pacotes bin contêm DLLs e os pacotes lib contêm os cabeçalhos e as bibliotecas de importação.

Os usuários de Mac podem encontrar algumas dependências em homebrew, fink ou Macports. http://brew.sh/, http://www.finkproject.org/ e http://www.macports.org/

Os usuários do Linux provavelmente já têm todas as dependências, exceto o Physicsfs e o burro. Se sua distribuição usar pacotes de desenvolvimento separados, eles precisarão ser instalados. Os pacotes provavelmente são nomeados *-Dev ou *-Devel.

Estas são as dependências necessárias para os complementos:

• Libpng e Zlib, para suporte à imagem PNG (Unix e apenas mais antigo Mingw) Página inicial: http://www.libpng.org/pub/png/ binários do Windows: http://gnuwin32.sourcege.net/packages/libpng.htmmmmmmmmmmmmem

  No Windows/Mac OS X/iPhone/Android, o suporte à imagem PNG está disponível usando as instalações nativas nos respectivos sistemas operacionais, portanto o libpng não é necessário.

• Libjpeg, para suporte da imagem JPEG (Unix e Mingw Somente Mingw mais antigo) Página inicial: http://www.ijg.org/ Windows Binários: http://gnuwin32.sourceforge.net/packages/jpeg.htm

  No Windows/Mac OS X/iPhone/Android, o JPEG Image Support está disponível usando as instalações nativas nos respectivos sistemas operacionais, para que a libjpeg não seja necessária.

• Libwebp, para o Webp Image Support Page: https://developers.google.com/speed/webp/

  No Android, o suporte à imagem do WebP está disponível usando as instalações nativas do sistema operacional, para que a libwebp não seja necessária.

• Freetype, para suporte de fonte TrueType. Página inicial: http://freetype.sourceforge.net/ Windows Binários: http://gnuwin32.sourceforge.net/packages/freetype.htm

• Ogg Vorbis, um formato de áudio com perdas gratuitas. (Libogg, Libvorbis, Libvorbisfile) Página inicial: http://www.vorbis.com/

• Opus, um codec de áudio com perdas gratuitas. (Libogg, libopus, libopusfile) Página inicial: http://www.opus-codec.org/

• FLAC, um codec de áudio sem perdas. (Libflac, libogg) Página inicial: http://flac.sourceforge.net/

• Biblioteca de player de It, XM, S3M e Mod Dumb, XM, S3M e Mod. (Libdumb) Página inicial: http://dumb.sourceforge.net/

• Openal, uma API de áudio 3D. O Addon de áudio pode usar o Openal, embora os recursos 3D não sejam usados. http://kcat.strangesoft.net/openal.html

  No Mac OS X, o Openal é necessário , mas deve vir com o sistema operacional de qualquer maneira.

  No Linux e Windows, o Opental só será usado se você solicitar, portanto, não há razão para instalá -lo especificamente.

• Physicsfs, fornece acesso a arquivos, por exemplo, arquivos .zip. Página inicial: http://icculus.org/physfs/

No Windows, pode ser uma dor colocar todas essas bibliotecas para que possam ser encontradas. Consulte a seção ReadMe_Cmake.txt no "subdiretório de depósito" quando chegar a hora.

Documentação da API

Para construir a documentação, você precisará do Pandoc. A página inicial de Pandoc é http://johnmacfarlane.net/pandoc/

Instalar o Pandoc a partir da fonte pode ser um desafio, mas você pode criar Allegro sem criar a documentação.

A documentação online está disponível no site da Allegro: http://docs.liballeg.org/

Construção com cmake

Construir com cmake é um processo de duas etapas. Durante a etapa de configuração , o CMake detectará sua configuração do compilador e encontrará as bibliotecas instaladas no seu sistema. Ao mesmo tempo, você pode selecionar opções para personalizar sua construção. Se você não tiver certeza do que está fazendo, deixe todas as opções nos padrões.

Você deve configurar o Allegro com um diretório de construção separado. Por exemplo,

 mkdir build
cd build
cmake ..

Se você configurar o Allegro para construir no diretório de origem (ou seja, cmake . ), você receberá uma mensagem de erro. Exclua CMakeCache.txt e o diretório CMakeFiles e reconfigure como descrito acima.

Quando a etapa de configuração for bem -sucedida, você invocará outra ferramenta para criar o Allegro. A ferramenta depende do seu compilador, mas geralmente é make ou do seu IDE.

Para evitar problemas, descompacte o Allegro em um diretório sem espaços ou outros personagens "estranhos" no caminho . Este é um problema conhecido.

Agora leia readme_msvc.txt, readme_make.txt ou readme_macosx.txt.