Struct re_renderer::context::ActiveFrameContext

pub struct ActiveFrameContext {
    pub before_view_builder_encoder: Mutex<FrameGlobalCommandEncoder>,
    pub frame_index: u64,
    top_level_error_scope: Option<WgpuErrorScope>,
}

Fields

before_view_builder_encoder: Mutex<FrameGlobalCommandEncoder>

Command encoder for all commands that should go in before view builder are submitted.

This should be used for any gpu copy operation outside of a renderer or view builder. (i.e. typically in crate::renderer::DrawData creation!)

frame_index: u64

Index of this frame. Is incremented for every render frame.

Keep in mind that all operations on WebGPU are asynchronous: This counter is part of the content timeline and may be arbitrarily behind both of the device timeline and queue timeline. See https://www.w3.org/TR/webgpu/#programming-model-timelines

top_level_error_scope: Option<WgpuErrorScope>

Top level device error scope, created at startup and closed & reopened on every frame.

According to documentation, not all errors may be caught by [wgpu::Device::on_uncaptured_error]. https://www.w3.org/TR/webgpu/#eventdef-gpudevice-uncapturederror Therefore, we should make sure that we always have an error scope open! Additionally, we use this to update RenderContext::frame_index_for_uncaptured_errors.

The only time this is allowed to be None is during shutdown and when closing an old and opening a new scope.