@carbonenginejs/runtime 0.1.0-alpha.6 → 0.1.0-alpha.7

package/dist/trinity/eve/scene/EveSpaceScene.js

@@ -1,5 +1,5 @@
 import { identity as _identity, applyDecs2311 as _applyDecs2311 } from '../../../_virtual/_rollupPluginBabelHelpers.js';
-import { edit, type, carbon, impl } from '#schema';
+import { edit, type, carbon, impl, CjsSchema } from '#schema';
 import { CjsModel } from '#model';
 import { mat4 } from '#math/mat4';
 import { quat } from '#math/quat';
@@ -15,8 +15,8 @@ import { EveUpdateContext as _EveUpdateContext } from '../EveUpdateContext.js';
 import { EveEffectRoot2 as _EveEffectRoot } from '../spaceObject/EveEffectRoot2.js';
 import { EveCamera as _EveCamera } from '../camera/EveCamera.js';
 import { CjsPerFrameLayouts } from '../../core/rawData/CjsPerFrameLayouts.js';
-import { PixelFormat, ShaderType, Tr2GpuUsage, TextureType } from '#consts/render-context';
-import { Tr2SubresourceData } from '#trinityal';
+import { PixelFormat, Tr2LoadAction, Tr2StoreAction, ShaderType, RenderState, Tr2GpuUsage, TextureType } from '#consts/render-context';
+import { Tr2DepthAttachment, Tr2ColorAttachment, Tr2SubresourceData } from '#trinityal';
 import { TriBatchType, RenderingMode } from '#consts/graphics';
 import '#resource/geometry';
 import '../../core/batch/TriRenderBatch/DefaultKeyGenerator.js';
@@ -35,7 +35,10 @@ import { Tr2ShadowMap as _Tr2ShadowMap } from '../../core/Tr2ShadowMap.js';
 import { Tr2VolumetricsRenderer as _Tr2VolumetricsRender } from '../../core/volumetrics/Tr2VolumetricsRenderer.js';
 import { screenToProjection, convertProjectionCoordToWorldPickRay } from '../../core/view/pickRay.js';
 import { EveVisualizeMethod } from '../../generated/eve/enums.js';
-import { ShadowQuality } from '../../generated/trinityCore/enums.js';
+import { ShadowQuality, Tr2RenderReason } from '../../generated/trinityCore/enums.js';
+import { TriFrustum } from '../../core/view/TriFrustum.js';
+import { TriShadowOrthoFrustum } from './shadows/TriShadowOrthoFrustum.js';
+import { GpuResourceHandle } from '../../core/Tr2GpuResourcePool/GpuResourceHandle.js';
 import { blue, EnumRegistrationType } from '#blue';
 import './EveSpaceSceneRenderDriver.js';
 
