Struct PhysicsAgent 

pub struct PhysicsAgent { /* private fields */ }

The agent responsible for managing the physics simulation.

It acts as the Control Plane (ISA) for the physics subsystem, deciding which strategies (lanes) to deploy and managing the physics world.

Implementations

impl PhysicsAgent

pub fn new(provider: Box<dyn PhysicsProvider>) -> Self

Creates a new PhysicsAgent with a given provider.

pub fn with_telemetry(self, registry: &MetricsRegistry) -> Self

Attaches a metrics registry to the agent for observability.

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

Attaches a DCC sender for telemetry events.

pub fn step(&mut self, world: &mut World, dt: f32)

Advances the physics simulation.

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

Selects the appropriate physics lane based on the current strategy.

pub fn cast_ray( &self, ray: &Ray, max_toi: f32, solid: bool, ) -> Option<RaycastHit>

Exposes raycasting from the provider.

pub fn get_debug_render_data(&self) -> (Vec<Vec3>, Vec<[u32; 2]>)

Returns debug rendering data from the provider.

pub fn last_step_time(&self) -> Duration

Returns the duration of the last step.

pub fn frame_count(&self) -> u64

Returns the total number of frames simulated.

pub fn current_strategy_id(&self) -> StrategyId

Returns the current GORNA strategy ID.

pub fn fixed_timestep(&self) -> f32

Returns the current fixed timestep.

pub fn set_fixed_timestep(&mut self, dt: f32)

Sets the fixed timestep.

Trait Implementations

impl Agent for PhysicsAgent

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.