Struct web_glitz::image::LayeredImageSource

pub struct LayeredImageSource<D, T> { /* fields omitted */ }

Encapsulates data that may be uploaded to a layered texture (sub-)image.

Example

use web_glitz::image::{LayeredImageSource, MipmapLevels};
use web_glitz::image::format::RGB8;
use web_glitz::image::texture_3d::Texture3DDescriptor;

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

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

context.submit(texture.base_level().upload_command(image_source));

Note that the pixel data type ([u8; 3] in the example) must implement [ClientFormat] for the texture's [InternalFormat] (in this case that means ClientFormat<RGB8> must be implemented for [u8; 3], which it is).

Implementations

impl<D, T> LayeredImageSource<D, T> where
    D: Borrow<[T]>, 

pub fn from_pixels(
    pixels: D,
    width: u32,
    height: u32,
    depth: u32
) -> Result<Self, FromPixelsError>

Creates a new LayeredImageSource from the pixels for an image with the given width, the given height and the given depth.

In this context the depth of the image corresponds to its number of layers.

Returns FromPixelsError::NotEnoughPixels if the pixels does not contain enough data for at least width * height * depth pixels.

Example

use web_glitz::image::LayeredImageSource;

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