@@ -68,6 +71,16 @@ const SHADOW_CLIP_TO_UV = mat4.fromValues(0.5, 0, 0, 0, 0, -0.5, 0, 0, 0, 0, 1,
 // const, NEVER mutated - objects in m_objects are scene roots.
 const IDENTITY = mat4.create();
 
+/** Carbon's default-constructed EveSpaceScene::ShadowResources: every texture empty. */
+function EmptyShadowResources() {
+  return {
+    shadowMap: new GpuResourceHandle(),
+    cascadedShadowDepth: new GpuResourceHandle(),
+    pointLightShadowMap: new GpuResourceHandle(),
+    pointLightShadowDepth: new GpuResourceHandle()
+  };
+}
+
 // ---------------------------------------------------------------------------
 // DRIVER-ORDER CONTRACT (per frame) - the CPU visibility/gather drive.
 // Carbon runs steps 5-12 inside EveSpaceScene::BeginRender/GatherBatches
@@ -140,7 +153,7 @@ new class extends _identity {
       } = _applyDecs2311(this, [type.define({
         className: "EveSpaceScene",
         family: "eve/scene"
-      })], [[[edit, edit.readwrite, type, type.int32, void 0, type.enum("trinity.EveSpaceScene.EveVisualizeMethod")], 16, "visualizeMethod"], [[edit, edit.notify, edit, edit.readwrite, edit, edit.persist, type, type.string], 16, "envMap1ResPath"], [[edit, edit.notify, edit, edit.readwrite, edit, edit.persist, type, type.string], 16, "envMap2ResPath"], [[edit, edit.notify, edit, edit.readwrite, edit, edit.persist, type, type.string], 16, "envMap3ResPath"], [[edit, edit.notify, edit, edit.readwrite, edit, edit.persist, type, type.string], 16, "lowQualityNebulaResPath"], [[edit, edit.notify, edit, edit.readwrite, edit, edit.persist, type, type.string], 16, "lowQualityNebulaMixResPath"], [[edit, edit.notify, edit, edit.readwrite, edit, edit.persist, type, type.string], 16, "envMapResPath"], [[edit, edit.readwrite, edit, edit.persist, type, type.color], 16, "fogColor"], [[edit, edit.readwrite, edit, edit.persist, type, type.vec3], 16, "sunDirection"], [[edit, edit.readwrite, edit, edit.persist, type, type.color], 16, "ambientColor"], [[edit, edit.readwrite, edit, edit.persistOnly, void 0, type.model("Tr2ShLightingManager")], 16, "shLightingManager"], [[edit, edit.read, void 0, type.objectRef("Tr2PostProcessAttributes")], 16, "combinedPostProcessAttributes"], [[edit, edit.read, void 0, type.objectRef("Tr2DataTextureManager")], 16, "dataTextureMgr"], [[edit, edit.readwrite, type, type.boolean], 16, "dynamicObjectReflectionEnabled"], [[edit, edit.read, void 0, type.objectRef("EveComponentRegistry")], 16, "componentRegistry"], [type.model("EveEffectRoot2"), 0, "cameraAttachmentParent"], [type.rawStruct("BluePy"), 0, "postProcessDebug"], [[edit, edit.read, edit, edit.persist, void 0, type.list("TriCurveSet")], 16, "curveSets"], [[edit, edit.readwrite, edit, edit.persist, type, type.float32], 16, "defaultDiffuseRoughness"], [[edit, edit.readwrite, edit, edit.persist, type, type.float32], 16, "fogStart"], [[edit, edit.readwrite, edit, edit.persist, type, type.float32], 16, "fogEnd"], [[edit, edit.notify, edit, edit.readwrite, edit, edit.persist, type, type.float32], 16, "reflectionIntensity"], [[edit, edit.read, void 0, type.list("EveDistanceField")], 16, "distanceFields"], [[edit, edit.readwrite, edit, edit.persist, void 0, type.model("Tr2Effect")], 16, "backgroundEffect"], [[edit, edit.readwrite, edit, edit.persist, type, type.float32], 16, "backgroundReflectionIntensity"], [[edit, edit.readwrite, edit, edit.persist, type, type.float32], 16, "nebulaIntensity"], [[edit, edit.readwrite, edit, edit.persist, type, type.boolean], 16, "display"], [[edit, edit.readwrite, edit, edit.persist, type, type.boolean], 16, "backgroundRenderingEnabled"], [[edit, edit.readwrite, edit, edit.persist, type, type.boolean], 16, "update"], [[edit, edit.readwrite, void 0, type.objectRef("Tr2ImpostorManager")], 16, "impostorManager"], [[edit, edit.read, edit, edit.persist, void 0, type.list("EveLensflare")], 16, "lensflares"], [[edit, edit.read, edit, edit.persist, void 0, type.list("Tr2ExternalParameter")], 16, "externalParameters"], [[edit, edit.readwrite, edit, edit.persist, type, type.float32], 16, "fogMax"], [[edit, edit.read, void 0, type.list("EveSceneStaticParticles")], 16, "staticParticles"], [[edit, edit.readwrite, void 0, type.objectRef("Tr2DebugRenderer")], 16, "debugRenderer"], [[edit, edit.read, edit, edit.persist, void 0, type.list("IEveSpaceObject2")], 16, "objects"], [[edit, edit.read, edit, edit.persist, void 0, type.list("IEveSpaceObject2")], 16, "uiObjects"], [[edit, edit.read, edit, edit.persist, void 0, type.list("IEveSpaceObject2")], 16, "backgroundObjects"], [[edit, edit.read, edit, edit.persist, void 0, type.list("EvePlanet")], 16, "planets"], [[edit, edit.readwrite, void 0, type.objectRef("Tr2RaytracingManager")], 16, "raytracingManager"], [[edit, edit.notify, edit, edit.readwrite, edit, edit.persist, type, type.color], 16, "reflectionBackLightingColor"], [[edit, edit.notify, edit, edit.readwrite, edit, edit.persist, type, type.float32], 16, "reflectionBackLightingContrast"], [[edit, edit.notify, edit, edit.readwrite, void 0, type.objectRef("Tr2ReflectionProbe")], 16, "reflectionProbe"], [[edit, edit.read, void 0, type.objectRef("Tr2VolumetricsRenderer")], 16, "volumetricsRenderer"], [[edit, edit.readwrite, edit, edit.persist, void 0, type.model("EveStarfield")], 16, "starfield"], [[edit, edit.readwrite, edit, edit.persist, type, type.float32], 16, "planetScale"], [[edit, edit.readwrite, edit, edit.persist, type, type.float32], 16, "planetCameraScale"], [[edit, edit.read, void 0, type.objectRef("Tr2SSSSS")], 16, "subSurfaceScattering"], [[edit, edit.notify, edit, edit.readwrite, type, type.int32, void 0, type.enum("trinity.ShadowQuality")], 16, "shadowQualitySetting"], [[edit, edit.readwrite, edit, edit.persist, type, type.color], 16, "sunDiffuseColor"], [[edit, edit.readwrite, edit, edit.persist, type, type.color], 16, "sunDiffuseColorWithDynamicLights"], [[edit, edit.readwrite, edit, edit.persist, type, type.quat], 16, "envMapRotation"], [[edit, edit.readwrite, void 0, type.objectRef("IEveBallpark")], 16, "ballpark"], [[edit, edit.readwrite, edit, edit.persist, type, type.string], 16, "name"], [[edit, edit.readwrite, edit, edit.persist, void 0, type.model("ITriVectorFunction")], 16, "sunBall"], [[edit, edit.readwrite, edit, edit.persist, void 0, type.model("Tr2PostProcess2")], 16, "postprocess"], [[edit, edit.readwrite, edit, edit.persist, void 0, type.model("EveVirtualCameraSystem")], 16, "virtualCameraSystem"], [[edit, edit.readwrite, void 0, type.objectRef("IEveSpaceObject2")], 16, "warpTunnel"], [[edit, edit.readwrite, type, type.float32], 16, "perFrameDebug"], [[edit, edit.readwrite, edit, edit.persist, void 0, type.model("Tr2ShadowMap")], 16, "cascadedShadowMap"], [[edit, edit.read, type, type.float64], 16, "updateTime"], [[edit, edit.readwrite, edit, edit.persist, type, type.boolean], 16, "useSunDiffuseColorWithDynamicLights"], [[edit, edit.read, void 0, type.objectRef("ITr2TextureProvider")], 16, "envMap1"], [[edit, edit.read, void 0, type.objectRef("ITr2TextureProvider")], 16, "envMap2"], [[edit, edit.read, void 0, type.objectRef("ITr2TextureProvider")], 16, "envMap3"], [[carbon, carbon.method, impl, impl.adapted], 18, "Update"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "PickObject"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "PickAsyncObject"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "PickObjectAndAreaID"], [[carbon, carbon.method, impl, impl.implemented], 18, "PickInfinity"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon's g_enablePostProcessDebugging global becomes the scene-scoped enablePostProcessDebugging field; the debug payload is a plain object, null when off.")], 18, "UpdatePostProcessAttributes"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPostProcess"], [[impl, impl.custom, void 0, impl.reason("Carbon performs this inside BeginRender; CarbonEngineJS exposes the scene-owned CPU phase because the engine driver owns the surrounding frame order.")], 18, "UpdateFogSettings"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon's Tr2ParallelFor becomes a sequential pass; the receivers touch only their own per-object records.")], 18, "UpdateShLighting"], [[carbon, carbon.method, impl, impl.implemented], 18, "RunLensflareOcclusionQueries"], [[carbon, carbon.method, impl, impl.adapted], 26, "registerWithVariableStore"], [[carbon, carbon.method, impl, impl.adapted], 18, "Initialize"], [[carbon, carbon.method, impl, impl.adapted], 18, "UpdateVariableStore"], [[carbon, carbon.method, impl, impl.adapted], 18, "Jitter"], [[carbon, carbon.method, impl, impl.adapted], 18, "EndRender"], [[carbon, carbon.method, impl, impl.implemented], 18, "RenderRenderables"], [[carbon, carbon.method, impl, impl.adapted], 18, "RenderBatch"], [[carbon, carbon.method, impl, impl.implemented], 18, "ApplyPerFrameData"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Tr2Renderer view statics and the ESM's render-target/viewport sizes are engine state; the driver supplies them in `frame`.")], 18, "PopulatePerFrameVSData"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Tr2Renderer statics, the ESM viewport, Tr2LightManager's atlas settings and the upscaler's mip bias are engine state; the driver supplies them in `frame`.")], 18, "PopulatePerFramePSData"], [[carbon, carbon.method, impl, impl.implemented], 18, "ReregisterEntities"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearComponentRegistry"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPostProcessDebug"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateScene"]], 0, void 0, CjsModel));
+      })], [[[edit, edit.readwrite, type, type.int32, void 0, type.enum("trinity.EveSpaceScene.EveVisualizeMethod")], 16, "visualizeMethod"], [[edit, edit.notify, edit, edit.readwrite, edit, edit.persist, type, type.string], 16, "envMap1ResPath"], [[edit, edit.notify, edit, edit.readwrite, edit, edit.persist, type, type.string], 16, "envMap2ResPath"], [[edit, edit.notify, edit, edit.readwrite, edit, edit.persist, type, type.string], 16, "envMap3ResPath"], [[edit, edit.notify, edit, edit.readwrite, edit, edit.persist, type, type.string], 16, "lowQualityNebulaResPath"], [[edit, edit.notify, edit, edit.readwrite, edit, edit.persist, type, type.string], 16, "lowQualityNebulaMixResPath"], [[edit, edit.notify, edit, edit.readwrite, edit, edit.persist, type, type.string], 16, "envMapResPath"], [[edit, edit.readwrite, edit, edit.persist, type, type.color], 16, "fogColor"], [[edit, edit.readwrite, edit, edit.persist, type, type.vec3], 16, "sunDirection"], [[edit, edit.readwrite, edit, edit.persist, type, type.color], 16, "ambientColor"], [[edit, edit.readwrite, edit, edit.persistOnly, void 0, type.model("Tr2ShLightingManager")], 16, "shLightingManager"], [[edit, edit.read, void 0, type.objectRef("Tr2PostProcessAttributes")], 16, "combinedPostProcessAttributes"], [[edit, edit.read, void 0, type.objectRef("Tr2DataTextureManager")], 16, "dataTextureMgr"], [[edit, edit.readwrite, type, type.boolean], 16, "dynamicObjectReflectionEnabled"], [[edit, edit.read, void 0, type.objectRef("EveComponentRegistry")], 16, "componentRegistry"], [type.model("EveEffectRoot2"), 0, "cameraAttachmentParent"], [type.rawStruct("BluePy"), 0, "postProcessDebug"], [[edit, edit.read, edit, edit.persist, void 0, type.list("TriCurveSet")], 16, "curveSets"], [[edit, edit.readwrite, edit, edit.persist, type, type.float32], 16, "defaultDiffuseRoughness"], [[edit, edit.readwrite, edit, edit.persist, type, type.float32], 16, "fogStart"], [[edit, edit.readwrite, edit, edit.persist, type, type.float32], 16, "fogEnd"], [[edit, edit.notify, edit, edit.readwrite, edit, edit.persist, type, type.float32], 16, "reflectionIntensity"], [[edit, edit.read, void 0, type.list("EveDistanceField")], 16, "distanceFields"], [[edit, edit.readwrite, edit, edit.persist, void 0, type.model("Tr2Effect")], 16, "backgroundEffect"], [[edit, edit.readwrite, edit, edit.persist, type, type.float32], 16, "backgroundReflectionIntensity"], [[edit, edit.readwrite, edit, edit.persist, type, type.float32], 16, "nebulaIntensity"], [[edit, edit.readwrite, edit, edit.persist, type, type.boolean], 16, "display"], [[edit, edit.readwrite, edit, edit.persist, type, type.boolean], 16, "backgroundRenderingEnabled"], [[edit, edit.readwrite, edit, edit.persist, type, type.boolean], 16, "update"], [[edit, edit.readwrite, void 0, type.objectRef("Tr2ImpostorManager")], 16, "impostorManager"], [[edit, edit.read, edit, edit.persist, void 0, type.list("EveLensflare")], 16, "lensflares"], [[edit, edit.read, edit, edit.persist, void 0, type.list("Tr2ExternalParameter")], 16, "externalParameters"], [[edit, edit.readwrite, edit, edit.persist, type, type.float32], 16, "fogMax"], [[edit, edit.read, void 0, type.list("EveSceneStaticParticles")], 16, "staticParticles"], [[edit, edit.readwrite, void 0, type.objectRef("Tr2DebugRenderer")], 16, "debugRenderer"], [[edit, edit.read, edit, edit.persist, void 0, type.list("IEveSpaceObject2")], 16, "objects"], [[edit, edit.read, edit, edit.persist, void 0, type.list("IEveSpaceObject2")], 16, "uiObjects"], [[edit, edit.read, edit, edit.persist, void 0, type.list("IEveSpaceObject2")], 16, "backgroundObjects"], [[edit, edit.read, edit, edit.persist, void 0, type.list("EvePlanet")], 16, "planets"], [[edit, edit.readwrite, void 0, type.objectRef("Tr2RaytracingManager")], 16, "raytracingManager"], [[edit, edit.notify, edit, edit.readwrite, edit, edit.persist, type, type.color], 16, "reflectionBackLightingColor"], [[edit, edit.notify, edit, edit.readwrite, edit, edit.persist, type, type.float32], 16, "reflectionBackLightingContrast"], [[edit, edit.notify, edit, edit.readwrite, void 0, type.objectRef("Tr2ReflectionProbe")], 16, "reflectionProbe"], [[edit, edit.read, void 0, type.objectRef("Tr2VolumetricsRenderer")], 16, "volumetricsRenderer"], [[edit, edit.readwrite, edit, edit.persist, void 0, type.model("EveStarfield")], 16, "starfield"], [[edit, edit.readwrite, edit, edit.persist, type, type.float32], 16, "planetScale"], [[edit, edit.readwrite, edit, edit.persist, type, type.float32], 16, "planetCameraScale"], [[edit, edit.read, void 0, type.objectRef("Tr2SSSSS")], 16, "subSurfaceScattering"], [[edit, edit.notify, edit, edit.readwrite, type, type.int32, void 0, type.enum("trinity.ShadowQuality")], 16, "shadowQualitySetting"], [[edit, edit.readwrite, edit, edit.persist, type, type.color], 16, "sunDiffuseColor"], [[edit, edit.readwrite, edit, edit.persist, type, type.color], 16, "sunDiffuseColorWithDynamicLights"], [[edit, edit.readwrite, edit, edit.persist, type, type.quat], 16, "envMapRotation"], [[edit, edit.readwrite, void 0, type.objectRef("IEveBallpark")], 16, "ballpark"], [[edit, edit.readwrite, edit, edit.persist, type, type.string], 16, "name"], [[edit, edit.readwrite, edit, edit.persist, void 0, type.model("ITriVectorFunction")], 16, "sunBall"], [[edit, edit.readwrite, edit, edit.persist, void 0, type.model("Tr2PostProcess2")], 16, "postprocess"], [[edit, edit.readwrite, edit, edit.persist, void 0, type.model("EveVirtualCameraSystem")], 16, "virtualCameraSystem"], [[edit, edit.readwrite, void 0, type.objectRef("IEveSpaceObject2")], 16, "warpTunnel"], [[edit, edit.readwrite, type, type.float32], 16, "perFrameDebug"], [[edit, edit.readwrite, edit, edit.persist, void 0, type.model("Tr2ShadowMap")], 16, "cascadedShadowMap"], [[edit, edit.read, type, type.float64], 16, "updateTime"], [[edit, edit.readwrite, edit, edit.persist, type, type.boolean], 16, "useSunDiffuseColorWithDynamicLights"], [[edit, edit.read, void 0, type.objectRef("ITr2TextureProvider")], 16, "envMap1"], [[edit, edit.read, void 0, type.objectRef("ITr2TextureProvider")], 16, "envMap2"], [[edit, edit.read, void 0, type.objectRef("ITr2TextureProvider")], 16, "envMap3"], [[carbon, carbon.method, impl, impl.adapted], 18, "Update"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "PickObject"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "PickAsyncObject"], [[carbon, carbon.method, impl, impl.notImplemented], 18, "PickObjectAndAreaID"], [[carbon, carbon.method, impl, impl.implemented], 18, "PickInfinity"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon's g_enablePostProcessDebugging global becomes the scene-scoped enablePostProcessDebugging field; the debug payload is a plain object, null when off.")], 18, "UpdatePostProcessAttributes"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPostProcess"], [[impl, impl.custom, void 0, impl.reason("Carbon performs this inside BeginRender; CarbonEngineJS exposes the scene-owned CPU phase because the engine driver owns the surrounding frame order.")], 18, "UpdateFogSettings"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Carbon's Tr2ParallelFor becomes a sequential pass; the receivers touch only their own per-object records.")], 18, "UpdateShLighting"], [[carbon, carbon.method, impl, impl.implemented], 18, "RunLensflareOcclusionQueries"], [[carbon, carbon.method, impl, impl.adapted], 26, "registerWithVariableStore"], [[carbon, carbon.method, impl, impl.adapted], 18, "Initialize"], [[carbon, carbon.method, impl, impl.adapted], 18, "UpdateVariableStore"], [[carbon, carbon.method, impl, impl.adapted], 18, "Jitter"], [[carbon, carbon.method, impl, impl.adapted], 18, "EndRender"], [[carbon, carbon.method, impl, impl.implemented], 18, "RenderRenderables"], [[carbon, carbon.method, impl, impl.adapted], 18, "RenderBatch"], [[carbon, carbon.method, impl, impl.adapted], 18, "RenderDepthPass"], [[carbon, carbon.method, impl, impl.adapted], 18, "RenderShadows"], [[carbon, carbon.method, impl, impl.adapted], 18, "SetupCascadedShadows"], [[carbon, carbon.method, impl, impl.implemented], 18, "ApplyPerFrameData"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Tr2Renderer view statics and the ESM's render-target/viewport sizes are engine state; the driver supplies them in `frame`.")], 18, "PopulatePerFrameVSData"], [[carbon, carbon.method, impl, impl.adapted, void 0, impl.reason("Tr2Renderer statics, the ESM viewport, Tr2LightManager's atlas settings and the upscaler's mip bias are engine state; the driver supplies them in `frame`.")], 18, "PopulatePerFramePSData"], [[carbon, carbon.method, impl, impl.implemented], 18, "ReregisterEntities"], [[carbon, carbon.method, impl, impl.implemented], 18, "ClearComponentRegistry"], [[carbon, carbon.method, impl, impl.implemented], 18, "GetPostProcessDebug"], [[carbon, carbon.method, impl, impl.implemented], 18, "UpdateScene"]], 0, void 0, CjsModel));
       _initStatic(this);
     }
     /** m_visualizeMethod (EveVisualizeMethod - enum EveVisualizeMethod) [READWRITE, ENUM] */
