Physically-based punctual lighting system (point + spot lights)

[Copilot]

The engine only supported a single main directional light. This adds a complete multi-light pipeline for point and spot lights with physically-based attenuation.

Shader

• lighting/punctual_light.hlslh (new) — Inverse-square distance attenuation with smooth range windowing (saturate(1-(d/r)⁴)² / max(d²,ε)), spot angular falloff, Cook-Torrance BRDF evaluation per punctual light
• layout/default_pass.hlslh — PointLightData/SpotLightData structs + cbuffer bindings at slots 12–13 (MAX_POINT_LIGHTS=8, MAX_SPOT_LIGHTS=4)
• layout/default_global_view.hlslh — PointLightCount/SpotLightCount added to global cbuffer
• standard_pbr.hlsl — ENABLE_PUNCTUAL_LIGHTS pass option; light accumulation loop in FSMain

C++ core

• RenderBuiltinLayout.h — GPU-matching structs (ShaderPointLightData, ShaderSpotLightData, buffer wrappers); ShaderPassInfo extended with light counts
• LightBase.h/cpp — PointLight gets position/range; SpotLight gets position/direction/range/inner+outer cone angles
• LightFeatureProcessor — GatherPunctualLightData() collects lights into GPU-ready buffers each Tick()
• DefaultForwardPipeline — UBO init + per-frame upload for light buffers at descriptor slots 12–13

ECS integration

• PointLightComponent / SpotLightComponent — ComponentAdaptor + ITransformEvent pattern, serialization, registered in RenderModule

Usage

// Create a point light via ECS
auto *pl = lf->CreateLight<PointLight>();
pl->SetPosition({5.f, 3.f, 0.f});
pl->SetRange(20.f);
pl->SetColor({1.f, 0.8f, 0.6f});
pl->SetIntensity(100.f); // candela

// Shader — automatically iterated when ENABLE_PUNCTUAL_LIGHTS=1
for (uint pi = 0; pi < PointLightCount && pi < MAX_POINT_LIGHTS; ++pi)
    e0 += EvaluatePointLight(PointLights[pi], V, N, worldPos, pbrParam);

Original prompt

帮我设计一套物理光照方案

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.