Struct StreamingTexture 

pub struct StreamingTexture { /* private fields */ }

An app-owned texture updated from CPU pixel data every frame or so — video frames, animated images, camera feeds, software-rendered panels. Owns the texture lifecycle that every media consumer otherwise hand-rolls around app_texture:

• creates (and on size/format change, recreates) the TEXTURE_BINDING | COPY_DST texture;
• uploads frames with Self::write_frame, or Self::write_frame_if_changed for sources that repeat frames (paused video, looping animations) where a cheap content hash saves the redundant upload;
• hands out a stable AppTexture handle via Self::app_texture for the surface() tree builder. The handle’s identity is stable across write_frame calls — which is what keeps the per-texture bind-group cache warm — and changes only when a size/format change forces a new GPU texture (one cold bind-group rebuild, then warm again).

data is tightly-packed rows of width * height pixels in the texture’s format (RGBA8 variants: 4 bytes/pixel; Rgba16Float: 8 bytes/pixel). Formats follow app_texture’s supported set.

Implementations

impl StreamingTexture

pub fn new( device: &Device, format: TextureFormat, width: u32, height: u32, ) -> Self

Create with an initial size. The texture contents are undefined until the first Self::write_frame; draw order guarantees nothing samples it before the first queue submission that follows a write.

pub fn write_frame( &mut self, device: &Device, queue: &Queue, width: u32, height: u32, data: &[u8], )

Upload one frame of tightly-packed pixel rows, recreating the texture first if width/height differ from the current size. Panics if data is not exactly width * height * bytes_per_pixel long.

pub fn write_frame_if_changed( &mut self, device: &Device, queue: &Queue, width: u32, height: u32, data: &[u8], ) -> bool

Self::write_frame, skipped when data hashes identically to the previous accepted frame. Worth it for sources that repeat frames (paused video, looping GIFs at rest); for live video where every frame differs, prefer Self::write_frame and skip the hash. Returns true when an upload happened.

pub fn app_texture(&self) -> AppTexture

The handle to embed in the tree via [damascene_core::surface]. Cheap clone; identity stays stable across Self::write_frame calls so backend bind-group caches stay warm.

pub fn size(&self) -> (u32, u32)

Current texture size (width, height) in texels.