lumen-engine-gpu 0.2.0

GPU rendering infrastructure for the Lumen 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
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119

use crate::{NodeKey, ProgramId};

#[derive(Debug, Clone)]
pub struct BindingLayoutEntry {
    pub binding: u32,
    pub visibility: wgpu::ShaderStages,
    pub ty: wgpu::BindingType,
}

impl BindingLayoutEntry {
    pub fn texture(binding: u32, visibility: wgpu::ShaderStages) -> Self {
        Self {
            binding,
            visibility,
            ty: wgpu::BindingType::Texture {
                sample_type: wgpu::TextureSampleType::Float { filterable: true },
                view_dimension: wgpu::TextureViewDimension::D2,
                multisampled: false,
            },
        }
    }

    pub fn storage_texture(
        binding: u32,
        visibility: wgpu::ShaderStages,
        format: wgpu::TextureFormat,
        access: wgpu::StorageTextureAccess,
    ) -> Self {
        Self {
            binding,
            visibility,
            ty: wgpu::BindingType::StorageTexture {
                access,
                format,
                view_dimension: wgpu::TextureViewDimension::D2,
            },
        }
    }

    pub fn sampler(binding: u32, visibility: wgpu::ShaderStages) -> Self {
        Self {
            binding,
            visibility,
            ty: wgpu::BindingType::Sampler(wgpu::SamplerBindingType::Filtering),
        }
    }

    pub fn uniform(binding: u32, visibility: wgpu::ShaderStages) -> Self {
        Self {
            binding,
            visibility,
            ty: wgpu::BindingType::Buffer {
                ty: wgpu::BufferBindingType::Uniform,
                has_dynamic_offset: false,
                min_binding_size: None,
            },
        }
    }

    pub fn storage(binding: u32, visibility: wgpu::ShaderStages, read_only: bool) -> Self {
        Self {
            binding,
            visibility,
            ty: wgpu::BindingType::Buffer {
                ty: wgpu::BufferBindingType::Storage { read_only },
                has_dynamic_offset: false,
                min_binding_size: None,
            },
        }
    }
}

#[derive(Debug, Clone)]
pub struct BindGroupLayoutSpec {
    pub label: Option<String>,
    pub entries: Vec<BindingLayoutEntry>,
}

impl BindGroupLayoutSpec {
    pub fn single(entries: Vec<BindingLayoutEntry>) -> Vec<Self> {
        vec![Self {
            label: None,
            entries,
        }]
    }
}

#[derive(Debug, Clone)]
pub struct RenderProgramDesc {
    pub label: Option<String>,
    pub shader: String,
    pub vertex_entry: String,
    pub fragment_entry: String,
    pub bind_groups: Vec<BindGroupLayoutSpec>,
    pub targets: Vec<Option<wgpu::ColorTargetState>>,
    pub vertex_buffers: Vec<wgpu::VertexBufferLayout<'static>>,
    pub primitive: wgpu::PrimitiveState,
}

#[derive(Debug, Clone)]
pub struct ComputeProgramDesc {
    pub label: Option<String>,
    pub shader: String,
    pub entry: String,
    pub bind_groups: Vec<BindGroupLayoutSpec>,
}

#[derive(Debug, Clone)]
pub enum ProgramDesc {
    Render(RenderProgramDesc),
    Compute(ComputeProgramDesc),
}

#[derive(Debug, Clone)]
pub struct Program {
    pub id: ProgramId,
    pub owner: Option<NodeKey>,
    pub desc: ProgramDesc,
}