@@ -788,7 +801,7 @@ new class extends _identity {
       if (!lightManager || !this.display) {
         return;
       }
-      lightManager.SetShadowQuality(this.shadowQualitySetting);
+      lightManager.SetShadowQuality(this.shadowQualitySetting, this.updateContext.renderContext.GetRecordingFrameNumber());
       lightManager.Clear(this.updateContext.renderContext);
       lightManager.SetFrustum(this.updateContext.GetFrustum());
       lightManager.AdjustLightCutoff(this.updateContext.GetLodFactor());
@@ -957,6 +970,19 @@ new class extends _identity {
       } else {
         this.#envMapTextureRes = this.#staticEnvMapTextureRes;
       }
+
+      // cpp:3247-3257: every object entity joins the scene's component registry
+      // - its light owners, post-process owners, shadow casters - and so does
+      // the camera attachment parent. Without it GatherLights finds no owners
+      // and no attachment light reaches a shader. The quad-renderer
+      // registration beside it is not ported, nor is the list-insert
+      // registration (OnListChanged, cpp:3465-3470): objects pushed after
+      // Initialize join through ReregisterEntities.
+      // Carbon's BlueCastPtr<EveEntity> is CjsSchema.cast.
+      for (const object of this.objects) {
+        CjsSchema.cast(object, _EveEntity)?.Register(this.componentRegistry);
+      }
+      CjsSchema.cast(this.cameraAttachmentParent, _EveEntity)?.Register(this.componentRegistry);
       return true;
     }
 
