Struct ImageTextureData 

pub struct ImageTextureData { /* private fields */ }

Full mip chain with a validated storage, color and alpha contract. This is an upload description, not a device resource. Backends retain normal scene ordering and coverage when sampling it at a different display size.

Implementations

impl ImageTextureData

pub const MAX_BYTES: usize

Maximum combined mip bytes for one source (64 MiB).

pub fn new(width: u32, height: u32, levels: Vec<Vec<u8>>) -> Result<Self>

Validate a complete mip chain, including odd and one-dimensional sizes. Every level halves each dimension, rounding down and clamping to one.

pub fn new_linear_p3_rgba16f( width: u32, height: u32, levels: Vec<Vec<u8>>, ) -> Result<Self>

Validate a complete bounded premultiplied linear-P3 RGBA16F mip chain. Rejects non-finite, negative, out-of-range and invalid associated pixels.

pub fn new_linear_rec2020_rgba16f( width: u32, height: u32, levels: Vec<Vec<u8>>, ) -> Result<Self>

Validate a complete bounded premultiplied linear Rec.2020 SDR mip chain. Native wide placement converts to extended composition primaries.

pub fn page( width: u32, height: u32, bytes: Vec<u8>, format: ImageTextureFormat, ) -> Result<Self>

A single immutable mip page; the canvas selects the pyramid level.

pub fn format(&self) -> ImageTextureFormat

Validated source storage/color contract.

pub fn bytes_per_pixel(&self) -> usize

Unpadded bytes per source pixel.

pub fn width(&self) -> u32

Source width in physical pixels.

pub fn height(&self) -> u32

Source height in physical pixels.

pub fn levels(&self) -> &[Vec<u8>]

Complete immutable mip chain, largest level first.

pub fn staging_byte_len(&self) -> usize

Bytes in a 256-byte-row-aligned staging buffer for the complete chain.

pub fn byte_len(&self) -> usize

Combined unpadded upload and GPU payload size.

Trait Implementations

impl Clone for ImageTextureData

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ImageTextureData

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

Formats the value using the given formatter.