Struct PipelineCacheKey 

pub struct PipelineCacheKey {
    pub version: u32,
    pub shader_hash: [u8; 32],
    pub bind_group_layout_hash: [u8; 32],
    pub push_constant_size: u32,
    pub workgroup_size: [u32; 3],
    pub feature_flags: PipelineFeatureFlags,
    pub backend_id: BackendId,
    /* private fields */
}

Versioned pipeline-cache key shared by every backend.

Replaces the pre-0.6 pattern of using a raw blake3 hash as the key. A raw hash is not robust: two pipelines that should miss (different bind-group layout, different push-constant size, different workgroup-size selection) hashed identically because the hash covered the shader source only. Silent cache hits against a non-equivalent pipeline are a correctness hazard (wrong bind-group layout binds undefined data; wrong workgroup-size launches beyond guarantees).

#[non_exhaustive] is enforced at the type level via the private __phantom field: external callers construct keys through PipelineCacheKey::new and cannot match exhaustively, so additive key fields do not break downstream matches.

Fields

version: u32

Key format version. Bumped to invalidate every cache entry without an API break.

shader_hash: [u8; 32]

blake3 hash of the canonical backend pipeline-source bytes.

bind_group_layout_hash: [u8; 32]

Structural hash of the bind-group layout descriptors. Not the backend handle; the bytes that describe slot count, types, visibility, and access modes per bind group.

push_constant_size: u32

Push-constant range in bytes. Included so a pipeline compiled for 16 B push constants never reuses against a layout that expects 32 B.

workgroup_size: [u32; 3]

Workgroup-size [x, y, z] the pipeline was specialized for.

feature_flags: PipelineFeatureFlags

Feature-flag bits the pipeline assumes at dispatch time.

backend_id: BackendId

Backend identity. Prevents pipelines from different backends from colliding when they happen to produce identical shader hashes.

Implementations

impl PipelineCacheKey

pub fn new( shader_hash: [u8; 32], bind_group_layout_hash: [u8; 32], push_constant_size: u32, workgroup_size: [u32; 3], feature_flags: PipelineFeatureFlags, backend_id: BackendId, ) -> Self

Construct a key at the current version.

Trait Implementations

impl Clone for PipelineCacheKey

fn clone(&self) -> PipelineCacheKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PipelineCacheKey

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

Formats the value using the given formatter.

impl Eq for PipelineCacheKey

impl Hash for PipelineCacheKey

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

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 PipelineCacheKey

fn eq(&self, other: &PipelineCacheKey) -> 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 StructuralPartialEq for PipelineCacheKey