Struct web_glitz::image::texture_2d_array::LevelLayer

pub struct LevelLayer<'a, F> { /* fields omitted */ }

Reference to a layer of a Level of a Texture2DArray.

Implementations

impl<'a, F> LevelLayer<'a, F> where
    F: TextureFormat, 

pub fn level(&self) -> usize

The index that identifies the Level this LevelLayer belongs to.

pub fn layer(&self) -> usize

The index that identifies this layer within the Level it belongs to.

Corresponds to the depth at which this LevelLayer occurs.

pub fn width(&self) -> u32

The width of the LevelLayer.

pub fn height(&self) -> u32

The height of the LevelLayer.

pub fn sub_image(&self, region: Region2D) -> LevelLayerSubImage<'_, F>

Returns a reference to the sub-region of this LevelLayer's image described by region.

Example

This may for example be used to upload data to only a sub-region of an image, rather than the complete image:

use web_glitz::image::{Image2DSource, MipmapLevels, Region2D};
use web_glitz::image::format::RGB8;
use web_glitz::image::texture_2d_array::Texture2DArrayDescriptor;

let texture = context.try_create_texture_2d_array(&Texture2DArrayDescriptor {
    format: RGB8,
    width: 256,
    height: 256,
    depth: 16,
    levels: MipmapLevels::Complete
}).unwrap();

let base_level = texture.base_level();
let layers = base_level.layers();
let layer = layers.get(0).unwrap();
let sub_image = layer.sub_image(Region2D::Area((0, 0), 128, 128));

let pixels: Vec<[u8; 3]> = vec![[0, 0, 255]; 128 * 128];
let data = Image2DSource::from_pixels(pixels, 128, 128).unwrap();

context.submit(sub_image.upload_command(data));

The lower left quadrant of the first layer of the texture's base level now contains blue pixels.

pub fn upload_command<D, T>(
    &self,
    data: Image2DSource<D, T>
) -> LevelLayerUploadCommand<D, T, F> where
    T: PixelUnpack<F>, 

Returns a command which, when executed, replaces the image data in this LevelLayer's image with the image data provided in data.

The image data must be stored as a PixelUnpack type that is suitable for the texture's TextureFormat.

If the dimensions of the image provided in data are not sufficient to cover the LevelLayer's image entirely, starting from the origin, then only the region of overlap is updated (note that the origin of an image is the lower left corner). For example, given a LevelLayer with a width of 256 pixels and a height of 256 pixels, and data with a width of 128 pixels and a height of 128 pixels, then only the lower left quadrant of the Level is updated. If the dimensions of the image provided in data would, when starting from the origin, cover more than the LevelLayer's image (the width and/or height of data is/are greater than the width and/or height of the Level's image), then any pixels that would fall outside of the LevelLayer are ignored. For example, given a LevelLayer with a width of 256 pixels and a height of 256 pixels, and data with a width of 256 pixels and a height of 512 pixels, then only the lower half of the image in data is used to update the LevelLayer and the upper half is ignored.

Example

use web_glitz::image::{Image2DSource, MipmapLevels};
use web_glitz::image::format::RGB8;
use web_glitz::image::texture_2d_array::Texture2DArrayDescriptor;

let texture = context.try_create_texture_2d_array(&Texture2DArrayDescriptor {
    format: RGB8,
    width: 256,
    height: 256,
    depth: 16,
    levels: MipmapLevels::Complete
}).unwrap();

let base_level = texture.base_level();
let layers = base_level.layers();
let layer = layers.get(0).unwrap();

let pixels: Vec<[u8; 3]> = vec![[255, 0, 0]; 256 * 256];
let data = Image2DSource::from_pixels(pixels, 256, 256).unwrap();

context.submit(layer.upload_command(data));

Trait Implementations

impl<'a, F> BlitSource for Texture2DArrayLevelLayer<'a, F> where
    F: TextureFormat + 'static, 

type Format = F

The image storage format used by the source image.

fn descriptor(&self) -> BlitSourceDescriptor

Encapsulates the information about the blit source required by the BlitCommand.

impl<'a, F: Hash> Hash for LevelLayer<'a, F>

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

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<'a, F: PartialEq> PartialEq<LevelLayer<'a, F>> for LevelLayer<'a, F>

fn eq(&self, other: &LevelLayer<'a, F>) -> bool

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

fn ne(&self, other: &LevelLayer<'a, F>) -> bool

This method tests for !=.

impl<'a, F> StructuralPartialEq for LevelLayer<'a, F>