allegro5

ยินดีต้อนรับสู่ Allegro!

Allegro เป็นห้องสมุดข้ามแพลตฟอร์มส่วนใหญ่มุ่งเป้าไปที่วิดีโอเกมและการเขียนโปรแกรมมัลติมีเดีย มันจัดการงานทั่วไประดับต่ำเช่นการสร้าง windows ยอมรับการป้อนข้อมูลผู้ใช้การโหลดข้อมูลการวาดภาพการเล่นเสียง ฯลฯ และโดยทั่วไปจะนำแพลตฟอร์มพื้นฐานออกไป อย่างไรก็ตาม Allegro ไม่ใช่เอ็นจิ้นเกม: คุณมีอิสระในการออกแบบและจัดโครงสร้างโปรแกรมของคุณตามที่คุณต้องการ

Allegro 5 มีคุณสมบัติเพิ่มเติมดังต่อไปนี้:

• รองรับบน Windows, Linux, Mac OSX, iPhone และ Android
• C ที่ใช้งานง่ายและใช้งานง่าย API ใช้งานได้จาก C ++ และภาษาการเขียนโปรแกรมอื่น ๆ อีกมากมาย
• ฮาร์ดแวร์เร่งบิตแมปและการรองรับการวาดภาพแบบกราฟิกแบบดั้งเดิม (ผ่าน OpenGL หรือ Direct3D)
• การสนับสนุนการบันทึกเสียง
• การโหลดและการวาดแบบอักษร
• การเล่นวิดีโอ
• สิ่งที่เป็นนามธรรมเหนือ Shaders และการวาดรูปหลายเหลี่ยมระดับต่ำ
• และอีกมากมาย

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 แบ่งออกเป็นห้องสมุดหลักและห้องสมุด Addon จำนวนหนึ่ง ห้องสมุดหลักขึ้นอยู่กับไลบรารีบางอย่างที่จะทำงาน หากคุณไม่มีสิ่งเหล่านั้นจะไม่มีอะไรทำงาน สิ่งเหล่านี้จำเป็นสำหรับห้องสมุดหลัก:

• DirectX SDK (Windows เท่านั้น)

  คุณสามารถรับสิ่งนี้สำหรับ MSVC จากเว็บไซต์ Microsoft (ดาวน์โหลดขนาดใหญ่)

  อีกวิธีหนึ่งคือการดาวน์โหลดขนาดเล็กสำหรับ MSVC และ MingW มีให้ที่นี่: http://liballeg.org/download.html#miscellaneous-files การแจกแจง MINGW บางส่วนมาพร้อมกับ DirectX SDK ที่เพียงพอเพื่อรองรับการรวบรวม Allegro

• Libraries การพัฒนา X11 (Linux/UNIX เท่านั้น) ไลบรารีจะเป็นส่วนหนึ่งของการกระจาย Linux ของคุณ แต่คุณอาจต้องติดตั้งอย่างชัดเจน

• OpenGL Development Libraries (เป็นทางเลือกบน Windows เท่านั้น)

Addons ก็อาจต้องใช้ห้องสมุดเพิ่มเติม เนื่องจาก Addons เป็นทางเลือกอย่างเคร่งครัดจึงไม่จำเป็นต้องสร้าง Allegro แต่ฟังก์ชั่นจำนวนมากอาจถูกปิดใช้งานหากไม่มีอยู่

ผู้ใช้ Windows อาจพบไบนารีที่รวบรวมไว้ล่วงหน้าสำหรับไลบรารีเพิ่มเติมจาก http://gnuwin32.sourceforge.net/ คุณต้องได้รับแพ็คเกจ bin และ lib แพ็คเกจ bin มี DLLs และแพ็คเกจ lib มีส่วนหัวและนำเข้าไลบรารี

ผู้ใช้ Mac อาจพบการพึ่งพาบางอย่างใน Homebrew, Fink หรือ MacPorts http://brew.sh/, http://www.finkproject.org/ และ http://www.macports.org/

ผู้ใช้ Linux มีแนวโน้มที่จะมีการพึ่งพาทั้งหมดอยู่แล้วยกเว้น PhysicsFs และเป็นใบ้ หากการกระจายของคุณใช้แพ็คเกจการพัฒนาแยกต่างหากพวกเขาจะต้องติดตั้ง แพ็คเกจอาจมีชื่อว่า *-dev หรือ *-devel

นี่คือการพึ่งพาที่จำเป็นสำหรับ addons:

• libpng และ zlib สำหรับการสนับสนุนรูปภาพ PNG (UNIX และ MINGW ที่เก่ากว่าเท่านั้น) หน้าแรก: http://www.libpng.org/pub/png/ binaries windows: http://gnuwin32.sourceforge.net/packages/libpng.htmng.htm

  บน Windows/Mac OS X/iPhone/Android การรองรับภาพ PNG สามารถใช้งานได้โดยใช้สิ่งอำนวยความสะดวกดั้งเดิมในระบบปฏิบัติการที่เกี่ยวข้องดังนั้นจึงไม่จำเป็นต้องใช้ libpng

• libjpeg สำหรับการสนับสนุนภาพ JPEG (UNIX และ MINGW ที่เก่ากว่าเท่านั้น) หน้าแรก: http://www.ijg.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 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/

• โง่, IT, XM, S3M และ Mod Player Library (libdumb) หน้าแรก: http://dumb.sourceforge.net/

• Openal, 3D Audio API Addon เสียงสามารถใช้ 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 ด้วยไดเรกทอรี Build แยกต่างหาก ตัวอย่างเช่น,

 mkdir build
cd build
cmake ..

หากคุณกำหนดค่า Allegro เพื่อสร้างในไดเรกทอรีต้นฉบับ (เช่น cmake . ) คุณจะได้รับข้อความแสดงข้อผิดพลาด ลบ CMakeCache.txt และไดเรกทอรี CMakeFiles และกำหนดค่าใหม่ตามที่อธิบายไว้ข้างต้น

เมื่อขั้นตอนการกำหนดค่าสำเร็จคุณจะเรียกใช้เครื่องมืออื่นเพื่อสร้าง Allegro เครื่องมือขึ้นอยู่กับคอมไพเลอร์ของคุณ แต่มักจะ make หรือ IDE ของคุณ

เพื่อหลีกเลี่ยงปัญหาให้แกะ Allegro ออกเป็นไดเรกทอรี ที่ไม่มีช่องว่างหรือตัวละคร "แปลก ๆ " อื่น ๆ ในเส้นทาง นี่เป็นปัญหาที่ทราบกันดี

ตอนนี้อ่าน readme_msvc.txt, readme_make.txt หรือ readme_macosx.txt