Struct TexelArrayLayout 

pub struct TexelArrayLayout {
    pub texel_format: TextureFormat,
    pub lanes_per_texel: u32,
    pub element_size: u64,
    pub elements_per_row: u32,
    pub width: u32,
    pub height: u32,
}

A texel array’s shape and texel format.

Derived from an element size and a capacity; see the module docs for how the row width follows from the two.

Fields

texel_format: TextureFormat

The format the texture is created with.

lanes_per_texel: u32

f32 lanes per texel: 1 for R32Float, 4 for Rgba32Float.

element_size: u64

Bytes per element.

elements_per_row: u32

How many elements one row holds.

width: u32

The texture’s width in texels.

height: u32

The texture’s height in texels.

Implementations

impl TexelArrayLayout

pub fn new(element_size: u64, capacity: u64, max_dimension: u32) -> Self

Lay out capacity elements of element_size bytes in a texture no larger than max_dimension on either axis.

max_dimension is the device’s [wgpu::Limits::max_texture_dimension_2d].

Panics

If element_size is not a whole number of f32 lanes, or if capacity elements of that size cannot be stored in a texture within max_dimension.

pub fn row_bytes(&self) -> u64

Bytes one row spans, padding included.

Always a whole number of [wgpu::COPY_BYTES_PER_ROW_ALIGNMENT] bytes.

pub fn capacity(&self) -> u64

How many elements fit without growing the texture.

pub fn texture_size(&self) -> Extent3d

The texture size to create.

fn rows_for(&self, element_count: u64) -> u32

How many rows element_count elements occupy.

pub fn pack(&self, elements: &[u8], out: &mut Vec<u8>)

Write elements into out as the row-padded image the texture holds.

elements is the packed element bytes — the same bytes a storage buffer would have been uploaded, and the same ones Self::element_size describes one of. out is reused across calls, so a steady frame reallocates nothing. Only the rows the elements reach are written; the rest of the texture is left as it was, which is sound because the shader addresses nothing past the element count the caller uploaded.

Panics

If elements is not a whole number of elements, or holds more than Self::capacity of them.

pub fn binding(binding: u32, visibility: ShaderStages) -> BindGroupLayoutEntry

The bind-group layout entry that binds one of these as a texture.

Trait Implementations

impl Clone for TexelArrayLayout

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 TexelArrayLayout

impl Debug for TexelArrayLayout

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

Formats the value using the given formatter.

impl Eq for TexelArrayLayout

impl PartialEq for TexelArrayLayout

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for TexelArrayLayout