pub struct Texture { /* private fields */ }
Expand description

Texture, tex data stored in GPU memory (VRAM)

Implementations§

source§

impl Texture

source

pub fn width(&self) -> u32

Texture base width

source

pub fn height(&self) -> u32

Texture base height

source

pub fn mipmaps(&self) -> u32

Mipmap levels, 1 by default

source

pub fn format(&self) -> PixelFormat

Data format

source

pub fn from_file(file_name: &str) -> Option<Self>

Load texture from file into GPU memory (VRAM)

source

pub fn from_image(image: &Image) -> Option<Self>

Load texture from image data

source

pub fn from_cubemap( image: &Image, layout: CubemapLayout ) -> Option<TextureCubemap>

Load cubemap from image, multiple image cubemap layouts supported

source

pub fn update(&mut self, pixels: &[u8]) -> bool

Update GPU texture with new data

Returns true on success, false if pixels has wrong size (use get_pixel_data_size())

source

pub fn update_rect(&mut self, rect: Rectangle, pixels: &[u8]) -> bool

Update GPU texture rectangle with new data

Returns true on success, false if pixels has wrong size or rect goes out of bounds

source

pub fn get_pixel_data_size(&self) -> usize

Get pixel data size in bytes for this texture

source

pub fn generate_mipmaps(&mut self)

Generate GPU mipmaps for a texture

source

pub fn set_filter(&mut self, filter: TextureFilter)

Set texture scaling filter mode

source

pub fn set_wrap(&mut self, wrap: TextureWrap)

Set texture wrapping mode

source

pub fn as_raw(&self) -> &Texture

Get the ‘raw’ ffi type Take caution when cloning so it doesn’t outlive the original

source

pub fn as_raw_mut(&mut self) -> &mut Texture

Get the ‘raw’ ffi type Take caution when cloning so it doesn’t outlive the original

source

pub unsafe fn from_raw(raw: Texture) -> Self

Convert a ‘raw’ ffi object to a safe wrapper

Safety
  • The raw object must be correctly initialized
  • The raw object should be unique. Otherwise, make sure its clones don’t outlive the newly created object.

Trait Implementations§

source§

impl Debug for Texture

source§

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

Formats the value using the given formatter. Read more
source§

impl Drop for Texture

source§

fn drop(&mut self)

Executes the destructor for this type. Read more

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for Twhere T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for Twhere T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for Twhere T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for Twhere U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.