allegro5

Allegro에 오신 것을 환영합니다!

Allegro는 주로 비디오 게임 및 멀티미디어 프로그래밍을 목표로하는 크로스 플랫폼 라이브러리입니다. Windows 작성, 사용자 입력 수락, 데이터로드, 이미지 그리기, 사운드 재생 등과 같은 일반적인 저수준 작업을 처리하고 일반적으로 기본 플랫폼을 추상화합니다. 그러나 Allegro는 게임 엔진이 아닙니다. 원하는대로 귀하의 프로그램을 자유롭게 설계하고 구조화 할 수 있습니다.

Allegro 5에는 다음과 같은 추가 기능이 있습니다.

• Windows, Linux, Mac OSX, iPhone 및 Android에서 지원됩니다
• C ++ 및 기타 여러 프로그래밍 언어에서 사용 가능한 사용자 친화적이고 직관적 인 C API
• 하드웨어 가속 비트 맵 및 그래픽 프리미티브 드로잉 지원 (OpenGL 또는 Direct3D를 통해)
• 오디오 녹음 지원
• 글꼴 로딩 및 드로잉
• 비디오 재생
• 셰이더 및 저수준 다각형 도면에 대한 추상화
• 그리고 더!

이 readme에는 Allegro가 구축하는 모든 플랫폼에 적용되는 일반 정보가 포함되어 있습니다.

readme_cmake.txt는 cmake를위한 몇 가지 빌드 옵션에 대해 설명합니다.

readme_msvc.txt는 Microsoft Visual C/C ++를 사용하여 Windows의 컴파일에 대해 설명합니다.

readme_make.txt는 GNU Make와의 컴파일에 대해 설명합니다. 이는 Linux, MacOS X 및 Windows의 Mingw와 같은 Unix와 같은 운영 체제에 적용됩니다.

readme_macosx.txt에는 MacOS X에 대한 몇 가지 추가 메모가 있습니다.

readme_iphone.txt는 iPhone 운영 체제에 대해 설명합니다.

요구 사항

C 및 C ++ 컴파일러가 설치되고 작동한다고 가정합니다. GCC, Clang 및 MSVC를 지원합니다.

Allegro는 또한 Cmake 3.0 이상이 필요합니다. http://www.cmake.org/에서 다운로드 할 수 있습니다.

라이브러리 종속성

Allegro는 핵심 라이브러리와 다수의 Addon 라이브러리로 나뉩니다. 핵심 라이브러리는 기능 할 특정 라이브러리에 따라 다릅니다. 당신이 그것들이 없다면, 아무것도 작동하지 않을 것입니다. 핵심 라이브러리에 필요합니다.

• Directx SDK (Windows 만 해당)

  Microsoft 웹 사이트 (대규모 다운로드)에서 MSVC에 대해 얻을 수 있습니다.

  또는 MSVC 및 MINGW에 대한 소규모 다운로드가 여기에서 확인할 수 있습니다 : http://liballeg.org/download.html#miscellaneous-files. 일부 mingw 분포에는 Allegro 컴파일을 지원하기에 충분한 Directx SDK가 제공됩니다.

• X11 Development Libraries (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 사용자는 PhysicsFs 및 Dumb를 제외한 모든 종속성을 이미 가지고있을 것입니다. 배포가 별도의 개발 패키지를 사용하는 경우 설치해야합니다. 패키지는 아마도 *-dev 또는 *-devel이라는 이름을 지정할 것입니다.

이들은 부가 용에 필요한 의존성입니다.

• PNG 이미지 지원 (Unix and Old Mingw 만 해당) 홈페이지 : 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 and Old Mingw 만 해당) 홈페이지 : http://www.ijg.org/ Windows Binaries : http://gnuwin32.sourceforge.net/packages/jpeg.htm

  Windows/Mac OS X/iPhone/Android에서는 각 운영 체제의 기본 시설을 사용하여 JPEG 이미지 지원을 사용할 수 있으므로 LIBJPEG가 필요하지 않습니다.

• Webpebp, Webp Image Support Home Page : https://developers.google.com/speed/webp/

  Android에서는 운영 체제의 기본 시설을 사용하여 Webp Image Support를 사용할 수 있으므로 libwebp가 필요하지 않습니다.

• 트루 타입 글꼴 지원을위한 프리 타입. 홈페이지 : http://freetype.sourceforge.net/ Windows Binaries : 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. 3D 기능은 사용되지 않지만 오디오 애드온은 Openal을 사용할 수 있습니다. http://kcat.strangesoft.net/openal.html

  Mac OS X에서는 Openal이 필요 하지만 어쨌든 OS와 함께 제공되어야합니다.

  Linux 및 Windows에서는 Openal이 요청한 경우에만 사용되므로 구체적으로 설치할 이유가 없습니다.

• Physicsfs는 아카이브 (예 : .zip 파일)에 대한 액세스를 제공합니다. 홈페이지 : http://icculus.org/physfs/

창문에서는이 모든 라이브러리를 찾을 수 있도록 배치하는 것이 고통 일 수 있습니다. 시간이 오면 "deps subdirectory"의 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 ..

소스 디렉토리 (예 : cmake . )에서 빌드하도록 Allegro를 구성하면 오류 메시지가 표시됩니다. CMakeCache.txt 및 CMakeFiles 디렉토리 및 위에서 설명한대로 재구성을 삭제하십시오.

구성 단계가 성공하면 Allegro를 구축하기 위해 다른 도구를 호출하게됩니다. 도구는 컴파일러에 따라 다르지만 일반적으로 make 또는 IDE입니다.

문제를 피하려면 Allegro를 공간이나 다른 "이상한"문자가없는 디렉토리로 포장 해제하십시오. 이것은 알려진 문제입니다.

이제 readme_msvc.txt, readme_make.txt 또는 readme_macosx.txt를 읽으십시오.