Struct Texture2D 

pub struct Texture2D {
    pub width: u32,
    pub height: u32,
    pub format: TextureFormat,
    pub data: Vec<u8>,
    pub mip_levels: u32,
    pub label: Option<String>,
}

CPU-side 2D texture bytes.

Fields

width: u32

Width in texels.

height: u32

Height in texels.

format: TextureFormat

Texture format.

data: Vec<u8>

Contiguous texture bytes.

mip_levels: u32

Number of mip levels. 0 means base data with auto generation later.

label: Option<String>

Optional debug label.

Implementations

impl Texture2D

pub fn new( width: u32, height: u32, format: TextureFormat, data: Vec<u8>, ) -> Result<Self, ValidationError>

Creates a base-level texture and validates byte size.

pub fn with_mip_levels( width: u32, height: u32, format: TextureFormat, data: Vec<u8>, mip_levels: u32, ) -> Result<Self, ValidationError>

Creates a texture with explicit mip-level count and validates byte size.

pub fn from_mips( width: u32, height: u32, format: TextureFormat, mips: Vec<Vec<u8>>, ) -> Result<Self, ValidationError>

Creates a texture from explicit mip levels and flattens the data.

pub fn labeled(self, label: impl Into<String>) -> Self

Returns this texture with a label.

pub fn base_level_len(&self) -> Result<usize, ValidationError>

Returns the expected byte length of the base mip level.

pub fn mip_level_range( &self, level: u32, ) -> Result<Range<usize>, ValidationError>

Returns the byte range occupied by one mip level in data.

pub fn validate(&self) -> Result<(), ValidationError>

Validates dimensions and byte length.

Trait Implementations

impl Clone for Texture2D

fn clone(&self) -> Texture2D

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Texture2D

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

Formats the value using the given formatter.

impl PartialEq for Texture2D

fn eq(&self, other: &Texture2D) -> 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 StructuralPartialEq for Texture2D