dunge 0.1.10

Simple and portable 3d render library
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

use {
    crate::{context::PixelSize, framebuffer::FrameFilter},
    std::num::NonZeroU32,
};

#[derive(Clone, Copy)]
pub(crate) struct Screen {
    pub width: NonZeroU32,
    pub height: NonZeroU32,
    pub pixel_size: PixelSize,
    pub filter: FrameFilter,
}

impl Screen {
    pub fn physical_size(&self) -> (u32, u32) {
        (self.width.get(), self.height.get())
    }

    pub fn virtual_size(&self) -> (u32, u32) {
        let (width, height) = self.physical_size();
        match self.pixel_size {
            PixelSize::XHalf => (width * 2, height * 2),
            PixelSize::X1 => (width, height),
            PixelSize::X2 => (width / 2, height / 2),
            PixelSize::X3 => (width / 3, height / 3),
            PixelSize::X4 => (width / 4, height / 4),
        }
    }

    pub fn virtual_size_aligned(&self) -> (u32, u32) {
        const N_COLOR_CHANNELS: u32 = 4;
        const ALIGNMENT: u32 = wgpu::COPY_BYTES_PER_ROW_ALIGNMENT / N_COLOR_CHANNELS;

        let (mut width, height) = self.virtual_size();
        width += ALIGNMENT - width % ALIGNMENT;
        (width, height)
    }

    pub fn buffer_size(&self, max_size: u32) -> (NonZeroU32, NonZeroU32) {
        let (width, height) = self.virtual_size_aligned();
        let (width, height) = match self.pixel_size {
            PixelSize::XHalf => (width + 1, height + 1),
            _ => (width, height),
        };

        (
            NonZeroU32::new(width.clamp(1, max_size)).expect("non zero"),
            NonZeroU32::new(height.clamp(1, max_size)).expect("non zero"),
        )
    }

    pub fn size_factor(&self) -> (f32, f32) {
        let (width, height) = self.virtual_size_aligned();
        let (width, height) = match self.pixel_size {
            PixelSize::XHalf => (width / 2, height / 2),
            PixelSize::X1 => (width, height),
            PixelSize::X2 => (width * 2, height * 2),
            PixelSize::X3 => (width * 3, height * 3),
            PixelSize::X4 => (width * 4, height * 4),
        };

        let (pw, ph) = self.physical_size();
        (pw as f32 / width as f32, ph as f32 / height as f32)
    }
}

impl Default for Screen {
    fn default() -> Self {
        let n = 1.try_into().expect("1 is non zero");
        Self {
            width: n,
            height: n,
            pixel_size: PixelSize::default(),
            filter: FrameFilter::default(),
        }
    }
}