babylonjs-editor-tools 5.5.0 → 5.5.1-alpha.0

package/build/src/rendering/volumetric/shaders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shaders.js","sourceRoot":"","sources":["../../../../src/rendering/volumetric/shaders.ts"],"names":[],"mappings":"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"}

package/build/src/rendering/volumetric/types.js

@@ -0,0 +1,301 @@
+/**
+ * Defines the key used to store the per-light volumetric lighting configuration in the metadata of a light.
+ * Storing the configuration in the metadata of the light is what makes it survive the save/load round trip
+ * for free (metadata is serialized by "Light.serialize" and restored by "Light.Parse") including for lights
+ * that live inside a clustered light container and are, as a result, not part of "scene.lights" anymore.
+ */
+export const volumetricLightMetadataKey = "volumetricLighting";
+/**
+ * Defines the maximum number of shadowed lights the raymarching shader can be compiled for.
+ * The effective count is computed at runtime from the capabilities of the engine.
+ */
+export const maxVolumetricShadowSlots = 8;
+/**
+ * Defines the maximum number of unshadowed lights the raymarching shader can be compiled for.
+ * The effective count is computed at runtime from the capabilities of the engine.
+ */
+export const maxVolumetricArrayLights = 256;
+/**
+ * Defines the maximum number of unshadowed directional lights the raymarching shader evaluates. Unlike the
+ * point and spot lights, a directional light lights the whole view ray, so each one costs a full march.
+ */
+export const maxVolumetricDirectionalLights = 4;
+/**
+ * Defines the available step distributions used while raymarching the participating medium.
+ */
+export var VolumetricStepDistribution;
+(function (VolumetricStepDistribution) {
+    /**
+     * All steps have the same length. Gives the best results for a medium that is mostly uniform.
+     */
+    VolumetricStepDistribution[VolumetricStepDistribution["Linear"] = 0] = "Linear";
+    /**
+     * Steps grow exponentially with the distance to the camera. Gives more precision near the camera
+     * where the perspective projection makes artifacts the most visible.
+     */
+    VolumetricStepDistribution[VolumetricStepDistribution["Exponential"] = 1] = "Exponential";
+})(VolumetricStepDistribution || (VolumetricStepDistribution = {}));
+/**
+ * Defines the available dithering modes used to hide the banding produced by a low step count.
+ */
+export var VolumetricDitherMode;
+(function (VolumetricDitherMode) {
+    /**
+     * No dithering at all. Banding will be visible unless the step count is very high.
+     */
+    VolumetricDitherMode[VolumetricDitherMode["None"] = 0] = "None";
+    /**
+     * Static 4x4 ordered (Bayer) matrix. Stable over time, best when no temporal anti-aliasing is used.
+     */
+    VolumetricDitherMode[VolumetricDitherMode["Bayer"] = 1] = "Bayer";
+    /**
+     * Interleaved gradient noise. Converges to the ground truth when temporal anti-aliasing is enabled.
+     */
+    VolumetricDitherMode[VolumetricDitherMode["InterleavedGradientNoise"] = 2] = "InterleavedGradientNoise";
+})(VolumetricDitherMode || (VolumetricDitherMode = {}));
+/**
+ * Defines how the density of the participating medium evolves with the distance to the camera.
+ * These are the same three models the fog of Babylon.js uses, but the volumetric lighting owns its own
+ * values: the medium the light shafts are computed in is independent from the fog applied on the surfaces.
+ */
+export var VolumetricFogMode;
+(function (VolumetricFogMode) {
+    /**
+     * Uniform medium. The transmittance falls as e^(-distance * density).
+     */
+    VolumetricFogMode[VolumetricFogMode["Exponential"] = 0] = "Exponential";
+    /**
+     * The medium gets denser with the distance. The transmittance falls as e^(-(distance * density)^2).
+     */
+    VolumetricFogMode[VolumetricFogMode["ExponentialSquared"] = 1] = "ExponentialSquared";
+    /**
+     * The medium fades in linearly between "fogStart" and "fogEnd", which fully hides anything past the end.
+     */
+    VolumetricFogMode[VolumetricFogMode["Linear"] = 2] = "Linear";
+})(VolumetricFogMode || (VolumetricFogMode = {}));
+/**
+ * Defines the available debug outputs of the volumetric lighting rendering pipeline.
+ */
+export var VolumetricDebugMode;
+(function (VolumetricDebugMode) {
+    /**
+     * No debug, the scattering is composed over the scene color.
+     */
+    VolumetricDebugMode[VolumetricDebugMode["None"] = 0] = "None";
+    /**
+     * Outputs the raw in-scattering buffer.
+     */
+    VolumetricDebugMode[VolumetricDebugMode["Scattering"] = 1] = "Scattering";
+    /**
+     * Outputs the transmittance of the medium.
+     */
+    VolumetricDebugMode[VolumetricDebugMode["Transmittance"] = 2] = "Transmittance";
+    /**
+     * Outputs a heat map of the number of lights evaluated per pixel.
+     */
+    VolumetricDebugMode[VolumetricDebugMode["LightCount"] = 3] = "LightCount";
+})(VolumetricDebugMode || (VolumetricDebugMode = {}));
+/**
+ * Returns the default volumetric lighting configuration of a light.
+ */
+export function getDefaultVolumetricLightConfiguration() {
+    return {
+        enabled: false,
+        volumeIntensity: 1,
+        anisotropy: 0.35,
+        useCustomColor: false,
+        color: [1, 1, 1],
+        castVolumetricShadows: true,
+        shadowDarkness: 1,
+        rangeMultiplier: 1,
+        priority: 0,
+    };
+}
+/**
+ * Returns the default configuration of the volumetric lighting rendering pipeline.
+ */
+export function getDefaultVolumetricLightingConfiguration() {
+    return {
+        steps: 40,
+        lightSteps: 0,
+        resolutionScale: 0.5,
+        stepDistribution: VolumetricStepDistribution.Exponential,
+        ditherMode: VolumetricDitherMode.InterleavedGradientNoise,
+        ditherStrength: 1,
+        temporalJitter: false,
+        fogMode: VolumetricFogMode.Exponential,
+        fogDensity: 0.0005,
+        fogStart: 0,
+        fogEnd: 2000,
+        fogColor: [1, 1, 1],
+        albedo: 1,
+        maxDistance: 10_000,
+        heightFogEnabled: false,
+        heightFogBaseHeight: 0,
+        heightFogFalloff: 0.01,
+        intensity: 1.5,
+        lightExtinctionEnabled: true,
+        lightExtinctionClamp: 1000,
+        extinctionAmount: 0,
+        ambientColor: [1, 1, 1],
+        ambientIntensity: 0,
+        screenSpaceShadows: true,
+        screenSpaceShadowSteps: 6,
+        screenSpaceShadowBias: 0.02,
+        screenSpaceShadowMaxDistance: 2000,
+        screenSpaceShadowThickness: 4,
+        blurPasses: 2,
+        blurRadius: 3,
+        blurDepthThreshold: 0.02,
+        upsampleDepthThreshold: 0.02,
+        maxLights: 128,
+        maxShadowedLights: 4,
+        pcfTaps: 4,
+        selectionRefreshRate: 2,
+        debugMode: VolumetricDebugMode.None,
+    };
+}
+/**
+ * Returns the number of samples taken across the volume of each point and spot light, resolving the
+ * automatic value derived from the number of steps of the raymarching.
+ * @param configuration defines the configuration of the pipeline.
+ */
+export function getVolumetricLightSteps(configuration) {
+    if (configuration.lightSteps > 0) {
+        return configuration.lightSteps;
+    }
+    return Math.max(4, Math.min(64, Math.round(configuration.steps * 0.3)));
+}
+function normalizeNumber(value, defaultValue, min, max) {
+    const result = typeof value === "number" && isFinite(value) ? value : defaultValue;
+    return Math.min(max, Math.max(min, result));
+}
+function normalizeColor(value, defaultValue) {
+    if (!Array.isArray(value) || value.length < 3) {
+        return defaultValue.slice();
+    }
+    return [normalizeNumber(value[0], defaultValue[0], 0, 100), normalizeNumber(value[1], defaultValue[1], 0, 100), normalizeNumber(value[2], defaultValue[2], 0, 100)];
+}
+/**
+ * Normalizes the given serialized per-light volumetric configuration by merging it over the default one.
+ * This is what makes projects saved by an older version of the editor load without any migration step.
+ * @param data defines the serialized configuration to normalize.
+ */
+export function normalizeVolumetricLightConfiguration(data) {
+    const defaults = getDefaultVolumetricLightConfiguration();
+    if (!data || typeof data !== "object") {
+        return defaults;
+    }
+    return {
+        enabled: data.enabled ?? defaults.enabled,
+        volumeIntensity: normalizeNumber(data.volumeIntensity, defaults.volumeIntensity, 0, 1000),
+        anisotropy: normalizeNumber(data.anisotropy, defaults.anisotropy, -0.95, 0.95),
+        useCustomColor: data.useCustomColor ?? defaults.useCustomColor,
+        color: normalizeColor(data.color, defaults.color),
+        castVolumetricShadows: data.castVolumetricShadows ?? defaults.castVolumetricShadows,
+        shadowDarkness: normalizeNumber(data.shadowDarkness, defaults.shadowDarkness, 0, 1),
+        rangeMultiplier: normalizeNumber(data.rangeMultiplier, defaults.rangeMultiplier, 0, 100),
+        priority: normalizeNumber(data.priority, defaults.priority, -1000, 1000),
+    };
+}
+/**
+ * Normalizes the given serialized pipeline configuration by merging it over the default one.
+ * @param data defines the serialized configuration to normalize.
+ */
+export function normalizeVolumetricLightingConfiguration(data) {
+    const defaults = getDefaultVolumetricLightingConfiguration();
+    if (!data || typeof data !== "object") {
+        return defaults;
+    }
+    return {
+        steps: Math.round(normalizeNumber(data.steps, defaults.steps, 4, 256)),
+        lightSteps: Math.round(normalizeNumber(data.lightSteps, defaults.lightSteps, 0, 128)),
+        resolutionScale: normalizeNumber(data.resolutionScale, defaults.resolutionScale, 0.1, 1),
+        stepDistribution: Math.round(normalizeNumber(data.stepDistribution, defaults.stepDistribution, 0, 1)),
+        ditherMode: Math.round(normalizeNumber(data.ditherMode, defaults.ditherMode, 0, 2)),
+        ditherStrength: normalizeNumber(data.ditherStrength, defaults.ditherStrength, 0, 1),
+        temporalJitter: data.temporalJitter ?? defaults.temporalJitter,
+        fogMode: Math.round(normalizeNumber(data.fogMode, defaults.fogMode, 0, 2)),
+        fogDensity: normalizeNumber(data.fogDensity, defaults.fogDensity, 0, 100),
+        fogStart: normalizeNumber(data.fogStart, defaults.fogStart, 0, 1_000_000),
+        // The linear mode divides by "fogEnd - fogStart" and its extinction has a pole at "fogEnd", so an end
+        // at or before the start would make the medium either vanish or turn instantly opaque.
+        fogEnd: Math.max(normalizeNumber(data.fogEnd, defaults.fogEnd, 0, 10_000_000), normalizeNumber(data.fogStart, defaults.fogStart, 0, 1_000_000) + 1e-3),
+        fogColor: normalizeColor(data.fogColor, defaults.fogColor),
+        albedo: normalizeNumber(data.albedo, defaults.albedo, 0, 1),
+        maxDistance: normalizeNumber(data.maxDistance, defaults.maxDistance, 1, 1_000_000),
+        heightFogEnabled: data.heightFogEnabled ?? defaults.heightFogEnabled,
+        heightFogBaseHeight: normalizeNumber(data.heightFogBaseHeight, defaults.heightFogBaseHeight, -1_000_000, 1_000_000),
+        heightFogFalloff: normalizeNumber(data.heightFogFalloff, defaults.heightFogFalloff, 0, 10),
+        intensity: normalizeNumber(data.intensity, defaults.intensity, 0, 100),
+        lightExtinctionEnabled: data.lightExtinctionEnabled ?? defaults.lightExtinctionEnabled,
+        lightExtinctionClamp: normalizeNumber(data.lightExtinctionClamp, defaults.lightExtinctionClamp, 0, 1_000_000),
+        extinctionAmount: normalizeNumber(data.extinctionAmount, defaults.extinctionAmount, 0, 1),
+        ambientColor: normalizeColor(data.ambientColor, defaults.ambientColor),
+        ambientIntensity: normalizeNumber(data.ambientIntensity, defaults.ambientIntensity, 0, 100),
+        screenSpaceShadows: data.screenSpaceShadows ?? defaults.screenSpaceShadows,
+        screenSpaceShadowSteps: Math.round(normalizeNumber(data.screenSpaceShadowSteps, defaults.screenSpaceShadowSteps, 1, 32)),
+        screenSpaceShadowBias: normalizeNumber(data.screenSpaceShadowBias, defaults.screenSpaceShadowBias, 0, 1),
+        screenSpaceShadowMaxDistance: normalizeNumber(data.screenSpaceShadowMaxDistance, defaults.screenSpaceShadowMaxDistance, 1, 10_000_000),
+        screenSpaceShadowThickness: normalizeNumber(data.screenSpaceShadowThickness, defaults.screenSpaceShadowThickness, 0.01, 1000),
+        blurPasses: Math.round(normalizeNumber(data.blurPasses, defaults.blurPasses, 0, 2)),
+        blurRadius: Math.round(normalizeNumber(data.blurRadius, defaults.blurRadius, 1, 6)),
+        blurDepthThreshold: normalizeNumber(data.blurDepthThreshold, defaults.blurDepthThreshold, 0.0001, 1),
+        upsampleDepthThreshold: normalizeNumber(data.upsampleDepthThreshold, defaults.upsampleDepthThreshold, 0.0001, 1),
+        maxLights: Math.round(normalizeNumber(data.maxLights, defaults.maxLights, 0, maxVolumetricArrayLights)),
+        maxShadowedLights: Math.round(normalizeNumber(data.maxShadowedLights, defaults.maxShadowedLights, 0, maxVolumetricShadowSlots)),
+        pcfTaps: normalizeNumber(data.pcfTaps, defaults.pcfTaps, 1, 4) >= 4 ? 4 : 1,
+        selectionRefreshRate: Math.round(normalizeNumber(data.selectionRefreshRate, defaults.selectionRefreshRate, 1, 60)),
+        debugMode: Math.round(normalizeNumber(data.debugMode, defaults.debugMode, 0, 3)),
+    };
+}
+/**
+ * Keeps the configurations that were already completed with the default values, so the selection pass of
+ * the pipeline, which reads the configuration of every light a few times per second, doesn't allocate.
+ */
+const completedVolumetricLightConfigurations = new WeakSet();
+/**
+ * Returns the volumetric lighting configuration stored in the metadata of the given light and creates
+ * it using the default values if it doesn't exist yet.
+ *
+ * The object stored in the metadata is completed in place instead of being replaced: the inspector and the
+ * undo/redo stack keep references on it, and replacing it would silently break them.
+ * @param light defines the reference to the light to ensure its volumetric lighting configuration.
+ */
+export function ensureVolumetricLightConfiguration(light) {
+    light.metadata ??= {};
+    const existing = light.metadata[volumetricLightMetadataKey];
+    if (!existing || typeof existing !== "object") {
+        light.metadata[volumetricLightMetadataKey] = normalizeVolumetricLightConfiguration(null);
+        completedVolumetricLightConfigurations.add(light.metadata[volumetricLightMetadataKey]);
+        return light.metadata[volumetricLightMetadataKey];
+    }
+    if (completedVolumetricLightConfigurations.has(existing)) {
+        return existing;
+    }
+    // Fills the keys a newer version of the editor may have added since the project was saved.
+    const defaults = getDefaultVolumetricLightConfiguration();
+    Object.keys(defaults).forEach((key) => {
+        if (existing[key] === undefined) {
+            existing[key] = defaults[key];
+        }
+    });
+    completedVolumetricLightConfigurations.add(existing);
+    return existing;
+}
+/**
+ * Returns the volumetric lighting configuration stored in the metadata of the given light, if any.
+ * @param light defines the reference to the light to get its volumetric lighting configuration.
+ */
+export function getVolumetricLightConfiguration(light) {
+    const data = light.metadata?.[volumetricLightMetadataKey];
+    return data && typeof data === "object" ? ensureVolumetricLightConfiguration(light) : null;
+}
+/**
+ * Returns wether or not the given light contributes to the volumetric lighting.
+ * @param light defines the reference to the light to check.
+ */
+export function isVolumetricLightEnabled(light) {
+    return light.metadata?.[volumetricLightMetadataKey]?.enabled === true;
+}
+//# sourceMappingURL=types.js.map

