Struct Font

pub struct Font { /* private fields */ }

A single font loaded from a file.

Implementations

impl Font

pub fn new(rusttype_font: Font<'static>) -> Font

Construct a new Font from a rusttype::Font.

pub fn render_char(&self, chr: char, scale: f32) -> Option<(CharInfo, Bitmap)>

Renders a character from this font at a given scale into a pair of (CharInfo, Bitmap).

If the character isn’t handled by the font, None is returned.

Examples found in repository

examples/basic_char.rs (line 7)

fn main() {
    let bytes = include_bytes!("Gudea-Regular.ttf");
    let font = load_font_from_bytes(bytes.to_vec());
    let (_, bitmap) = font.render_char('A', 40.0).unwrap();
    for line in bitmap.lines() {
        for &pixel in line {
            if pixel == 0 {
                print!(" ");
            } else {
                print!("#");
            }
        }
        println!("");
    }
}

pub fn make_atlas<I: Iterator<Item = char>>( &self, i: I, scale: f32, margin: u32, width: usize, height: usize, ) -> (Atlas, Bitmap, f32)

Creates an atlas for a set of characters rendered at a given scale.

margin is the distance between characters in pixels. width and height denote the starting size of the bitmap.

The resulting bitmap may be larger than width x height in order to fit all of the characters.

Examples found in repository

examples/basic_atlas.rs (line 8)

fn main() {
    let bytes = include_bytes!("Gudea-Regular.ttf");
    let font = load_font_from_bytes(bytes.to_vec());
    let chars = font_atlas::ASCII.iter().cloned().chain(font_atlas::ASCII.iter().cloned());
    let (_, bitmap, _) = font.make_atlas(chars, 20.0, 1, 128, 128);
    for line in bitmap.lines() {
        print!("{:03} ", line.len());
        for &pixel in line {
            if pixel == 0 {
                print!(" ");
            } else {
                print!("#");
            }
        }
        println!("");
    }
}

Trait Implementations

impl Clone for Font

fn clone(&self) -> Font

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Font

fn fmt(&self, formatter: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.