@zephyr3d/editor 0.3.8 → 0.3.9

package/dist/vendor/zephyr3d/scene/dist/camera/camera.js

@@ -4,6 +4,7 @@ import { Compositor } from '../posteffect/compositor.js';
 import { TAA } from '../posteffect/taa.js';
 import { SSR } from '../posteffect/ssr.js';
 import { SSS } from '../posteffect/sss.js';
+import { SkinSSS } from '../posteffect/skinsss.js';
 import { Tonemap } from '../posteffect/tonemap.js';
 import { FXAA } from '../posteffect/fxaa.js';
 import { Bloom } from '../posteffect/bloom.js';
@@ -144,6 +145,13 @@ const SSS_QUALITY_PRESET_SETTINGS = {
     /** @internal SSS multi-scatter energy compensation. */ _sssMultiScatter;
     /** @internal Cached runtime SSS settings after applying the quality preset. */ _sssResolvedSettings;
     /** @internal SSS debug visualization mode. */ _sssDebugView;
+    /** @internal Skin SSS enable flag (via post effect). */ _skinSSS;
+    /** @internal Skin SSS post effect reference. */ _postEffectSkinSSS;
+    /** @internal Skin SSS final blend strength. */ _skinSSSStrength;
+    /** @internal Skin SSS mask opacity bias. */ _skinSSSOpacity;
+    /** @internal Skin SSS blur tap spacing in pixels. */ _skinSSSSampleStep;
+    /** @internal Skin SSS depth rejection scale. */ _skinSSSDepthScale;
+    /** @internal Skin SSS blurred multiplier boost. */ _skinSSSColorBoost;
     /** @internal SSAO enable flag (via post effect). */ _SSAO;
     /** @internal SSAO post effect reference. */ _postEffectSSAO;
     /** @internal SSAO scale (sampling radius multiplier). */ _SSAOScale;
@@ -260,6 +268,13 @@ const SSS_QUALITY_PRESET_SETTINGS = {
         };
         this.updateSSSResolvedSettings();
         this._sssDebugView = 'none';
+        this._skinSSS = false;
+        this._postEffectSkinSSS = new DRef();
+        this._skinSSSStrength = 1;
+        this._skinSSSOpacity = 0.18;
+        this._skinSSSSampleStep = 2;
+        this._skinSSSDepthScale = 80;
+        this._skinSSSColorBoost = 1;
         this._SSAO = false;
         this._postEffectSSAO = new DRef();
         this._SSAOScale = 10;
@@ -712,6 +727,57 @@ const SSS_QUALITY_PRESET_SETTINGS = {
     set sssDebugView(val) {
         this._sssDebugView = val ?? 'none';
     }
+    /** Gets whether the dedicated Skin SSS post effect is enabled. */ get skinSSS() {
+        return this._postEffectSkinSSS.get().enabled;
+    }
+    set skinSSS(val) {
+        this._postEffectSkinSSS.get().enabled = !!val;
+    }
+    /** Final blend strength for the dedicated Skin SSS post effect. */ get skinSSSStrength() {
+        return this._skinSSSStrength;
+    }
+    set skinSSSStrength(val) {
+        this._skinSSSStrength = Math.max(0, val ?? 0);
+        if (this._postEffectSkinSSS.get()) {
+            this._postEffectSkinSSS.get().strength = this._skinSSSStrength;
+        }
+    }
+    /** Bias subtracted from the blurred skin mask before compositing. */ get skinSSSOpacity() {
+        return this._skinSSSOpacity;
+    }
+    set skinSSSOpacity(val) {
+        this._skinSSSOpacity = Math.max(0, Math.min(1, val ?? 0));
+        if (this._postEffectSkinSSS.get()) {
+            this._postEffectSkinSSS.get().opacity = this._skinSSSOpacity;
+        }
+    }
+    /** Pixel spacing between blur taps. The reference shader uses 2. */ get skinSSSSampleStep() {
+        return this._skinSSSSampleStep;
+    }
+    set skinSSSSampleStep(val) {
+        this._skinSSSSampleStep = Math.max(0.25, val ?? 0.25);
+        if (this._postEffectSkinSSS.get()) {
+            this._postEffectSkinSSS.get().sampleStep = this._skinSSSSampleStep;
+        }
+    }
+    /** Depth rejection scale. The reference shader uses 80. */ get skinSSSDepthScale() {
+        return this._skinSSSDepthScale;
+    }
+    set skinSSSDepthScale(val) {
+        this._skinSSSDepthScale = Math.max(0, val ?? 0);
+        if (this._postEffectSkinSSS.get()) {
+            this._postEffectSkinSSS.get().depthScale = this._skinSSSDepthScale;
+        }
+    }
+    /** Multiplier applied to the blurred skin lighting multiplier before compositing. */ get skinSSSColorBoost() {
+        return this._skinSSSColorBoost;
+    }
+    set skinSSSColorBoost(val) {
+        this._skinSSSColorBoost = Math.max(0, val ?? 0);
+        if (this._postEffectSkinSSS.get()) {
+            this._postEffectSkinSSS.get().colorBoost = this._skinSSSColorBoost;
+        }
+    }
     /** @internal */ get ssrParams() {
         return this._ssrParams;
     }
@@ -1124,6 +1190,11 @@ const SSS_QUALITY_PRESET_SETTINGS = {
             }
             Camera._historyData.delete(this);
         }
+        const historyResourceManager = Camera._historyResourceManager.get(this);
+        if (historyResourceManager) {
+            historyResourceManager.dispose();
+            Camera._historyResourceManager.delete(this);
+        }
         this._prevVPMatrix = null;
         this._prevPosition = null;
         this._prevJitteredVPMatrix = null;
@@ -1143,6 +1214,17 @@ const SSS_QUALITY_PRESET_SETTINGS = {
             this._postEffectSSS.set(sss);
             this._compositor.appendPostEffect(sss);
         }
+        if (!this._postEffectSkinSSS.get()) {
+            const skinSSS = new SkinSSS();
+            skinSSS.enabled = false;
+            skinSSS.strength = this._skinSSSStrength;
+            skinSSS.opacity = this._skinSSSOpacity;
+            skinSSS.sampleStep = this._skinSSSSampleStep;
+            skinSSS.depthScale = this._skinSSSDepthScale;
+            skinSSS.colorBoost = this._skinSSSColorBoost;
+            this._postEffectSkinSSS.set(skinSSS);
+            this._compositor.appendPostEffect(skinSSS);
+        }
         if (!this._postEffectSSAO.get()) {
             const ssao = new SAO();
             ssao.enabled = false;
@@ -1338,6 +1420,10 @@ const SSS_QUALITY_PRESET_SETTINGS = {
    *
    * @internal
    */ setHistoryResourceManager(manager) {
+        const current = Camera._historyResourceManager.get(this);
+        if (current && current !== manager) {
+            current.dispose();
+        }
         Camera._historyResourceManager.set(this, manager);
     }
     /** @internal */ setController(controller) {
@@ -1382,6 +1468,7 @@ const SSS_QUALITY_PRESET_SETTINGS = {
         this._postEffectMotionBlur.dispose();
         this._postEffectSSAO.dispose();
         this._postEffectSSS.dispose();
+        this._postEffectSkinSSS.dispose();
         this._postEffectSSR.dispose();
         this._postEffectTAA.dispose();
         this._postEffectTonemap.dispose();