coffee 0.4.1

An opinionated 2D game engine focused on simplicity, explicitness, and type-safety
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
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104

use super::{Gpu, TargetView};

pub struct Surface {
    window: winit::window::Window,
    surface: wgpu::Surface,
    swap_chain: wgpu::SwapChain,
    extent: wgpu::Extent3d,
    output: Option<wgpu::SwapChainOutput>,
}

impl Surface {
    pub fn new(
        window: winit::window::Window,
        device: &wgpu::Device,
    ) -> Surface {
        let surface = wgpu::Surface::create(&window);
        let size = window.inner_size();

        let (swap_chain, extent) = new_swap_chain(device, &surface, size);

        Surface {
            window,
            surface,
            swap_chain,
            extent,
            output: None,
        }
    }

    pub fn window(&self) -> &winit::window::Window {
        &self.window
    }

    pub fn target(&mut self) -> &TargetView {
        if self.output.is_none() {
            let output = self
                .swap_chain
                .get_next_texture()
                .expect("Get next texture");

            self.output = Some(output);
        }

        &self.output.as_ref().unwrap().view
    }

    pub fn resize(
        &mut self,
        gpu: &mut Gpu,
        size: winit::dpi::PhysicalSize<u32>,
    ) {
        let (swap_chain, extent) =
            new_swap_chain(&gpu.device, &self.surface, size);

        self.swap_chain = swap_chain;
        self.extent = extent;
        self.output = None;
    }

    pub fn swap_buffers(&mut self, gpu: &mut Gpu) {
        let new_encoder = gpu.device.create_command_encoder(
            &wgpu::CommandEncoderDescriptor {
                label: Some("coffee::backend::surface blit"),
            },
        );

        // We swap the current decoder by a new one here, so we can finish the
        // current frame
        let encoder = std::mem::replace(&mut gpu.encoder, new_encoder);

        gpu.queue.submit(&[encoder.finish()]);

        self.output = None;
    }

    pub fn request_redraw(&mut self) {
        self.window.request_redraw();
    }
}

fn new_swap_chain(
    device: &wgpu::Device,
    surface: &wgpu::Surface,
    size: winit::dpi::PhysicalSize<u32>,
) -> (wgpu::SwapChain, wgpu::Extent3d) {
    let swap_chain = device.create_swap_chain(
        surface,
        &wgpu::SwapChainDescriptor {
            usage: wgpu::TextureUsage::OUTPUT_ATTACHMENT,
            format: wgpu::TextureFormat::Bgra8UnormSrgb,
            width: size.width,
            height: size.height,
            present_mode: wgpu::PresentMode::Mailbox,
        },
    );

    let extent = wgpu::Extent3d {
        width: size.width,
        height: size.height,
        depth: 1,
    };

    (swap_chain, extent)
}