Struct crow::Texture

pub struct Texture { /* fields omitted */ }

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.

Methods

impl Texture

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

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, ErrDontCare>

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)

pub fn width(&self) -> u32

pub fn height(&self) -> u32

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

Stores the current state of this Texture in an image. This function is fairly slow and should not be used carelessly.

pub fn clear_depth(&mut self, ctx: &mut Context) -> Result<(), ErrDontCare>

Resets the depth buffer to 1.0 for every pixel.

Trait Implementations

impl Clone for Texture

fn clone(&self) -> Texture

Returns a copy 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
) -> Result<(), ErrDontCare>

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)
) -> Result<(), ErrDontCare>

Sets each pixel of self to color.

fn receive_line(
    &mut self,
    ctx: &mut Context,
    from: (i32, i32),
    to: (i32, i32),
    color: (f32, f32, f32, f32)
) -> Result<(), ErrDontCare>

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)
) -> Result<(), ErrDontCare>

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