blit

Crates.ioblit
lib.rsblit
version0.8.5
sourcesrc
created_at2018-01-06 21:31:51.680114
updated_at2024-03-07 20:42:37.98496
descriptionBlit sprites on a buffer with a mask
homepagehttps://github.com/tversteeg/blit
repositoryhttps://github.com/tversteeg/blit.git
max_upload_size
id45768
size220,548
Thomas Versteeg (tversteeg)

documentation

https://docs.rs/blit

README

blit

Build Status Crates.io Documentation License: GPL-3.0 Downloads

Documentation

Draw sprites quickly using a masking color or an alpha treshold.

Interactive Demo

This crate works with RGBA u32 buffers. The alpha channel can only be read with a singular treshold, converting it to a binary transparent or opaque color. The reason this limitation is in place is that it allows efficient rendering optimizations.

For ergonomic use of this crate without needing to type convert everything most functions accepting numbers are generic with the number types being [num_traits::ToPrimitive], this might seem confusing but any number can be passed to these functions immediately.

When using this crate the most important function to know about is [Blit::blit], which is implemented for [BlitBuffer].

Example

use blit::{Blit, ToBlitBuffer, BlitOptions, geom::Size};

const CANVAS_SIZE: Size = Size { width: 180, height: 180 };
const MASK_COLOR: u32 = 0xFF_00_FF;
// Create a buffer in which we'll draw our image
let mut canvas: Vec<u32> = vec![0xFF_FF_FF_FF; CANVAS_SIZE.pixels()];

// Load the image from disk using the `image` crate
let img = image::open("examples/smiley_rgb.png").unwrap().into_rgb8();

// Blit by creating a special blitting buffer first where the MASK_COLOR will be the color that will be made transparent
let blit_buffer = img.to_blit_buffer_with_mask_color(MASK_COLOR);

// Draw the image 2 times to the buffer
blit_buffer.blit(&mut canvas, CANVAS_SIZE, &BlitOptions::new_position(10, 10));
blit_buffer.blit(&mut canvas, CANVAS_SIZE, &BlitOptions::new_position(20, 20));
Commit count: 234

cargo fmt