cega 0.1.3

CGA and EGA binary image file processing library
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

use std::path::{Path, PathBuf};

use clap::Parser;

use cega::color::palette::palette_from_abbr;
use cega::image::Image;
use cega::sdl::render_sdl;
use cega::terminal::{TerminalMode, TerminalPalette};

#[derive(Parser, Debug)]
#[clap(version = "0.1", author = "Kenzi Connor")]
struct Args {
    #[clap(name = "IMAGE")]
    image: PathBuf,

    #[clap(value_enum, short, long, value_parser = TerminalMode::from_short, help="[possible values: a, c, p, h]\na = plain ascii\nc = colored ascii\np = full pixels via ansi bg color\nh = horizontal half pixels (UGLY)\nImages may be wider than terminal and will then crop")]
    ascii_mode: Option<TerminalMode>,

    #[clap(value_parser(["cga0", "cga0i", "cga1", "cga1i", "ega"]),num_args(0..=1), short, long, default_value="ega", help="ega palette can be used for cga, but not the inverse\n")]
    palette: String,

    #[clap(short, long, value_parser(["ega_row_planar", "erp", "cga"]), default_value="cga")]
    image_parser: String,

    #[clap(short, long, value_parser = parse_asci_param, help="4 chars palette like -a \" +%0\"")]
    custom_ascii: Option<String>,

    #[clap(short, long, default_value_t = 320)]
    width: usize,

    #[clap(
        short,
        long,
        help = "used for wrapping rows if retiling with tile_height\n"
    )]
    max_width: Option<usize>,

    #[clap(short, long)]
    tile_height: Option<usize>,

    #[clap(short, long, default_value_t = false)]
    sdl: bool,

    #[clap(short, long, default_value_t = false)]
    quiet: bool,
}

fn parse_asci_param(arg: &str) -> Result<String, String> {
    if let 0 | 4 = arg.len() {
        Ok(arg.to_string())
    } else {
        Err(format!("requires a 4 character string like: -a \" +%0\""))
    }
}

fn main() -> Result<(), Box<dyn std::error::Error>> {
    let args = Args::parse();

    let reader = std::fs::read(&Path::new(&args.image))?;
    let palette = palette_from_abbr(&args.palette);
    let mut image = Image::new(&reader, args.width, &args.image_parser);

    let mut image_data = image.data.clone();

    if args.tile_height.is_some() {
        image_data = image.retile(args.tile_height.unwrap(), args.max_width);
    }

    if args.ascii_mode.is_some() {
        print!(
            "{}",
            TerminalPalette::new(
                args.ascii_mode.unwrap(),
                args.custom_ascii.as_deref(),
                palette.clone()
            )
            .output_image_string(image_data.clone())
        );
    }

    if !args.quiet {
        if !image.is_fullscreen() {
            if args.width == 320 {
                println!("\nImage appears to not be fullscreen 320*200. It may be tiled, try setting a narrower -w width to detect tiles.");
                println!("Possible widths: {:?}", image.width_factors());
            } else if args.tile_height.is_none() && image.is_tall() {
                println!("\nImage height appears to >= 4x its width. If there are tiles, setting -t tile_height will make a more compact view");
                println!("Possible heights: {:?}", image.height_factors());
            }
        }
    }

    if args.sdl {
        render_sdl(image_data, palette)?
    }
    Ok(())
}