访问官网
Github
文档欢迎使用Allegro!
Allegro是一个跨平台库,主要面向视频游戏和多媒体编程。它处理常见的底层任务,如创建窗口、接受用户输入、加载数据、绘制图像、播放声音等,并通常抽象底层平台。然而,Allegro不是一个游戏引擎:你可以自由设计和构建你的程序结构。
Allegro 5具有以下额外特性:
- 支持Windows、Linux、Mac OSX、iPhone和Android
- 用户友好、直观的C API,可从C++和许多其他编程语言使用
- 硬件加速的位图和图形基元绘制支持(通过OpenGL或Direct3D)
- 音频录制支持
- 字体加载和绘制
- 视频播放
- 着色器和低级多边形绘制的抽象
- 以及更多!
本自述文件包含适用于Allegro可构建的所有平台的一般信息。
README_cmake.txt讨论了一些CMake的构建选项。
README_msvc.txt讨论了在Windows上使用Microsoft Visual C/C++的编译。
README_make.txt讨论了使用GNU make的编译。这适用于类Unix操作系统,如Linux、MacOS X和Windows上的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发行版附带了足够支持编译Allegro的DirectX SDK。
-
X11开发库(仅Linux/Unix) 这些库是Linux发行版的一部分,但你可能需要明确安装。
-
OpenGL开发库(仅在Windows上可选)
附加库也可能需要额外的库。由于附加库是严格可选的,它们不是构建Allegro所必需的,但如果没有它们,许多功能可能会被禁用。
Windows用户可以从http://gnuwin32.sourceforge.net/找到一些额外库的预编译二进制文件。你需要获取bin和lib包。bin包含DLL,lib包含头文件和导入库。
Mac用户可以在Homebrew、Fink或MacPorts中找到一些依赖项。 http://brew.sh/、http://www.finkproject.org/和 http://www.macports.org/
Linux用户可能已经拥有所有依赖项,除了PhysicsFS和DUMB。如果你的发行版使用单独的开发包,则需要安装它们。这些包可能命名为*-dev或*-devel。
以下是附加库所需的依赖项:
-
libpng和zlib,用于PNG图像支持(仅Unix和旧版MinGW) 主页:http://www.libpng.org/pub/png/ Windows二进制文件:http://gnuwin32.sourceforge.net/packages/libpng.htm
在Windows/Mac OS X/iPhone/Android上,PNG图像支持可通过使用各自操作系统的本机功能获得,因此不需要libpng。
-
libjpeg，用于JPEG图像支持（仅适用于Unix和较旧的MinGW） 主页：http://www.ijg.org/ Windows二进制文件：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/
-
DUMB，一个IT、XM、S3M和MOD播放器库（libdumb） 主页：http://dumb.sourceforge.net/
-
OpenAL，一个3D音频API 音频插件可以使用OpenAL，尽管3D功能未被使用。 http://kcat.strangesoft.net/openal.html
在Mac OS X上，OpenAL是必需的，但应该已经随操作系统一起提供。
在Linux和Windows上，只有在您明确请求时才会使用OpenAL，因此没有特别安装它的必要。
-
PhysicsFS，提供对档案（如.zip文件）的访问 主页：http://icculus.org/physfs/
在Windows上，要将所有这些库放置在可被找到的位置可能会很麻烦。当需要时，请参阅README_cmake.txt中关于"deps子目录"的部分。
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。
