Struct RenderAgent 

pub struct RenderAgent { /* private fields */ }

The agent responsible for managing the state and logic of the rendering pipeline.

Implementations

impl RenderAgent

pub fn new() -> Self

Creates a new RenderAgent with default lanes and automatic strategy selection.

pub fn render( &mut self, encoder: &mut dyn CommandEncoder, render_ctx: &RenderContext<'_>, )

Renders the scene using the provided encoder and render context.

This is the main rendering method that encodes GPU commands via the selected lane. Shadow lanes are executed first, followed by the selected render lane.

pub fn with_strategy(strategy: RenderingStrategy) -> Self

Creates a new RenderAgent with the specified rendering strategy.

pub fn with_telemetry_sender(self, sender: Sender<TelemetryEvent>) -> Self

Attaches a telemetry sender so the agent can emit GpuReport events to the DCC.

pub fn add_lane(&mut self, lane: Box<dyn Lane>)

Adds a custom lane to the registry.

pub fn set_strategy(&mut self, strategy: RenderingStrategy)

Sets the rendering strategy.

pub fn strategy(&self) -> RenderingStrategy

Returns the current rendering strategy.

pub fn lanes(&self) -> &LaneRegistry

Returns a reference to the lane registry.

pub fn select_lane(&self) -> &dyn Lane

Selects the appropriate render lane based on the current strategy.

pub fn prepare_frame( &mut self, world: &mut World, graphics_device: &dyn GraphicsDevice, )

Prepares all rendering data for the current frame.

This method runs the entire Control Plane logic for rendering:

1. Prepares GPU resources for any newly loaded meshes.
2. Extracts all visible objects from the ECS into the internal RenderWorld.

pub fn produce_render_objects(&self) -> Vec<RenderObject>

Translates the prepared data from the RenderWorld into a list of RenderObjects.

This method should be called after prepare_frame. It reads the intermediate RenderWorld and produces the final, low-level data structure required by the RenderSystem.

Uses the selected lane’s domain-specific pipeline selection if available, otherwise falls back to a default pipeline.

pub fn extract_camera_view(&self, world: &World) -> ViewInfo

Extracts the active camera from the ECS world and generates a ViewInfo.

This method queries the ECS for entities with both a Camera and GlobalTransform component, finds the first active camera, and constructs a ViewInfo containing the camera’s view and projection matrices.

Arguments

• world: The ECS world containing camera entities

Returns

A ViewInfo containing the camera’s matrices and position. If no active camera is found, returns a default ViewInfo with identity matrices.

pub fn last_frame_time(&self) -> Duration

Returns the duration of the last frame’s render pass.

pub fn frame_count(&self) -> u64

Returns the total number of frames rendered.

pub fn current_strategy_id(&self) -> StrategyId

Returns the current GORNA strategy ID.

pub fn render_world(&self) -> &RenderWorld

Returns a reference to the internal RenderWorld.

pub fn render_world_mut(&mut self) -> &mut RenderWorld

Returns a mutable reference to the internal RenderWorld.

pub fn gpu_meshes(&self) -> &Arc<RwLock<Assets<GpuMesh>>>

Returns a reference to the GPU meshes cache.

Trait Implementations

impl Agent for RenderAgent

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 update(&mut self, context: &mut EngineContext<'_>)

Periodically updates the agent’s internal state.

fn report_status(&self) -> AgentStatus

Reports the current status and health of the agent.

fn execute(&mut self)

Executes the agent’s primary function for this frame. Called after update(), this is where the agent performs its main work.

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 RenderAgent

fn default() -> Self

Returns the “default value” for a type.