Struct GpuFrameContext 

#[non_exhaustive]
pub struct GpuFrameContext<'a> {
    pub camera: &'a Camera,
    pub viewport_size: Vec2,
    pub dt: f32,
    pub frame_index: u64,
    pub viewport_id: Option<ViewportId>,
}

Per-frame, read-only context passed to a GpuPlugin.

Mirrors the render-relevant fields of RuntimeFrameContext without the input or pick state, which GPU plugins do not consume.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

camera: &'a Camera

Active camera for this frame.

viewport_size: Vec2

Viewport size in physical pixels.

dt: f32

Wall-clock seconds since the previous frame.

frame_index: u64

Monotonically increasing frame counter, supplied by the host.

viewport_id: Option<ViewportId>

Viewport this invocation is associated with, if the host renders multiple viewports per frame and calls pre_prepare / post_paint once per viewport. None for single-viewport hosts.

Plugins registered via ViewportRuntime::with_gpu_plugin_for_viewport only execute when this field matches the viewport they were scoped to. Unscoped plugins run on every call regardless of this field.

Implementations

impl<'a> GpuFrameContext<'a>

pub fn new( camera: &'a Camera, viewport_size: Vec2, dt: f32, frame_index: u64, ) -> Self

Construct a context for a single-viewport host. Multi-viewport hosts that call pre_prepare / post_paint once per viewport chain with_viewport to scope the call.

pub fn with_viewport(self, viewport_id: ViewportId) -> Self

Associate this context with a specific viewport. Plugins registered via ViewportRuntime::with_gpu_plugin_for_viewport run only when this id matches the one they were scoped to.