Gloam.Console.Render 0.7.0

Gloam.Console.Render

High-performance console rendering backend for Gloam engine

Overview

Gloam.Console.Render provides a full-featured console rendering implementation with double-buffered output, ANSI color support, and optimized drawing operations for roguelike games.

Features

• Console Rendering: Full IRenderer implementation for console output
• Double Buffering: Flicker-free rendering with ConsoleSurface
• ANSI Color Support: Rich color output with RGB to ConsoleColor mapping
• Layer Support: Integration with layer rendering system
• Input Handling: ConsoleInputDevice with keyboard input detection

Quick Start

using Gloam.Console.Render.Rendering;
using Gloam.Runtime;

// Setup console rendering
var renderer = new ConsoleRenderer();
var host = new GloamHost(hostConfig);
host.SetRenderer(renderer);

// Use with layers
var layerManager = new LayerRenderingManager();
layerManager.RegisterLayer(new GameWorldLayer(), priority: 0);
layerManager.RegisterLayer(new HudLayer(), priority: 100);

Rendering Features

• Console Surface: ConsoleSurface for efficient drawing operations
• Color Management: Automatic RGB to ConsoleColor conversion
• Transparency Support: Alpha channel handling (alpha=0 treated as transparent)
• Background Bleed Prevention: Smart background color management

Key Components

• Renderer: ConsoleRenderer - Main rendering implementation
• Surface: ConsoleSurface - Double-buffered drawing surface
• Input: ConsoleInputDevice - Keyboard input with edge detection
• Layer Integration: Full support for layer-based rendering

Performance Features

• Double Buffering: Only redraw changed console cells
• Optimized Drawing: Minimal console write operations
• Memory Efficient: Buffer pooling for reduced allocations
• High Frame Rates: Capable of 60+ FPS rendering

Usage with Layers

public class GameLayer : BaseLayerRenderer
{
    public override async Task RenderAsync(IRenderer renderer, RenderLayerContext context)
    {
        // Draw game world
        renderer.DrawGlyph(10, 5, '@', Colors.Gold);
        renderer.DrawText(0, 0, "Health: 100", Colors.Red);
    }
}

Documentation

• Full Documentation
• API Reference
• GitHub Repository

License

MIT License - see LICENSE for details.