package/build/src/rendering/volumetric/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/rendering/volumetric/types.ts"],"names":[],"mappings":"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"}

package/build/src/rendering/volumetric-lighting.js

@@ -0,0 +1,72 @@
+import { VolumetricLightingRenderingPipeline } from "./volumetric/pipeline";
+import { normalizeVolumetricLightingConfiguration } from "./volumetric/types";
+let volumetricLightingRenderingPipeline = null;
+/**
+ * Defines the configuration of the volumetric lighting rendering pipeline per camera.
+ */
+export const volumetricLightingRenderingPipelineCameraConfigurations = new Map();
+export function getVolumetricLightingRenderingPipeline() {
+    // Babylon.js disposes a rendering pipeline on its own as soon as one of its post-processes fails to
+    // compile. Without this the editor would keep reporting the effect as enabled while nothing renders.
+    if (volumetricLightingRenderingPipeline?.isDisposed) {
+        volumetricLightingRenderingPipeline = null;
+    }
+    return volumetricLightingRenderingPipeline;
+}
+/**
+ * Sets the reference to the default rendering pipeline.
+ * @access editor only.
+ */
+export function setVolumetricLightingRenderingPipelineRef(pipeline) {
+    volumetricLightingRenderingPipeline = pipeline;
+}
+/**
+ * Returns wether or not the volumetric lighting rendering pipeline is supported by the engine of the scene.
+ * Both WebGL 2 and WebGPU are supported, each with its own hand written version of the shaders.
+ * @param scene defines the reference to the scene to check.
+ */
+export function isVolumetricLightingSupported(scene) {
+    const engine = scene?.getEngine();
+    return engine ? VolumetricLightingRenderingPipeline.IsSupported(engine) : false;
+}
+export function disposeVolumetricLightingRenderingPipeline() {
+    if (volumetricLightingRenderingPipeline) {
+        volumetricLightingRenderingPipeline.dispose();
+        volumetricLightingRenderingPipeline = null;
+    }
+}
+export function createVolumetricLightingRenderingPipeline(scene, camera) {
+    volumetricLightingRenderingPipeline = new VolumetricLightingRenderingPipeline("VolumetricLightingRenderingPipeline", scene, camera);
+    return volumetricLightingRenderingPipeline;
+}
+export function serializeVolumetricLightingRenderingPipeline() {
+    if (!volumetricLightingRenderingPipeline) {
+        return null;
+    }
+    return volumetricLightingRenderingPipeline.serializeConfiguration();
+}
+export function parseVolumetricLightingRenderingPipeline(scene, camera, data) {
+    const pipeline = getVolumetricLightingRenderingPipeline() ?? createVolumetricLightingRenderingPipeline(scene, camera);
+    // A project saved before the medium was derived from the size of the scene has no value stored for it,
+    // and the static defaults would be wrong for anything but a scene authored in centimetres.
+    const configuration = { ...data };
+    if (configuration.fogDensity === undefined) {
+        configuration.fogDensity = VolumetricLightingRenderingPipeline.GetDefaultFogDensity(pipeline.scene, pipeline.camera);
+    }
+    if (configuration.fogEnd === undefined) {
+        configuration.fogEnd = VolumetricLightingRenderingPipeline.GetDefaultFogEnd(pipeline.scene, pipeline.camera);
+    }
+    if (configuration.screenSpaceShadowMaxDistance === undefined) {
+        configuration.screenSpaceShadowMaxDistance = VolumetricLightingRenderingPipeline.GetDefaultFogEnd(pipeline.scene, pipeline.camera);
+    }
+    pipeline.applyConfiguration(normalizeVolumetricLightingConfiguration(configuration));
+    return pipeline;
+}
+/**
+ * Marks the list of lights contributing to the volumetric lighting as dirty. Called when the volumetric
+ * configuration of a light is edited so the effect updates without waiting for the next selection pass.
+ */
+export function markVolumetricLightsDirty() {
+    volumetricLightingRenderingPipeline?.markLightsDirty();
+}
+//# sourceMappingURL=volumetric-lighting.js.map

