dotmax 0.1.7

High-performance terminal braille rendering for images, animations, and graphics
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114

//! Simple shapes demonstration (prints to stdout)
//!
//! This is a validation-friendly version that prints grid content to stdout
//! instead of using TerminalRenderer (which requires a TTY).
//!
//! Run with: cargo run --example shapes_demo_simple

use dotmax::primitives::{
    draw_polygon, draw_polygon_filled, draw_rectangle, draw_rectangle_filled,
};
use dotmax::BrailleGrid;

fn main() -> Result<(), dotmax::DotmaxError> {
    println!("═══════════════════════════════════════════════════════");
    println!("Shapes Demo - Visual Validation");
    println!("═══════════════════════════════════════════════════════\n");

    // Demo 1: Rectangle outlines
    println!("Demo 1: Rectangle outlines (various sizes)");
    println!("───────────────────────────────────────────────────────");
    let mut grid = BrailleGrid::new(60, 12)?;
    draw_rectangle(&mut grid, 5, 5, 15, 10)?;
    draw_rectangle(&mut grid, 30, 5, 25, 15)?;
    draw_rectangle(&mut grid, 65, 5, 40, 30)?;
    print_grid(&grid);
    println!();

    // Demo 2: Filled rectangles
    println!("Demo 2: Filled rectangles (solid fill)");
    println!("───────────────────────────────────────────────────────");
    let mut grid = BrailleGrid::new(60, 12)?;
    draw_rectangle_filled(&mut grid, 10, 5, 20, 12)?;
    draw_rectangle_filled(&mut grid, 40, 8, 25, 18)?;
    draw_rectangle_filled(&mut grid, 75, 10, 30, 25)?;
    print_grid(&grid);
    println!();

    // Demo 3: Triangles (outline)
    println!("Demo 3: Triangles (outline)");
    println!("───────────────────────────────────────────────────────");
    let mut grid = BrailleGrid::new(60, 12)?;
    let triangle1 = [(30, 5), (15, 35), (45, 35)];
    let triangle2 = [(90, 35), (75, 5), (105, 5)];
    draw_polygon(&mut grid, &triangle1)?;
    draw_polygon(&mut grid, &triangle2)?;
    print_grid(&grid);
    println!();

    // Demo 4: Filled triangles
    println!("Demo 4: Filled triangles (solid fill)");
    println!("───────────────────────────────────────────────────────");
    let mut grid = BrailleGrid::new(60, 12)?;
    let triangle = [(60, 8), (40, 40), (80, 40)];
    draw_polygon_filled(&mut grid, &triangle)?;
    print_grid(&grid);
    println!();

    // Demo 5: Regular polygons
    println!("Demo 5: Regular polygons (pentagon, hexagon)");
    println!("───────────────────────────────────────────────────────");
    let mut grid = BrailleGrid::new(60, 12)?;

    // Pentagon
    let pentagon = [(30, 8), (40, 15), (35, 30), (25, 30), (20, 15)];
    draw_polygon(&mut grid, &pentagon)?;

    // Hexagon
    let hexagon = [(70, 15), (80, 10), (90, 15), (90, 25), (80, 30), (70, 25)];
    draw_polygon(&mut grid, &hexagon)?;

    print_grid(&grid);
    println!();

    // Demo 6: Filled polygon (hexagon)
    println!("Demo 6: Filled hexagon (solid fill)");
    println!("───────────────────────────────────────────────────────");
    let mut grid = BrailleGrid::new(60, 12)?;
    let hexagon = [(50, 10), (65, 8), (75, 18), (70, 32), (55, 34), (45, 24)];
    draw_polygon_filled(&mut grid, &hexagon)?;
    print_grid(&grid);
    println!();

    // Demo 7: Mixed - rectangles and polygons
    println!("Demo 7: Mixed shapes");
    println!("───────────────────────────────────────────────────────");
    let mut grid = BrailleGrid::new(60, 12)?;
    draw_rectangle(&mut grid, 5, 5, 30, 25)?;
    let triangle = [(60, 8), (45, 32), (75, 32)];
    draw_polygon(&mut grid, &triangle)?;
    draw_rectangle_filled(&mut grid, 90, 15, 20, 18)?;
    print_grid(&grid);
    println!();

    println!("═══════════════════════════════════════════════════════");
    println!("✓ All shape demos rendered successfully!");
    println!("✓ Visual inspection: Check edges are continuous");
    println!("✓ Check: Filled shapes have solid interiors");
    println!("✓ Check: Polygon vertices connect properly");
    println!("═══════════════════════════════════════════════════════");

    Ok(())
}

/// Helper function to print grid contents to stdout
fn print_grid(grid: &BrailleGrid) {
    let (width, height) = grid.dimensions();
    for y in 0..height {
        for x in 0..width {
            let c = grid.get_char(x, y);
            print!("{}", c);
        }
        println!();
    }
}