MonoGame.Forms

Willkommen bei Monogame.Forms!

Monogame.Forms ist die einfachste Art, ein Monogame -Render -Fenster in Ihr Windows -Formulationsprojekt zu integrieren. Es sollte Ihr Leben viel einfacher machen, wenn Sie Ihre eigene Editor -Umgebung erstellen möchten.

Notiz

• Das Projekt von monogame.forms verwendet eine modifizierte Version des Monogame.Framework. Es heißt monogame.framework.windowsdx.9000 (erstellt von NKAST), das schneller, speicheroptimiert, fehlerhaft ist und die vollständige Maus- und Tastatureingabe in WindowsForms unterstützt. Sie können monogame.Forts auch sehr einfach auf eine neue Monogame -Version aktualisieren - nur indem Sie das Monogame.Framework.Windowsdx.9000 Nuget -Paket aktualisieren!
• Monogame.forms.gl - veraltet! - schneller Alternative: monogame.template.gtk.csharp (erstellt von Harry-CPP).

Tipp

• Wenn Sie Skalierungsprobleme mit Ihrem gezogenen Inhalt haben, möchten Sie möglicherweise den richtigen Autoscalemode eines Formulars einstellen, der eine monogameControl enthält: AutoScaleMode = System.Windows.Forms.AutoScaleMode.None; . Wenn Sie die Skalierung Ihrer gesamten Anwendung deaktivieren möchten, müssen Sie eine Manifest-Datei hinzufügen.

Wichtig

• Verwenden Sie niemals DoubleBuffering für eine benutzerdefinierte Steuerung. Es wird zu Flackern und Verlangsamen führen.

Setup monogame.Forms

Optionen:

• Erstellen Sie aus der Quelle (dieses Repo)
• Paket installieren:
  • dotnet add package MonoGame.Forms.DX oder den Paketmanager verwenden
• Vorlagen installieren:
  • dotnet new install MonoGame.Forms.Templates

---

Tutorials

Erstellen von Monogame.Forts -Projekte:

• Automatisch über Terminal (falls die Vorlagen installiert):
  • .NET 6.0: dotnet new mgf -n MyMonoGameFormsProject
  • .NET -Framework: dotnet new mgfn -n MyMonoGameFormsProject
• Handbuch:

1. Erstellen Sie ein neues WindowsForms -Projekt
2. Installieren Sie das Nuget -Paket
3. Bauen Sie die Lösung auf

Erstellen von Monogame.Forms -Steuerelemente:

• Automatisch über Terminal (falls die Vorlagen installiert):
  • MonogameControl: dotnet new mgc -na MyMonoGameControl
  • InvalidationControl: dotnet new mgic -na MyInvalidationControl
• Handbuch:

1. Erstellen Sie eine neue Klasse und nennen Sie sie gezeichnet.
2. Erbe von monogame.forms.controls.monogameControl
3. Überschreiben​​
4. Speichern Sie Ihre Lösung
5. Bauen Sie Ihre Lösung auf
6. Doppelklicken Sie auf Form1.cs, damit der Designer öffnet
7. Öffnen Sie die Toolbox
8. Ziehen Sie das neu erstellte Steuerelement auf das Form1 -Steuerelement ab und lassen Sie sie fallen
9. Öffnen Sie die Eigenschaften der neuen Steuerung und setzen Sie die Option Dock zum Ausfüllen fest

10. Gewinn ???

Zeichnung

Im Monogame können Sie mit der SpriteBatch einigermaßen auf den Bildschirm ziehen. In monogame.Forms werden Sie dasselbe tun, aber dafür den Herausgeber verwenden.

In den Klassen monogame.Forms.Control heißt dieser Dienst Editor . Um etwas an die SpriteBatch zu ziehen, müssen Sie dies tun:

 Editor . spriteBatch . DrawString ();

Werfen wir einen Blick auf die endgültige bezeichnetste Klasse:

 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 ();
        }
    }
}

Ergebnis:

Es ist ziemlich wie im Monogame.Framework!

Proben

Schauen Sie sich die monogame.Forms.plople-Project an, die Teil dieses Repo ist, um mehr darüber zu erfahren, wie Monogame.Forms funktioniert.

---

WTF Ist diese InvalidationControl ?

Diese bestimmte Steuerklasse muss die update () -Methode nicht überschreiben, da sie manuell aktualisiert wird (von Ihnen!).

Sie müssen lediglich () für jede Änderung, die Sie anzeigen möchten, ungültig () auf einer benutzerdefinierten InvalidationControl anrufen. Nachdem Sie dies aufgerufen haben, verbraucht Ihre Kontrolle keine CPU -Stromversorgung mehr. Dies ist großartig, wenn Sie Vorschau -Steuerelemente für Texturen und ähnliche Dinge erstellen!

Bilder oder es ist nicht passiert

Hier sind einige Beispielbilder aus dem Blazor -Zweig:

Projekte mit monogame.forms

Rogue Engine Editor :

Quecksilberpartikel Sandbox :

Penumbraphysik.Editor :

---

Jetzt viel Spaß mit monogame.Forms!

Besonderer Dank

• Nkast und Spiceywolf aus der Monogame -Community
• Alle anderen aus dem offiziellen Monogame.Forms_Thread
• Die großartige Monogame -Community selbst :)