MonoGame.Forms

¡Bienvenido a monogame.forms!

Monogame.forms es la forma más fácil de integrar una ventana de renderizado de monogame en su proyecto de formularios de Windows. Debería hacerle la vida mucho más fácil, cuando desee crear su propio entorno de editor.

Nota

• El proyecto monogame.forms utiliza una versión modificada del monogame.framework. Se llama monogame.framework.windowsdx.9000 (creado por NKAST), que es más rápido, optimizado de memoria, fijado y admite la entrada completa de mouse y teclado dentro de Windowsforms. También puede actualizar monogame.forms a una nueva versión de Monogame muy fácilmente, ¡solo actualizando el paquete monogame.framework.windowsdx.9000 nuget!
• Monogame.forms.gl - ¡Detenido! - Alternativa más rápida: monogame.template.gtk.csharp (creado por Harry-CPP).

Consejo

• Si experimenta problemas de escala con su contenido dibujado, es posible que desee establecer el modelo automático correcto de un formulario que contenga un monogamecontrol: AutoScaleMode = System.Windows.Forms.AutoScaleMode.None; . Si desea desactivar la escala de toda su aplicación, debe agregar un archivo manifiesto .

Importante

• Nunca use DoubleBuffering en un control personalizado. Causará parpadeos y despacio.

Configurar monogame.forms

Opciones:

• Construir desde la fuente (este repositorio)
• Paquete de instalación:
  • dotnet add package MonoGame.Forms.DX o use el administrador de paquetes
• Instalar plantillas:
  • dotnet new install MonoGame.Forms.Templates

---

Tutoriales

Creación de proyectos de monogame.forms:

• Automagical a través de terminal (si se instalan plantillas):
  • .NET 6.0: dotnet new mgf -n MyMonoGameFormsProject
  • .NET -Framework: dotnet new mgfn -n MyMonoGameFormsProject
• Manual:

1. Cree un nuevo proyecto de Windowsforms
2. Instale el paquete Nuget
3. Construir la solución

Creación de controles de monogame.forms:

• Automagical a través de terminal (si se instalan plantillas):
  • Monogamecontrol: dotnet new mgc -na MyMonoGameControl
  • InvalidationControl: dotnet new mgic -na MyInvalidationControl
• Manual:

1. Crea una nueva clase y nombre DrawTest
2. Heredar de monogame.forms.controls.monogamecontrol
3. Anular su método inicialize () , update () y dibujo ()
4. Guarde su solución
5. Construye tu solución
6. Haga doble clic en Form1.cs para que el diseñador se abra
7. Abra la caja de herramientas
8. Arrastre y suelte el control recién creado en el control Form1
9. Abra las propiedades del nuevo control y establezca la opción Dock para llenar

10. Ganancia ???

Dibujo

En Monogame podrías dibujar algo a la pantalla con el Spritebatch . En monogame.forms , hará lo mismo, pero debe usar el editorService para esto.

En las clases de monogame.forms.control Este servicio se llama editor . Entonces, para atraer algo al Spritebatch , debe hacer esto:

 Editor . spriteBatch . DrawString ();

Echemos un vistazo a la clase final de DrawTest :

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

Resultado:

Es más o menos en el monogame.framework!

Muestras

Eche un vistazo a monogame.forms.samples-project, que es parte de este repositorio, para obtener más información sobre cómo funciona monogame.forms.

---

WTF ¿Es este Control de Invalidation ?

Esta clase de control específica no necesita anular el método Update () , porque se actualiza manualmente (¡por usted!).

Simplemente necesita llamar a Invalidate () en un Control de invalidación personalizado para cada cambio que desee ver en él. Después de llamar a esto, su control ya no consume la potencia de la CPU. ¡Esto es genial al crear controles de vista previa para texturas y cosas similares!

Fotos o no sucedió

Aquí hay algunas fotos de muestra de la rama Blazor:

Proyectos utilizando monogame.forms

Editor de motor Rogue :

Sandbox de partículas de mercurio :

Penumbraphysics.Editor :

---

¡Ahora diviértete con monogame.forms!

Agradecimiento especial

• Nkast y Spiceywolf de la comunidad de monogame
• todos los demás del monogame oficial.forms_thread
• La increíble comunidad de monogame en sí :)