MonoGame.Forms

Bem -vindo ao monogame.forms!

Monogame.forms é a maneira mais fácil de integrar uma janela de renderização de monogame no projeto do Windows Forms. Deve facilitar sua vida, quando você deseja criar seu próprio ambiente de editor.

Observação

• O Projeto Monogame.Forms usa uma versão modificada do monogame.framework. Chama -se monogame.framework.windowsdx.9000 (criado pelo NKAST), que é mais rápido, otimizado pela memória, bugfixado e suporta a entrada completa do mouse e do teclado no WindowsForms. Você também pode atualizar o monogame.forms para uma nova versão de monogame com muita facilidade - apenas atualizando o pacote Monogame.Framework.Windowsdx.9000 NUGET!
• Monogame.forms.gl - depreciado! - alternativa mais rápida: monogame.template.gtk.csharp (criado por Harry-cpp).

Dica

• Se você tiver problemas de dimensionamento com seu conteúdo desenhado, convém definir o modo automático certo de um formulário contendo um monogameControl: AutoScaleMode = System.Windows.Forms.AutoScaleMode.None; . Se você deseja desativar a escala de todo o aplicativo, precisará adicionar um arquivo de manifesto .

Importante

• Nunca use a buffer dupla em um controle personalizado. Isso causará tremores e desaceleração.

Configurar monogame.forms

Opções:

• Construa a partir da fonte (este repo)
• Pacote de instalação:
  • dotnet add package MonoGame.Forms.DX OU Use o gerenciador de pacotes
• Instalar modelos:
  • dotnet new install MonoGame.Forms.Templates

---

Tutoriais

Criando projetos Monogame.Forms:

• Automagical via terminal (se os modelos instalados):
  • .NET 6.0: dotnet new mgf -n MyMonoGameFormsProject
  • .NET -Framework: dotnet new mgfn -n MyMonoGameFormsProject
• Manual:

1. Crie um novo projeto WindowsForms
2. Instale o pacote NUGET
3. Construir a solução

Criando controles monogame.forms:

• Automagical via terminal (se os modelos instalados):
  • MonogameControl: dotnet new mgc -na MyMonoGameControl
  • InvalidaçãoControl: dotnet new mgic -na MyInvalidationControl
• Manual:

1. Crie uma nova classe e nomeie -se
2. Herdar de monogame.forms.controls.monogameControl
3. Substituir o método Initialize () , Update () e Draw ()
4. Salve sua solução
5. Construa sua solução
6. Clique duas vezes no Form1.cs para que o designer seja aberto
7. Abra a caixa de ferramentas
8. Arraste e solte o controle recém -criado no controle do Form1
9. Abra as propriedades do novo controle e defina a opção Dock para preencher

10. Lucro ???

Desenho

No Monogame, você pode desenhar algo para a tela com o SpriteBatch . No Monogame.Forms , você fará o mesmo, mas precisará usar o EditorService para isso.

Nas classes Monogame.Forms.Control, este serviço é chamado de editor . Portanto, para atrair algo para o SpriteBatch , você precisa fazer isso:

 Editor . spriteBatch . DrawString ();

Vamos dar uma olhada na aula final do 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:

É muito parecido com o monogame.Framework!

Amostras

Dê uma olhada no Monogame.forms.samples-Project, que faz parte deste repositório, para saber mais sobre como o monogame.forms funciona.

---

WTF isso é invalidaçãoControl ?

Esta classe de controle específica não precisa substituir o método update () , porque é atualizado manualmente (por você!).

Você simplesmente precisa ligar para o invalidato () em um invalidação personalizada para cada alteração que deseja ver nele. Depois de chamar isso, seu controle não consome mais poder da CPU. Isso é ótimo ao criar controles de visualização para texturas e coisas semelhantes!

Fotos ou isso não aconteceu

Aqui estão algumas fotos de amostra do ramo da Blazor:

Projetos usando monogame.forms

Editor de motores desonestos :

Sandbox de partícula de mercúrio :

Penumbraphysics.editor :

---

Agora divirta -se com monogame.forms!

Obrigado especial

• Nkast e Spiceywolf da comunidade Monogame
• todos os outros do monogame oficial.forms_thread
• A incrível comunidade de monogames em si :)