@@ -1127,6 +1153,260 @@ new class extends _identity {
       batch.Clear();
     }
 
+    /**
+     * Carbon EveSpaceScene::RenderDepthPass (cpp:2201-2356): the opaque, decal
+     * and depth batches drawn with the depth technique into the bound depth
+     * buffer, and into the normal map and custom stencil when they are given.
+     * Both targets and the depth are cleared to zero, reverse-Z's far.
+     *
+     * Carbon's Metal branch is the one taken (cpp:2255-2259, 2319-2321): with
+     * no normal map, colour slot 0 is unbound for the pass rather than left on
+     * the scene colour.
+     *
+     * Adapted. The batches come in as `batchMap`: Carbon draws its own
+     * m_primaryBatches, and the gather that fills them is the driver's here.
+     * Not ported, each a later insertion at its place in this order: the
+     * mesh-morph update before the pass (cpp:2212-2228; nothing registers an
+     * ITr2MeshMorph), the planets' z-only areas (cpp:2285-2308; EvePlanet has no
+     * GetZOnlyRenderables), and the volumetrics sun angle and planet shadow
+     * casters after it (cpp:2328-2355).
+     *
+     * @param {object} depthMap The scene depth; the caller has bound it.
+     * @param {object|null} normalMap The normal map, or null.
+     * @param {object|null} customStencil The custom stencil target, or null.
+     * @param {Tr2RenderContext} renderContext The frame's context.
+     * @param {string} techniqueName The depth technique ("Depth" from the driver).
+     * @param {object} batchMap The frame's batch map.
+     * @returns {void}
+     */
+    RenderDepthPass(depthMap, normalMap, customStencil, renderContext, techniqueName, batchMap) {
+      if (!this.display) return;
+      const esm = renderContext.GetEffectStateManager();
+      const clearAndStore = () => new Tr2ColorAttachment(Tr2LoadAction.CLEAR, Tr2StoreAction.STORE);
+      const clearDepth = new Tr2DepthAttachment(Tr2LoadAction.CLEAR, Tr2StoreAction.STORE, 0);
+      let renderingMode;
+      esm.BeginManagedRendering();
+      esm.SetRenderTarget(1, customStencil);
+      esm.PushRenderTarget();
+      if (normalMap) {
+        esm.SetRenderTarget(0, normalMap);
+        if (customStencil) {
+          renderContext.RenderPassHint(clearAndStore(), clearAndStore(), clearDepth);
+          renderContext.Clear({
+            clearColor: true,
+            color: [0, 0, 0, 0],
+            slot: 1
+          });
+        } else {
+          renderContext.RenderPassHint(clearAndStore(), clearDepth);
+        }
+        renderContext.Clear({
+          clearColor: true,
+          clearDepth: true,
+          color: [0, 0, 0, 0],
+          depth: 0
+        });
+        renderingMode = RenderingMode.RM_OPAQUE;
+      } else {
+        esm.SetRenderTarget(0, null);
+        if (customStencil) {
+          renderContext.RenderPassHint(new Tr2ColorAttachment(), clearAndStore(), clearDepth);
+          renderContext.Clear({
+            clearColor: true,
+            color: [0, 0, 0, 0],
+            slot: 1
+          });
+          renderingMode = RenderingMode.RM_OPAQUE;
+        } else {
+          renderContext.RenderPassHint(new Tr2ColorAttachment(), clearDepth);
+          renderingMode = RenderingMode.RM_DEPTH_ONLY;
+        }
+        renderContext.Clear({
+          clearDepth: true,
+          depth: 0
+        });
+      }
+      this.ApplyPerFrameData(renderContext);
+      for (const batchType of [TriBatchType.TRIBATCHTYPE_OPAQUE, TriBatchType.TRIBATCHTYPE_DECAL, TriBatchType.TRIBATCHTYPE_DEPTH]) {
+        esm.ApplyStandardStates(renderingMode);
+        const accumulator = batchMap.GetAccumulator(batchType);
+        if (accumulator) renderContext.RenderBatches(accumulator, techniqueName);
+      }
+
+      // Metal supports render-pass hints, so the hinted pass ends here
+      // (cpp:2310-2314); without a normal map Carbon's Metal branch only pops.
+      if (normalMap) renderContext.EndRenderPassHint();
+      esm.PopRenderTarget();
+      esm.SetRenderTarget(1, null);
+      esm.EndManagedRendering();
+    }
+
+    /** m_enableShadows: C++-only, set in the constructor and never cleared (EveSpaceScene.cpp:180). */
+    _enableShadows = true;
+
+    /**
+     * m_shadowBatches: one accumulator per cascade split (cpp:245-250). Carbon
+     * gives each its own pool allocator; ours draw from the context's.
+     */
+    _shadowBatches = Array.from({
+      length: CjsPerFrameLayouts.SHADOW_FRUSTUM_COUNT
+    }, () => new TriRenderBatchAccumulator(EffectKeyGenerator));
+
+    /** The shadow pass's per-frame vertex block, of which only ViewProjectionMat is set (cpp:764-765). */
+    _shadowPerFrameVS = RawData.create("EveSpaceScenePerFrameVSData");
+
+    /** m_shadowPerFrameVSBuffer */
+    _shadowPerFrameVSBuffer = null;
+
+    /**
+     * Carbon EveSpaceScene::RenderShadows (cpp:2618-2676): the cascaded shadow
+     * map at LOW or HIGH shadow quality.
+     *
+     * Adapted: the renderer is passed in for the resolve's blitter, as
+     * `Tr2ShadowMap.DrawToShadowMapResult` takes it. Not ported, each a later
+     * insertion here: the raytraced branch (no Tr2RaytracingManager), and the
+     * point and spot light shadow atlas (the light manager's shadow maps).
+     *
+     * @param {object} depthMap The scene depth.
+     * @param {object|null} normalMap The depth pass's normal map (the raytraced branch reads it).
+     * @param {object} gpuResourcePool The driver's pool.
+     * @param {Tr2RenderContext} renderContext The frame's context.
+     * @param {object} renderer The renderer owning the blitter.
+     * @returns {object} ShadowResources: `shadowMap`, `cascadedShadowDepth`,
+     *   `pointLightShadowMap`, `pointLightShadowDepth`, each a GpuResourceHandle,
+     *   empty when absent.
+     */
+    RenderShadows(depthMap, normalMap, gpuResourcePool, renderContext, renderer) {
+      if (!this.display || !this._enableShadows) return EmptyShadowResources();
+      if (this.cascadedShadowMap && (this.shadowQualitySetting === ShadowQuality.SHADOW_LOW || this.shadowQualitySetting === ShadowQuality.SHADOW_HIGH)) {
+        return this.SetupCascadedShadows(Tr2RenderReason.TR2RENDERREASON_NORMAL, this.cascadedShadowMap, this.updateContext.GetFrustum(), depthMap, gpuResourcePool, renderContext, renderer);
+      }
+      return EmptyShadowResources();
+    }
+
+    /**
+     * Carbon EveSpaceScene::SetupCascadedShadows (cpp:608-798): splits the view
+     * into cascades, finds each one's shadow casters, draws them with their
+     * "Shadow" technique into the cascade's cell of the depth atlas, then
+     * resolves the atlas against the scene depth into a screen-space shadow
+     * factor.
+     *
+     * Adapted: Carbon reads the camera off Tr2Renderer's statics, which the
+     * render context holds here, and finds casters and gathers batches in
+     * parallel, which runs in order here. Not ported, each a later insertion:
+     * the instanced mesh manager's shadow batches, the planets as shadow
+     * casters, and the volumetrics' shadows.
+     *
+     * @param {number} renderReason A `Tr2RenderReason`.
+     * @param {Tr2ShadowMap} shadowMap The scene's cascaded shadow map.
+     * @param {TriFrustum} viewFrustum The camera frustum.
+     * @param {object} depthMap The scene depth.
+     * @param {object} gpuResourcePool The driver's pool.
+     * @param {Tr2RenderContext} renderContext The frame's context.
+     * @param {object} renderer The renderer owning the blitter.
+     * @returns {object} ShadowResources, as RenderShadows.
+     */
+    SetupCascadedShadows(renderReason, shadowMap, viewFrustum, depthMap, gpuResourcePool, renderContext, renderer) {
+      if (!this.componentRegistry) return EmptyShadowResources();
+      const shadowCasters = this.componentRegistry.GetComponents(EveComponentType.ShadowCaster);
+      const volumetricCount = this.componentRegistry.ComponentCount(EveComponentType.VolumetricRenderable);
+      const fogCount = this.componentRegistry.ComponentCount(EveComponentType.FroxelFogSettings);
+      if (shadowCasters.length + volumetricCount + fogCount === 0) return EmptyShadowResources();
+      shadowMap.UpdateSplitValues(renderContext.GetFrontClip(), renderContext.GetBackClip());
+      const shadowMapSize = shadowMap.GetShadowMapSize();
+      const splitCount = CjsPerFrameLayouts.SHADOW_FRUSTUM_COUNT;
+
+      // The frustum's left, right, top and bottom over the near plane, from the
+      // projection (cpp:633-644); Carbon's _11, _22, _31 and _32 are 0, 5, 8, 9.
+      const projection = renderContext.GetProjection();
+      const rightMinusLeft = 2 / projection[0];
+      const bottomMinusTop = 2 / -projection[5];
+      const left = (projection[8] - 1) / 2 * rightMinusLeft;
+      const top = (-projection[9] - 1) / 2 * bottomMinusTop;
+      const right = rightMinusLeft + left;
+      const bottom = bottomMinusTop + top;
+      const sunDir = this.sunDirection;
+      const cameraFrustums = [];
+      const shadowFrustums = [];
+      const splitSetups = [];
+      for (let splitIndex = 0; splitIndex < splitCount; ++splitIndex) {
+        const splitSetup = shadowMap.SetupShadowSplit(splitIndex, renderContext.GetInverseViewTransform(), sunDir, viewFrustum.zNear, left, right, top, bottom);
+
+        // The split's slice of the camera frustum, for half-space culling of
+        // casters. Only the planes are read, so they are all that is made.
+        const cameraFrustum = new TriFrustum();
+        cameraFrustum.ExtractFrustum(mat4.invert(mat4.create(), splitSetup.invViewProj));
+        cameraFrustums.push(cameraFrustum);
+        shadowFrustums.push(new TriShadowOrthoFrustum(splitSetup.shadowFrustum, shadowMapSize, sunDir));
+        splitSetups.push(splitSetup);
+      }
+
+      // Without the atlas there is nothing to draw into (cpp:661-665).
+      const cascadedShadowDepth = shadowMap.PrepareShadowRendering(gpuResourcePool, renderContext);
+      if (!cascadedShadowDepth || !cascadedShadowDepth.IsValid()) return EmptyShadowResources();
+      const allocator = renderContext.GetTriPoolAllocator();
+      for (let frustumIndex = 0; frustumIndex < splitCount; ++frustumIndex) {
+        const batches = this._shadowBatches[frustumIndex];
+        const shadowCasterInfo = [];
+        if (allocator) batches.SetTriPoolAllocator(allocator);
+        for (const caster of shadowCasters) {
+          const radius = [0];
+          if (caster.IsCastingShadow(cameraFrustums[frustumIndex], shadowFrustums[frustumIndex], renderReason, radius)) {
+            shadowCasterInfo.push({
+              radius: radius[0],
+              caster,
+              perObjectData: null
+            });
+          }
+        }
+        for (const info of shadowCasterInfo) info.perObjectData = info.caster.GetShadowPerObjectData(batches);
+        for (const info of shadowCasterInfo) info.caster.GetShadowBatches(batches, info.perObjectData, info.radius);
+        batches.Finalize();
+      }
+      const esm = renderContext.GetEffectStateManager();
+      const shaderTypeMask = renderContext.GetRenderContextAL().constructor.SHADER_TYPE_MASK;
+      const perFrameVsMask = 1 << ShaderType.VERTEX_SHADER | shaderTypeMask & (1 << ShaderType.COMPUTE_SHADER | 1 << ShaderType.GEOMETRY_SHADER | 1 << ShaderType.HULL_SHADER | 1 << ShaderType.DOMAIN_SHADER);
+      renderContext.SetRenderState(RenderState.RS_DEPTH_CLIP_ENABLE, 0);
+      try {
+        for (let splitIndex = 0; splitIndex < splitCount; ++splitIndex) {
+          const batches = this._shadowBatches[splitIndex];
+          if (batches.GetBatchCount() === 0) {
+            batches.Clear();
+            continue;
+          }
+          shadowMap.BeginShadowRendering(renderContext, splitIndex);
+
+          // column_major for shaders: Carbon stores Transpose(lightViewProjection).
+          this._shadowPerFrameVS.SetAndTranspose("ViewProjectionMat", splitSetups[splitIndex].lightViewProjection);
+          this._shadowPerFrameVSBuffer ??= renderContext.CreateConstantBuffer();
+          const data = this._shadowPerFrameVS.GetData();
+          FillAndSetConstants(this._shadowPerFrameVSBuffer, data, data.byteLength, perFrameVsMask, PER_FRAME_VS, renderContext);
+
+          // The atlas is a forward-depth surface cleared to 1 (PrepareShadowRendering).
+          esm.SetInvertedDepthTest(false);
+          try {
+            esm.ApplyStandardStates(RenderingMode.RM_OPAQUE);
+            renderContext.RenderBatches(batches, "Shadow");
+          } finally {
+            esm.SetInvertedDepthTest(true);
+          }
+          batches.Clear();
+        }
+        shadowMap.EndShadowRendering(renderContext);
+      } finally {
+        renderContext.SetRenderState(RenderState.RS_DEPTH_CLIP_ENABLE, 1);
+      }
+      this.PopulatePerFramePSData(renderContext, {}, shadowMap);
+      this.ApplyPerFrameData(renderContext);
+      const result = shadowMap.DrawToShadowMapResult(renderContext, gpuResourcePool, depthMap, cascadedShadowDepth.Get(), this.upscalingAmount, renderer);
+      return {
+        shadowMap: result ?? new GpuResourceHandle(),
+        cascadedShadowDepth,
+        pointLightShadowMap: new GpuResourceHandle(),
+        pointLightShadowDepth: new GpuResourceHandle()
+      };
+    }
+
     /**
      * Carbon EveSpaceScene::ApplyPerFrameData (cpp:818-828): uploads and binds
      * both per-frame blocks. The VERTEX block is bound for every non-pixel