[−][src]Struct web_glitz::image::texture_cube::LevelFaceMut
A mutable reference to a face of a TextureCube mipmap level.
Methods from Deref<Target = LevelFace<'a, F>>
pub fn level(&self) -> usize
[src]
Returns the index that identifies the level this face belongs to.
pub fn face(&self) -> CubeFace
[src]
Returns the face referenced by this LevelFace.
pub fn width(&self) -> u32
[src]
Returns the width of this LevelFace.
pub fn height(&self) -> u32
[src]
Returns the height of this LevelFace.
pub fn sub_image(&self, region: Region2D) -> LevelFaceSubImage<F>
[src]
Returns a reference to the sub-region of this LevelFace'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_cube::TextureCubeDescriptor; let texture = context.create_texture_cube(&TextureCubeDescriptor { format: RGB8, width: 256, height: 256, levels: MipmapLevels::Complete }).unwrap(); let level = texture.base_level(); let face = level.positive_x(); let sub_image = face.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 "positive x" face of the texture's base level now contains blue pixels.
pub fn upload_command<D, T>(
&self,
data: Image2DSource<D, T>
) -> UploadCommand<D, T, F> where
T: ClientFormat<F>,
[src]
&self,
data: Image2DSource<D, T>
) -> UploadCommand<D, T, F> where
T: ClientFormat<F>,
Returns a command which, when executed, replaces the image data in this LevelFace's image
with the image data provided in data
.
The image data must be stored in a ClientFormat that is suitable for the texture's TextureFormat.
If the dimensions of the image provided in data
are not sufficient to cover the
LevelFace'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
LevelFace 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
LevelFace is updated. If the dimensions of the image provided in data
would, when
starting from the origin, cover more than the Level'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 LevelFace are ignored. For example, given a LevelFace
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 LevelFace and the upper half is ignored.
Example
This example uploads red pixels to the "positive x" face of the base mipmap level a TextureCube:
use web_glitz::image::{Image2DSource, MipmapLevels}; use web_glitz::image::format::RGB8; use web_glitz::image::texture_cube::TextureCubeDescriptor; let texture = context.create_texture_cube(&TextureCubeDescriptor { format: RGB8, width: 256, height: 256, levels: MipmapLevels::Complete }).unwrap(); let pixels: Vec<[u8; 3]> = vec![[255, 0, 0]; 256 * 256]; let data = Image2DSource::from_pixels(pixels, 256, 256).unwrap(); context.submit(texture.base_level().positive_x().upload_command(data));
Trait Implementations
impl<'a, F> AsAttachableImageRef for TextureCubeLevelFaceMut<'a, F> where
F: TextureFormat,
[src]
F: TextureFormat,
type Format = F
The type of image storage format the image is stored in.
fn as_attachable_image_ref(&mut self) -> AttachableImageRef<Self::Format>
[src]
impl<'a, F> Deref for LevelFaceMut<'a, F>
[src]
Auto Trait Implementations
impl<'a, F> !Send for LevelFaceMut<'a, F>
impl<'a, F> Unpin for LevelFaceMut<'a, F>
impl<'a, F> !Sync for LevelFaceMut<'a, F>
impl<'a, F> !UnwindSafe for LevelFaceMut<'a, F>
impl<'a, F> !RefUnwindSafe for LevelFaceMut<'a, F>
Blanket Implementations
impl<D, T> IntoBuffer<T> for D where
D: Borrow<T> + 'static,
T: Copy + 'static,
[src]
D: Borrow<T> + 'static,
T: Copy + 'static,
fn into_buffer<Rc>(Self, &Rc, UsageHint) -> Buffer<T> where
Rc: RenderingContext + Clone + 'static,
[src]
Rc: RenderingContext + Clone + 'static,
impl<T, U> Into<U> for T where
U: From<T>,
[src]
U: From<T>,
impl<T> From<T> for T
[src]
impl<T, U> TryFrom<U> for T where
U: Into<T>,
[src]
U: Into<T>,
type Error = Infallible
The type returned in the event of a conversion error.
fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>
[src]
impl<T, U> TryInto<U> for T where
U: TryFrom<T>,
[src]
U: TryFrom<T>,
type Error = <U as TryFrom<T>>::Error
The type returned in the event of a conversion error.
fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>
[src]
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
T: ?Sized,
fn borrow_mut(&mut self) -> &mut T
[src]
impl<T> Borrow<T> for T where
T: ?Sized,
[src]
T: ?Sized,
impl<T> Any for T where
T: 'static + ?Sized,
[src]
T: 'static + ?Sized,