Struct sdl2::render::TextureCreator

pub struct TextureCreator<T> { /* fields omitted */ }

Creates Textures that cannot outlive the creator

The TextureCreator does not hold a lifetime to its Canvas by design choice.

If a Canvas is dropped before its TextureCreator, it is still safe to use.

It is, however, useless.

Any Texture created here can only be drawn onto the original Canvas. A Texture used in a Canvas must come from a TextureCreator coming from that same Canvas. Using a Texture to render to a Canvas not being the parent of the Texture's TextureCreator is undefined behavior.

Methods

impl<T> TextureCreator<T>

Texture-creating methods for the renderer

fn raw(&self) -> *mut SDL_Renderer

fn default_pixel_format(&self) -> PixelFormatEnum

fn create_texture<F>(
    &self,
    format: F,
    access: TextureAccess,
    width: u32,
    height: u32
) -> Result<Texture, TextureValueError> where
    F: Into<Option<PixelFormatEnum>>, 

Creates a texture for a rendering context.

If format is None, the format will be the one the parent Window or Surface uses.

If format is Some(pixel_format), the default will be overridden, and the texture will be created with the specified format if possible. If the PixelFormat is not supported, this will return an error.

You should prefer the default format if possible to have performance gains and to avoid unsupported Pixel Formats that can cause errors. However, be careful with the default PixelFormat if you want to create transparent textures.

fn create_texture_static<F>(
    &self,
    format: F,
    width: u32,
    height: u32
) -> Result<Texture, TextureValueError> where
    F: Into<Option<PixelFormatEnum>>, 

Shorthand for create_texture(format, TextureAccess::Static, width, height)

fn create_texture_streaming<F>(
    &self,
    format: F,
    width: u32,
    height: u32
) -> Result<Texture, TextureValueError> where
    F: Into<Option<PixelFormatEnum>>, 

Shorthand for create_texture(format, TextureAccess::Streaming, width, height)

fn create_texture_target<F>(
    &self,
    format: F,
    width: u32,
    height: u32
) -> Result<Texture, TextureValueError> where
    F: Into<Option<PixelFormatEnum>>, 

Shorthand for create_texture(format, TextureAccess::Target, width, height)

fn create_texture_from_surface<S: AsRef<SurfaceRef>>(
    &self,
    surface: S
) -> Result<Texture, TextureValueError>

Creates a texture from an existing surface.

Remarks

The access hint for the created texture is TextureAccess::Static.

unsafe fn raw_create_texture(&self, raw: *mut SDL_Texture) -> Texture

Create a texture from its raw SDL_Texture.