Skip to content

ANSI_GRAPHICS_PLAN.md

Latest commit

 

History

History
142 lines (116 loc) · 5.18 KB

ANSI_GRAPHICS_PLAN.md

File metadata and controls

142 lines (116 loc) · 5.18 KB

ANSI Graphics Implementation Plan for Game of Life

Current State Analysis

The current Program.cs displays the Game of Life using basic ASCII characters:

  • Live cells: " O "
  • Dead cells: " . "
  • Simple line-by-line output with generation counter
  • No positioning control or visual enhancement

Task List: ANSI Graphics Implementation

Phase 1: Foundation Setup

  1. Create ConsoleRenderer class

    • Add new ConsoleRenderer.cs file to GameOfLife project
    • Implement basic screen management methods (ClearScreen, SetEncoding)
    • Add cursor positioning utilities (SetCursorPosition, CalculateCenter)

  2. Console initialization

    • Set UTF-8 encoding for Unicode character support
    • Implement cursor hide/show functionality
    • Add exception handling for terminal size limitations

Phase 2: Visual Enhancement

  1. Design enhanced cell rendering

    • Replace " O " with colored Unicode blocks ("█" or "●")
    • Replace " . " with subtle characters ("·" or space)
    • Implement ANSI color codes (green for alive, gray for dead)

  2. Add border system

    • Create Unicode box drawing border around game area
    • Use characters like "┌─┐│└┘" for clean borders
    • Calculate border dimensions based on board size

  3. Implement centering logic

    • Calculate center position using Console.WindowWidth/Height
    • Handle different terminal sizes gracefully
    • Add fallback positioning for small terminals

Phase 3: Animation System

  1. Create smooth rendering

    • Replace line-by-line printing with positioned cell updates
    • Clear only game area between generations (not full screen)
    • Add configurable delay between generations (default 500ms)

  2. Generation counter display

    • Position generation info in fixed location (top or bottom)
    • Style with consistent formatting
    • Ensure it doesn't interfere with game area

Phase 4: Integration & Enhancement

  1. Update Program.cs

    • Replace PrintBoard() method with ConsoleRenderer calls
    • Modify Main() method to use new rendering system
    • Maintain backward compatibility with existing logic

  2. Add configuration options

    • Create settings for different visual styles
    • Add animation speed control
    • Include color on/off toggle for accessibility

Phase 5: Testing & Refinement

  1. Cross-platform testing

    • Test on Windows, macOS, and Linux terminals
    • Verify Unicode character support
    • Add fallback ASCII characters where needed

  2. Update tests

    • Ensure existing tests continue to pass
    • Add tests for ConsoleRenderer methods (where applicable)
    • Test exception handling for small terminals

  3. Performance optimization

    • Minimize screen refreshes and flicker
    • Optimize cursor movement patterns
    • Add efficient screen clearing methods

Phase 6: Documentation & Polish

  1. Update documentation

    • Document new visual features in CLAUDE.md
    • Add usage examples for different terminal configurations
    • Include screenshots or ASCII art examples

  2. Final integration

    • Ensure all existing functionality preserved
    • Test complete game flow with new graphics
    • Verify test coverage remains at 100%

Technical Implementation Details

ConsoleRenderer Class Structure

public class ConsoleRenderer
{
    // Screen management
    public void ClearScreen()
    public void SetEncoding()
    public void HideCursor()
    public void ShowCursor()
    
    // Positioning
    public void SetCursorToCenter(int boardSize)
    public (int x, int y) CalculateCenter(int width, int height)
    
    // Rendering
    public void RenderBoard(GameOfLifeBoard board)
    public void RenderCell(int x, int y, CellStatus status)
    public void DrawBorder(int size)
    public void RenderGeneration(int generation)
    
    // Configuration
    public void SetColors(ConsoleColor alive, ConsoleColor dead)
    public void SetCellCharacters(char alive, char dead)
}

Visual Design Options

  • Live cells: "█" (full block), "●" (bullet), "■" (square)
  • Dead cells: "·" (middle dot), " " (space), "░" (light shade)
  • Colors: Green/cyan for alive, gray/dim for dead
  • Border: Unicode box drawing characters

Cross-Platform Considerations

  • UTF-8 encoding setup: Console.OutputEncoding = System.Text.Encoding.UTF8
  • Fallback ASCII characters for unsupported terminals
  • Exception handling for small terminal windows
  • Terminal capability detection

Expected Results

  • Visually appealing centered game area with colored Unicode graphics
  • Smooth animation with fluid transitions between generations
  • Professional terminal-based game presentation
  • All existing game logic and test coverage preserved
  • Cross-platform compatibility (Windows, macOS, Linux)

Benefits

  • Enhanced user experience with modern console graphics
  • Demonstrates advanced terminal programming techniques
  • Maintains backward compatibility
  • Foundation for future enhancements (mouse input, larger boards, etc.)

Implementation Notes

This phased approach ensures systematic implementation while maintaining existing codebase integrity and test coverage. Each phase builds upon the previous one, allowing for incremental testing and validation.