Struct LitForwardLane 

pub struct LitForwardLane {
    pub shader_complexity: ShaderComplexity,
    pub max_directional_lights: u32,
    pub max_point_lights: u32,
    pub max_spot_lights: u32,
}

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.

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 RenderLane for LitForwardLane

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

Returns a human-readable identifier for this rendering strategy.

fn get_pipeline_for_material( &self, material_uuid: Option<AssetUUID>, materials: &Assets<Box<dyn Material>>, ) -> RenderPipelineId

Gets the appropriate render pipeline for a given material.

fn render( &self, render_world: &RenderWorld, encoder: &mut dyn CommandEncoder, render_ctx: &RenderContext<'_>, gpu_meshes: &RwLock<Assets<GpuMesh>>, materials: &RwLock<Assets<Box<dyn Material>>>, )

Encodes GPU commands to render the scene into the provided command encoder.

fn estimate_cost( &self, render_world: &RenderWorld, gpu_meshes: &RwLock<Assets<GpuMesh>>, ) -> f32

Estimates the GPU cost of rendering the given RenderWorld with this strategy.