package/build/src/rendering/volumetric-lighting.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"volumetric-lighting.js","sourceRoot":"","sources":["../../../src/rendering/volumetric-lighting.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,mCAAmC,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAoC,wCAAwC,EAAE,MAAM,oBAAoB,CAAC;AAEhH,IAAI,mCAAmC,GAA+C,IAAI,CAAC;AAE3F;;GAEG;AACH,MAAM,CAAC,MAAM,uDAAuD,GAAG,IAAI,GAAG,EAAe,CAAC;AAE9F,MAAM,UAAU,sCAAsC;IACrD,oGAAoG;IACpG,qGAAqG;IACrG,IAAI,mCAAmC,EAAE,UAAU,EAAE,CAAC;QACrD,mCAAmC,GAAG,IAAI,CAAC;IAC5C,CAAC;IAED,OAAO,mCAAmC,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yCAAyC,CAAC,QAAoD;IAC7G,mCAAmC,GAAG,QAAQ,CAAC;AAChD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,6BAA6B,CAAC,KAAY;IACzD,MAAM,MAAM,GAAG,KAAK,EAAE,SAAS,EAAE,CAAC;IAClC,OAAO,MAAM,CAAC,CAAC,CAAC,mCAAmC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,0CAA0C;IACzD,IAAI,mCAAmC,EAAE,CAAC;QACzC,mCAAmC,CAAC,OAAO,EAAE,CAAC;QAC9C,mCAAmC,GAAG,IAAI,CAAC;IAC5C,CAAC;AACF,CAAC;AAED,MAAM,UAAU,yCAAyC,CAAC,KAAY,EAAE,MAAc;IACrF,mCAAmC,GAAG,IAAI,mCAAmC,CAAC,qCAAqC,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;IAEpI,OAAO,mCAAmC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,4CAA4C;IAC3D,IAAI,CAAC,mCAAmC,EAAE,CAAC;QAC1C,OAAO,IAAI,CAAC;IACb,CAAC;IAED,OAAO,mCAAmC,CAAC,sBAAsB,EAAE,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,wCAAwC,CAAC,KAAY,EAAE,MAAc,EAAE,IAAS;IAC/F,MAAM,QAAQ,GAAG,sCAAsC,EAAE,IAAI,yCAAyC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAEtH,uGAAuG;IACvG,2FAA2F;IAC3F,MAAM,aAAa,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;IAClC,IAAI,aAAa,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QAC5C,aAAa,CAAC,UAAU,GAAG,mCAAmC,CAAC,oBAAoB,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACtH,CAAC;IACD,IAAI,aAAa,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACxC,aAAa,CAAC,MAAM,GAAG,mCAAmC,CAAC,gBAAgB,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9G,CAAC;IACD,IAAI,aAAa,CAAC,4BAA4B,KAAK,SAAS,EAAE,CAAC;QAC9D,aAAa,CAAC,4BAA4B,GAAG,mCAAmC,CAAC,gBAAgB,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpI,CAAC;IAED,QAAQ,CAAC,kBAAkB,CAAC,wCAAwC,CAAC,aAAa,CAAqC,CAAC,CAAC;IAEzH,OAAO,QAAQ,CAAC;AACjB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB;IACxC,mCAAmC,EAAE,eAAe,EAAE,CAAC;AACxD,CAAC"}

