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

//! Example: View image metadata from any file path
//!
//! Run with:
//! ```bash
//! cargo run --example view_image --features image -- path/to/image.png
//! ```

use dotmax::image::load_from_path;
use std::env;
use std::path::Path;

#[allow(clippy::uninlined_format_args, clippy::unnecessary_wraps)]
fn main() -> Result<(), Box<dyn std::error::Error>> {
    // Initialize tracing
    tracing_subscriber::fmt()
        .with_max_level(tracing::Level::INFO)
        .init();

    // Get image path from command line args
    let args: Vec<String> = env::args().collect();
    let image_path = if args.len() > 1 {
        &args[1]
    } else {
        "examples/tiger_1.png" // Default to tiger image
    };

    println!("═══════════════════════════════════════════════");
    println!("  dotmax - Image Viewer");
    println!("═══════════════════════════════════════════════\n");
    println!("📂 Loading: {}\n", image_path);

    let path = Path::new(image_path);
    match load_from_path(path) {
        Ok(img) => {
            println!("✅ Successfully loaded image!\n");
            println!("📊 Image Details:");
            println!("   - Dimensions: {}×{} pixels", img.width(), img.height());
            println!("   - Color Type: {:?}", img.color());
            println!("   - Total Pixels: {}", img.width() * img.height());

            // Calculate braille cell dimensions (2×4 dots per cell)
            let braille_width = (img.width() + 1) / 2; // 2 dots wide per cell
            let braille_height = (img.height() + 3) / 4; // 4 dots tall per cell
            println!("\n🔲 Braille Rendering Info:");
            println!(
                "   - Would render as: {}×{} braille cells",
                braille_width, braille_height
            );
            println!(
                "   - Terminal size estimate: {} columns × {} rows",
                braille_width, braille_height
            );

            println!("\n✨ Image loaded successfully!");
        }
        Err(e) => {
            println!("❌ Failed to load image:");
            println!("   Error: {}", e);
            println!("\nTip: Make sure the file exists and is a supported format");
            println!("     Supported: PNG, JPG, GIF, BMP, WebP, TIFF");
        }
    }

    println!("\n═══════════════════════════════════════════════");
    Ok(())
}