rustial-renderer-wgpu 1.0.0

Pure WGPU renderer for the rustial 2.5D map engine
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

//! Renderer-owned terrain depth / coordinate buffers.

/// Renderer-owned terrain interaction buffers.
///
/// These textures establish the Phase D renderer-depth foundation for
/// terrain-aware interaction, future picking, and broader pass-graph work.
pub struct TerrainInteractionBuffers {
    depth_texture: wgpu::Texture,
    depth_view: wgpu::TextureView,
    coord_texture: wgpu::Texture,
    coord_view: wgpu::TextureView,
    size: (u32, u32),
}

impl TerrainInteractionBuffers {
    /// Create interaction buffers for the given surface size.
    pub fn new(device: &wgpu::Device, width: u32, height: u32) -> Self {
        let size = (width.max(1), height.max(1));
        let depth_texture = device.create_texture(&wgpu::TextureDescriptor {
            label: Some("rustial_terrain_interaction_depth"),
            size: wgpu::Extent3d {
                width: size.0,
                height: size.1,
                depth_or_array_layers: 1,
            },
            mip_level_count: 1,
            sample_count: 1,
            dimension: wgpu::TextureDimension::D2,
            format: wgpu::TextureFormat::Depth32Float,
            usage: wgpu::TextureUsages::RENDER_ATTACHMENT | wgpu::TextureUsages::TEXTURE_BINDING,
            view_formats: &[],
        });
        let depth_view = depth_texture.create_view(&wgpu::TextureViewDescriptor::default());

        let coord_texture = device.create_texture(&wgpu::TextureDescriptor {
            label: Some("rustial_terrain_interaction_coords"),
            size: wgpu::Extent3d {
                width: size.0,
                height: size.1,
                depth_or_array_layers: 1,
            },
            mip_level_count: 1,
            sample_count: 1,
            dimension: wgpu::TextureDimension::D2,
            format: wgpu::TextureFormat::Rgba16Float,
            usage: wgpu::TextureUsages::RENDER_ATTACHMENT | wgpu::TextureUsages::TEXTURE_BINDING,
            view_formats: &[],
        });
        let coord_view = coord_texture.create_view(&wgpu::TextureViewDescriptor::default());

        Self {
            depth_texture,
            depth_view,
            coord_texture,
            coord_view,
            size,
        }
    }

    /// Resize the interaction buffers.
    pub fn resize(&mut self, device: &wgpu::Device, width: u32, height: u32) {
        *self = Self::new(device, width, height);
    }

    /// Depth view storing terrain-depth prepass output.
    pub fn depth_view(&self) -> &wgpu::TextureView {
        &self.depth_view
    }

    /// Coordinate view storing terrain world/relative coordinate output.
    pub fn coord_view(&self) -> &wgpu::TextureView {
        &self.coord_view
    }

    /// Current buffer size in pixels.
    pub fn size(&self) -> (u32, u32) {
        self.size
    }

    /// Access the underlying depth texture.
    pub fn depth_texture(&self) -> &wgpu::Texture {
        &self.depth_texture
    }

    /// Access the underlying coordinate texture.
    pub fn coord_texture(&self) -> &wgpu::Texture {
        &self.coord_texture
    }
}