Struct ShaderDefines 

pub struct ShaderDefines { /* private fields */ }

A collection of shader macro definitions.

Internally uses an ordered Vec<(Symbol, Symbol)> to store definitions, ensuring that identical macro sets produce identical hash values.

Performance

• Insertion/lookup: O(log n) due to binary search
• Hash computation: O(n) but cached
• Comparison: O(1) when using cached hashes

Implementations

impl ShaderDefines

pub fn new() -> ShaderDefines

Create empty shader defines collection

pub fn with_capacity(capacity: usize) -> ShaderDefines

Create shader defines collection with pre-allocated capacity

pub fn set(&mut self, key: &str, value: &str)

Set shader define (maintains sorted order)

If key exists, updates its value; otherwise inserts new entry.

pub fn set_symbol(&mut self, key: Spur, value: Spur)

Set shader define using Symbol (internal method, more efficient)

pub fn remove(&mut self, key: &str) -> bool

Remove shader define

pub fn remove_symbol(&mut self, key: Spur) -> bool

Remove shader define using Symbol

pub fn contains(&self, key: &str) -> bool

Check if contains a shader define

pub fn contains_symbol(&self, key: Spur) -> bool

Check if contains a shader define using Symbol

pub fn get(&self, key: &str) -> Option<String>

Get shader define value

pub fn get_symbol(&self, key: Spur) -> Option<Cow<'static, str>>

Get shader define value using Symbol

pub fn clear(&mut self)

Clear all shader defines

pub fn len(&self) -> usize

Get shader defines count

pub fn is_empty(&self) -> bool

Check if empty

pub fn iter(&self) -> impl Iterator<Item = &(Spur, Spur)>

Iterate all shader defines (as Symbols)

pub fn iter_strings(&self) -> impl Iterator<Item = (String, String)>

Iterate all shader defines (as strings)

pub fn to_map(&self) -> BTreeMap<String, String>

Convert to BTreeMap (for template rendering)

pub fn merge(&mut self, other: &ShaderDefines)

Merge shader defines from another ShaderDefines

If there are conflicts, values from other will override values in self.

pub fn merged_with(&self, other: &ShaderDefines) -> ShaderDefines

Create a new merged ShaderDefines

pub fn compute_hash(&self) -> u64

Compute content hash (for caching)

pub fn as_slice(&self) -> &[(Spur, Spur)]

Get internal defines reference (for direct access)

Trait Implementations

impl Clone for ShaderDefines

fn clone(&self) -> ShaderDefines

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ShaderDefines

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Default for ShaderDefines

fn default() -> ShaderDefines

Returns the “default value” for a type.

impl From<&[(&str, &str)]> for ShaderDefines

Create ShaderDefines from list of macro definitions

fn from(defines: &[(&str, &str)]) -> ShaderDefines

Converts to this type from the input type.

impl Hash for ShaderDefines

fn hash<H>(&self, state: &mut H)

where H: Hasher,

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ShaderDefines

fn eq(&self, other: &ShaderDefines) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for ShaderDefines