Struct D3d11ImageLayout 

pub struct D3d11ImageLayout {
    pub dxgi_format: u32,
    pub texture_width: usize,
    pub texture_height: usize,
    pub bytes_per_texel: usize,
    pub gl_internal_format: u32,
}

One texture’s format and geometry for a HAL image. texture_width and texture_height are texels and rows, not image pixels: the packed rows fold several pixels or several planes into one texel, and a semi-planar row is the image’s row stride rather than its width.

Fields

dxgi_format: u32

texture_width: usize

texture_height: usize

bytes_per_texel: usize

gl_internal_format: u32

Implementations

impl D3d11ImageLayout

pub fn tight_row_bytes(&self) -> usize

Bytes in one texture row, with no driver padding: the row a copy into or out of the texture moves.

This is the image’s own row for every format except a semi-planar one, whose texture row is the stride and can exceed the image width (see image_d3d11_layout). The image footprint of such a tensor is the storage’s business, not this table’s, because only the storage still knows the image width.

pub fn tight_bytes(&self) -> usize

Bytes in the whole texture, padding-free: tight_row_bytes over every row, with the same semi-planar caveat.

pub fn widened_to(&self, texture_width: usize) -> Self

This layout with its rows widened to texture_width texels.

The one sanctioned edit of a table entry, and only for a semi-planar row: its texture must be as wide as the row pitch the driver hands a CPU map, and a pitch is a property of a created texture rather than of the format, so the allocator probes for one and widens the entry here (see D3d11TextureTensor::new_image). A wrapped external texture is widened the same way, to the width its host chose.

A width below the entry’s own is not a widening and leaves it alone: the table’s width is the floor every consumer of the layout may assume.

Trait Implementations

impl Clone for D3d11ImageLayout

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 D3d11ImageLayout

impl Debug for D3d11ImageLayout

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

Formats the value using the given formatter.

impl Eq for D3d11ImageLayout

impl PartialEq for D3d11ImageLayout

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for D3d11ImageLayout