nightshade 0.23.0

A cross-platform data-oriented game 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

use crate::render::wgpu::passes::SpotlightShadowData;
use crate::render::wgpu::passes::geometry::projection::MAX_SPOTLIGHT_SHADOWS;
use crate::render::wgpu::passes::shadow_depth::{MAX_POINT_LIGHT_SHADOWS, PointLightShadowData};

/// Nearest-filtered clamping sampler used to read shadow maps. Shared by the
/// mesh and skinned mesh passes for directional/spot and point shadow lookups.
pub(crate) fn shadow_comparison_sampler(device: &wgpu::Device, label: &str) -> wgpu::Sampler {
    device.create_sampler(&wgpu::SamplerDescriptor {
        label: Some(label),
        address_mode_u: wgpu::AddressMode::ClampToEdge,
        address_mode_v: wgpu::AddressMode::ClampToEdge,
        address_mode_w: wgpu::AddressMode::ClampToEdge,
        mag_filter: wgpu::FilterMode::Nearest,
        min_filter: wgpu::FilterMode::Nearest,
        mipmap_filter: wgpu::MipmapFilterMode::Nearest,
        ..Default::default()
    })
}

/// Storage buffer sized for the spotlight shadow table. Shared by the mesh and
/// skinned mesh passes.
pub(crate) fn spotlight_shadow_buffer(device: &wgpu::Device, label: &str) -> wgpu::Buffer {
    device.create_buffer(&wgpu::BufferDescriptor {
        label: Some(label),
        size: (std::mem::size_of::<SpotlightShadowData>() * MAX_SPOTLIGHT_SHADOWS) as u64,
        usage: wgpu::BufferUsages::STORAGE | wgpu::BufferUsages::COPY_DST,
        mapped_at_creation: false,
    })
}

/// Storage buffer sized for the point-light shadow table. Shared by the mesh
/// and skinned mesh passes.
pub(crate) fn point_shadow_buffer(device: &wgpu::Device, label: &str) -> wgpu::Buffer {
    device.create_buffer(&wgpu::BufferDescriptor {
        label: Some(label),
        size: (std::mem::size_of::<PointLightShadowData>() * MAX_POINT_LIGHT_SHADOWS) as u64,
        usage: wgpu::BufferUsages::STORAGE | wgpu::BufferUsages::COPY_DST,
        mapped_at_creation: false,
    })
}

/// A 1x1 R32Float cube-array view standing in for the point-shadow cubemap
/// before any shadows are rendered. The backing texture is owned by the
/// returned view. Shared by the mesh and skinned mesh passes.
pub(crate) fn dummy_point_shadow_cubemap_view(
    device: &wgpu::Device,
    label: &str,
) -> wgpu::TextureView {
    let texture = device.create_texture(&wgpu::TextureDescriptor {
        label: Some(label),
        size: wgpu::Extent3d {
            width: 1,
            height: 1,
            depth_or_array_layers: 6 * MAX_POINT_LIGHT_SHADOWS as u32,
        },
        mip_level_count: 1,
        sample_count: 1,
        dimension: wgpu::TextureDimension::D2,
        format: wgpu::TextureFormat::R32Float,
        usage: wgpu::TextureUsages::TEXTURE_BINDING,
        view_formats: &[],
    });
    texture.create_view(&wgpu::TextureViewDescriptor {
        dimension: Some(wgpu::TextureViewDimension::CubeArray),
        ..Default::default()
    })
}