Tetris

تتريس

استنساخ Tetris ™ الذي تم إنشاؤه في C ++ و SDL ، تم تصميم المشروع أيضًا ليتم تجميعه مع emscripten إلى webasm ونشره عبر الإنترنت.

ابدأ لعبة جديدة

الضوابط

مفتاح	فعل
left_arrow	تحرك اليسار
right_arrow	تحرك يمينًا
z أو up_arrow	تدوير اتجاه عقارب الساعة
x أو left-ctrl	تدوير عكس اتجاه عقارب الساعة
space	قطرة صعبة
down_arrow	انخفاض ناعم
p	وقفة اللعبة
r	إعادة ضبط اللعبة

التبعيات

• git: للتحكم في الإصدار
• برنامج التحويل البرمجي C ++ القياسي يتوافق مع المعايير C ++ 17 وما فوق: لبناء المشروع محليًا (تم اختباره على GCC12.0 و Clang 13.0)
• emscripten: لتجميع البرنامج إلى webasm
• مكتبة SDL2.0: لتقديم الأشياء على الشاشة.
• مكتبة SDL TTF: لتقديم الخط من ملفات خطوط TrueType (.ttf).
• مكتبة SDL Mixer: لتشغيل الموسيقى والأصوات.

بناء التعليمات

(لا يزال هذا القسم أو README.MD قيد الإنشاء ، قد تساعد في تحسين ذلك عن طريق فتح PR/مشكلة فيما يتعلق به)

قم بتنفيذ الخطوات التالية لإنشاء المشروع على جهازك الأصلي:

1. استنساخ/تنزيل المستودع

2. انتقل إلى دليل src للمستودع

3. قم الآن بتجميع البرنامج (اعتمادًا على ما إذا كنت ترغب في إنشاء نسخة قابلة للنشر عبر الإنترنت أو البناء الأصلي ، اتبع إحدى الخطوات التالية)

   التحذير: لا يحتوي المستودع حاليًا على نظام/نص بناء لأتمتة عملية الإنشاء ، لذلك للأسف في الوقت الحالي ، فإن البناء اليدوي هو الطريقة الوحيدة لتشغيل المشروع على النظام (إذا كنت مهتمًا بإعداد واحدة للمشروع ، فلا تتردد في فتح مشكلة تناقشها)

   3.1. بناء webasm باستخدام emscripten :

   لإنشاء النسخة القابلة للنشر عبر الإنترنت من اللعبة ، سنستخدم emscripten لتجميع البرنامج إلى Webasm.

   • تنفيذ الأمر التالي هو أنني أعتقد أن كل ما تحتاجه لتجميع المشروع (لاحظ أن emscripten تميل إلى أن يستغرق وقتًا طويلاً نسبيًا من برنامج التحويل البرمجي C ++ الخاص بك لبناء المشروع ، وسيستغرق الأمر دائمًا وقتًا أطول بكثير من البناء من البناء اللاحق)

   $ em++ -std=c++17 renderer.cpp game.cpp app.cpp main.cpp -O2 -s TOTAL_MEMORY=67108864 -s USE_SDL=2 -s USE_SDL_TTF=2 -s USE_SDL_MIXER=2 --preload-file assets -o ../build/index.js

   TODO: اشرح ما يفعله الأمر أعلاه بالتفصيل

   • يجب أن تكون ملفات الإنشاء في build فرعية للمستودع
   • بمجرد الوصول إلى دليل الإنشاء ، يمكنك ببساطة استخدام emrun لتشغيل صفحات HTML عبر خادم ويب تم إطلاقه محليًا.

   $ emrun index.html

   FWIW: قد ترغب أيضًا في زيارة وثائق Emscripten فيما يتعلق بمزيد من المعلومات حول بناء مشروع مع Emscripten إذا كنت من المثير للاهتمام معرفة المزيد عن ذلك.

   3.2. البناء الأصلي باستخدام برنامج التحويل البرمجي C ++ الأصلي :

   • ما عليك سوى استخدام برنامج التحويل البرمجي C ++ الأصلي الخاص بك للبناء والتنفيذ من جميع الملفات المصدر (الترتيب الذي يجب تقديمه إلى الأمر يجب ألا يهم في معظم الحالات)

   • تأكد من ربط مكتبات SDL2 و SDL2_ttf و SDL2_mixer بشكل صحيح.

    $ g++ -std=c++17 renderer.cpp game.cpp app.cpp main.cpp -O2 -lSDL2_ttf -lSDL2_mixer -lSDL2

   • تشغيل القابل للتنفيذ المبني.

من المفترض أن يفهم المطورين من كل التعليمات هذه التعليمات ، لذلك إذا لم تتمكن من فهم أي شيء أو مواجهة أي صعوبة في بناء المشروع ، فتأكد من الشكوى عن ذلك من خلال فتح قضية أو في قسم مناقشة.

ل Hacktoberfest

يشارك هذا المستودع في Hacktoberfest ، لذلك يجب أن يتم حساب أي مساهمة تم إجراؤها في هذا المشروع خلال شهر أكتوبر نحو Hacktoberfest.

مساهمة

مساهمة من جميع الأنواع (الرمز ، غير الرمز ، منخفضة الرموز) يتم تقديمها.

• إذا كنت تتطلع إلى المساهمة في المشروع ، فتأكد من قراءة إرشادات المساهمة قبل تقديم طلب سحب جديد.

• إذا كنت ترغب في الإبلاغ عن خطأ ، أو ترغب في مشاركة الأفكار/المساهمة في المشروع ، فلا تتردد في فتح مشكلة/علاقات عامة فيما يتعلق بذلك

لا تتردد أيضًا في فتح مشكلة لطلب الاستفسارات.

إذا كنت تحب المشروع ، فتأكد من دعم المطورين من خلال منحه نجمة؟

رخصة

• رخصة معهد ماساتشوستس للتكنولوجيا
• حقوق الطبع والنشر 2022 © Ankur Saini.