dotmax 0.1.9

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
115

//! Benchmarks for braille mapping operations (Story 3.5)
//!
//! These benchmarks measure the performance of the pixels-to-braille mapping stage,
//! which converts binary pixel data to BrailleGrid using 2×4 pixel blocks.
//!
//! Performance targets:
//! - 160×96 pixels (80×24 cells): <10ms
//! - 400×200 pixels (200×50 cells): <25ms

#![cfg(feature = "image")]

use criterion::{criterion_group, criterion_main, Criterion};
use dotmax::image::{
    auto_threshold, load_from_path, pixels_to_braille, resize_to_dimensions, to_grayscale,
};
use std::hint::black_box;
use std::path::Path;

/// Benchmark braille mapping for standard terminal size (160×96 pixels = 80×24 cells)
fn bench_pixels_to_braille_standard(c: &mut Criterion) {
    // Prepare binary image at terminal size
    let img = load_from_path(Path::new("tests/fixtures/images/sample.png"))
        .expect("Failed to load sample image");
    let resized = resize_to_dimensions(&img, 160, 96, true).expect("Failed to resize");
    let gray = to_grayscale(&resized);
    let gray_dynamic = image::DynamicImage::ImageLuma8(gray);
    let binary = auto_threshold(&gray_dynamic);

    c.bench_function("pixels_to_braille_160x96", |b| {
        b.iter(|| {
            let grid = pixels_to_braille(black_box(&binary), 80, 24).unwrap();
            black_box(grid);
        });
    });
}

/// Benchmark braille mapping for large terminal (400×200 pixels = 200×50 cells)
fn bench_pixels_to_braille_large(c: &mut Criterion) {
    let img = load_from_path(Path::new("tests/fixtures/images/sample.png"))
        .expect("Failed to load sample image");
    let resized = resize_to_dimensions(&img, 400, 200, true).expect("Failed to resize");
    let gray = to_grayscale(&resized);
    let gray_dynamic = image::DynamicImage::ImageLuma8(gray);
    let binary = auto_threshold(&gray_dynamic);

    c.bench_function("pixels_to_braille_400x200", |b| {
        b.iter(|| {
            let grid = pixels_to_braille(black_box(&binary), 200, 50).unwrap();
            black_box(grid);
        });
    });
}

/// Benchmark braille mapping for small image (40×24 pixels = 20×6 cells)
fn bench_pixels_to_braille_small(c: &mut Criterion) {
    let img = load_from_path(Path::new("tests/fixtures/images/sample.png"))
        .expect("Failed to load sample image");
    let resized = resize_to_dimensions(&img, 40, 24, true).expect("Failed to resize");
    let gray = to_grayscale(&resized);
    let gray_dynamic = image::DynamicImage::ImageLuma8(gray);
    let binary = auto_threshold(&gray_dynamic);

    c.bench_function("pixels_to_braille_40x24", |b| {
        b.iter(|| {
            let grid = pixels_to_braille(black_box(&binary), 20, 6).unwrap();
            black_box(grid);
        });
    });
}

/// Benchmark full pipeline: threshold → braille mapping (standard size)
fn bench_threshold_to_braille_pipeline(c: &mut Criterion) {
    let img = load_from_path(Path::new("tests/fixtures/images/sample.png"))
        .expect("Failed to load sample image");
    let resized = resize_to_dimensions(&img, 160, 96, true).expect("Failed to resize");
    let gray = to_grayscale(&resized);
    let gray_dynamic = image::DynamicImage::ImageLuma8(gray);

    c.bench_function("threshold_to_braille_pipeline_160x96", |b| {
        b.iter(|| {
            let binary = auto_threshold(black_box(&gray_dynamic));
            let grid = pixels_to_braille(&binary, 80, 24).unwrap();
            black_box(grid);
        });
    });
}

/// Benchmark full end-to-end pipeline (load → resize → grayscale → threshold → braille)
fn bench_full_image_to_braille_pipeline(c: &mut Criterion) {
    let img = load_from_path(Path::new("tests/fixtures/images/sample.png"))
        .expect("Failed to load sample image");

    c.bench_function("full_image_to_braille_pipeline", |b| {
        b.iter(|| {
            let resized =
                resize_to_dimensions(black_box(&img), 160, 96, true).expect("Failed to resize");
            let gray = to_grayscale(&resized);
            let gray_dynamic = image::DynamicImage::ImageLuma8(gray);
            let binary = auto_threshold(&gray_dynamic);
            let grid = pixels_to_braille(&binary, 80, 24).unwrap();
            black_box(grid);
        });
    });
}

criterion_group!(
    benches,
    bench_pixels_to_braille_standard,
    bench_pixels_to_braille_large,
    bench_pixels_to_braille_small,
    bench_threshold_to_braille_pipeline,
    bench_full_image_to_braille_pipeline,
);

criterion_main!(benches);