shdrlib 0.1.0

A three-tiered Vulkan shader compilation and rendering framework built in pure Rust
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

//! Error types for the EX tier
//!
//! EX tier errors wrap CORE tier errors and add additional context specific to
//! manager operations.

use thiserror::Error;

/// Errors that can occur during RuntimeManager operations
#[derive(Error, Debug)]
pub enum RuntimeError {
    /// Instance creation failed
    #[error("Instance creation failed: {0}")]
    InstanceCreationFailed(#[from] crate::core::InstanceError),

    /// Device creation failed
    #[error("Device creation failed: {0}")]
    DeviceCreationFailed(#[from] crate::core::DeviceError),

    /// No graphics queue family found on selected device
    #[error("No graphics queue family found on selected device")]
    NoGraphicsQueue,

    /// No suitable physical device found
    #[error("No suitable physical device found (total devices: {0})")]
    NoSuitableDevice(usize),

    /// Fence operation failed
    #[error("Fence synchronization failed: {0}")]
    FenceSyncFailed(#[from] crate::core::FenceError),

    /// Semaphore creation failed
    #[error("Semaphore creation failed: {0}")]
    SemaphoreCreationFailed(#[from] crate::core::SemaphoreError),

    /// Command pool creation failed
    #[error("Command pool creation failed: {0}")]
    CommandPoolCreationFailed(#[from] crate::core::CommandPoolError),

    /// Command buffer operation failed
    #[error("Command buffer operation failed: {0}")]
    CommandBufferError(#[from] crate::core::CommandBufferError),

    /// Queue operation failed
    #[error("Queue operation failed: {0}")]
    QueueError(#[from] crate::core::QueueError),

    /// Other runtime errors (fallback for helper utilities)
    #[error("{0}")]
    Other(String),
}

/// Errors that can occur during ShaderManager operations
#[derive(Error, Debug)]
pub enum ShaderManagerError {
    /// Shader compilation failed
    #[error("Shader compilation failed: {0}")]
    ShaderCompilationFailed(#[from] crate::core::ShaderError),

    /// Pipeline creation failed (from CORE)
    #[error("Pipeline creation failed: {0}")]
    PipelineCreationFailed(#[from] crate::core::PipelineError),

    /// Pipeline builder error (from EX)
    #[error("Pipeline builder error: {0}")]
    PipelineBuilderError(#[from] PipelineError),

    /// Invalid shader ID provided
    #[error("Invalid shader ID: {0:?}")]
    InvalidShaderId(ShaderId),

    /// Invalid pipeline ID provided
    #[error("Invalid pipeline ID: {0:?}")]
    InvalidPipelineId(PipelineId),

    /// Descriptor pool creation failed
    #[error("Descriptor pool creation failed: {0}")]
    DescriptorPoolCreationFailed(#[from] crate::core::DescriptorPoolError),

    /// Descriptor operation failed
    #[error("Descriptor operation failed: {0}")]
    DescriptorError(#[from] crate::core::DescriptorError),
}

/// Errors that can occur during pipeline building
#[derive(Error, Debug)]
pub enum PipelineError {
    /// No vertex shader provided (required for graphics pipelines)
    #[error("No vertex shader provided - vertex shader is required for graphics pipelines")]
    NoVertexShader,

    /// No fragment shader provided (required for graphics pipelines)
    #[error("No fragment shader provided - fragment shader is required for graphics pipelines")]
    NoFragmentShader,

    /// No compute shader provided (required for compute pipelines)
    #[error("No compute shader provided - compute shader is required for compute pipelines")]
    NoComputeShader,

    /// Pipeline creation failed in CORE tier
    #[error("Pipeline creation failed: {0}")]
    CreationFailed(#[from] crate::core::PipelineError),

    /// Invalid descriptor set layout
    #[error("Invalid descriptor set layout configuration")]
    InvalidDescriptorLayout,

    /// No color attachment formats specified (required for graphics pipelines)
    #[error("No color attachment formats specified - at least one format is required")]
    NoColorAttachmentFormats,
}

/// Newtype for type-safe shader IDs
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub struct ShaderId(pub(crate) usize);

/// Newtype for type-safe pipeline IDs
#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub struct PipelineId(pub(crate) usize);