imgii 0.8.0

ASCII Image Generator
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

//! Handles implementation for rendering PNG.

use super::generic_converter::render_ascii_generic;
use crate::{
    conversion::converters::generic_converter::Imgii2dImage,
    error::ImgiiError,
    options::{ImgiiOptions, RasciiOptions},
};

use image::open;
use rascii_art_img::render_image_to;

/// Reads and converts an image to ASCII and renders it into image.
///
/// # Params
/// * `input_file_name`: The input file name of the image to convert.
/// * `imgii_options`: The imgii options for rendering ASCII.
///
/// # Returns
/// * `Vec<Vec<ImageData>>`: A 2d `Vec` of images, containing each rendered character from the
///   image.
pub(crate) fn parse_ascii_to_2d_png_vec(
    input_file_name: &str,
    imgii_options: &ImgiiOptions,
) -> Result<Imgii2dImage, ImgiiError> {
    let ascii_text = read_png_as_ascii(input_file_name, imgii_options.rascii_options())?;
    render_ascii_generic(imgii_options, ascii_text)
}

/// Reads the image as an ASCII string using `RASCII`.
///
/// # Params
/// * `input_file_name`: The input file name of the image to convert.
/// * `rascii_options`: The RASCII image options.
///
/// # Returns
/// * `String` containing the colored image data as ASCII, colored using terminal escape sequences.
pub(crate) fn read_png_as_ascii(
    input_file_name: &str,
    rascii_options: &RasciiOptions,
) -> Result<String, ImgiiError> {
    // render the ascii text with RASCII
    let mut ascii_text = String::new();
    let loaded_img =
        open(input_file_name).map_err(|err| -> ImgiiError { anyhow::Error::new(err).into() })?;
    render_image_to(&loaded_img, &mut ascii_text, rascii_options)
        .map_err(|err| -> ImgiiError { anyhow::Error::new(err).into() })?;

    Ok(ascii_text)
}