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
//! Error types for the dynamic-material registry.
use awsm_materials::MaterialShaderId;
use awsm_renderer_core::error::AwsmCoreError;
use thiserror::Error;
/// Errors returned by the dynamic-material registry.
#[derive(Error, Debug)]
pub enum AwsmDynamicMaterialError {
/// Attempted to register a material under a name that's already in
/// use at a different `(layout_hash, wgsl_hash)`. Re-registering a
/// material with byte-identical `(layout, wgsl)` is idempotent and
/// does not produce this error.
#[error("[dynamic-material] duplicate name `{0}` already registered")]
DuplicateName(String),
/// Lookup / unregistration referenced a shader id that the registry
/// has never seen, or has already removed.
#[error("[dynamic-material] unknown shader id {0:?}")]
UnknownShaderId(MaterialShaderId),
/// Tried to unregister a material that still has live instances on
/// meshes. Tear down the meshes (or reassign their materials) before
/// unregistering.
#[error("[dynamic-material] cannot unregister `{name}`: {instance_count} live instances")]
InUse {
/// Name of the material that's still referenced.
name: String,
/// Number of live mesh instances still pointing at the material.
instance_count: usize,
},
/// The registration's layout (or the instance override) named a
/// uniform / texture / buffer field whose name collides with a
/// kernel-provided symbol (`material`, `texture_pool`, `extras_pool`,
/// `frame_globals`, `camera`, `frag`, `vert`).
#[error("[dynamic-material] reserved field name `{0}` (collides with kernel-provided symbol)")]
ReservedName(String),
/// The author's WGSL fragment failed to compile. The wrapped string
/// is naga's diagnostic output (multi-line, includes file:line:col
/// when available). `material-editor`'s error pane parses this for
/// the line/column gutter.
#[error("[dynamic-material] WGSL compile failed: {0}")]
WgslCompile(String),
/// Pass-through from the underlying WebGPU core error type — e.g.
/// a downstream buffer create failed while the extras-pool allocator
/// was growing.
#[error("[dynamic-material] {0}")]
Core(#[from] AwsmCoreError),
/// Registration would push `bucket_entries.len()` past the
/// `MAX_BUCKET_ENTRIES` cap. The tightest constraint is the
/// classify pass's per-workgroup `tile_mask: atomic<u32>`, which
/// accumulates a `BUCKET_BIT_<NAME> = (1u << index)` per visible
/// bucket id — a bucket index `>= 32` would compile to
/// `1u << 32u`, an implementation-defined WGSL shift that
/// typically resolves to `0` on Dawn, silently dropping the
/// bucket from classification. See [`crate::dynamic_materials::MAX_BUCKET_ENTRIES`]
/// for the full encoding inventory.
#[error("[dynamic-material] bucket-id cap exceeded: would push bucket_entries.len() to {would_be}, max is {max} (each classify tile_mask word holds 32 bucket bits). Raise MAX_BUCKET_WORDS to widen the cap.")]
BucketCapExceeded {
/// What `bucket_entries.len()` would become if this material /
/// registration were accepted.
would_be: usize,
/// The hard cap (`MAX_BUCKET_ENTRIES` = `MAX_BUCKET_WORDS` × 32).
max: usize,
},
}