allegro5

欢迎来到Allegro！

Allegro是一个跨平台库，主要针对视频游戏和多媒体编程。它处理常见的低级任务，例如创建窗口，接受用户输入，加载数据，绘制图像，播放声音等，并通常将基础平台抽象出来。但是，Allegro不是游戏引擎：您可以随意设计和构建程序。

Allegro 5具有以下其他功能：

• 在Windows，Linux，Mac OSX，iPhone和Android上支持
• 用户友好，直观的C API可从C ++和许多其他编程语言使用
• 硬件加速位图和图形原始图形支持（通过OpenGL或Direct3D）
• 录音支持
• 字体加载和绘图
• 视频播放
• 着色器上的抽象和低级多边形图
• 还有更多！

此读书我包含适用于Allegro构建的所有平台的一般信息。

readme_cmake.txt讨论了Cmake的一些构建选项。

readme_msvc.txt与Microsoft Visual C/C ++在Windows上讨论了编译。

readme_make.txt讨论了使用GNU Make的编译。这适用于Windows上类似Unix的操作系统，例如Linux，MacOS X和Mingw。

readme_macosx.txt还有一些其他关于MacOS X的注释。

readme_iphone.txt讨论iPhone操作系统。

要求

我们假设您已经安装了C和C ++编译器。我们支持GCC，Clang和MSVC。

Allegro还需要Cmake 3.0或更高版本才能构建。您可以从http://www.cmake.org/下载它

库依赖性

Allegro分为一个核心库和许多插件库。核心库取决于某些库的功能。如果您没有这些，则无济于事。这些是核心库所需的：

• DirectX SDK（仅Windows）

  您可以从Microsoft网站（大下载）获得MSVC。

  另外，MSVC和MINGW的下载较小，请参见：http：//liballeg.org/download.html#miscellaneous-files。一些MINGW发行版带有足够的DirectX SDK来支持编译Allegro。

• X11开发库（仅Linux/Unix）库将成为Linux发行的一部分，但您可能必须明确安装它们。

• OpenGL开发库（仅在Windows上可选）

插件也可能需要其他库。由于附加子是严格的可选，因此不需要构建Allegro，但是如果不存在，则可能会禁用许多功能。

Windows用户可能会从http://gnuwin32.sourceforge.net/找到其他库中的一些预编译二进制文件。您需要获取bin和lib包。 bin包装包含DLL， lib软件包包含标题和导入库。

Mac用户可能会在自制，Fink或MacPorts中找到一些依赖项。 http://brew.sh/，http://www.finkproject.org/和http://www.macports.org/

Linux用户可能已经拥有所有依赖关系，除了物理和愚蠢之外。如果您的发行版使用单独的开发软件包，则需要安装它们。这些软件包可能被命名为 *-dev或 *-devel。

这些是插件所需的依赖项：

• libpng and zlib, for PNG image support (Unix and older MinGW only) Home page: http://www.libpng.org/pub/png/ Windows binaries: http://gnuwin32.sourceforge.net/packages/libpng.htm

  在Windows/Mac OS X/iPhone/Android上，可以通过使用相应操作系统上的本机设施获得PNG图像支持，因此不需要LIBPNG。

• libjpeg，用于jpeg映像支持（仅UNIX和较旧的mingw）主页：http：//www.ijijg.org/ windows binaries：http：//gnuwin32.sourceforge.net/packages/jpeg.htm

  在Windows/Mac OS X/iPhone/Android上，可以通过使用相应操作系统上的本机设施获得JPEG图像支持，因此不需要LibjPeg。

• libwebp，用于WebP映像支持主页：https：//developers.google.com/speed/webp/

  在Android上，可以使用操作系统的本机设施获得WebP映像支持，因此不需要LibWebp。

• freetype，用于trueType字体支持。主页：http：//freetype.sourceforge.net/ Windows二进制文件：http：//gnuwin32.sourceforge.net/packages/freetype.htm

• Ogg Vorbis，一种免费的有损音频格式。 （libogg，libvorbis，libvorbisfile）主页：http：//www.vorbis.com/

• Opus，免费的有损音频编解码器。 （libogg，libopus，libopusfile）主页：http：//www.opus-codec.org/

• FLAC，免费的无损音频编解码器。 （libflac，libogg）主页：http：//flac.sourceforge.net/

• 愚蠢，iT，XM，S3M和Mod Player库。 （libdumb）主页：http：//dumb.sourceforge.net/

• 开放式，3D音频API。音频插件可以使用开放式，尽管未使用3D功能。 http://kcat.strangesoft.net/openal.html

  在Mac OS X上，需要开放式，但无论如何都应随操作系统带来。

  在Linux和Windows上，只有在您要求的情况下才能使用OpenAL，因此没有理由专门安装它。

• Physicsfs，提供对档案的访问权限，例如.zip文件。主页：http：//icculus.org/physfs/

在窗户上，放置所有这些图书馆可能会很痛苦。当时间到来时，请参阅“ DEPS子目录”上的readme_cmake.txt部分。

API文档

要构建文档，您将需要Pandoc。 Pandoc的主页是http://johnmacfarlane.net/pandoc/

从来源安装Pandoc可能具有挑战性，但是您可以在不构建文档的情况下构建Allegro。

在线文档可以在Allegro网站上找到：http：//docs.liballeg.org/

用Cmake建造

使用CMAKE构建是两个步骤的过程。在配置步骤中，CMAKE将检测您的编译器设置，并找到系统上安装的库。同时，您可以选择自定义构建的选项。如果您不确定自己在做什么，请在默认情况下将所有选项保留。

您必须使用单独的构建目录配置Allegro。例如，

 mkdir build
cd build
cmake ..

如果您将Allegro配置为在源目录中构建（即cmake .您将收到一条错误消息。如上所述，删除CMakeCache.txt和CMakeFiles目录和重新配置。

一旦配置步骤成功，您将调用另一个构建Allegro的工具。该工具取决于您的编译器，但通常是make或IDE。

为了避免问题，请将Allegro拆除到没有空格或其他“怪异”字符的目录中。这是一个已知的问题。

现在阅读readme_msvc.txt，readme_make.txt或readme_macosx.txt。