Struct Bitmap

pub struct Bitmap<'a> { /* private fields */ }

A single 8x16 or 16x16 bitmap, corresponding to a single displayed glyph. See the module documentation for a cryptic warning about combining characters, invisible characters, etc.

Implementations

impl<'a> Bitmap<'a>

pub fn get_bytes(&self) -> &'a [u8]

Returns the bytes that make up the given bitmap. Each byte contains 8 pixels. The highest order bit of the byte is the leftmost pixel, the next highest order bit is the next pixel, and so on. If the glyph is wide (see is_wide) then there are two bytes per row, otherwise there is one byte per row.

Examples found in repository

examples/banner.rs (line 16)

fn banner_print(unifont: &mut Unifont, ink: char, wat: &str) {
    for c in wat.chars() {
	let bitmap = unifont.load_bitmap(c as u32);
	let pitch = if bitmap.is_wide() { 2 } else { 1 };
	for x in 0..bitmap.get_dimensions().0 {
	    for _ in 0 .. 2 {
		for y in (0..16).rev() {
		    for _ in 0 .. 2 {
			let bi = (x/8) + y*pitch;
			let shift = x%8;
			let b = bitmap.get_bytes()[bi];
			if (128 >> shift) & b == 0 {
			    print!(" ");
			}
			else {
			    print!("{}", ink);
			}
		    }
		}
		println!("");
	    }
	}
    }
}

pub fn is_wide(&self) -> bool

Returns true if the bitmap is wide (16x16), false if it is narrow (8x16).

Examples found in repository

examples/banner.rs (line 9)

fn banner_print(unifont: &mut Unifont, ink: char, wat: &str) {
    for c in wat.chars() {
	let bitmap = unifont.load_bitmap(c as u32);
	let pitch = if bitmap.is_wide() { 2 } else { 1 };
	for x in 0..bitmap.get_dimensions().0 {
	    for _ in 0 .. 2 {
		for y in (0..16).rev() {
		    for _ in 0 .. 2 {
			let bi = (x/8) + y*pitch;
			let shift = x%8;
			let b = bitmap.get_bytes()[bi];
			if (128 >> shift) & b == 0 {
			    print!(" ");
			}
			else {
			    print!("{}", ink);
			}
		    }
		}
		println!("");
	    }
	}
    }
}

pub fn get_dimensions<T: From<u8>>(&self) -> (T, T)

Returns the dimensions of the bitmap, width then height. Always returns (8,16) or (16,16).

Examples found in repository

examples/banner.rs (line 10)

fn banner_print(unifont: &mut Unifont, ink: char, wat: &str) {
    for c in wat.chars() {
	let bitmap = unifont.load_bitmap(c as u32);
	let pitch = if bitmap.is_wide() { 2 } else { 1 };
	for x in 0..bitmap.get_dimensions().0 {
	    for _ in 0 .. 2 {
		for y in (0..16).rev() {
		    for _ in 0 .. 2 {
			let bi = (x/8) + y*pitch;
			let shift = x%8;
			let b = bitmap.get_bytes()[bi];
			if (128 >> shift) & b == 0 {
			    print!(" ");
			}
			else {
			    print!("{}", ink);
			}
		    }
		}
		println!("");
	    }
	}
    }
}

Trait Implementations

impl<'a> Debug for Bitmap<'a>

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

Formats the value using the given formatter.

impl<'a> PartialEq for Bitmap<'a>

fn eq(&self, other: &Bitmap<'a>) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'a> Eq for Bitmap<'a>

impl<'a> StructuralPartialEq for Bitmap<'a>