Struct Typographer 

pub struct Typographer {
    pub sampler: Sampler,
    pub symbol_aspect_ratio: f32,
    pub luma_threshold: f32,
    pub fill: Option<Fill>,
    pub edges: Option<Edges>,
    pub colours: Option<Colours>,
}

Typographer entry-point.

By default, this always produces an empty image. To add output, define Typographer::fill and/or Typographer::edges. For full configurability, this could be done with the struct update syntax:

let typographer = Typographer {
    char_aspect_ratio: 1.5, 
    fill: Some(Fill {
        gradient: " `.:-=;*?+#%@".toString(), 
        brightness_gain: 0.1, 
        ..Default::default()
    }), 
    edges: Some(Edges::default()), 
    ..Default::default()
};

… or using the using the Typographer::new and Typographer::new_coloured short-hands.

Images are then rendered using Typographer::render, provided an input image and output size in symbols.

Fields

sampler: Sampler

Algorithm used to downsample the image.

symbol_aspect_ratio: f32

The aspect ratio height / width of the symbols. This is usually around 2.0.

luma_threshold: f32

Luma threshold to reduce noise. Defined in [0, 1].

fill: Option<Fill>

Settings used to render luma.

edges: Option<Edges>

Settings used to render edges.

colours: Option<Colours>

Settings used to colourise the symbols.

Implementations

impl Typographer

pub fn new() -> Typographer

Constructs with only fill and edges enabled. Each have default settings.

pub fn new_coloured() -> Typographer

Constructs with fill, edges, and colours enabled. Each have default settings.

pub fn render(&self, image: &RgbImage, size: Size) -> AsciiImage

Renders an RGB image to an ASCII image of given size in symbols.

Trait Implementations

impl Clone for Typographer

fn clone(&self) -> Typographer

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Default for Typographer

fn default() -> Self

Returns the “default value” for a type.