ascii-img2 0.1.0

ASCII image generation 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

//! Character set module.

use alloc::vec::Vec;

/// A character set.
pub trait Charset: Send + Sync {
    fn map(&self, luminance: f32) -> char;
}

/// A character set where all characters are uniformly distributed across the luminance range.
/// ```rust
/// use ascii_img2::prelude::*;
/// let charset = LinearCharset::new(vec![' ', ';', '&']);
/// assert_eq!(charset.map(0.0), ' ');
/// assert_eq!(charset.map(0.5), ';');
/// assert_eq!(charset.map(1.0), '&');
/// ```
pub struct LinearCharset {
    chars: Vec<char>,
}

impl LinearCharset {
    pub fn new(chars: impl Into<Vec<char>>) -> Self {
        Self {
            chars: chars.into(),
        }
    }
}

impl Charset for LinearCharset {
    fn map(&self, luminance: f32) -> char {
        let index = (luminance.clamp(0.0, 1.0) * (self.chars.len() - 1) as f32).round() as usize;
        self.chars[index]
    }
}