package/build/src/tools/guards.js

@@ -137,6 +137,20 @@ export function isLight(object) {
     }
     return false;
 }
+/**
+ * Returns wether or not the given object is a ShadowGenerator.
+ * @param object defines the reference to the object to test its class name.
+ */
+export function isShadowGenerator(object) {
+    return object.getClassName?.() === "ShadowGenerator";
+}
+/**
+ * Returns wether or not the given object is a CascadedShadowGenerator.
+ * @param object defines the reference to the object to test its class name.
+ */
+export function isCascadedShadowGenerator(object) {
+    return object.getClassName?.() === "CascadedShadowGenerator";
+}
 /**
  * Returns wether or not the given object is a ClusteredLightContainer.
  * @param object defines the reference to the object to test its class name.

package/build/src/tools/guards.js.map

@@ -1 +1 @@
-{"version":3,"file":"guards.js","sourceRoot":"","sources":["../../../src/tools/guards.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"guards.js","sourceRoot":"","sources":["../../../src/tools/guards.ts"],"names":[],"mappings":"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"}

package/declaration/src/index.d.ts

@@ -22,7 +22,11 @@ export * from "./rendering/taa";
 export * from "./rendering/ssao";
 export * from "./rendering/motion-blur";
 export * from "./rendering/default-pipeline";
+export * from "./rendering/volumetric-lighting";
 export * from "./rendering/tools";
+export * from "./rendering/volumetric/types";
+export * from "./rendering/volumetric/selector";
+export * from "./rendering/volumetric/pipeline";
 export * from "./decorators/scene";
 export * from "./decorators/gui";
 export * from "./decorators/sound";

package/declaration/src/loading/mesh.d.ts

@@ -0,0 +1 @@
+export declare function registerMeshParser(): void;

package/declaration/src/rendering/tools.d.ts

@@ -10,6 +10,7 @@ export interface IApplyRenderingConfigurationOptions {
     vlsDisabled?: boolean;
     ssrDisabled?: boolean;
     motionBlurDisabled?: boolean;
+    volumetricLightingDisabled?: boolean;
     defaultPipelineDisabled?: boolean;
     taaDisabled?: boolean;
 }