Struct Texture 

pub struct Texture { /* private fields */ }

A two dimensional texture stored in video memory.

Textures are copy-on-write, so cloning a texture is cheap until the clone or the original is modified.

Transparency is supported.

Implementations

impl Texture

pub fn new( ctx: &mut Context, dimensions: (u32, u32), ) -> Result<Self, NewTextureError>

Creates a new texture with the given dimensions.

The content of the texture is undefined after its creation.

pub fn from_image( ctx: &mut Context, image: RgbaImage, ) -> Result<Self, NewTextureError>

Creates a new texture from the given image.

pub fn load<P: AsRef<Path>>( ctx: &mut Context, path: P, ) -> Result<Texture, LoadTextureError>

Loads a texture from an image located at path.

pub fn get_section(&self, position: (u32, u32), size: (u32, u32)) -> Texture

Returns the part of self specified by position and size as a Texture.

Panics

This function panics if part of the requested section would be outside of the original texture.

pub fn dimensions(&self) -> (u32, u32)

Returns the dimensions of this texture.

pub fn width(&self) -> u32

Returns the width of this texture.

pub fn height(&self) -> u32

Returns the height of this texture.

Trait Implementations

impl Clone for Texture

fn clone(&self) -> Texture

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Texture

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

Formats the value using the given formatter.

impl DrawTarget for Texture

fn receive_draw( &mut self, ctx: &mut Context, texture: &Texture, position: (i32, i32), config: &DrawConfig, )

Draws the texture onto self. This permanently alters self, in case the original is still required, consider cloning this Texture first.

It is recommended to call Context::draw instead of using this method directly.

fn receive_clear_color( &mut self, ctx: &mut Context, color: (f32, f32, f32, f32), )

Sets each pixel of self to color.

fn receive_clear_depth(&mut self, ctx: &mut Context)

Resets the depth buffer of self to 1.0.

fn receive_line( &mut self, ctx: &mut Context, from: (i32, i32), to: (i32, i32), color: (f32, f32, f32, f32), )

Draws a line from from to to.

fn receive_rectangle( &mut self, ctx: &mut Context, lower_left: (i32, i32), upper_right: (i32, i32), color: (f32, f32, f32, f32), )

Draws the bounding box of an axis-aligned rectangle specified by its lower_left and upper_right corner.

fn get_image_data(&self, ctx: &mut Context) -> RgbaImage

Returns the current state of the DrawTarget.