Struct ExternalTexture 

pub struct ExternalTexture { /* private fields */ }

A GPU texture that another renderer, such as a game engine, draws into, shown through Cranpose’s image primitives.

The handle belongs to the renderer that draws the scene: the wgpu renderer draws a wgpu::TextureView and samples it as stored, so an sRGB texture needs a non-sRGB view. Software renderers draw it transparent.

Draw frame with the number of the texture’s current content. Image ids include that number, so every cache keyed by an image id draws the new content once the number changes.

Implementations

impl ExternalTexture

pub fn new( width: u32, height: u32, opaque: bool, handle: impl Any + Send + Sync, ) -> Result<ExternalTexture, ImageBitmapError>

Wraps a renderer’s texture handle of width by height pixels. opaque promises that every pixel the texture holds has full alpha.

pub fn frame(&self, frame: u64) -> ImageBitmap

The bitmap that draws content number frame of this texture.

pub fn width(&self) -> u32

Width in pixels.

pub fn height(&self) -> u32

Height in pixels.

pub fn bitmaps_alive(&self) -> bool

Whether a bitmap from frame, or another clone of this texture, is still alive. A renderer draws the texture only through such a bitmap, so once none is alive, no draw of it is waiting for the GPU queue.

Trait Implementations

impl Clone for ExternalTexture

fn clone(&self) -> ExternalTexture

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ExternalTexture

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

Formats the value using the given formatter.