Allegroは、主にビデオゲームとマルチメディアプログラミングを対象としたクロスプラットフォームライブラリです。ウィンドウの作成、ユーザー入力の受け入れ、データの読み込み、画像の描画、音などの一般的な低レベルのタスクを処理し、一般的に基礎となるプラットフォームを抽象化します。ただし、Allegroはゲームエンジンではありません。プログラムを自由に設計および構成することができます。
Allegro 5には次の追加機能があります。
このREADMEには、Allegroが構築するすべてのプラットフォームに適用される一般的な情報が含まれています。
readme_cmake.txtは、cmakeのビルドオプションについて説明します。
readme_msvc.txt Microsoft Visual C/C ++でWindowsでのコンピレーションについて説明します。
readme_make.txtは、gnu makeとのコンピレーションについて説明します。これは、WindowsのLinux、MacOS X、MingWなどのUNIXのようなオペレーティングシステムに適用されます。
readme_macosx.txtには、macos xにいくつかの追加メモがあります。
readme_iphone.txtはiPhoneオペレーティングシステムについて説明します。
CおよびC ++コンパイラがインストールされ、機能していると仮定します。 GCC、Clang、MSVCをサポートしています。
アレグロは、構築するためにCmake 3.0以降も必要です。 http://www.cmake.org/からダウンロードできます
Allegroは、コアライブラリと多数のアドオンライブラリに分かれています。コアライブラリは、機能する特定のライブラリに依存します。あなたがそれらを持っていないなら、何もうまくいきません。これらは、コアライブラリに必要です。
DirectXSDK(Windowsのみ)
Microsoft WebサイトからMSVCのこれを入手できます(大規模なダウンロード)。
または、MSVCとMINGWの小さなダウンロードをここから入手できます:http://liballeg.org/download.html#miscellaneous-files。一部のMINGW分布には、ALLEGROのコンパイルをサポートするのに十分なDirectXSDKが付属しています。
X11開発ライブラリ(Linux/Unixのみ)ライブラリはLinuxディストリビューションの一部になりますが、明示的にインストールする必要がある場合があります。
OpenGL開発ライブラリ(Windowsでのみオプション)
アドオンも追加のライブラリが必要になる場合があります。アドオンは厳密にオプションであるため、アレグロを構築するために必要ではありませんが、存在しない場合は多くの機能が無効になる場合があります。
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 and zlib、png image support(unix and land older 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、for webp画像サポートホームページ:https://developers.google.com/speed/webp/
Androidでは、Operating Systemのネイティブ設備を使用してWebPイメージサポートを利用できます。そのため、LibWebpは必要ありません。
TrueTypeフォントサポート用のFreetype。ホームページ: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/
愚かな、それ、XM、S3M、MODプレーヤーライブラリ。 (libdumb)ホームページ:http://dumb.sourceforge.net/
オープン、3DオーディオAPI。 3D機能は使用されていませんが、オーディオアドオンはオープンを使用できます。 http://kcat.strangesoft.net/openal.html
Mac OS Xでは、Openalが必要ですが、とにかくOSに付属する必要があります。
LinuxとWindowsでは、オープンが使用される場合にのみ使用されるため、具体的にインストールする理由はありません。
Physicsfsは、Eg .Zipファイルなどのアーカイブへのアクセスを提供します。ホームページ:http://icculus.org/physfs/
Windowsでは、これらすべてのライブラリを配置して、それらを見つけることができるのは苦痛かもしれません。時が来たら、「DEPSサブディレクトリ」のreadme_cmake.txtセクションを参照してください。
ドキュメントを作成するには、Pandocが必要になります。 Pandocのホームページはhttp://johnmacfarlane.net/pandoc/です
SourceからPandocをインストールするのは難しい場合がありますが、ドキュメントを作成せずにAllegroを構築できます。
オンラインドキュメントは、Allegro Webサイト:http://docs.liballeg.org/で入手できます。
Cmakeを使用した建物は2段階のプロセスです。構成ステップ中、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を読んでください。