1-bit image embedding at compile time.

[dependencies]
stockbook = "0.3.0

The main functionality of Stockbook is the stamp! macro, which lets you include data similarly to how include_bytes! does, but from an image, specifically a 1-bit black and white image. The macro returns a Stamp type, which just holds the image's width, height, and a static reference to the pixel data. The pixel data is represented internally as an array of bytes, in which individual bits correspond to individual pixels.

1. Example

File assets/star.png (scaled x8 for preview, originally 12x12 px):

File src/lib.rs:

use stockbook::{stamp, Color, Stamp};

static STAR_SPRITE: Stamp = stamp!("assets/star.png");

pub fn draw_star() {
	for (x, y, color) in STAR_SPRITE.pixels() {
		match color {
			Color::Black => {}, // Treat as transparent
			Color::White => draw_pixel_at(x, y),
		}
	}
}

fn draw_pixel_at(x: usize, y: usize) {
	/* ... */
}

2. Supported formats

Stockbook uses the image crate under the hood.

3. Feature flags

• progmem — wraps all pixel data of Stamps in “avr_progmem::wrapper::ProgMem”. Combined with the “avr” target architecture, this allows you to keep most of the data in program memory without the need to copy it to RAM. A no-op for non-“avr” target architectures.

4. Unstable features

Although this library works on stable, any changes to images referenced by the stamp! macro might not be detected because of caching. Therefore, until track_path API stabilizes, it is recommended to use the nightly toolchain, however functionality behind this feature is unstable and may change or stop compiling at any time.

5. Source

6. License

This software is licensed under the MIT license.