Struct Texture 

pub struct Texture {
    inner: Arc<TextureInner>,
}

GPU image texture backed by a wgpu::Texture.

Cheaply cloneable; the underlying GPU resource is Arc-wrapped.

Fields

inner: Arc<TextureInner>

Implementations

impl Texture

pub fn from_rgba( app: &Application, width: u32, height: u32, bytes: &[u8], ) -> Self

Construct from raw RGBA8 bytes in linear-srgb space.

bytes.len() must equal width * height * 4.

Panics

Panics if the byte slice length doesn’t match width * height * 4.

pub fn from_image(app: &Application, img: &DynamicImage) -> Self

Construct from a decoded image. Converts to RGBA8 if needed.

pub(crate) fn from_render_texture_parts( texture: Texture, view: TextureView, sampler: Sampler, width: u32, height: u32, ) -> Self

Wrap a set of wgpu texture handles as a Texture.

Used internally by crate::texture::render_texture::RenderTexture::as_texture to expose a render-target as a sampled sprite texture without copying GPU bytes. Not part of the public API — render textures are the supported caller, and pub(crate) keeps it that way.

pub fn empty( app: &Application, width: u32, height: u32, format: TextureFormat, ) -> Self

Construct an empty (zeroed) texture for the given format.

Usage flags include TEXTURE_BINDING | COPY_DST, suitable for sampling and per-frame uploads (e.g. backing a crate::texture::video_texture). For render targets see crate::texture::render_texture.

pub fn width(&self) -> u32

Texture width in pixels.

pub fn height(&self) -> u32

Texture height in pixels.

pub(crate) fn view(&self) -> &TextureView

pub(crate) fn sampler(&self) -> &Sampler

pub(crate) fn wgpu_texture(&self) -> &Texture

pub(crate) fn id(&self) -> usize

Identity for batching — texture-pointer-equality.

Two Texture clones (or two views into the same Arc) share the same id; two independently-constructed textures don’t. Used by the renderer to group sprite draws.

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.