#pixel #blit #blitting #no-alloc

no-std simple-blit

Provides simple blitting from one surface to another with some possible transformations

13 releases (3 stable)

2.0.0 Jun 9, 2024
1.2.0 Jun 9, 2024
1.0.0 Feb 20, 2024
0.8.0 Jan 16, 2024
0.3.0 Nov 14, 2023

#90 in No standard library

Download history 8/week @ 2024-07-19 62/week @ 2024-07-26 4/week @ 2024-09-13 1/week @ 2024-09-20 73/week @ 2024-09-27 9/week @ 2024-10-04

83 downloads per month
Used in 2 crates

MIT-0 license

31KB
778 lines

simple-blit

Provides simple blitting from one surface to another with some possible transformations.

Example

use simple_blit::*;

let mut dest: [u8; 25] = [
    0, 0, 0, 0, 0,
    0, 0, 0, 0, 0,
    0, 0, 0, 0, 0,
    0, 0, 0, 0, 0,
    0, 0, 0, 0, 0,
];

let src: [u8; 16] = [
    1, 1, 1, 1,
    1, 1, 1, 1,
    1, 1, 1, 1,
    1, 1, 1, 1,
];

blit(
    // construct a surface which holds width and height
    GenericSurface::new(&mut dest, size(5, 5))
        .unwrap()
        // offset on the destination
        .offset_surface_mut(point(1, 1)),
    // you can borrow the surface if you don't want to drop it
    // (the destination has to be borrowed mutably of course)
    &GenericSurface::new(&src, size(4, 4))
        .unwrap()
        .sub_surface(
            point(0, 0), // source offset
            size(3, 3)   // size of the area to copy
        ),
    // no transformations
    Default::default(),
);

assert_eq!(dest, [
    0, 0, 0, 0, 0,
    0, 1, 1, 1, 0,
    0, 1, 1, 1, 0,
    0, 1, 1, 1, 0,
    0, 0, 0, 0, 0,
]);

Cargo features

  • pixels-integration (off by default): implements Surface and SurfaceMut for Pixels.
  • image-integration (off by default): implements Surface and SurfaceMut for ImageSurface
  • serde (off by default): implements Serialize and Deserialize for surface types and Transform.

License

As of version 1.0.0, this crate's license has been changed from MIT to MIT-0 (aka MIT No Attribution).

Dependencies

~0–31MB
~468K SLoC