Enum PlaneFormat 

pub enum PlaneFormat {
    R8,
    R16,
    RG8,
    RG16,
    RGBA8,
    BGRA8,
    RGBA16,
    RGBA16F,
    RGBA32F,
    R16Uint,
    R32Float,
    RGBA16Uint,
    RGB10A2,
}

Per-plane storage primitive. A plane’s PlaneFormat names the smallest texture format a GPU upload would use for it; the shader reinterprets the channels when needed (e.g. AYUV64LE uses RGBA16 storage with AYUV channel semantics).

Variants

R8

R16

RG8

RG16

RGBA8

BGRA8

RGBA16

RGBA16F

RGBA32F

R16Uint

R32Float

RGBA16Uint

Four-channel 16-bit unsigned-integer RGBA (Rgba16Uint), 8 B/px. The integer 4-channel storage primitive an already-colour multi-plane raw frame uploads as (read via textureLoad — never sampler-normalised).

RGB10A2

Packed 10:10:10:2 unsigned-normalized RGBA (Rgb10a2Unorm), 4 B/px — R in bits 0..10, G 10..20, B 20..30, A 30..32 (little-endian; DXGI R10G10B10A2_UNORM / Vulkan A2B10G10R10_UNORM_PACK32). The HDR10 swapchain / render-target primitive (PixelFormat::Rgb10A2).

Implementations

impl PlaneFormat

pub const fn bytes_per_sample(self) -> u32

Size in bytes of one stored texel of this plane format (all channels). width_in_texels * bytes_per_sample() is the tight row stride; every backend’s stride / buffer-length math derives from this single table. RGBA16F is two bytes per channel (IEEE half), matching RGBA16.

pub const fn requires_16bit_norm(self) -> bool

True when a texture of this plane format needs the wgpu::Features::TEXTURE_FORMAT_16BIT_NORM adapter feature — the three 16-bit normalized storage primitives (R16 → R16Unorm, RG16 → Rg16Unorm, RGBA16 → Rgba16Unorm). The 16-bit integer primitives (R16Uint, RGBA16Uint), the 16-bit float primitive (RGBA16F → Rgba16Float), and every 8-/10-/32-bit primitive are core wgpu formats and return false.

This is the single source of truth an interop import gate keys on: a PixelFormat whose plane layout contains any such plane cannot be zero-copy imported on a device without the feature (see PixelFormat::requires_16bit_norm).

pub const fn to_wgpu_texture_format(self) -> TextureFormat

Available on crate feature wgpu only.

Canonical wgpu equivalent of this per-plane storage primitive. Used at the wgpu-backend boundary where the type system needs the real wgpu::TextureFormat (transient texture creation, pipeline layout). Backend-agnostic code carries PlaneFormat instead.

Trait Implementations

impl Clone for PlaneFormat

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for PlaneFormat

impl Debug for PlaneFormat

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PlaneFormat

Available on crate feature serde only.

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for PlaneFormat

impl Hash for PlaneFormat

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 PlaneFormat

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for PlaneFormat

Available on crate feature serde only.

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for PlaneFormat