Struct PipelineCacheKey 

pub struct PipelineCacheKey {
    pub shader_hash: u64,
    pub entry_point: String,
    pub layout_tag: String,
}

Unique key identifying a compiled compute pipeline.

Two pipelines are considered identical — and therefore candidates for sharing a cached wgpu::ComputePipeline — when all three fields match.

Layout tag conventions

The layout_tag is an opaque caller-supplied string. A suggested convention is to encode the binding types in declaration order, e.g.:

Binding pattern	layout_tag
read ⟶ read_write	"r-w"
read ⟶ read ⟶ read_write	"r-r-w"
uniform ⟶ read ⟶ read_write	"u-r-w"

Any unambiguous scheme works as long as it is applied consistently within a project.

Fields

shader_hash: u64

FNV-1a 64-bit hash of the WGSL shader source text.

Using a hash keeps the key small; the probability of a collision for distinct shaders in a typical project is negligible (< 2⁻⁶⁰).

entry_point: String

The @compute function name used as the pipeline entry point.

layout_tag: String

An opaque string describing the bind-group layout structure.

Implementations

impl PipelineCacheKey

pub fn new(shader_source: &str, entry_point: &str, layout_tag: &str) -> Self

Construct a key from raw shader source, entry point, and layout tag.

The shader source is hashed with fnv1a_64; the raw text is not stored in the key.

Examples

use oxigdal_gpu::pipeline_cache::{PipelineCacheKey, fnv1a_64};

let src = "// wgsl shader source";
let key = PipelineCacheKey::new(src, "main", "r-w");
assert_eq!(key.shader_hash, fnv1a_64(src.as_bytes()));
assert_eq!(key.entry_point, "main");
assert_eq!(key.layout_tag, "r-w");

pub fn from_hash(shader_hash: u64, entry_point: &str, layout_tag: &str) -> Self

Construct a key directly from a pre-computed shader hash.

Use this when the hash has already been computed externally to avoid re-hashing the shader source.

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 Display for PipelineCacheKey

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

Formats the value using the given formatter.

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 Eq for PipelineCacheKey

impl StructuralPartialEq for PipelineCacheKey