Struct LitForwardLane 

pub struct LitForwardLane {
    pub shader_complexity: ShaderComplexity,
    pub max_directional_lights: u32,
    pub max_point_lights: u32,
    pub max_spot_lights: u32,
    /* private fields */
}

A lane that implements forward rendering with lighting support.

This lane renders meshes with lighting calculations performed in the fragment shader. It supports multiple light types (directional, point, spot) and includes shader complexity tracking for GORNA resource negotiation.

Performance Characteristics

• O(meshes × lights) fragment shader complexity
• Suitable for: Scenes with moderate light counts (< 20 lights)
• Shader complexity tracking: Integrates with GORNA for adaptive quality

Cost Estimation

The cost estimation includes:

• Base triangle and draw call costs (same as SimpleUnlitLane)
• Shader complexity multiplier based on the configured complexity level
• Per-light cost scaling based on the number of active lights

Fields

shader_complexity: ShaderComplexity

The shader complexity level to use for cost estimation.

max_directional_lights: u32

Maximum number of directional lights supported per pass.

max_point_lights: u32

Maximum number of point lights supported per pass.

max_spot_lights: u32

Maximum number of spot lights supported per pass.

Implementations

impl LitForwardLane

pub fn new() -> Self

Creates a new LitForwardLane with default settings.

pub fn with_complexity(complexity: ShaderComplexity) -> Self

Creates a new LitForwardLane with the specified shader complexity.

pub fn effective_light_counts( &self, render_world: &RenderWorld, ) -> (usize, usize, usize)

Returns the effective number of lights that will be used for rendering.

This clamps the actual light counts to the maximum supported per pass.

impl LitForwardLane

pub fn get_pipeline_for_material( &self, _material: Option<&AssetHandle<Box<dyn Material>>>, ) -> RenderPipelineId

Returns the render pipeline for the given material (or default).

Trait Implementations

impl Debug for LitForwardLane

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for LitForwardLane

fn default() -> Self

Returns the “default value” for a type.

impl Lane for LitForwardLane

fn strategy_name(&self) -> &'static str

Human-readable name identifying this lane’s strategy.

fn lane_kind(&self) -> LaneKind

The kind of processing this lane performs.

fn estimate_cost(&self, ctx: &LaneContext) -> f32

Estimated computational cost of running this lane.

fn on_initialize(&self, ctx: &mut LaneContext) -> Result<(), LaneError>

Called once when the lane is registered or the underlying context resets.

fn execute(&self, ctx: &mut LaneContext) -> Result<(), LaneError>

Main execution entry point — called each frame/tick by the owning agent.

fn on_shutdown(&self, ctx: &mut LaneContext)

Called when the lane is being destroyed or the context is shutting down.

fn as_any(&self) -> &dyn Any

Downcast to a concrete type for type-specific operations.

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

Downcast to a concrete type (mutable) for type-specific operations.