Struct GpuImage 

pub struct GpuImage { /* private fields */ }

GPU-resident packed image backed by an rgba8uint 2D texture.

The logical channel count remains 1..=4. Unused texture components are zero, so device storage is a predictable four bytes per pixel on every backend.

Implementations

impl GpuImage

pub fn upload_u8<const CHANNELS: usize>( runtime: &WgpuRuntime, view: ImageView<'_, u8, CHANNELS>, ) -> SpatialResult<Self>

Explicitly uploads a packed or strided u8 image into a texture.

pub fn readback_u8<const CHANNELS: usize>( &mut self, runtime: &WgpuRuntime, ) -> SpatialResult<Image<u8, CHANNELS>>

Explicitly reads the texture back into an owned packed host image.

pub const fn width(&self) -> u32

Returns image width in pixels.

pub const fn height(&self) -> u32

Returns image height in pixels.

pub const fn channels(&self) -> u32

Returns the logical component count.

pub const fn metadata(&self) -> ImageMetadata

Returns retained semantic metadata.

pub const fn receipt(&self) -> &GpuImageReceipt

Returns cumulative transfer and device-stage accounting.

pub fn recycle(self, runtime: &WgpuRuntime)

Drops texture storage after verifying the runtime ownership contract.