AoGui 1.0.0

AoGui - Simple C# GUI Library

A lightweight, easy-to-use C# GUI library with no external dependencies beyond .NET Windows Forms.

Features

• Simple API - Easy to learn and use
• Synchronized Properties - X/Y and Position are automatically synchronized
• No Dependencies - Uses only .NET built-in libraries
• Cross-version Support - Works with .NET 8.0, 9.0, and 10.0

Requirements

• .NET 8.0 or higher with Windows support
• Windows OS

Quick Start

using AoGui;

class Program
{
    static void Main()
    {
        Window window = new Window(800, 600, "My App");
        
        Button button = new Button();
        button.Content = "Click me";
        button.FontSize = 20;
        button.TextColor = Color.White;
        button.Color = Color.Black;
        button.Width = 120;
        button.Height = 40;
        button.Position = new Vector2(100, 100);
        
        window.Add(button);
        
        while(window.IsRunning())
        {
            if (button.IsClicked())
            {
                // Handle click
            }
            
            window.UpdateAndRender();
        }
    }
}

Property Synchronization

The library automatically synchronizes X/Y with Position and Width/Height with Size:

button.Position = new Vector2(100, 100);
button.X = 200;  // Position.X is now 200

button.Size = new Vector2(120, 40);
button.Width = 200;  // Size.X is now 200

Controls

Button

• Content - Button text
• FontSize - Text size
• TextColor - Text color
• Color - Background color
• IsClicked() - Returns true when clicked
• IsPressed() - Returns true while mouse is down
• IsReleased() - Returns true when mouse is released
• IsHovered() - Returns true when mouse is over button

Text

• Content - Text to display
• FontSize - Text size
• Color - Text color

Window

• Add(UIElement) - Add control to window
• IsRunning() - Check if window is still open
• UpdateAndRender() - Update and draw all controls

Building

dotnet build

Running Examples

Console Test (Quick Verification)

dotnet run --project examples/QuickTest.csproj

GUI Applications

For GUI applications, use Start-Process to run in a separate window:

# Run GUI test (recommended)
Start-Process "dotnet" -ArgumentList "run --project examples\GuiTest.csproj" -WorkingDirectory "c:\Users\Aleks\Workspace\AoGui"

# Run original example
Start-Process "dotnet" -ArgumentList "run --project examples\TestApp.csproj" -WorkingDirectory "c:\Users\Aleks\Workspace\AoGui"

Or build and run the executable directly:

dotnet build examples/GuiTest.csproj
.\examples\bin\Debug\net8.0-windows\GuiTest.exe

Project Structure

AoGui/
├── src/
│   ├── Core/
│   │   ├── Vector2.cs      # 2D vector structure
│   │   ├── Color.cs        # Color structure with presets
│   │   └── UIElement.cs    # Base class for all UI elements
│   ├── Controls/
│   │   ├── Button.cs       # Button control
│   │   └── Text.cs         # Text label control
│   ├── Rendering/
│   │   ├── IRenderer.cs    # Renderer interface
│   │   └── GdiRenderer.cs  # GDI+ implementation
│   └── Window.cs           # Main window class
├── examples/
│   ├── test.cs             # Original example
│   └── SyncTest.cs         # Property synchronization test
└── AoGui.csproj            # Library project file

License

Free to use for any purpose.