@zephyr3d/scene 0.9.14 → 0.9.16

package/dist/render/rendergraph/forward_plus_builder.js

@@ -33,7 +33,7 @@ const _clusters = [];
 const _devicePoolAllocator = new DevicePoolAllocator();
 let _backDepthColorState = null;
 let _frontDepthColorState = null;
-const SURFACE_MRT_FLAGS = MaterialVaryingFlags.SSR_STORE_ROUGHNESS | MaterialVaryingFlags.SSS_STORE_PROFILE | MaterialVaryingFlags.SSS_STORE_DIFFUSE | MaterialVaryingFlags.SSS_STORE_NORMAL | MaterialVaryingFlags.SSS_STORE_TRANSMISSION;
+const SURFACE_MRT_FLAGS = MaterialVaryingFlags.SSR_STORE_ROUGHNESS | MaterialVaryingFlags.SSS_STORE_PROFILE | MaterialVaryingFlags.SSS_STORE_DIFFUSE | MaterialVaryingFlags.SSS_STORE_NORMAL | MaterialVaryingFlags.SSS_STORE_TRANSMISSION | MaterialVaryingFlags.SKIN_SSS_STORE;
 function getClusteredLight() {
     return _clusters.length > 0 ? _clusters.pop() : new ClusteredLight();
 }
