@zephyr3d/scene 0.8.0 → 0.8.1

package/dist/src/shadow/shadowmapper.js

@@ -1,790 +0,0 @@
-import { Matrix4x4, Frustum, Vector3, AABB, Vector4, retainObject, CubeFace } from '@zephyr3d/base';
-import { Camera } from '../camera/camera.js';
-import { SSM } from './ssm.js';
-import { ESM } from './esm.js';
-import { VSM } from './vsm.js';
-import { PCFPD } from './pcf_pd.js';
-import { PCFOPT } from './pcf_opt.js';
-import { Application } from '../app/app.js';
-import { LIGHT_TYPE_NONE, LIGHT_TYPE_DIRECTIONAL, LIGHT_TYPE_POINT } from '../values.js';
-import { ShaderHelper } from '../material/shader/helper.js';
-
-const tmpMatrix = new Matrix4x4();
-const tmpFrustum = new Frustum(Matrix4x4.identity());
-// const zeroPosition = Vector3.zero();
-/**
- * The shadow map generator
- * @public
- */ class ShadowMapper {
-    /** @internal */ static _snapMatrix = new Matrix4x4();
-    /** @internal */ static _target = new Vector3();
-    /** @internal */ static _up = new Vector3();
-    /** @internal */ static _frustumMin = new Vector3();
-    /** @internal */ static _frustumMax = new Vector3();
-    /** @internal */ static _frustumCenter = new Vector3();
-    /** @internal */ static _lightCameras = new WeakMap();
-    /** @internal */ static _shadowMapParams = [];
-    /** @internal */ _light;
-    /** @internal */ _config;
-    /** @internal */ _resourceDirty;
-    /** @internal */ _shadowMode;
-    /** @internal */ _shadowDistance;
-    /** @internal */ _impl;
-    /** @internal */ _pdSampleCount;
-    /** @internal */ _pdSampleRadius;
-    /** @internal */ _pcfKernelSize;
-    /** @internal */ _vsmBlurKernelSize;
-    /** @internal */ _vsmBlurRadius;
-    /** @internal */ _vsmDarkness;
-    /** @internal */ _esmBlur;
-    /** @internal */ _esmBlurKernelSize;
-    /** @internal */ _esmBlurRadius;
-    /** @internal */ _esmDepthScale;
-    /** @internal */ _shadowRegion;
-    /**
-   * Creates an instance of ShadowMapper
-   * @param light - The light that is used to generate shadow map
-   */ constructor(light){
-        this._light = light;
-        this._config = {
-            shadowMapSize: 1024,
-            numCascades: 1,
-            splitLambda: 0.5,
-            depthBias: 0.5,
-            normalBias: 0.2,
-            nearClip: 1
-        };
-        this._resourceDirty = true;
-        this._shadowMode = 'hard';
-        this._shadowDistance = 2000;
-        this._impl = null;
-        this._pdSampleCount = 12;
-        this._pdSampleRadius = 4;
-        this._pcfKernelSize = 5;
-        this._vsmBlurKernelSize = 5;
-        this._vsmBlurRadius = 4;
-        this._vsmDarkness = 0.3;
-        this._esmBlur = true;
-        this._esmBlurKernelSize = 5;
-        this._esmBlurRadius = 4;
-        this._esmDepthScale = 200;
-        this._shadowRegion = null;
-        this.applyMode(this._shadowMode);
-    }
-    copyFrom(other) {
-        this.shadowMapSize = other.shadowMapSize;
-        this.shadowRegion = other.shadowRegion ? new AABB(other.shadowRegion) : null;
-        this.shadowDistance = other.shadowDistance;
-        this.numShadowCascades = other.numShadowCascades;
-        this.splitLambda = other.splitLambda;
-        this.depthBias = other.depthBias;
-        this.normalBias = other.normalBias;
-        this.nearClip = other.nearClip;
-        this.mode = other.mode;
-        this.pdSampleCount = other.pdSampleCount;
-        this.pdSampleRadius = other.pdSampleRadius;
-        this.pcfKernelSize = other.pcfKernelSize;
-        this.vsmBlurKernelSize = other.vsmBlurKernelSize;
-        this.vsmBlurRadius = other.vsmBlurRadius;
-        this.vsmDarkness = other.vsmDarkness;
-        this.esmBlur = other.esmBlur;
-        this.esmBlurKernelSize = other.esmBlurKernelSize;
-        this.esmBlurRadius = other.esmBlurRadius;
-        this.esmDepthScale = other.esmDepthScale;
-    }
-    /** The light that is used to generate shadow map */ get light() {
-        return this._light;
-    }
-    /** Size of the shadow map */ get shadowMapSize() {
-        return this._config.shadowMapSize;
-    }
-    set shadowMapSize(num) {
-        if (!Number.isInteger(num) || num < 1) {
-            console.error(`invalid shadow map size: ${num}`);
-            return;
-        }
-        if (this._config.shadowMapSize !== num) {
-            this._config.shadowMapSize = num;
-            this._resourceDirty = true;
-        }
-    }
-    /** Shadow region for directional light */ get shadowRegion() {
-        return this._shadowRegion;
-    }
-    set shadowRegion(region) {
-        this._shadowRegion = region;
-    }
-    /** Maximum distance from the camera, shadow will not be rendered beyond this range */ get shadowDistance() {
-        return this._shadowDistance;
-    }
-    set shadowDistance(val) {
-        this._shadowDistance = Math.max(0, val);
-    }
-    /** Count of the cascades, The maximum value is 4 */ get numShadowCascades() {
-        return this._config.numCascades;
-    }
-    set numShadowCascades(num) {
-        if (num !== 1 && num !== 2 && num !== 3 && num !== 4) {
-            console.error(`invalid shadow cascade number: ${num}`);
-            return;
-        }
-        if (!this._light.isDirectionLight() && num > 1) {
-            console.error(`only directional light can have more than one shadow cascades`);
-            return;
-        }
-        if (num !== this._config.numCascades) {
-            this._config.numCascades = num;
-            this._resourceDirty = true;
-        }
-    }
-    /** The split lambda for cascaded shadow mapping */ get splitLambda() {
-        return this._config.splitLambda;
-    }
-    set splitLambda(val) {
-        if (this._config.splitLambda !== val) {
-            this._config.splitLambda = val;
-        }
-    }
-    /** Depth bias for the shadow map */ get depthBias() {
-        return this._config.depthBias;
-    }
-    set depthBias(val) {
-        this._config.depthBias = val;
-    }
-    /** Normal bias for the shadow map */ get normalBias() {
-        return this._config.normalBias;
-    }
-    set normalBias(val) {
-        this._config.normalBias = val;
-    }
-    /** Near clip plane */ get nearClip() {
-        return this._config.nearClip;
-    }
-    set nearClip(val) {
-        if (this._config.nearClip !== val) {
-            this._config.nearClip = val;
-        }
-    }
-    /** Shadow map mode */ get mode() {
-        return this._shadowMode;
-    }
-    set mode(mode) {
-        if (mode !== this._shadowMode) {
-            this._shadowMode = mode;
-            this.applyMode(this._shadowMode);
-        }
-    }
-    /** Generated shadow map */ /*
-  get shadowMap(): ShadowMapType {
-    return (this._impl.getShadowMap(this) ?? this._framebuffer?.getColorAttachments()[0] ?? null) as ShadowMapType;
-  }
-  */ /** Sampler of the shadow map */ /*
-  get shadowMapSampler(): TextureSampler {
-    return this._impl.getShadowMapSampler(this);
-  }
-  */ /** @internal */ getShaderHash(shadowMapParams) {
-        return `${shadowMapParams.impl.constructor.name}_${shadowMapParams.impl.getShaderHash()}_${shadowMapParams.lightType}_${shadowMapParams.shadowMap.target}_${Number(shadowMapParams.numShadowCascades > 1)}_${Number(Application.instance.device.getDeviceCaps().textureCaps.getTextureFormatInfo(shadowMapParams.shadowMap.format).filterable)}`;
-    }
-    /** Sample count for poisson disc PCF */ get pdSampleCount() {
-        return this._pdSampleCount;
-    }
-    set pdSampleCount(val) {
-        val = Math.min(Math.max(1, Number(val) >> 0), 64);
-        if (val !== this._pdSampleCount) {
-            this._pdSampleCount = val;
-            const pcfpd = this.asPCFPD();
-            if (pcfpd) {
-                pcfpd.tapCount = this._pdSampleCount;
-            }
-        }
-    }
-    /** Radius for poisson disc PCF */ get pdSampleRadius() {
-        return this._pdSampleRadius;
-    }
-    set pdSampleRadius(val) {
-        val = Math.max(0, Number(val) >> 0);
-        if (val !== this._pdSampleRadius) {
-            this._pdSampleRadius = val;
-            this.asPCFPD()?.setDepthScale(this._pdSampleRadius);
-        }
-    }
-    /** Kernel size for optimized PCF */ get pcfKernelSize() {
-        return this._pcfKernelSize;
-    }
-    set pcfKernelSize(val) {
-        val = val !== 3 && val !== 5 && val !== 7 ? 5 : val;
-        if (val !== this._pcfKernelSize) {
-            this._pcfKernelSize = val;
-            const pcfopt = this.asPCFOPT();
-            if (pcfopt) {
-                pcfopt.kernelSize = this._pcfKernelSize;
-            }
-        }
-    }
-    /** Kernel size of VSM */ get vsmBlurKernelSize() {
-        return this._vsmBlurKernelSize;
-    }
-    set vsmBlurKernelSize(val) {
-        val = Math.max(3, Number(val) >> 0) | 1;
-        if (val !== this._vsmBlurKernelSize) {
-            this._vsmBlurKernelSize = val;
-            const vsm = this.asVSM();
-            if (vsm) {
-                vsm.kernelSize = this._vsmBlurKernelSize;
-            }
-        }
-    }
-    /** Blur radius for VSM */ get vsmBlurRadius() {
-        return this._vsmBlurRadius;
-    }
-    set vsmBlurRadius(val) {
-        val = Math.max(0, Number(val) || 0);
-        if (val !== this._vsmBlurRadius) {
-            this._vsmBlurRadius = val;
-            const vsm = this.asVSM();
-            if (vsm) {
-                vsm.blurSize = this._vsmBlurRadius;
-            }
-        }
-    }
-    /** Darkness for VSM */ get vsmDarkness() {
-        return this._vsmDarkness;
-    }
-    set vsmDarkness(val) {
-        val = Math.min(0.999, Math.max(0, Number(val) || 0));
-        if (val !== this._vsmDarkness) {
-            this._vsmDarkness = val;
-            this.asVSM()?.setDepthScale(this._vsmDarkness);
-        }
-    }
-    /** Whether to enable ESM blur */ get esmBlur() {
-        return this._esmBlur;
-    }
-    set esmBlur(val) {
-        if (!!val !== this.esmBlur) {
-            this._esmBlur = !!val;
-            const esm = this.asESM();
-            if (esm) {
-                esm.blur = this._esmBlur;
-            }
-        }
-    }
-    /** Kernel size for ESM */ get esmBlurKernelSize() {
-        return this._esmBlurKernelSize;
-    }
-    set esmBlurKernelSize(val) {
-        val = Math.max(3, Number(val) >> 0) | 1;
-        if (val !== this._esmBlurKernelSize) {
-            this._esmBlurKernelSize = val;
-            const esm = this.asESM();
-            if (esm) {
-                esm.kernelSize = this._esmBlurKernelSize;
-            }
-        }
-    }
-    /** Blur radius for ESM */ get esmBlurRadius() {
-        return this._esmBlurRadius;
-    }
-    set esmBlurRadius(val) {
-        val = Math.max(0, Number(val) || 0);
-        if (val !== this._esmBlurRadius) {
-            this._esmBlurRadius = val;
-            const esm = this.asESM();
-            if (esm) {
-                esm.blurSize = this._esmBlurRadius;
-            }
-        }
-    }
-    /** Depth scale for ESM */ get esmDepthScale() {
-        return this._esmDepthScale;
-    }
-    set esmDepthScale(val) {
-        val = Math.max(0, Number(val) || 0);
-        if (val !== this._esmDepthScale) {
-            this._esmDepthScale = val;
-            this.asESM()?.setDepthScale(this._esmDepthScale);
-        }
-    }
-    /** @internal */ computeShadow(shadowMapParams, scope, shadowVertex, NdotL) {
-        return this._impl.computeShadow(shadowMapParams, scope, shadowVertex, NdotL);
-    }
-    /** @internal */ computeShadowCSM(shadowMapParams, scope, shadowVertex, NdotL, split) {
-        return this._impl.computeShadowCSM(shadowMapParams, scope, shadowVertex, NdotL, split);
-    }
-    /** @internal */ static releaseTemporalResources(ctx) {
-        if (ctx.shadowMapInfo) {
-            for (const k of ctx.shadowMapInfo.keys()){
-                const shadowMapParams = ctx.shadowMapInfo.get(k);
-                //ctx.device.pool.releaseFrameBuffer(shadowMapParams.shadowMapFramebuffer);
-                shadowMapParams.lightType = LIGHT_TYPE_NONE;
-                shadowMapParams.depthClampEnabled = false;
-                shadowMapParams.shaderHash = '';
-                shadowMapParams.numShadowCascades = 1;
-                shadowMapParams.shadowMapFramebuffer = null;
-                shadowMapParams.impl = null;
-                shadowMapParams.shadowMap = null;
-                shadowMapParams.shadowMapSampler = null;
-                shadowMapParams.implData = null;
-                this._shadowMapParams.push(shadowMapParams);
-            }
-            ctx.shadowMapInfo = null;
-        }
-    }
-    /** @internal */ static computeShadowBias(shadowMapParams, scope, z, NdotL, linear) {
-        const pb = scope.$builder;
-        const depthBiasParam = ShaderHelper.getDepthBiasValues(scope);
-        if (shadowMapParams.lightType === LIGHT_TYPE_DIRECTIONAL) {
-            return pb.dot(pb.mul(depthBiasParam.xy, pb.vec2(1, pb.sub(1, NdotL))), pb.vec2(1, 1));
-        } else {
-            const nearFar = ShaderHelper.getShadowCameraParams(scope).xy;
-            const linearDepth = linear ? z : ShaderHelper.nonLinearDepthToLinearNormalized(scope, z, nearFar);
-            const biasScaleFactor = pb.mix(1, depthBiasParam.w, linearDepth);
-            return pb.dot(pb.mul(depthBiasParam.xy, pb.vec2(1, pb.sub(1, NdotL)), biasScaleFactor), pb.vec2(1, 1));
-        }
-    }
-    /** @internal */ static computeShadowBiasCSM(shadowMapParams, scope, NdotL, split) {
-        const pb = scope.$builder;
-        const depthBiasParam = ShaderHelper.getDepthBiasValues(scope);
-        const splitFlags = pb.vec4(pb.float(pb.equal(split, 0)), pb.float(pb.equal(split, 1)), pb.float(pb.equal(split, 2)), pb.float(pb.equal(split, 3)));
-        const depthBiasScale = pb.dot(ShaderHelper.getDepthBiasScales(scope), splitFlags);
-        return pb.dot(pb.mul(depthBiasParam.xy, pb.vec2(1, pb.sub(1, NdotL)), depthBiasScale), pb.vec2(1, 1));
-    }
-    /** @internal */ isTextureInvalid(texture, target, format, width, height) {
-        return texture && (texture.target !== target || texture.format !== format || texture.width !== width || texture.height !== height || texture.depth !== this.numShadowCascades);
-    }
-    /** @internal */ createTexture(target, format, width, height, depth) {
-        const device = Application.instance.device;
-        const options = {
-            samplerOptions: {
-                mipFilter: 'none'
-            }
-        };
-        switch(target){
-            case '2d':
-                return device.createTexture2D(format, width, height, options);
-            case 'cube':
-                return device.createCubeTexture(format, width, options);
-            case '2darray':
-                return device.createTexture2DArray(format, width, height, depth, options);
-            default:
-                return null;
-        }
-    }
-    /** @internal */ static fetchTemporalFramebuffer(autoRelease, lightType, numCascades, width, height, colorFormat, depthFormat, mipmapping) {
-        const device = Application.instance.device;
-        const useTextureArray = numCascades > 1 && device.type !== 'webgl';
-        const colorAttachments = colorFormat ? useTextureArray ? [
-            device.pool.fetchTemporalTexture2DArray(false, colorFormat, width, height, numCascades, mipmapping)
-        ] : lightType === LIGHT_TYPE_POINT ? [
-            device.pool.fetchTemporalTextureCube(false, colorFormat, width, mipmapping)
-        ] : [
-            device.pool.fetchTemporalTexture2D(false, colorFormat, width, height, mipmapping)
-        ] : null;
-        const depthAttachment = depthFormat ? useTextureArray ? device.pool.fetchTemporalTexture2DArray(false, depthFormat, width, height, numCascades, false) : device.type !== 'webgl' && lightType === LIGHT_TYPE_POINT ? device.pool.fetchTemporalTextureCube(false, depthFormat, width, false) : device.pool.fetchTemporalTexture2D(false, depthFormat, width, height, false) : null;
-        const fb = device.pool.createTemporalFramebuffer(autoRelease, colorAttachments, depthAttachment);
-        if (colorAttachments) {
-            device.pool.releaseTexture(colorAttachments[0]);
-        }
-        if (depthAttachment) {
-            device.pool.releaseTexture(depthAttachment);
-        }
-        return fb;
-    }
-    /** @internal */ updateResources(shadowMapParams) {
-        const device = Application.instance.device;
-        const colorFormat = shadowMapParams.impl.getShadowMapColorFormat(shadowMapParams);
-        const depthFormat = shadowMapParams.impl.getShadowMapDepthFormat(shadowMapParams);
-        const numCascades = shadowMapParams.numShadowCascades;
-        const useTextureArray = numCascades > 1 && device.type !== 'webgl';
-        const shadowMapWidth = numCascades > 1 && !useTextureArray ? 2 * this._config.shadowMapSize : this._config.shadowMapSize;
-        const shadowMapHeight = numCascades > 2 && !useTextureArray ? 2 * this._config.shadowMapSize : this._config.shadowMapSize;
-        /*
-    const colorAttachments = colorFormat
-      ? useTextureArray
-        ? [device.pool.fetchTemporalTexture2DArray(false, colorFormat, shadowMapWidth, shadowMapHeight, numCascades, false)]
-        : this._light.isPointLight()
-          ? [device.pool.fetchTemporalTextureCube(false, colorFormat, shadowMapWidth, false)]
-          : [device.pool.fetchTemporalTexture2D(false, colorFormat, shadowMapWidth, shadowMapHeight, false)]
-      : null;
-    const depthAttachment = depthFormat
-      ? useTextureArray
-        ? device.pool.fetchTemporalTexture2DArray(false, depthFormat, shadowMapWidth, shadowMapHeight, numCascades, false)
-        : device.type !== 'webgl' && this._light.isPointLight()
-          ? device.pool.fetchTemporalTextureCube(false, depthFormat, shadowMapWidth, false)
-          : device.pool.fetchTemporalTexture2D(false, depthFormat, shadowMapWidth, shadowMapHeight, false)
-      : null;
-    shadowMapParams.shadowMapFramebuffer = device.pool.createTemporalFramebuffer(false, colorAttachments, depthAttachment);
-    if (colorAttachments) {
-      device.pool.releaseTexture(colorAttachments[0]);
-    }
-    if (depthAttachment) {
-      device.pool.releaseTexture(depthAttachment);
-    }
-    */ shadowMapParams.shadowMapFramebuffer = ShadowMapper.fetchTemporalFramebuffer(true, this._light.lightType, numCascades, shadowMapWidth, shadowMapHeight, colorFormat, depthFormat);
-        shadowMapParams.impl = this._impl;
-        this._impl.updateResources(shadowMapParams);
-    }
-    /** @internal */ createLightCameraPoint(lightCamera) {
-        //lightCamera.reparent(this._light);
-        lightCamera.parent = lightCamera.scene.rootNode;
-        lightCamera.position.setXYZ(0, 0, 0);
-        lightCamera.rotation.identity();
-        lightCamera.scale.setXYZ(1, 1, 1);
-        lightCamera.setPerspective(Math.PI / 2, 1, this._config.nearClip, Math.min(this._shadowDistance, this._light.range));
-        lightCamera.position.set(this._light.positionAndRange.xyz());
-    }
-    /** @internal */ createLightCameraSpot(lightCamera) {
-        lightCamera.parent = this._light;
-        lightCamera.position.setXYZ(0, 0, 0);
-        lightCamera.rotation.identity();
-        lightCamera.scale.setXYZ(1, 1, 1);
-        lightCamera.setPerspective(2 * this._light.cutoff, 1, this._config.nearClip, Math.min((this._shadowDistance, this._light).range));
-    }
-    /** @internal */ createLightCameraDirectional(sceneAABB, sceneCamera, lightCamera, cropMatrix, border) {
-        let frustum = sceneCamera.frustumViewSpace;
-        if (this._shadowDistance < sceneCamera.getFarPlane()) {
-            tmpMatrix.set(sceneCamera.getProjectionMatrix());
-            tmpMatrix.setNearFar(tmpMatrix.getNearPlane(), this._shadowDistance);
-            //tmpMatrix.multiplyRight(sceneCamera.viewMatrix);
-            tmpFrustum.initWithMatrix(tmpMatrix);
-            frustum = tmpFrustum;
-        }
-        border = border || 0;
-        const expand = (this.shadowMapSize - 2 * border) / this.shadowMapSize;
-        //const frustum = sceneCamera.frustum;
-        const frustumMin = ShadowMapper._frustumMin;
-        const frustumMax = ShadowMapper._frustumMax;
-        const frustumCenter = ShadowMapper._frustumCenter;
-        const target = ShadowMapper._target;
-        const up = ShadowMapper._up;
-        // const frustum = new Frustum(sceneCamera.viewProjectionMatrix);
-        frustumMin.setXYZ(Number.MAX_VALUE, Number.MAX_VALUE, Number.MAX_VALUE);
-        frustumMax.setXYZ(-Number.MAX_VALUE, -Number.MAX_VALUE, -Number.MAX_VALUE);
-        frustum.corners.forEach((p)=>{
-            frustumMin.inplaceMin(p);
-            frustumMax.inplaceMax(p);
-        });
-        let radius = Vector3.distance(frustumMin, frustumMax) * 0.5 * expand;
-        const center = sceneCamera.thisToWorld(Vector3.add(frustumMin, frustumMax, frustumCenter).scaleBy(0.5), frustumCenter);
-        // Bounding sphere of the shadow camera should not be larger than bounding sphere of the scene.
-        const sceneRadius = sceneAABB.diagonalLength * 0.5 * expand;
-        if (sceneRadius < radius) {
-            radius = sceneRadius;
-            Vector3.add(sceneAABB.minPoint, sceneAABB.maxPoint, center).scaleBy(0.5);
-        }
-        target.setXYZ(center.x + this._light.directionAndCutoff.x, center.y + this._light.directionAndCutoff.y, center.z + this._light.directionAndCutoff.z);
-        up.setXYZ(0, 1, 0);
-        lightCamera.lookAt(center, target, up);
-        lightCamera.position.set(center);
-        lightCamera.setOrtho(-radius, radius, -radius, radius, -radius, Math.max(Vector3.distance(center, sceneCamera.getWorldPosition()), sceneCamera.getFarPlane()));
-        center.setXYZ(0, 0, 0);
-        lightCamera.viewProjectionMatrix.transformPointP(center, center);
-        if (cropMatrix) {
-            const tx = center.x * this.shadowMapSize * 0.5;
-            const ty = center.y * this.shadowMapSize * 0.5;
-            const rx = Math.round(tx);
-            const ry = Math.round(ty);
-            center.setXYZ((rx - tx) * 2 / this.shadowMapSize, (ry - ty) * 2 / this.shadowMapSize, 0);
-            cropMatrix.translation(center);
-        }
-    /*
-    const minx = frustumMin.x;
-    const maxx = frustumMax.x;
-    const miny = frustumMin.y;
-    const maxy = frustumMax.y;
-    const minz = frustumMin.z;
-    const maxz = frustumMax.z;
-    const texelSizeW = (maxx - minx) / this.shadowMapSize;
-    const texelSizeH = (maxy - miny) / this.shadowMapSize;
-    const cx = Math.floor((minx + maxx) / 2 / texelSizeW) * texelSizeW;
-    const cy = Math.floor((miny + maxy) / 2 / texelSizeH) * texelSizeH;
-    const cz = (minz + maxz) / 2;
-    const hx = Math.floor(((maxx - minx) * (expand + 0.5)) / texelSizeW) * texelSizeW;
-    const hy = Math.floor(((maxy - miny) * (expand + 0.5)) / texelSizeH) * texelSizeH;
-    lightCamera.position.setXYZ(cx, cy, cz);
-    lightCamera.setOrtho(
-      -hx,
-      hx,
-      -hy,
-      hy,
-      sceneMax.z - maxz,
-      sceneMax.z - minz + 1
-    );
-    if (cropMatrix) {
-      // compute crop matrix
-      let clipMaxX = 0,
-        clipMaxY = 0;
-      let clipMinX = Number.MAX_VALUE,
-        clipMinY = Number.MAX_VALUE;
-      frustum.corners.forEach((p) => {
-        const clipPos = lightCamera.viewProjectionMatrix.transformPoint(p);
-        clipPos.x = Math.min(1, Math.max(-1, clipPos.x / clipPos.w));
-        clipPos.y = Math.min(1, Math.max(-1, clipPos.y / clipPos.w));
-        if (clipPos.x > clipMaxX) {
-          clipMaxX = clipPos.x;
-        }
-        if (clipPos.x < clipMinX) {
-          clipMinX = clipPos.x;
-        }
-        if (clipPos.y > clipMaxY) {
-          clipMaxY = clipPos.y;
-        }
-        if (clipPos.y < clipMinY) {
-          clipMinY = clipPos.y;
-        }
-      });
-      const clipW = clipMaxX - clipMinX;
-      const clipH = clipMaxY - clipMinY;
-      clipMinX -= expand * clipW;
-      clipMinY -= expand * clipH;
-      clipMaxX += expand * clipW;
-      clipMaxY += expand * clipH;
-      const scaleX = 2 / (clipMaxX - clipMinX);
-      const scaleY = 2 / (clipMaxY - clipMinY);
-      const offsetX = -0.5 * (clipMaxX + clipMinX) * scaleX;
-      const offsetY = -0.5 * (clipMaxY + clipMinY) * scaleY;
-      cropMatrix.identity();
-      cropMatrix.m00 = scaleX;
-      cropMatrix.m11 = scaleY;
-      cropMatrix.m03 = offsetX;
-      cropMatrix.m13 = offsetY;
-    }
-    */ }
-    /** @internal */ static fetchShadowMapParams() {
-        if (this._shadowMapParams.length > 0) {
-            return this._shadowMapParams.pop();
-        } else {
-            return {
-                lightType: LIGHT_TYPE_NONE,
-                depthClampEnabled: false,
-                shaderHash: '',
-                cameraParams: new Vector4(),
-                cascadeDistances: new Vector4(),
-                depthBiasScales: new Vector4(),
-                depthBiasValues: [
-                    new Vector4(),
-                    new Vector4(),
-                    new Vector4(),
-                    new Vector4()
-                ],
-                numShadowCascades: 1,
-                shadowMatrices: new Float32Array(16 * 4),
-                shadowMap: null,
-                shadowMapSampler: null,
-                shadowMapFramebuffer: null,
-                impl: null,
-                implData: null
-            };
-        }
-    }
-    /** @internal */ static fetchCameraForScene(scene) {
-        const cameras = this._lightCameras.get(scene);
-        if (!cameras || cameras.length === 0) {
-            const camera = new Camera(scene);
-            retainObject(camera);
-            return camera;
-        } else {
-            const camera = cameras.pop();
-            camera.parent = scene.rootNode;
-            camera.position.setXYZ(0, 0, 0);
-            camera.rotation.identity();
-            camera.scale.setXYZ(1, 1, 1);
-            camera.clipMask = 0;
-            return camera;
-        }
-    }
-    /** @internal */ static releaseCamera(camera) {
-        let cameras = this._lightCameras.get(camera.scene);
-        if (!cameras) {
-            cameras = [];
-            this._lightCameras.set(camera.scene, cameras);
-        }
-        camera.remove();
-        cameras.push(camera);
-    }
-    /** @internal */ calcSplitDistances(nearPlane, farPlane, numCascades) {
-        const result = [
-            0,
-            0,
-            0,
-            0,
-            0
-        ];
-        for(let i = 0; i <= numCascades; ++i){
-            const fIDM = i / numCascades;
-            const fLog = nearPlane * Math.pow(farPlane / nearPlane, fIDM);
-            const fUniform = nearPlane + (farPlane - nearPlane) * fIDM;
-            result[i] = fLog * this._config.splitLambda + fUniform * (1 - this._config.splitLambda);
-        }
-        return result;
-    }
-    /** @internal */ calcDepthBiasParams(camera, shadowMapSize, depthBias, normalBias, depthScale, result) {
-        const sizeNear = Math.min(camera.getProjectionMatrix().getNearPlaneWidth(), camera.getProjectionMatrix().getNearPlaneHeight());
-        const sizeFar = Math.min(camera.getProjectionMatrix().getFarPlaneWidth(), camera.getProjectionMatrix().getFarPlaneHeight());
-        const scaleFactor = sizeNear / shadowMapSize * 2;
-        result.setXYZW(depthBias * scaleFactor, normalBias * 0.0001, depthScale, sizeFar / sizeNear);
-    }
-    /** @internal */ postRenderShadowMap(shadowMapParams) {
-        this._impl.postRenderShadowMap(shadowMapParams);
-    }
-    /** @internal */ render(ctx, renderPass) {
-        if (!ctx.shadowMapInfo) {
-            ctx.shadowMapInfo = new Map();
-        }
-        const shadowMapParams = ShadowMapper.fetchShadowMapParams();
-        shadowMapParams.impl = this._impl;
-        shadowMapParams.lightType = this.light.lightType;
-        shadowMapParams.numShadowCascades = shadowMapParams.lightType === LIGHT_TYPE_DIRECTIONAL ? this._config.numCascades : 1;
-        ctx.shadowMapInfo.set(this.light, shadowMapParams);
-        const scene = ctx.scene;
-        const camera = ctx.camera;
-        renderPass.light = this._light;
-        this.updateResources(shadowMapParams);
-        shadowMapParams.shaderHash = this.getShaderHash(shadowMapParams);
-        const device = Application.instance.device;
-        const fb = shadowMapParams.shadowMapFramebuffer;
-        shadowMapParams.depthClampEnabled = false;
-        renderPass.clearColor = fb.getColorAttachments()[0] ? fb.getColorAttachments()[0].isFloatFormat() ? new Vector4(1, 1, 1, 1) : new Vector4(0, 0, 0, 1) : null;
-        const depthScale = this._impl.getDepthScale();
-        const shadowRegion = this._light.isDirectionLight() && this._shadowRegion && this._shadowRegion.isValid() ? this._shadowRegion : scene.boundingBox;
-        if (this._light.isPointLight()) {
-            const shadowMapRenderCamera = ShadowMapper.fetchCameraForScene(scene);
-            this.createLightCameraPoint(shadowMapRenderCamera);
-            this.calcDepthBiasParams(camera, this._config.shadowMapSize, this._config.depthBias, this._config.normalBias, depthScale, shadowMapParams.depthBiasValues[0]);
-            shadowMapParams.cameraParams.setXYZW(shadowMapRenderCamera.getNearPlane(), shadowMapRenderCamera.getFarPlane(), this._config.shadowMapSize, this._shadowDistance);
-            device.setFramebuffer(fb);
-            shadowMapParams.shadowMatrices.set(Matrix4x4.transpose(shadowMapRenderCamera.viewMatrix));
-            for (const face of [
-                CubeFace.PX,
-                CubeFace.NX,
-                CubeFace.PY,
-                CubeFace.NY,
-                CubeFace.PZ,
-                CubeFace.NZ
-            ]){
-                shadowMapRenderCamera.lookAtCubeFace(face);
-                fb.setColorAttachmentCubeFace(0, face);
-                fb.setDepthAttachmentCubeFace(face);
-                ctx.camera = shadowMapRenderCamera;
-                renderPass.render(ctx);
-            }
-            shadowMapParams.shadowMatrices.set(Matrix4x4.identity());
-            ShadowMapper.releaseCamera(shadowMapRenderCamera);
-        } else {
-            if (this._config.numCascades > 1) {
-                const distances = this.calcSplitDistances(camera.getNearPlane(), Math.min(this._shadowDistance, camera.getFarPlane()), this._config.numCascades);
-                const cascadeCamera = ShadowMapper.fetchCameraForScene(scene);
-                const shadowMapRenderCamera = ShadowMapper.fetchCameraForScene(scene);
-                const shadowMapCullCamera = ShadowMapper.fetchCameraForScene(scene);
-                shadowMapCullCamera.clipMask = AABB.ClipLeft | AABB.ClipRight | AABB.ClipBottom | AABB.ClipTop;
-                cascadeCamera.parent = camera;
-                shadowMapParams.depthClampEnabled = Application.instance.device.getDeviceCaps().shaderCaps.supportFragmentDepth;
-                for(let split = 0; split < this._config.numCascades; split++){
-                    cascadeCamera.setPerspective(camera.getFOV(), camera.getAspect(), distances[split], distances[split + 1]);
-                    const snapMatrix = ShadowMapper._snapMatrix;
-                    const border = shadowMapParams.impl.getShadowMapBorder(shadowMapParams); //20 / this._config.shadowMapSize;
-                    this.createLightCameraDirectional(shadowRegion, cascadeCamera, shadowMapRenderCamera, snapMatrix, border);
-                    this.createLightCameraDirectional(shadowRegion, cascadeCamera, shadowMapCullCamera, null, border);
-                    this.calcDepthBiasParams(camera, this._config.shadowMapSize, this._config.depthBias, this._config.normalBias, depthScale, shadowMapParams.depthBiasValues[split]);
-                    shadowMapParams.depthBiasScales[split] = 1;
-                    // Incorrect calculation
-                    // shadowMapParams.depthBiasScales[split] = shadowMapParams.depthBiasValues[0].x !== 0 ? shadowMapParams.depthBiasValues[split].x / shadowMapParams.depthBiasValues[0].x : 1;
-                    shadowMapParams.cameraParams.setXYZW(shadowMapRenderCamera.getNearPlane(), shadowMapRenderCamera.getFarPlane(), this._config.shadowMapSize, this._shadowDistance);
-                    let scissor = null;
-                    if (fb.getColorAttachments()[0]?.isTexture2DArray() || fb.getDepthAttachment()?.isTexture2DArray()) {
-                        shadowMapRenderCamera.setProjectionMatrix(Matrix4x4.multiply(snapMatrix, shadowMapRenderCamera.getProjectionMatrix()));
-                        fb.setColorAttachmentLayer(0, split);
-                        fb.setDepthAttachmentLayer(split);
-                    } else {
-                        const numRows = this._config.numCascades > 2 ? 2 : 1;
-                        const numCols = this._config.numCascades > 1 ? 2 : 1;
-                        const adjMatrix = new Matrix4x4();
-                        const col = split % 2;
-                        const row = split >> 1;
-                        adjMatrix.setRowXYZW(0, 1.5 - 0.5 * numCols, 0, 0, 0);
-                        adjMatrix.setRowXYZW(1, 0, 1.5 - 0.5 * numRows, 0, 0);
-                        adjMatrix.setRowXYZW(2, 0, 0, 1, 0);
-                        adjMatrix.setRowXYZW(3, col - 0.5 * numCols + 0.5, row - 0.5 * numRows + 0.5, 0, 1);
-                        shadowMapRenderCamera.setProjectionMatrix(Matrix4x4.multiply(adjMatrix, Matrix4x4.multiply(snapMatrix, shadowMapRenderCamera.getProjectionMatrix())));
-                        if (device.type === 'webgpu') {
-                            scissor = [
-                                col * this._config.shadowMapSize,
-                                (numRows - 1 - row) * this._config.shadowMapSize,
-                                this._config.shadowMapSize,
-                                this._config.shadowMapSize
-                            ];
-                        } else {
-                            scissor = [
-                                col * this._config.shadowMapSize,
-                                row * this._config.shadowMapSize,
-                                this._config.shadowMapSize,
-                                this._config.shadowMapSize
-                            ];
-                        }
-                    }
-                    device.setFramebuffer(fb);
-                    device.setScissor(scissor);
-                    ctx.camera = shadowMapRenderCamera;
-                    renderPass.render(ctx, shadowMapCullCamera);
-                    shadowMapParams.shadowMatrices.set(Matrix4x4.transpose(shadowMapRenderCamera.viewProjectionMatrix), split * 16);
-                    shadowMapParams.cascadeDistances[split] = distances[split + 1];
-                }
-                ShadowMapper.releaseCamera(cascadeCamera);
-                ShadowMapper.releaseCamera(shadowMapRenderCamera);
-                ShadowMapper.releaseCamera(shadowMapCullCamera);
-            } else {
-                const shadowMapRenderCamera = ShadowMapper.fetchCameraForScene(scene);
-                const snapMatrix = ShadowMapper._snapMatrix;
-                shadowMapRenderCamera.clipMask = AABB.ClipLeft | AABB.ClipRight | AABB.ClipBottom | AABB.ClipTop;
-                if (this._light.isDirectionLight()) {
-                    this.createLightCameraDirectional(shadowRegion, camera, shadowMapRenderCamera, snapMatrix, shadowMapParams.impl.getShadowMapBorder(shadowMapParams));
-                } else {
-                    this.createLightCameraSpot(shadowMapRenderCamera);
-                }
-                this.calcDepthBiasParams(camera, this._config.shadowMapSize, this._config.depthBias, this._config.normalBias, depthScale, shadowMapParams.depthBiasValues[0]);
-                shadowMapParams.cameraParams.setXYZW(shadowMapRenderCamera.getNearPlane(), shadowMapRenderCamera.getFarPlane(), this._config.shadowMapSize, this._shadowDistance);
-                device.setFramebuffer(fb);
-                shadowMapRenderCamera.setProjectionMatrix(Matrix4x4.multiply(snapMatrix, shadowMapRenderCamera.getProjectionMatrix()));
-                ctx.camera = shadowMapRenderCamera;
-                renderPass.render(ctx);
-                shadowMapParams.shadowMatrices.set(Matrix4x4.transpose(shadowMapRenderCamera.viewProjectionMatrix));
-                ShadowMapper.releaseCamera(shadowMapRenderCamera);
-            }
-        }
-        ctx.camera = camera;
-        this.postRenderShadowMap(shadowMapParams);
-    }
-    /** @internal */ applyMode(mode) {
-        if (mode !== 'hard' && mode !== 'vsm' && mode !== 'esm' && mode !== 'pcf-pd' && mode !== 'pcf-opt') {
-            console.error(`ShadowMapper.setShadowMode() failed: invalid mode: ${mode}`);
-            return;
-        }
-        this._impl = null;
-        if (mode === 'hard') {
-            this._impl = new SSM();
-        } else if (mode === 'vsm') {
-            this._impl = new VSM(this._vsmBlurKernelSize, this._vsmBlurRadius, this._vsmDarkness);
-        } else if (mode === 'esm') {
-            this._impl = new ESM(this._esmBlurKernelSize, this._esmBlurRadius, this._esmDepthScale);
-        } else if (mode === 'pcf-pd') {
-            this._impl = new PCFPD(this._pdSampleCount, this._pdSampleRadius);
-        } else if (mode === 'pcf-opt') {
-            this._impl = new PCFOPT(this._pcfKernelSize);
-        }
-    }
-    /** @internal */ asVSM() {
-        return this._impl?.getType() === 'vsm' ? this._impl : null;
-    }
-    /** @internal */ asESM() {
-        return this._impl?.getType() === 'esm' ? this._impl : null;
-    }
-    /** @internal */ asPCFPD() {
-        return this._impl?.getType() === 'pcf-pd' ? this._impl : null;
-    }
-    /** @internal */ asPCFOPT() {
-        return this._impl?.getType() === 'pcf-opt' ? this._impl : null;
-    }
-}
-
-export { ShadowMapper };
-//# sourceMappingURL=shadowmapper.js.map