Apos.Gui 0.11.5

Apos.Gui

UI library for MonoGame.

Documentation

• API
• Wiki

Build

NuGet

Features

• Mouse, Keyboard, Gamepad, Touchscreen
• UI scaling

Showcase

<img src="Images/Showcase.gif" alt="Apos GUI Loop" width="800" height="480" />

Usage samples

First, find a font ttf file to use (Call it FontFile.ttf), put it in a subfolder called "Fonts" in your content folder. Add it to the MonoGame content pipeline and select copy in "Build Action" instead of ~build~.

In your game's LoadContent(), get the Helper classes ready:

protected override void LoadContent() {
    InputHelper.Game = this;
    GuiHelper.Window = Window;
    GuiHelper.Scale = 1f;

    GuiHelper.FontSize = 30;
    using MemoryStream ms = new MemoryStream();
    TitleContainer.OpenStream($"{Content.RootDirectory}/Fonts/FontFile.ttf").CopyTo(ms);
    byte[] fontBytes = ms.ToArray();
    GuiHelper.Font = DynamicSpriteFont.FromTtf(fontBytes, GuiHelper.FontSize);
}

You can create a simple UI with the following code:

ComponentFocus focus;

Action<Component> grabFocus = c => {
    focus.Focus = c;
};

var screen = new ScreenPanel();
screen.Layout = new LayoutVerticalCenter();

var p = new Panel();
p.Layout = new LayoutVerticalCenter();
p.AddHoverCondition(Default.ConditionHoverMouse);
p.AddAction(Default.IsScrolled, Default.ScrollVertically);

p.Add(Default.CreateButton("Fun", c => {
    Console.WriteLine("This is fun.");
    return true;
}, grabFocus));
p.Add(Default.CreateButton("Quit", c => {
    Console.WriteLine("Quitting the game.");
    Exit();
    return true;
}, grabFocus));
screen.Add(p);

focus = new ComponentFocus(screen, Default.ConditionPreviousFocus, Default.ConditionNextFocus);

The above code will create 2 buttons, "Fun" and "Quit". You can use your mouse, keyboard, or gamepad to interact with them.

In your Update(GameTime gameTime), call the following functions:

protected override void Update(GameTime gametime) {
    //Call UpdateSetup at the start.
    InputHelper.UpdateSetup();
    GuiHelper.UpdateSetup();

    focus.UpdateSetup();
    focus.UpdateInput();
    focus.Update();

    //Call UpdateCleanup at the end.
    InputHelper.UpdateCleanup();
}

In your Draw(GameTime gameTime), call:

protected override void Draw(GameTime gameTime) {
    GraphicsDevice.Clear(Color.Black);
    focus.Draw(spritebatch);
    base.Draw(gameTime);
}

Working usage code can be found in the AposGameStarter project. Look into menu.cs.