Struct WgpuCustomContext 

pub struct WgpuCustomContext {
    pub device: Arc<Device>,
    /* private fields */
}

Host-owned recording context. Producers record work; only the renderer submits.

Fields

device: Arc<Device>

Device on which producer pipelines and buffers must be created.

Implementations

impl WgpuCustomContext

pub fn cache_key(&self) -> usize

Queue-scoped cache identity; cached output retains the device and queue.

pub fn create_output( &self, extent: Size<DevicePixels>, ) -> Result<WgpuCustomOutput>

Allocate a host-device output with straight-alpha encoded-sRGB RGBA8 channels.

pub fn image_upload_context(&self) -> WgpuImageUploadContext

Owned worker-safe handles for allocating and filling image staging data. The worker cannot submit work on the renderer queue.

pub fn create_image_output( &self, data: &ImageTextureData, ) -> Result<WgpuCustomOutput>

Synchronous convenience route. Media workers normally stage first and call adopt_image_upload during host preparation instead.

pub fn adopt_image_upload( &self, staged: &WgpuStagedImage, ) -> Result<WgpuCustomOutput>

Record copies of already-filled buffers. No texture allocation or pixel copying occurs here. A staged image may be adopted again after abandonment.

pub fn adopt_image_upload_with_guard( &self, staged: &WgpuStagedImage, guard: Option<Arc<dyn Send + Sync>>, ) -> Result<WgpuCustomOutput>

Retain an admission lease until GPU completion, or release it when this recording is abandoned. Staging resources have their own completion guard.

pub fn record<T>( &self, encode: impl FnOnce(&mut CommandEncoder) -> Result<T>, ) -> Result<T>

Record preparation commands. Do not submit work or wait on the GPU here. An encoding error invalidates this transaction, including commands recorded earlier.

pub fn can_reuse(&self, output: &WgpuCustomOutput) -> bool

Whether output is submitted, local to this recording, or staged earlier in this host batch.

Trait Implementations

impl Drop for WgpuCustomContext

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.