MonoGame.Forms

مرحبا بكم في monogame.forms!

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

ملحوظة

• يستخدم مشروع monogame.forms إصدارًا معدّلًا من monogame.framework. يطلق عليه monogame.framework.windowsdx.9000 (تم إنشاؤه بواسطة NKAST) ، وهو أسرع ، محسّن للذاكرة ، مختلطًا ويدعم إدخال الماوس ولوحة المفاتيح الكاملة داخل WindowsForms. يمكنك أيضًا تحديث monogame.forms إلى إصدار جديد من monogame بسهولة شديدة - فقط عن طريق تحديث monogame.framework.windowsdx.9000 nuget package!
• monogame.forms.gl - إهمال! - بديل أسرع: monogame.template.gtk.csharp (تم إنشاؤه بواسطة Harry-CPP).

نصيحة

• إذا واجهت تحجيم المشكلات مع المحتوى المرسوم الخاص بك ، فقد ترغب في تعيين أحواض Autoscalemode الصحيح لنموذج يحتوي على أحادي المونترول: AutoScaleMode = System.Windows.Forms.AutoScaleMode.None; . إذا كنت ترغب في إيقاف تشغيل تحجيم التطبيق بالكامل ، فأنت بحاجة إلى إضافة ملف واضح .

مهم

• لا تستخدم أبدًا مرور مزدوج على عنصر تحكم مخصص. سوف يسبب الخفقان وبطء الهبوط.

الإعداد monogame.forms

خيارات:

• بناء من المصدر (هذا الريبو)
• حزمة تثبيت:
  • dotnet add package MonoGame.Forms.DX أو استخدم مدير الحزمة
• تثبيت القوالب:
  • dotnet new install MonoGame.Forms.Templates

---

دروس

إنشاء مشاريع monogame.forms:

• تلقائي عبر المحطة (إذا تم تثبيت القوالب):
  • .NET 6.0: dotnet new mgf -n MyMonoGameFormsProject
  • .net -framework: dotnet new mgfn -n MyMonoGameFormsProject
• يدوي:

1. إنشاء مشروع WindowsForms جديد
2. تثبيت حزمة nuget
3. بناء الحل

إنشاء ضوابط monogame.forms:

• تلقائي عبر المحطة (إذا تم تثبيت القوالب):
  • MonogameControl: dotnet new mgc -na MyMonoGameControl
  • PerilidationControl: dotnet new mgic -na MyInvalidationControl
• يدوي:

1. قم بإنشاء فئة جديدة واسمها
2. ورث من monogame.forms.controls.monogamecontrol
3. تجاوز طريقة التهيئة () و update () و draw ()
4. احفظ الحل الخاص بك
5. بناء الحل الخاص بك
6. انقر نقرًا مزدوجًا على Form1.cs بحيث يفتح المصمم
7. افتح صندوق الأدوات
8. سحب وإسقاط التحكم الذي تم إنشاؤه حديثًا على عنصر التحكم Form1
9. افتح خصائص عنصر التحكم الجديد وقم بتعيين خيار قفص الاتهام لملء

10. ربح ؟؟؟

رسم

في Monogame ، يمكنك رسم بعض الشيء على الشاشة باستخدام spriteBatch . في monogame.forms ، ستفعل الشيء نفسه ولكن تحتاج إلى استخدام خدمة editorService لهذا الغرض.

في فصول monogame.forms.control ، تسمى هذه الخدمة المحرر . لذلك ، من أجل رسم شيء ما إلى spriteBatch ، تحتاج إلى القيام بذلك:

 Editor . spriteBatch . DrawString ();

لنلقي نظرة على فئة الاختبار النهائي:

 using Microsoft . Xna . Framework ;
using MonoGame . Forms . Controls ;

namespace nugetTest
{
    public class DrawTest : MonoGameControl
    {
        string WelcomeMessage = "Hello MonoGame.Forms!" ;

        protected override void Initialize ()
        {
        }
        
        protected override void Update ( GameTime gameTime )
        {
        }

        protected override void Draw ()
        {
            Editor . spriteBatch . Begin ();

            Editor . spriteBatch . DrawString ( Editor . Font , WelcomeMessage , new Vector2 (
                ( Editor . graphics . Viewport . Width / 2 ) - ( Editor . Font . MeasureString ( WelcomeMessage ). X / 2 ),
                ( Editor . graphics . Viewport . Height / 2 ) - ( Editor . FontHeight / 2 )),
                Color . White );

            Editor . spriteBatch . End ();
        }
    }
}

نتيجة:

إنه يشبه إلى حد كبير في monogame.framework!

عينات

ألقِ نظرة على monogame.forms.samples-project ، وهو جزء من هذا الريبو ، لمعرفة المزيد حول كيفية عمل monogame.forms.

---

WTF هل هذا الإبطال ؟

لا تحتاج فئة التحكم المحددة هذه إلى تجاوز طريقة التحديث () ، لأنها يتم تحديثها يدويًا (بواسطتك!).

تحتاج ببساطة إلى الاتصال ببطل () على إبطال مخصص لكل تغيير تريد رؤيته عليه. بعد استدعاء هذا ، لم يعد سيطرتك تستهلك قوة وحدة المعالجة المركزية بعد الآن. هذا أمر رائع عند إنشاء عناصر تحكم المعاينة للقوام وأشياء مماثلة!

صور أو لم يحدث

فيما يلي بعض صور عينة من فرع Blazor:

المشاريع باستخدام monogame.forms

محرر المحرك Rogue :

صندوق رمل جسيمات الزئبق :

penumbraphysics.editor :

---

الآن استمتع مع monogame.forms!

شكر خاص

• Nkast و Spiceywolf من مجتمع Monogame
• أي شخص آخر من monogame.forms_thread الرسمي
• مجتمع الأحادي الرائع نفسه :)