blitter 0.6.1

This library performs various blitting and drawing operations on a 32 bits framebuffer.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78

//#![windows_subsystem = "windows"]
use minifb::{Key, Window, WindowOptions};
use blitter::*;

const WIDTH: usize = 640;
const HEIGHT: usize = 520;

fn main() {
    // Framebuffer initialization
    let mut pixels: Vec<u32> = vec!(0; WIDTH * HEIGHT);
    let mut fb = Framebuffer {width: WIDTH, height: HEIGHT, pixels: &mut pixels};
    
    // User bitmaps generating / loading
    let image:  Vec<u32> =  { vec![0xffffffff; 100] };
    let image2:  Vec<u32> =  { vec![0x0000ff00; 2500] };
    let image3:  Vec<u32> =  { vec![0x0000ff00; 100] };
    let path = "resources/test-image.png";
    let png = from_png_file(&path, PixelFormat::Zrgb).unwrap();

    // Test mask
    let test_mask = vec![true, false, true, false, true, false, true, false, true, false,
    false, true, false, true, false, true, false, true, false, true,
    true, false, true, false, true, false, true, false, true, false,
    false, true, false, true, false, true, false, true, false, true,
    true, false, true, false, true, false, true, false, true, false,
    false, true, false, true, false, true, false, true, false, true,
    true, false, true, false, true, false, true, false, true, false,
    false, true, false, true, false, true, false, true, false, true,
    true, false, true, false, true, false, true, false, true, false,
    false, true, false, true, false, true, false, true, false, true];
    let mask = Mask::Bits(&test_mask);

    // Bitmaps structs stored in a Vec (could be a hashmap or whatever you want), to give more easily ownership to other functions
    let mut bitmaps = Vec::new();
    bitmaps.push(Bitmap {w: 10, h: 10, x: 0, y: 0, pixels: &image});
    bitmaps.push(Bitmap{w: png.0, h: png.1, x: 0, y: 320, pixels: &png.2});
    bitmaps.push(Bitmap {w: 50, h: 50, x: 590, y: 470, pixels: &image2});
    bitmaps.push(Bitmap {w: 10, h: 10, x: 630, y: 460, pixels: &image3});

    let mut window = Window::new(
        "Test - ESC to exit",
        WIDTH,
        HEIGHT,
        WindowOptions::default(),
    )
    .unwrap_or_else(|e| {
        panic!("{}", e);
    });

    // Limit to max ~60 fps update rate
    window.limit_update_rate(Some(std::time::Duration::from_micros(16600)));

    // Drawing non moving part of screen
    bitmaps[1].blit(&mut fb);
    bitmaps[2].blit(&mut fb);
    fb.draw_fatpixel(WIDTH/2, HEIGHT/2, 4, 0xffffffff).unwrap();
    bitmaps[3].blit_mask(&mut fb, mask);

    while window.is_open() && !window.is_key_down(Key::Escape) {
        
        // We can easily give bitmaps and framebuffer ownership; of course you can it do the way you want
        move_square(&mut fb, &mut bitmaps);

        // We unwrap here as we want this code to exit if it fails. Real applications may want to handle this in a different way
        window
            .update_with_buffer(&fb.pixels, WIDTH, HEIGHT)
            .unwrap();
    }
}

// For testing : moves a 10x10 square and prints a 4x4 pixel at the center of the screen
fn move_square(mut fb: &mut Framebuffer, bitmaps: &mut Vec<Bitmap>) {
    // We just clear the animated part of the screen
    fb.clear_area(640, 10, 0, 0, 0).unwrap();

    bitmaps[0].blit(&mut fb);
    if bitmaps[0].x < WIDTH as isize - 10 { bitmaps[0].x = bitmaps[0].x+3; }
}