Struct libktx_rs::texture::Texture

pub struct Texture<'a> { /* fields omitted */ }

A KTX (1 or 2) texture.

This wraps both a sys::ktxTexture handle, and the TextureSource it was created from.

Implementations

impl<'a> Texture<'a>

pub fn new<S>(source: S) -> Result<Self, KtxError> where
    S: TextureSource<'a>, 

Attempts to create a new texture, consuming the given TextureSource.

pub fn handle(&self) -> *mut ktxTexture

Returns the pointer to the (C-allocated) underlying sys::ktxTexture.

SAFETY: Pointers are harmless. Dereferencing them is not!

pub fn data_size(&self) -> usize

Returns the total size of image data, in bytes.

pub fn data(&self) -> &[u8]

Returns a read-only view on the image data.

pub fn data_mut(&mut self) -> &mut [u8]

Returns a read-write view on the image data.

pub fn row_pitch(&self, level: u32) -> usize

Returns the pitch (in bytes) of an image row at the specified image level.
This is rounded up to 1 if needed.

pub fn element_size(&self) -> usize

Returns the size (in bytes) of an element of the image.

pub fn write_to<T: TextureSink>(&self, sink: &mut T) -> Result<(), KtxError>

Attempts to write the texture (in its native format, either KTX1 or KTX2) to sink.

pub fn ktx1<'b>(&'b mut self) -> Option<Ktx1<'b, 'a>>

If this Texture really is a KTX1, returns KTX1-specific functionalities for it.

pub fn ktx2<'b>(&'b mut self) -> Option<Ktx2<'b, 'a>>

If this Texture really is a KTX2, returns KTX2-specific functionalities for it.

Trait Implementations

impl<'a> Drop for Texture<'a>

fn drop(&mut self)

Executes the destructor for this type.