allegro5

مرحبًا بك في Allegro!

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 إلى مكتبة أساسية وعدد من مكتبات Addon. تعتمد المكتبة الأساسية على بعض المكتبات للعمل. إذا لم يكن لديك هؤلاء ، فلن ينجح شيء. هذه مطلوبة للمكتبة الأساسية:

• DirectX SDK (Windows فقط)

  يمكنك الحصول على هذا لـ MSVC من موقع Microsoft Web (تنزيل كبير).

  بدلاً من ذلك ، تتوفر تنزيلات أصغر لـ MSVC و MINGW هنا: http://liballeg.org/download.html#miscellwer-files. بعض توزيعات MingW تأتي مع DirectX SDK كافية لدعم تجميع Allegro.

• مكتبات تطوير X11 (Linux/UNIX فقط) ستكون المكتبات جزءًا من توزيع Linux الخاص بك ، ولكن قد تضطر إلى تثبيتها بشكل صريح.

• مكتبات تطوير OpenGL (اختياري فقط على Windows)

قد تتطلب الإضافات أيضًا مكتبات إضافية. نظرًا لأن الإضافات اختيارية تمامًا ، فهي غير مطلوبة لبناء 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.

هذه هي التبعيات المطلوبة للإضافات:

• libpng و zlib ، لدعم صورة png (UNIX و MingW الأقدم فقط) الصفحة الرئيسية: http://www.libpng.org/pub/png/ windows binaries: http://gnuwin32.sourceforge.net/packages/libpng.htm.htm

  على Windows/Mac OS X/iPhone/Android ، يتوفر دعم صورة PNG باستخدام المرافق الأصلية على أنظمة التشغيل المعنية ، لذلك ليس LIBPNG مطلوبًا.

• libjpeg ، لدعم صورة JPEG (UNIX و MINGW الأقدم فقط) الصفحة الرئيسية: http://www.ijg.org/ binaries Windows: http://gnuwin32.sourceforge.net/packages/jpeg.htm

  على Windows/Mac OS X/iPhone/Android ، يتوفر دعم صورة JPEG باستخدام المنشآت الأصلية على أنظمة التشغيل المعنية ، لذلك لا يلزم LiBJPEG.

• libwebp ، لدعم صورة ويب الصفحة الرئيسية الصفحة الرئيسية: https://developers.google.com/speed/webp/

  على Android ، يتوفر دعم صورة الويب باستخدام المرافق الأصلية لنظام التشغيل ، لذلك ليس من المطلوب 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/

• غبية ، IT ، XM ، S3M و Mod Library. (libdumb) الصفحة الرئيسية: http://dumb.sourceforge.net/

• Openal ، A 3D Audio API. يمكن أن يستخدم الملحق الصوتي Openal ، على الرغم من عدم استخدام إمكانات ثلاثية الأبعاد. http://kcat.strangesoft.net/openal.html

  على Mac OS X ، مطلوب Openal ولكن يجب أن يأتي مع نظام التشغيل على أي حال.

  على Linux و Windows ، لن يتم استخدام Openal إلا إذا طلبت ذلك ، وبالتالي لا يوجد سبب لتثبيته على وجه التحديد.

• Physicsfs ، يوفر الوصول إلى المحفوظات ، على سبيل المثال ملفات .zip. الصفحة الرئيسية: http://icculus.org/physfs/

على النوافذ ، قد يكون من المؤلم وضع جميع هذه المكتبات بحيث يمكن العثور عليها. يرجى الاطلاع على قسم 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.

لتجنب المشاكل ، قم بفك أليجرو في دليل بدون مسافات أو شخصيات "غريبة" أخرى في المسار . هذه مشكلة معروفة.

اقرأ الآن readme_msvc.txt أو readme_make.txt أو readme_macosx.txt.