cuneus 0.5.0

A WGPU-based shader development tool
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

// @group(0): Per-Frame Resources (TimeUniform)
// @group(1): Primary Pass I/O & Parameters (output texture, shader params, input textures)
// @group(2): Global Engine Resources (fonts, audio, atomics, mouse)
// @group(3): User-Defined Data Buffers (custom storage buffers)

pub mod builder;
pub mod core;
pub mod multipass;
pub mod resource;

pub use builder::*;
pub use core::*;
pub use multipass::*;
pub use resource::*;

// Texture format constants
pub const COMPUTE_TEXTURE_FORMAT_RGBA16: wgpu::TextureFormat = wgpu::TextureFormat::Rgba16Float;
pub const COMPUTE_TEXTURE_FORMAT_RGBA8: wgpu::TextureFormat = wgpu::TextureFormat::Rgba8Unorm;

use crate::Core;

/// Main entry point for creating compute shaders
impl ComputeShader {
    /// Create a compute shader using the builder pattern
    /// This is the primary API for all compute shader creation
    pub fn builder() -> ComputeShaderBuilder {
        ComputeShaderBuilder::new()
    }

    /// Create a simple compute shader with basic configuration
    pub fn new(core: &Core, shader_source: &str) -> Self {
        let config = ComputeShaderBuilder::new()
            .with_label("Simple Compute Shader")
            .build();

        Self::from_builder(core, shader_source, config)
    }

    /// Create a compute shader with custom uniform parameters
    pub fn with_uniforms<T: crate::UniformProvider>(
        core: &Core,
        shader_source: &str,
        label: &str,
    ) -> Self {
        let config = ComputeShaderBuilder::new()
            .with_custom_uniforms::<T>()
            .with_label(label)
            .build();

        Self::from_builder(core, shader_source, config)
    }

    /// Create a multi-pass compute shader
    pub fn with_multi_pass(
        core: &Core,
        shader_source: &str,
        passes: &[PassDescription],
        label: &str,
    ) -> Self {
        let config = ComputeShaderBuilder::new()
            .with_multi_pass(passes)
            .with_label(label)
            .build();

        Self::from_builder(core, shader_source, config)
    }
}