@@ -46,6 +46,9 @@ function getCoreMaterial(material) {
 function hasSSSMaterialCore(material) {
     return !!getCoreMaterial(material)?.subsurfaceProfile;
 }
+function hasSkinSSSMaterialCore(material) {
+    return !!getCoreMaterial(material)?.skinSSS;
+}
 function renderQueueHasActiveSSS(renderQueue) {
     const itemList = renderQueue.itemList;
     if (!itemList) {
@@ -64,6 +67,24 @@ function renderQueueHasActiveSSS(renderQueue) {
     }
     return false;
 }
+function renderQueueHasActiveSkinSSS(renderQueue) {
+    const itemList = renderQueue.itemList;
+    if (!itemList) {
+        return false;
+    }
+    const lists = [
+        ...itemList.opaque.lit,
+        ...itemList.opaque.unlit
+    ];
+    for (const list of lists){
+        for (const material of list.materialList){
+            if (hasSkinSSSMaterialCore(material)) {
+                return true;
+            }
+        }
+    }
+    return false;
+}
 function filterActualSSSItemList(items) {
     return items.filter((item)=>hasSSSMaterialCore(item.drawable.getMaterial?.()));
 }
@@ -185,6 +206,9 @@ function getLightPassColorAttachments(ctx, colorAttachment) {
     if (ctx.materialFlags & MaterialVaryingFlags.SSS_STORE_TRANSMISSION) {
         attachments.push(ctx.SSSTransmissionTexture);
     }
+    if (ctx.materialFlags & MaterialVaryingFlags.SKIN_SSS_STORE) {
+        attachments.push(ctx.SkinSSSTexture);
+    }
     return attachments.length === 1 ? attachments[0] : attachments;
 }
 /**
@@ -193,6 +217,7 @@ function getLightPassColorAttachments(ctx, colorAttachment) {
  */ function deriveForwardPlusOptions(scene, camera, deviceType, renderQueue) {
     const ssr = camera.SSR && scene.env.light.envLight && scene.env.light.envLight.hasRadiance();
     const sss = camera.SSS && renderQueueHasActiveSSS(renderQueue);
+    const skinSSS = camera.skinSSS && renderQueueHasActiveSkinSSS(renderQueue);
     const needSceneColor = renderQueue.needSceneColor();
     const needSceneColorWithDepth = renderQueue.needSceneColorWithDepth();
     return {
@@ -205,12 +230,32 @@ function getLightPassColorAttachments(ctx, colorAttachment) {
         needSceneColor,
         needSceneColorWithDepth,
         needsTransmissionDepthForSSR: !!ssr && needSceneColor && !needSceneColorWithDepth,
-        sss: !!sss
+        sss: !!sss,
+        skinSSS: !!skinSSS
     };
 }
+// ─── Forward+ Graph Builder ─────────────────────────────────────────
+/**
+ * Constructs a render graph representing the forward+ pipeline.
+ *
+ * Each step in the existing `SceneRenderer._renderScene` becomes a graph pass.
+ * Execute callbacks delegate to the existing rendering code, sharing a mutable
+ * `FrameState`.
+ *
+ * @param graph - The render graph to populate.
+ * @param ctx - The draw context for this frame.
+ * @param renderQueue - The culled render queue.
+ * @param options - Pipeline feature toggles.
+ * @returns The backbuffer handle (graph output).
+ *
+ * @public
+ */ function buildForwardPlusGraph(graph, ctx, renderQueue, options) {
+    return buildForwardPlusGraphInternal(graph, ctx, renderQueue, options).backbuffer;
+}
 function buildForwardPlusGraphInternal(graph, ctx, renderQueue, options) {
     const backbuffer = graph.importTexture('backbuffer');
     ctx.SSS = !!options.sss;
+    ctx.SkinSSSTexture = null;
     // Shared mutable frame state
     const frame = {
         ctx,
@@ -330,6 +375,7 @@ function buildForwardPlusGraphInternal(graph, ctx, renderQueue, options) {
     const depthHandle = depthPassResult.depthHandle;
     const motionVectorHandle = depthPassResult.motionVectorHandle;
     const renderDepthAttachment = depthPassResult.graphDepthAttachmentHandle ?? depthPassResult.externalDepthAttachment ?? null;
+    const useFinalFramebufferAsIntermediate = !!depthPassResult.externalDepthAttachment && depthPassResult.externalDepthAttachment === ctx.finalFramebuffer?.getDepthAttachment();
     let preLightTransmissionDepthToken;
     if (options.needsTransmissionDepthForSSR) {
         preLightTransmissionDepthToken = graph.addPass('TransmissionDepthForSSR', (builder)=>{
@@ -516,7 +562,8 @@ function buildForwardPlusGraphInternal(graph, ctx, renderQueue, options) {
         if (writeSSSDiffuse && writeSSSTransmission && includeSSRSurfaceMRT && getSSSLightingTextureFormat(ctx, 2, includeSSRSurfaceMRT) !== ctx.colorFormat) {
             writeSSSTransmission = false;
         }
-        const sssLightingAttachmentCount = (writeSSSDiffuse ? 1 : 0) + (writeSSSTransmission ? 1 : 0);
+        const writeSkinSSS = options.skinSSS;
+        const sssLightingAttachmentCount = (writeSSSDiffuse ? 1 : 0) + (writeSSSTransmission ? 1 : 0) + (writeSkinSSS ? 1 : 0);
         const sssLightingFormat = getSSSLightingTextureFormat(ctx, sssLightingAttachmentCount, includeSSRSurfaceMRT);
         const sssDiffuseHandle = writeSSSDiffuse ? builder.createTexture({
             format: sssLightingFormat,
@@ -526,7 +573,10 @@ function buildForwardPlusGraphInternal(graph, ctx, renderQueue, options) {
             format: sssLightingFormat,
             label: 'sssTransmission'
         }) : undefined;
-        const useFinalFramebufferAsIntermediate = !!depthPassResult.externalDepthAttachment && depthPassResult.externalDepthAttachment === ctx.finalFramebuffer?.getDepthAttachment();
+        const skinSSSHandle = writeSkinSSS ? builder.createTexture({
+            format: sssLightingFormat,
+            label: 'skinSSS'
+        }) : undefined;
         const sceneColorFramebufferHandle = useFinalFramebufferAsIntermediate ? undefined : builder.createFramebuffer({
             label: 'SceneColorFramebuffer',
             width: ctx.renderWidth,
@@ -557,6 +607,7 @@ function buildForwardPlusGraphInternal(graph, ctx, renderQueue, options) {
             }
             ctx.SSSDiffuseTexture = sssDiffuseHandle ? rgCtx.getTexture(sssDiffuseHandle) : null;
             ctx.SSSTransmissionTexture = sssTransmissionHandle ? rgCtx.getTexture(sssTransmissionHandle) : null;
+            ctx.SkinSSSTexture = skinSSSHandle ? rgCtx.getTexture(skinSSSHandle) : null;
             const renderLightPass = ()=>renderMainLightPass(frame, sceneColorTex, sceneColorCopyTex, rgCtx, sceneColorFramebufferHandle, sceneColorCopyFramebufferHandle);
             if (historyManager && lightHistoryReadBindings.length > 0) {
                 historyManager.beginReadScope(lightHistoryReadBindings.map((binding)=>({
@@ -613,19 +664,24 @@ function buildForwardPlusGraphInternal(graph, ctx, renderQueue, options) {
             builder.read(binding.handle);
         }
         const outputBackbuffer = builder.write(backbuffer);
+        const taaHistoryColorHandle = useFinalFramebufferAsIntermediate ? outputBackbuffer : sceneColorHandle;
         builder.setExecute((rgCtx)=>{
+            const renderAndCommitComposite = ()=>{
+                renderComposite(frame);
+                queueTAAHistoryCommit(frame, rgCtx, historyManager, taaHistoryColorHandle, motionVectorHandle);
+            };
             if (historyManager && compositeHistoryReadBindings.length > 0) {
                 historyManager.beginReadScope(compositeHistoryReadBindings.map((binding)=>({
                         name: binding.name,
                         texture: rgCtx.getTexture(binding.handle)
                     })));
                 try {
-                    renderComposite(frame);
+                    renderAndCommitComposite();
                 } finally{
                     historyManager.endReadScope();
                 }
             } else {
-                renderComposite(frame);
+                renderAndCommitComposite();
             }
         });
         return outputBackbuffer;
@@ -684,7 +740,7 @@ function renderForwardSSSProfile(frame, profileFramebuffer, profileTexture, para
         ctx.SSRNormalTexture = normalTexture;
         ctx.compositor = null;
         ctx.camera.commandBufferReuse = false;
-        ctx.materialFlags = ctx.materialFlags & ~(MaterialVaryingFlags.SSR_STORE_ROUGHNESS | MaterialVaryingFlags.SSS_STORE_PROFILE | MaterialVaryingFlags.SSS_STORE_NORMAL | MaterialVaryingFlags.SSS_STORE_DIFFUSE | MaterialVaryingFlags.SSS_STORE_TRANSMISSION) | profileFlags;
+        ctx.materialFlags = ctx.materialFlags & ~(MaterialVaryingFlags.SSR_STORE_ROUGHNESS | MaterialVaryingFlags.SSS_STORE_PROFILE | MaterialVaryingFlags.SSS_STORE_NORMAL | MaterialVaryingFlags.SSS_STORE_DIFFUSE | MaterialVaryingFlags.SSS_STORE_TRANSMISSION | MaterialVaryingFlags.SKIN_SSS_STORE) | profileFlags;
         _scenePass.transmission = false;
         _scenePass.renderOpaque = true;
         _scenePass.renderTransparent = false;
@@ -914,7 +970,7 @@ function blitToCurrentColorAttachment(ctx, source) {
     const device = ctx.device;
     // Use RenderGraph-allocated scene color texture
     const depthTex = frame.depthFramebuffer?.getDepthAttachment();
-    ctx.materialFlags &= ~(MaterialVaryingFlags.SSR_STORE_ROUGHNESS | MaterialVaryingFlags.SSS_STORE_PROFILE | MaterialVaryingFlags.SSS_STORE_DIFFUSE | MaterialVaryingFlags.SSS_STORE_NORMAL | MaterialVaryingFlags.SSS_STORE_TRANSMISSION);
+    ctx.materialFlags &= ~(MaterialVaryingFlags.SSR_STORE_ROUGHNESS | MaterialVaryingFlags.SSS_STORE_PROFILE | MaterialVaryingFlags.SSS_STORE_DIFFUSE | MaterialVaryingFlags.SSS_STORE_NORMAL | MaterialVaryingFlags.SSS_STORE_TRANSMISSION | MaterialVaryingFlags.SKIN_SSS_STORE);
     if (ctx.SSR) {
         ctx.materialFlags |= MaterialVaryingFlags.SSR_STORE_ROUGHNESS;
     }
@@ -926,6 +982,9 @@ function blitToCurrentColorAttachment(ctx, source) {
             ctx.materialFlags |= MaterialVaryingFlags.SSS_STORE_TRANSMISSION;
         }
     }
+    if (ctx.SkinSSSTexture) {
+        ctx.materialFlags |= MaterialVaryingFlags.SKIN_SSS_STORE;
+    }
     if (depthTex === ctx.finalFramebuffer?.getDepthAttachment()) {
         ctx.intermediateFramebuffer = ctx.finalFramebuffer;
     } else if (sceneColorFramebufferHandle && !hasSurfaceMRT(ctx)) {
@@ -1004,6 +1063,34 @@ function blitToCurrentColorAttachment(ctx, source) {
 /** @internal */ function renderTransmissionDepthPass(frame, rgCtx) {
     renderSceneDepth(frame, frame.depthFramebuffer, rgCtx);
 }
+function queueTAAHistoryCommit(frame, rgCtx, historyManager, colorHandle, motionVectorHandle) {
+    const { ctx } = frame;
+    if (!historyManager?.frameActive || !ctx.camera.TAA || !frame.options.motionVectors || !motionVectorHandle) {
+        return;
+    }
+    const colorTexture = rgCtx.getTexture(colorHandle);
+    const colorSize = {
+        width: colorTexture.width,
+        height: colorTexture.height
+    };
+    historyManager.queueRetainedCommit(RGHistoryResources.TAA_COLOR, {
+        format: colorTexture.format,
+        sizeMode: 'absolute',
+        width: colorTexture.width,
+        height: colorTexture.height
+    }, colorSize, colorTexture);
+    const motionVectorTexture = rgCtx.getTexture(motionVectorHandle);
+    const motionVectorSize = {
+        width: motionVectorTexture.width,
+        height: motionVectorTexture.height
+    };
+    historyManager.queueRetainedCommit(RGHistoryResources.TAA_MOTION_VECTOR, {
+        format: motionVectorTexture.format,
+        sizeMode: 'absolute',
+        width: motionVectorTexture.width,
+        height: motionVectorTexture.height
+    }, motionVectorSize, motionVectorTexture);
+}
 /** @internal */ function renderComposite(frame) {
     const { ctx } = frame;
     ctx.compositor?.drawPostEffects(ctx, PostEffectLayer.end, ctx.linearDepthTexture);
@@ -1014,6 +1101,7 @@ function blitToCurrentColorAttachment(ctx, source) {
     ctx.materialFlags &= ~MaterialVaryingFlags.SSS_STORE_DIFFUSE;
     ctx.materialFlags &= ~MaterialVaryingFlags.SSS_STORE_NORMAL;
     ctx.materialFlags &= ~MaterialVaryingFlags.SSS_STORE_TRANSMISSION;
+    ctx.materialFlags &= ~MaterialVaryingFlags.SKIN_SSS_STORE;
     if (ctx.intermediateFramebuffer && ctx.intermediateFramebuffer !== ctx.finalFramebuffer) {
         const blitter = new CopyBlitter();
         blitter.srgbOut = !ctx.finalFramebuffer;
@@ -1082,5 +1170,5 @@ function blitToCurrentColorAttachment(ctx, source) {
     }
 }
 
-export { deriveForwardPlusOptions, executeForwardPlusGraph };
+export { buildForwardPlusGraph, deriveForwardPlusOptions, executeForwardPlusGraph };
 //# sourceMappingURL=forward_plus_builder.js.map