Struct wgpu::Extent3d

#[repr(C)]
pub struct Extent3d {
    pub width: u32,
    pub height: u32,
    pub depth_or_array_layers: u32,
}

Extent of a texture related operation.

Fields

width: u32

height: u32

depth_or_array_layers: u32

Implementations

impl Extent3d

pub fn physical_size(&self, format: TextureFormat) -> Extent3d

Calculates the physical size is backing an texture of the given format and extent. This includes padding to the block width and height of the format.

This is the texture extent that you must upload at when uploading to mipmaps of compressed textures.

let format = wgpu::TextureFormat::Bc1RgbaUnormSrgb; // 4x4 blocks
assert_eq!(
    wgpu::Extent3d { width: 7, height: 7, depth_or_array_layers: 1 }.physical_size(format),
    wgpu::Extent3d { width: 8, height: 8, depth_or_array_layers: 1 }
);
// Doesn't change, already aligned
assert_eq!(
    wgpu::Extent3d { width: 8, height: 8, depth_or_array_layers: 1 }.physical_size(format),
    wgpu::Extent3d { width: 8, height: 8, depth_or_array_layers: 1 }
);
let format = wgpu::TextureFormat::Astc8x5RgbaUnorm; // 8x5 blocks
assert_eq!(
    wgpu::Extent3d { width: 7, height: 7, depth_or_array_layers: 1 }.physical_size(format),
    wgpu::Extent3d { width: 8, height: 10, depth_or_array_layers: 1 }
);

pub fn max_mips(&self) -> u32

Calculates the maximum possible count of mipmaps.

Treats the depth as part of the mipmaps. If calculating for a 2DArray texture, which does not mipmap depth, set depth to 1.

assert_eq!(wgpu::Extent3d { width: 1, height: 1, depth_or_array_layers: 1 }.max_mips(), 1);
assert_eq!(wgpu::Extent3d { width: 60, height: 60, depth_or_array_layers: 1 }.max_mips(), 6);
assert_eq!(wgpu::Extent3d { width: 240, height: 1, depth_or_array_layers: 1 }.max_mips(), 8);

pub fn mip_level_size(&self, level: u32, is_3d_texture: bool) -> Extent3d

Calculates the extent at a given mip level.

Trait Implementations

impl Clone for Extent3d

pub fn clone(&self) -> Extent3d

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Extent3d

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

Formats the value using the given formatter.

impl Default for Extent3d

pub fn default() -> Extent3d

Returns the “default value” for a type.

impl Hash for Extent3d

pub fn hash<__H>(&self, state: &mut __H) where
    __H: Hasher, 

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H) where
    H: Hasher, 

Feeds a slice of this type into the given Hasher.

impl PartialEq<Extent3d> for Extent3d

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl Copy for Extent3d

impl Eq for Extent3d

impl StructuralEq for Extent3d

impl StructuralPartialEq for Extent3d