MonoGame.Forms

Bienvenue sur Monogame.Forms!

Monogame.forms est le moyen le plus simple d'intégrer une fenêtre de rendu Monogame dans votre projet Windows Forms. Cela devrait vous faciliter la vie lorsque vous souhaitez créer votre propre environnement d'éditeur.

Note

• Le projet Monogame.Forms utilise une version modifiée du monogame.framework. Il s'appelle monogame.framework.windowsdx.9000 (créé par NKAST), qui est plus rapide, optimisé par la mémoire, Bugfixé et prend en charge la saisie complète de la souris et du clavier dans WindowsForms. Vous pouvez également mettre à jour monogame.forms vers une nouvelle version monogame très facilement - simplement en mettant à jour le package monogame.framework.windowsdx.9000 Nuget!
• Monogame.forms.gl - déprécié! - Alternative plus rapide: monogame.template.gtk.csharp (créé par Harry-CPP).

Conseil

• Si vous rencontrez des problèmes de mise à l'échelle avec votre contenu dessiné, vous souhaiterez peut-être définir la bonne autoscalemode d'un formulaire contenant un monogameControl: AutoScaleMode = System.Windows.Forms.AutoScaleMode.None; . Si vous souhaitez désactiver l'échelle de l'ensemble de votre application, vous devez ajouter un fichier manifeste .

Important

• N'utilisez jamais DoubleBuffering sur un contrôle personnalisé. Cela provoquera des scintillements et des ralentissements.

Configuration de Monogame.Forms

Options:

• Construire à partir de la source (ce repo)
• Installer le package:
  • dotnet add package MonoGame.Forms.DX ou utiliser le gestionnaire de packages
• Installer des modèles:
  • dotnet new install MonoGame.Forms.Templates

---

Tutoriels

Création de projets Monogame.forms:

• Automagical via le terminal (IF Modèles installés):
  • .Net 6.0: dotnet new mgf -n MyMonoGameFormsProject
  • .NET-FRAMEWROWN: dotnet new mgfn -n MyMonoGameFormsProject
• Manuel:

1. Créer un nouveau projet WindowsForms
2. Installer le package Nuget
3. Construire la solution

Création de contrôles monogame.forms:

• Automagical via le terminal (IF Modèles installés):
  • MonogameControl: dotnet new mgc -na MyMonoGameControl
  • InvalidationControl: dotnet new mgic -na MyInvalidationControl
• Manuel:

1. Créez une nouvelle classe et nommez-le DrawTest
2. Hériter de monogame.forms.controls.MonogameControl
3. Remplacer sa méthode initialize () , update () et draw ()
4. Enregistrez votre solution
5. Créez votre solution
6. Double-cliquez sur Form1.cs pour que le concepteur s'ouvre
7. Ouvrez la boîte à outils
8. Faites glisser et déposez le contrôle nouvellement créé sur le contrôle Form1
9. Ouvrez les propriétés du nouveau contrôle et définissez l'option Dock à remplir

10. Profit ???

Dessin

Dans Monogame, vous pouvez dessiner à l'écran avec le Spritebatch . Dans Monogame.Forms , vous ferez de même, mais vous devez utiliser l'éditeur pour cela.

Dans les classes Monogame.Forms.Control, ce service s'appelle Editor . Donc, afin de dessiner quelque chose sur le spritebatch, vous devez faire ceci:

 Editor . spriteBatch . DrawString ();

Jetons un coup d'œil à la classe finale du dessin :

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

Résultat:

C'est à peu près comme dans le monogame.framework!

Échantillons

Jetez un œil à la monogame.forms.sample-project, qui fait partie de ce référentiel, pour en savoir plus sur le fonctionnement de monogame.forms.

---

WTF est cette invalidationControl ?

Cette classe de contrôle spécifique n'a pas besoin pour remplacer la méthode Update () , car elle est mise à jour manuellement (par vous!).

Il vous suffit d'appeler Invalidate () sur une InvalidationControl personnalisée pour chaque modification que vous souhaitez voir dessus. Après avoir appelé cela, votre contrôle ne consomme plus la puissance du processeur. C'est génial lors de la création de contrôles de prévisualisation pour les textures et des choses similaires!

Des photos ou ça ne s'est pas produit

Voici quelques exemples de photos de la branche Blazor:

Projets utilisant monogame.forms

Éditeur de moteur Rogue :

Boîte à sable sur les particules de mercure :

Pénumbraphysics.editor :

---

Maintenant, amusez-vous avec Monogame.Forms!

Merci spécial

• Nkast et Spiceywolf de la communauté monogame
• Tout le monde du monogame officiel.forms_thread
• La communauté monogame impressionnante elle-même :)