allegro5

Добро пожаловать в Аллегро!

Allegro-это кроссплатформенная библиотека, в основном нацеленная на видеоигры и мультимедийное программирование. Он обрабатывает общие задачи низкого уровня, такие как создание Windows, принятие пользовательского ввода, загрузка данных, рисование изображений, воспроизведение звуков и т. Д. И, как правило, абстрагирование базовой платформы. Тем не менее, Allegro не является игровым двигателем: вы можете разрабатывать и структурировать свою программу, как вам нравится.

Allegro 5 имеет следующие дополнительные функции:

• Поддерживается в Windows, Linux, Mac OSX, iPhone и Android
• Удобный, интуитивно понятный C API, используемый из C ++ и многих других языков программирования
• Аппаратный ускоренный растровый карта и графическая примитивная поддержка рисования (через OpenGL или Direct3D)
• Поддержка аудиозаписи
• Загрузка и рисунок шрифта
• Видео воспроизведение
• Абстракции над шейдерами и низкоуровневым рисунком полигона
• И еще!

Этот Readme содержит общую информацию, которая применяется ко всем платформам, на которых строится Allegro.

Readme_cmake.txt обсуждает некоторые варианты сборки для Cmake.

Readme_msvc.txt обсуждает компиляцию в Windows с Microsoft Visual C/C ++.

Readme_make.txt обсуждает компиляцию с GNU Make. Это относится к UNIX-подобным операционным системам, таким как Linux, MacOS X и Mingw в Windows.

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)

  Вы можете получить это для MSVC с веб -сайта Microsoft (большая загрузка).

  В качестве альтернативы, небольшие загрузки для MSVC и Mingw доступны здесь: http://liballeg.org/download.html#miscellese-files. Некоторые распределения Mingw поставляются с достаточным количеством DirectX SDK для поддержки составления Allegro.

• Библиотеки разработки X11 (только Linux/Unix) Библиотеки будут частью вашего распределения Linux, но вам, возможно, придется их явно установить.

• Библиотеки Development Development (опционально только на Windows)

Аддонам также может потребоваться дополнительные библиотеки. Поскольку аддоны строго необязательны, они не обязаны создавать аллегро, но много функциональности может быть отключено, если они отсутствуют.

Пользователи 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, вероятно, уже есть все зависимости, кроме Physicsfs и Dumb. Если в вашем распределении используются отдельные пакеты разработки, их необходимо будет установить. Пакеты, вероятно, названы *-dev или *-devel.

Это зависимости, необходимые для аддон:

• Libpng и Zlib, для поддержки изображений PNG (только Unix и Older Mingw) Домашняя страница: http://www.libpng.org/pub/png/ binaries Windows: http://gnuwin32.sourceforge.net/packages/libpng.htm

  В Windows/Mac OS X/iPhone/Android поддержка изображений PNG доступна с использованием собственных объектов в соответствующих операционных системах, поэтому LIBPNG не требуется.

• Libjpeg, для JPEG -поддержки изображения (Unix и Older Mingw Only) Домашняя страница: http://www.ijg.org/ Windows binaries: http://gnuwin32.sourceforge.net/packages/jpeg.htm

  В Windows/Mac OS X/iPhone/Android поддержка изображения JPEG доступна с использованием собственных объектов в соответствующих операционных системах, поэтому LibJPEG не требуется.

• Libwebp, для Home Page Webp Image Home Page: https://developers.google.com/speed/webp/

  На Android поддержка изображений Webp доступна с использованием нативных средств операционной системы, поэтому LIBWEBP не требуется.

• Freetype, для поддержки шрифтов Truetype. Главная страница: http://freetype.sourceforge.net/ binaries 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 Player Library. (libdumb) Домашняя страница: http://dumb.sourceforge.net/

• Открытый, 3D AUDIO API. Audio Addon может использовать Openal, хотя 3D -возможности не используются. http://kcat.strangesoft.net/openal.html

  На Mac OS X требуется Openal, но в любом случае должен поставляться с ОС.

  На Linux и Windows OpenAl будет использоваться только в случае его запроса, поэтому нет причин для его конкретной установки.

• Physicsfs, предоставляет доступ к архивам, например, файлы .zip. Главная страница: http://icculus.org/physfs/

В окнах может быть боль, чтобы разместить все эти библиотеки, чтобы их можно было найти. Пожалуйста, смотрите раздел readme_cmake.txt на «Deps Suberirectory», когда придет время.

Документация API

Чтобы создать документацию, вам понадобится Pandoc. Домашняя страница Pandoc - http://johnmacfarlane.net/pandoc/

Установка Pandoc из Source может быть сложной задачей, но вы можете создать Allegro, не создавая документацию.

Онлайн документация доступна на веб -сайте Allegro: http://docs.liballeg.org/

Здание с Cmake

Строительство с Cmake - это двухэтапный процесс. На шаге конфигурации Cmake обнаружит настройку компилятора и найдет библиотеки, которые установлены в вашей системе. В то же время вы можете выбрать параметры для настройки вашей сборки. Если вы не уверены в том, что делаете, оставьте все варианты по умолчанию.

Вы должны настроить Allegro с отдельным каталогом сборки. Например,

 mkdir build
cd build
cmake ..

Если вы настроите Allegro для создания в справочнике Source (то есть cmake . ) Вы получите сообщение об ошибке. Удалить CMakeCache.txt и каталог CMakeFiles и повторную конфигурацию, как описано выше.

Как только этап конфигурации будет успешным, вы вызовете еще один инструмент для создания Allegro. Инструмент зависит от вашего компилятора, но обычно либо make , либо с вашей IDE.

Чтобы избежать проблем, распаковать Аллегро в каталог без пробелов или других «странных» персонажей на пути . Это известная проблема.

Теперь прочитайте readme_msvc.txt, readme_make.txt или readme_macosx.txt.