Struct PipelineCache 

pub struct PipelineCache {
    pub total_lookups: u64,
    pub hits: u64,
    pub misses: u64,
    /* private fields */
}

In-memory cache mapping pipeline keys to compiled pipeline binaries.

key is a caller-defined u64 (typically a hash of the pipeline descriptor / shader source). value is an opaque Vec<u8> that represents the compiled pipeline object — format is backend-specific.

Fields

total_lookups: u64

Total number of cache lookups (hits + misses).

hits: u64

Total number of cache hits.

misses: u64

Total number of cache misses (compilations triggered).

Implementations

impl PipelineCache

pub fn new() -> Self

Create a new, empty pipeline cache.

pub fn get_or_create( &mut self, key: u64, create_fn: impl Fn() -> Vec<u8>, ) -> &Vec<u8>

Return a reference to the cached binary for key, compiling and caching it first if not already present.

create_fn is invoked at most once per unique key.

pub fn get(&self, key: u64) -> Option<&Vec<u8>>

Return the cached binary for key, or None if not present.

pub fn invalidate(&mut self, key: u64) -> bool

Remove a cached entry (e.g. when the shader source changes).

pub fn clear(&mut self)

Remove all cached entries.

pub fn len(&self) -> usize

Number of cached pipelines.

pub fn is_empty(&self) -> bool

true if the cache is empty.

pub fn hit_ratio(&self) -> f64

Hit ratio in [0.0, 1.0]. Returns 0.0 if no lookups have occurred.

Trait Implementations

impl Debug for PipelineCache

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

Formats the value using the given formatter.

impl Default for PipelineCache

fn default() -> PipelineCache

Returns the “default value” for a type.