blittle 0.5.1

A fast little blitter
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

mod from;
mod to;
mod zrgb;

use crate::{Error, Surface};
use bytemuck::cast_slice_mut;
pub use from::FromZrgb;
use glam::USizeVec2;
use raw_window_handle::{HasDisplayHandle, HasWindowHandle};
use softbuffer::Buffer;
use std::marker::PhantomData;
use std::ops::DerefMut;
pub use to::ToZrgb;
pub use zrgb::Zrgb;

/// Red, green, blue as [Zrgb] pixels, referencing a [Buffer].
pub type SoftbufferSurface<'s> = Surface<'s, &'s mut [Zrgb], Zrgb>;

impl<'s> SoftbufferSurface<'s> {
    /// Convert a softbuffer [Buffer] to a surface.
    ///
    /// The underlying pixel buffer is a mutable reference to `buffer`.
    pub fn from_softbuffer<D: HasDisplayHandle, W: HasWindowHandle>(
        buffer: &'s mut Buffer<D, W>,
    ) -> Self {
        let size = USizeVec2 {
            x: buffer.width().get() as usize,
            y: buffer.height().get() as usize,
        };
        let buffer = cast_slice_mut::<u32, Zrgb>(buffer.deref_mut());
        Self {
            size,
            buffer,
            destination_rect: None,
            blit_area: None,
            _p: PhantomData,
        }
    }
}

impl<'s, S: AsRef<[Zrgb]> + AsMut<[Zrgb]>> Surface<'s, S, Zrgb> {
    /// Blit to a softbuffer [Buffer].
    pub fn blit_to_softbuffer<D: HasDisplayHandle, W: HasWindowHandle>(
        &self,
        buffer: &'s mut Buffer<D, W>,
    ) -> Result<(), Error> {
        let mut destination = SoftbufferSurface::from_softbuffer(buffer);
        self.blit(&mut destination)
    }
}