Struct TextureData

Source

pub struct TextureData<'data, U = DynamicTextureUsages> { /* private fields */ }

Implementations§

Source §

impl<'data> TextureData<'data, TextureNoUsages>

Source

pub fn empty<S>(size: S, format: Format) -> Self
where S: Into<Size>,

Source

pub fn new<S>( size: S, format: Format, data: &'data [u8], ) -> Result<Self, InvalidLen>
where S: Into<Size>,

Source §

impl<'data, U> TextureData<'data, U>

Source

pub fn read(self) -> TextureData<'data, U::Out>
where U: Use<dyn Read>,

Enables the read usage.

This allows the texture to be used for reading. Compile-time enforcement ensures the correct usage is present.

Source

pub fn write(self) -> TextureData<'data, U::Out>
where U: Use<dyn Write>,

Enables the write usage.

This allows the texture to be used for writing. Compile-time enforcement ensures the correct usage is present.

Source

pub fn copy_from(self) -> TextureData<'data, U::Out>
where U: Use<dyn CopyFrom>,

Enables the copy from usage.

This allows the texture to be used for coping from it. Compile-time enforcement ensures the correct usage is present.

Source

pub fn copy_to(self) -> TextureData<'data, U::Out>
where U: Use<dyn CopyTo>,

Enables the copy to usage.

This allows the texture to be used for coping to it. Compile-time enforcement ensures the correct usage is present.

Source

pub fn bind(self) -> TextureData<'data, U::Out>
where U: Use<dyn Bind>,

Enables the bind usage.

This allows the texture to be used for binding to read in a shader. Compile-time enforcement ensures the correct usage is present.

Source

pub fn render(self) -> TextureData<'data, U::Out>
where U: Use<dyn Render>,

Enables the render usage.

This allows the texture to be used for render into it. Compile-time enforcement ensures the correct usage is present.

Source

pub fn erase(self) -> TextureData<'data>
where U: TextureUsages,

Erases the static type information about usages.

The full static type of a texture includes information about all of its usages, for example: Texture2d<Texture<false, false, true, true>>. This enables compile-time checks for required usages - for example, you won’t be able to render to a texture without the render usage. However, this strict typing significantly complicates type management.

As a compromise, you can call this method to erase usage information from the type, which moves the checks to runtime instead. In this case, using the texture in a context where the required usage is missing will cause a panic.