Struct OverlayAgent 

pub struct OverlayAgent { /* private fields */ }

The agent responsible for overlay / debug rendering passes.

Owns a [LaneRegistry] of overlay lanes (gizmo, wireframe, emissive, …). Each lane is asked to run every frame; lanes that have nothing to do early-out internally rather than being gated at the agent level. This keeps the agent generic — it never knows what each lane needs to consult to decide.

Trait Implementations

impl Agent for OverlayAgent

fn access(&self) -> AgentAccess

Reads only the LaneBus and shared read-only resources, records into its own encoder, and buffers its pass into its OutputDeck — no World, no shared mutable resource. Eligible to run concurrently with any wave.

fn deck_writes(&self) -> Vec<TypeId>

Buffers its pass into the [OverlayPassSlot] deck slot.

fn id(&self) -> AgentId

Returns the unique identifier for this agent.

fn negotiate(&mut self, _request: NegotiationRequest) -> NegotiationResponse

Negotiates with the DCC to determine the best execution strategy given the current global resource constraints and priorities.

fn apply_budget(&mut self, budget: ResourceBudget)

Applies a resource budget issued by the DCC. The agent must adjust its internal logic (e.g., LOD, quality settings) to stay within the allocated limits.

fn on_initialize(&mut self, context: &mut EngineContext<'_>)

Called once after the agent is registered with the DCC.

fn execute(&mut self, context: &mut EngineContext<'_>)

Called every frame by the engine loop.

fn report_status(&self) -> AgentStatus

Reports the current status and health of the agent.

fn execution_timing(&self) -> ExecutionTiming

Declares WHEN and HOW this agent should execute within the frame pipeline.

fn as_any(&self) -> &dyn Any

Allows downcasting to concrete agent types.

fn as_any_mut(&mut self) -> &mut dyn Any

Allows mutable downcasting to concrete agent types.

impl Default for OverlayAgent

fn default() -> Self

Returns the “default value” for a type.