@onerjs/core 8.28.4 → 8.28.5

package/PostProcesses/RenderPipeline/Pipelines/thinSSAO2RenderingPipeline.d.ts

@@ -0,0 +1,130 @@
+import type { Camera, Nullable, Scene } from "../../../index.js";
+import { ThinSSAO2PostProcess } from "../../thinSSAO2PostProcess.js";
+import { ThinSSAO2BlurPostProcess } from "../../thinSSAO2BlurPostProcess.js";
+import { ThinSSAO2CombinePostProcess } from "../../thinSSAO2CombinePostProcess.js";
+/**
+ * The SSAO2 rendering pipeline is used to generate ambient occlusion effects.
+ */
+export declare class ThinSSAO2RenderingPipeline {
+    /** @internal */
+    readonly _ssaoPostProcess: ThinSSAO2PostProcess;
+    /** @internal */
+    readonly _ssaoBlurXPostProcess: ThinSSAO2BlurPostProcess;
+    /** @internal */
+    readonly _ssaoBlurYPostProcess: ThinSSAO2BlurPostProcess;
+    /** @internal */
+    readonly _ssaoCombinePostProcess: ThinSSAO2CombinePostProcess;
+    /**
+     * Gets or sets the name of the rendering pipeline
+     */
+    name: string;
+    /**
+     * The camera to which the rendering pipeline will be applied.
+     */
+    get camera(): Nullable<Camera>;
+    set camera(camera: Nullable<Camera>);
+    /**
+     * Number of samples used for the SSAO calculations. Default value is 8.
+     */
+    set samples(n: number);
+    get samples(): number;
+    /**
+     * The output strength of the SSAO post-process. Default value is 1.0.
+     */
+    get totalStrength(): number;
+    set totalStrength(value: number);
+    /**
+     * The radius around the analyzed pixel used by the SSAO post-process. Default value is 2.0
+     */
+    get radius(): number;
+    set radius(value: number);
+    /**
+     * Maximum depth value to still render AO. A smooth falloff makes the dimming more natural, so there will be no abrupt shading change.
+     */
+    get maxZ(): number;
+    set maxZ(value: number);
+    /**
+     * In order to save performances, SSAO radius is clamped on close geometry. This ratio changes by how much.
+     */
+    get minZAspect(): number;
+    set minZAspect(value: number);
+    /**
+     * The base color of the SSAO post-process
+     * The final result is "base + ssao" between [0, 1]
+     */
+    get base(): number;
+    set base(value: number);
+    /**
+     * Used in SSAO calculations to compensate for accuracy issues with depth values. Default 0.02.
+     *
+     * Normally you do not need to change this value, but you can experiment with it if you get a lot of in false self-occlusion on flat surfaces when using fewer than 16 samples. Useful range is normally [0..0.1] but higher values is allowed.
+     */
+    get epsilon(): number;
+    set epsilon(n: number);
+    /**
+     * Skips the denoising (blur) stage of the SSAO calculations.
+     *
+     * Useful to temporarily set while experimenting with the other SSAO2 settings.
+     */
+    set bypassBlur(b: boolean);
+    get bypassBlur(): boolean;
+    /**
+     * Enables the configurable bilateral denoising (blurring) filter. Default is true.
+     * Set to false to instead use a legacy bilateral filter that can't be configured.
+     *
+     * The denoising filter runs after the SSAO calculations and is a very important step. Both options results in a so called bilateral being used, but the "expensive" one can be
+     * configured in several ways to fit your scene.
+     */
+    set expensiveBlur(b: boolean);
+    get expensiveBlur(): boolean;
+    /**
+     * The number of samples the bilateral filter uses in both dimensions when denoising the SSAO calculations. Default value is 16.
+     *
+     * A higher value should result in smoother shadows but will use more processing time in the shaders.
+     *
+     * A high value can cause the shadows to get to blurry or create visible artifacts (bands) near sharp details in the geometry. The artifacts can sometimes be mitigated by increasing the bilateralSoften setting.
+     */
+    get bilateralSamples(): number;
+    set bilateralSamples(n: number);
+    /**
+     * Controls the shape of the denoising kernel used by the bilateral filter. Default value is 0.
+     *
+     * By default the bilateral filter acts like a box-filter, treating all samples on the same depth with equal weights. This is effective to maximize the denoising effect given a limited set of samples. However, it also often results in visible ghosting around sharp shadow regions and can spread out lines over large areas so they are no longer visible.
+     *
+     * Increasing this setting will make the filter pay less attention to samples further away from the center sample, reducing many artifacts but at the same time increasing noise.
+     *
+     * Useful value range is [0..1].
+     */
+    get bilateralSoften(): number;
+    set bilateralSoften(n: number);
+    /**
+     * How forgiving the bilateral denoiser should be when rejecting samples. Default value is 0.
+     *
+     * A higher value results in the bilateral filter being more forgiving and thus doing a better job at denoising slanted and curved surfaces, but can lead to shadows spreading out around corners or between objects that are close to each other depth wise.
+     *
+     * Useful value range is normally [0..1], but higher values are allowed.
+     */
+    get bilateralTolerance(): number;
+    set bilateralTolerance(n: number);
+    /**
+     * Indicates that the combine stage should use the current camera viewport to render the SSAO result on only a portion of the output texture (default: true).
+     */
+    get useViewportInCombineStage(): boolean;
+    set useViewportInCombineStage(b: boolean);
+    /**
+     * Checks if all the post processes in the pipeline are ready.
+     * @returns true if all the post processes in the pipeline are ready
+     */
+    isReady(): boolean;
+    private _scene;
+    /**
+     * Constructor of the SSR rendering pipeline
+     * @param name The rendering pipeline name
+     * @param scene The scene linked to this pipeline
+     */
+    constructor(name: string, scene: Scene);
+    /**
+     * Disposes of the pipeline
+     */
+    dispose(): void;
+}

package/PostProcesses/RenderPipeline/Pipelines/thinSSAO2RenderingPipeline.js

@@ -0,0 +1,193 @@
+import { ThinSSAO2PostProcess } from "../../thinSSAO2PostProcess.js";
+import { ThinSSAO2BlurPostProcess } from "../../thinSSAO2BlurPostProcess.js";
+import { ThinSSAO2CombinePostProcess } from "../../thinSSAO2CombinePostProcess.js";
+/**
+ * The SSAO2 rendering pipeline is used to generate ambient occlusion effects.
+ */
+export class ThinSSAO2RenderingPipeline {
+    /**
+     * The camera to which the rendering pipeline will be applied.
+     */
+    get camera() {
+        return this._ssaoPostProcess.camera;
+    }
+    set camera(camera) {
+        this._ssaoPostProcess.camera = camera;
+        this._ssaoCombinePostProcess.camera = camera;
+    }
+    /**
+     * Number of samples used for the SSAO calculations. Default value is 8.
+     */
+    set samples(n) {
+        this._ssaoPostProcess.samples = n;
+    }
+    get samples() {
+        return this._ssaoPostProcess.samples;
+    }
+    /**
+     * The output strength of the SSAO post-process. Default value is 1.0.
+     */
+    get totalStrength() {
+        return this._ssaoPostProcess.totalStrength;
+    }
+    set totalStrength(value) {
+        this._ssaoPostProcess.totalStrength = value;
+    }
+    /**
+     * The radius around the analyzed pixel used by the SSAO post-process. Default value is 2.0
+     */
+    get radius() {
+        return this._ssaoPostProcess.radius;
+    }
+    set radius(value) {
+        this._ssaoPostProcess.radius = value;
+    }
+    /**
+     * Maximum depth value to still render AO. A smooth falloff makes the dimming more natural, so there will be no abrupt shading change.
+     */
+    get maxZ() {
+        return this._ssaoPostProcess.maxZ;
+    }
+    set maxZ(value) {
+        this._ssaoPostProcess.maxZ = value;
+    }
+    /**
+     * In order to save performances, SSAO radius is clamped on close geometry. This ratio changes by how much.
+     */
+    get minZAspect() {
+        return this._ssaoPostProcess.minZAspect;
+    }
+    set minZAspect(value) {
+        this._ssaoPostProcess.minZAspect = value;
+    }
+    /**
+     * The base color of the SSAO post-process
+     * The final result is "base + ssao" between [0, 1]
+     */
+    get base() {
+        return this._ssaoPostProcess.base;
+    }
+    set base(value) {
+        this._ssaoPostProcess.base = value;
+    }
+    /**
+     * Used in SSAO calculations to compensate for accuracy issues with depth values. Default 0.02.
+     *
+     * Normally you do not need to change this value, but you can experiment with it if you get a lot of in false self-occlusion on flat surfaces when using fewer than 16 samples. Useful range is normally [0..0.1] but higher values is allowed.
+     */
+    get epsilon() {
+        return this._ssaoPostProcess.epsilon;
+    }
+    set epsilon(n) {
+        this._ssaoPostProcess.epsilon = n;
+    }
+    /**
+     * Skips the denoising (blur) stage of the SSAO calculations.
+     *
+     * Useful to temporarily set while experimenting with the other SSAO2 settings.
+     */
+    set bypassBlur(b) {
+        this._ssaoBlurXPostProcess.bypassBlur = b;
+        this._ssaoBlurYPostProcess.bypassBlur = b;
+    }
+    get bypassBlur() {
+        return this._ssaoBlurXPostProcess.bypassBlur;
+    }
+    /**
+     * Enables the configurable bilateral denoising (blurring) filter. Default is true.
+     * Set to false to instead use a legacy bilateral filter that can't be configured.
+     *
+     * The denoising filter runs after the SSAO calculations and is a very important step. Both options results in a so called bilateral being used, but the "expensive" one can be
+     * configured in several ways to fit your scene.
+     */
+    set expensiveBlur(b) {
+        this._ssaoBlurXPostProcess.expensiveBlur = b;
+        this._ssaoBlurYPostProcess.expensiveBlur = b;
+    }
+    get expensiveBlur() {
+        return this._ssaoBlurXPostProcess.expensiveBlur;
+    }
+    /**
+     * The number of samples the bilateral filter uses in both dimensions when denoising the SSAO calculations. Default value is 16.
+     *
+     * A higher value should result in smoother shadows but will use more processing time in the shaders.
+     *
+     * A high value can cause the shadows to get to blurry or create visible artifacts (bands) near sharp details in the geometry. The artifacts can sometimes be mitigated by increasing the bilateralSoften setting.
+     */
+    get bilateralSamples() {
+        return this._ssaoBlurXPostProcess.bilateralSamples;
+    }
+    set bilateralSamples(n) {
+        this._ssaoBlurXPostProcess.bilateralSamples = n;
+        this._ssaoBlurYPostProcess.bilateralSamples = n;
+    }
+    /**
+     * Controls the shape of the denoising kernel used by the bilateral filter. Default value is 0.
+     *
+     * By default the bilateral filter acts like a box-filter, treating all samples on the same depth with equal weights. This is effective to maximize the denoising effect given a limited set of samples. However, it also often results in visible ghosting around sharp shadow regions and can spread out lines over large areas so they are no longer visible.
+     *
+     * Increasing this setting will make the filter pay less attention to samples further away from the center sample, reducing many artifacts but at the same time increasing noise.
+     *
+     * Useful value range is [0..1].
+     */
+    get bilateralSoften() {
+        return this._ssaoBlurXPostProcess.bilateralSoften;
+    }
+    set bilateralSoften(n) {
+        this._ssaoBlurXPostProcess.bilateralSoften = n;
+        this._ssaoBlurYPostProcess.bilateralSoften = n;
+    }
+    /**
+     * How forgiving the bilateral denoiser should be when rejecting samples. Default value is 0.
+     *
+     * A higher value results in the bilateral filter being more forgiving and thus doing a better job at denoising slanted and curved surfaces, but can lead to shadows spreading out around corners or between objects that are close to each other depth wise.
+     *
+     * Useful value range is normally [0..1], but higher values are allowed.
+     */
+    get bilateralTolerance() {
+        return this._ssaoBlurXPostProcess.bilateralTolerance;
+    }
+    set bilateralTolerance(n) {
+        this._ssaoBlurXPostProcess.bilateralTolerance = n;
+        this._ssaoBlurYPostProcess.bilateralTolerance = n;
+    }
+    /**
+     * Indicates that the combine stage should use the current camera viewport to render the SSAO result on only a portion of the output texture (default: true).
+     */
+    get useViewportInCombineStage() {
+        return this._ssaoCombinePostProcess.useViewportInCombineStage;
+    }
+    set useViewportInCombineStage(b) {
+        this._ssaoCombinePostProcess.useViewportInCombineStage = b;
+    }
+    /**
+     * Checks if all the post processes in the pipeline are ready.
+     * @returns true if all the post processes in the pipeline are ready
+     */
+    isReady() {
+        return this._ssaoPostProcess.isReady() && this._ssaoBlurXPostProcess.isReady() && this._ssaoBlurYPostProcess.isReady() && this._ssaoCombinePostProcess.isReady();
+    }
+    /**
+     * Constructor of the SSR rendering pipeline
+     * @param name The rendering pipeline name
+     * @param scene The scene linked to this pipeline
+     */
+    constructor(name, scene) {
+        this.name = name;
+        this._scene = scene;
+        this._ssaoPostProcess = new ThinSSAO2PostProcess(this.name, this._scene);
+        this._ssaoBlurXPostProcess = new ThinSSAO2BlurPostProcess(this.name + " BlurX", this._scene.getEngine(), true);
+        this._ssaoBlurYPostProcess = new ThinSSAO2BlurPostProcess(this.name + " BlurY", this._scene.getEngine(), false);
+        this._ssaoCombinePostProcess = new ThinSSAO2CombinePostProcess(this.name + " Combiner", this._scene.getEngine());
+    }
+    /**
+     * Disposes of the pipeline
+     */
+    dispose() {
+        this._ssaoPostProcess?.dispose();
+        this._ssaoBlurXPostProcess?.dispose();
+        this._ssaoBlurYPostProcess?.dispose();
+        this._ssaoCombinePostProcess?.dispose();
+    }
+}
+//# sourceMappingURL=thinSSAO2RenderingPipeline.js.map

package/PostProcesses/RenderPipeline/Pipelines/thinSSAO2RenderingPipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thinSSAO2RenderingPipeline.js","sourceRoot":"","sources":["../../../../../../dev/core/src/PostProcesses/RenderPipeline/Pipelines/thinSSAO2RenderingPipeline.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Camera, Nullable, Scene } from \"core/index\";\r\nimport { ThinSSAO2PostProcess } from \"core/PostProcesses/thinSSAO2PostProcess\";\r\nimport { ThinSSAO2BlurPostProcess } from \"core/PostProcesses/thinSSAO2BlurPostProcess\";\r\nimport { ThinSSAO2CombinePostProcess } from \"core/PostProcesses/thinSSAO2CombinePostProcess\";\r\n\r\n/**\r\n * The SSAO2 rendering pipeline is used to generate ambient occlusion effects.\r\n */\r\nexport class ThinSSAO2RenderingPipeline {\r\n    /** @internal */\r\n    public readonly _ssaoPostProcess: ThinSSAO2PostProcess;\r\n    /** @internal */\r\n    public readonly _ssaoBlurXPostProcess: ThinSSAO2BlurPostProcess;\r\n    /** @internal */\r\n    public readonly _ssaoBlurYPostProcess: ThinSSAO2BlurPostProcess;\r\n    /** @internal */\r\n    public readonly _ssaoCombinePostProcess: ThinSSAO2CombinePostProcess;\r\n\r\n    /**\r\n     * Gets or sets the name of the rendering pipeline\r\n     */\r\n    public name: string;\r\n\r\n    /**\r\n     * The camera to which the rendering pipeline will be applied.\r\n     */\r\n    public get camera() {\r\n        return this._ssaoPostProcess.camera;\r\n    }\r\n\r\n    public set camera(camera: Nullable<Camera>) {\r\n        this._ssaoPostProcess.camera = camera;\r\n        this._ssaoCombinePostProcess.camera = camera;\r\n    }\r\n\r\n    /**\r\n     * Number of samples used for the SSAO calculations. Default value is 8.\r\n     */\r\n    public set samples(n: number) {\r\n        this._ssaoPostProcess.samples = n;\r\n    }\r\n    public get samples(): number {\r\n        return this._ssaoPostProcess.samples;\r\n    }\r\n\r\n    /**\r\n     * The output strength of the SSAO post-process. Default value is 1.0.\r\n     */\r\n    public get totalStrength() {\r\n        return this._ssaoPostProcess.totalStrength;\r\n    }\r\n\r\n    public set totalStrength(value: number) {\r\n        this._ssaoPostProcess.totalStrength = value;\r\n    }\r\n\r\n    /**\r\n     * The radius around the analyzed pixel used by the SSAO post-process. Default value is 2.0\r\n     */\r\n    public get radius() {\r\n        return this._ssaoPostProcess.radius;\r\n    }\r\n\r\n    public set radius(value: number) {\r\n        this._ssaoPostProcess.radius = value;\r\n    }\r\n\r\n    /**\r\n     * Maximum depth value to still render AO. A smooth falloff makes the dimming more natural, so there will be no abrupt shading change.\r\n     */\r\n    public get maxZ() {\r\n        return this._ssaoPostProcess.maxZ;\r\n    }\r\n\r\n    public set maxZ(value: number) {\r\n        this._ssaoPostProcess.maxZ = value;\r\n    }\r\n\r\n    /**\r\n     * In order to save performances, SSAO radius is clamped on close geometry. This ratio changes by how much.\r\n     */\r\n    public get minZAspect() {\r\n        return this._ssaoPostProcess.minZAspect;\r\n    }\r\n\r\n    public set minZAspect(value: number) {\r\n        this._ssaoPostProcess.minZAspect = value;\r\n    }\r\n\r\n    /**\r\n     * The base color of the SSAO post-process\r\n     * The final result is \"base + ssao\" between [0, 1]\r\n     */\r\n    public get base() {\r\n        return this._ssaoPostProcess.base;\r\n    }\r\n\r\n    public set base(value: number) {\r\n        this._ssaoPostProcess.base = value;\r\n    }\r\n\r\n    /**\r\n     * Used in SSAO calculations to compensate for accuracy issues with depth values. Default 0.02.\r\n     *\r\n     * Normally you do not need to change this value, but you can experiment with it if you get a lot of in false self-occlusion on flat surfaces when using fewer than 16 samples. Useful range is normally [0..0.1] but higher values is allowed.\r\n     */\r\n    public get epsilon(): number {\r\n        return this._ssaoPostProcess.epsilon;\r\n    }\r\n\r\n    public set epsilon(n: number) {\r\n        this._ssaoPostProcess.epsilon = n;\r\n    }\r\n\r\n    /**\r\n     * Skips the denoising (blur) stage of the SSAO calculations.\r\n     *\r\n     * Useful to temporarily set while experimenting with the other SSAO2 settings.\r\n     */\r\n    public set bypassBlur(b: boolean) {\r\n        this._ssaoBlurXPostProcess.bypassBlur = b;\r\n        this._ssaoBlurYPostProcess.bypassBlur = b;\r\n    }\r\n\r\n    public get bypassBlur(): boolean {\r\n        return this._ssaoBlurXPostProcess.bypassBlur;\r\n    }\r\n\r\n    /**\r\n     * Enables the configurable bilateral denoising (blurring) filter. Default is true.\r\n     * Set to false to instead use a legacy bilateral filter that can't be configured.\r\n     *\r\n     * The denoising filter runs after the SSAO calculations and is a very important step. Both options results in a so called bilateral being used, but the \"expensive\" one can be\r\n     * configured in several ways to fit your scene.\r\n     */\r\n    public set expensiveBlur(b: boolean) {\r\n        this._ssaoBlurXPostProcess.expensiveBlur = b;\r\n        this._ssaoBlurYPostProcess.expensiveBlur = b;\r\n    }\r\n\r\n    public get expensiveBlur(): boolean {\r\n        return this._ssaoBlurXPostProcess.expensiveBlur;\r\n    }\r\n\r\n    /**\r\n     * The number of samples the bilateral filter uses in both dimensions when denoising the SSAO calculations. Default value is 16.\r\n     *\r\n     * A higher value should result in smoother shadows but will use more processing time in the shaders.\r\n     *\r\n     * A high value can cause the shadows to get to blurry or create visible artifacts (bands) near sharp details in the geometry. The artifacts can sometimes be mitigated by increasing the bilateralSoften setting.\r\n     */\r\n    public get bilateralSamples() {\r\n        return this._ssaoBlurXPostProcess.bilateralSamples;\r\n    }\r\n\r\n    public set bilateralSamples(n: number) {\r\n        this._ssaoBlurXPostProcess.bilateralSamples = n;\r\n        this._ssaoBlurYPostProcess.bilateralSamples = n;\r\n    }\r\n\r\n    /**\r\n     * Controls the shape of the denoising kernel used by the bilateral filter. Default value is 0.\r\n     *\r\n     * By default the bilateral filter acts like a box-filter, treating all samples on the same depth with equal weights. This is effective to maximize the denoising effect given a limited set of samples. However, it also often results in visible ghosting around sharp shadow regions and can spread out lines over large areas so they are no longer visible.\r\n     *\r\n     * Increasing this setting will make the filter pay less attention to samples further away from the center sample, reducing many artifacts but at the same time increasing noise.\r\n     *\r\n     * Useful value range is [0..1].\r\n     */\r\n    public get bilateralSoften() {\r\n        return this._ssaoBlurXPostProcess.bilateralSoften;\r\n    }\r\n\r\n    public set bilateralSoften(n: number) {\r\n        this._ssaoBlurXPostProcess.bilateralSoften = n;\r\n        this._ssaoBlurYPostProcess.bilateralSoften = n;\r\n    }\r\n\r\n    /**\r\n     * How forgiving the bilateral denoiser should be when rejecting samples. Default value is 0.\r\n     *\r\n     * A higher value results in the bilateral filter being more forgiving and thus doing a better job at denoising slanted and curved surfaces, but can lead to shadows spreading out around corners or between objects that are close to each other depth wise.\r\n     *\r\n     * Useful value range is normally [0..1], but higher values are allowed.\r\n     */\r\n    public get bilateralTolerance() {\r\n        return this._ssaoBlurXPostProcess.bilateralTolerance;\r\n    }\r\n\r\n    public set bilateralTolerance(n: number) {\r\n        this._ssaoBlurXPostProcess.bilateralTolerance = n;\r\n        this._ssaoBlurYPostProcess.bilateralTolerance = n;\r\n    }\r\n\r\n    /**\r\n     * Indicates that the combine stage should use the current camera viewport to render the SSAO result on only a portion of the output texture (default: true).\r\n     */\r\n    public get useViewportInCombineStage() {\r\n        return this._ssaoCombinePostProcess.useViewportInCombineStage;\r\n    }\r\n\r\n    public set useViewportInCombineStage(b: boolean) {\r\n        this._ssaoCombinePostProcess.useViewportInCombineStage = b;\r\n    }\r\n\r\n    /**\r\n     * Checks if all the post processes in the pipeline are ready.\r\n     * @returns true if all the post processes in the pipeline are ready\r\n     */\r\n    public isReady(): boolean {\r\n        return this._ssaoPostProcess.isReady() && this._ssaoBlurXPostProcess.isReady() && this._ssaoBlurYPostProcess.isReady() && this._ssaoCombinePostProcess.isReady();\r\n    }\r\n\r\n    private _scene: Scene;\r\n\r\n    /**\r\n     * Constructor of the SSR rendering pipeline\r\n     * @param name The rendering pipeline name\r\n     * @param scene The scene linked to this pipeline\r\n     */\r\n    constructor(name: string, scene: Scene) {\r\n        this.name = name;\r\n        this._scene = scene;\r\n\r\n        this._ssaoPostProcess = new ThinSSAO2PostProcess(this.name, this._scene);\r\n        this._ssaoBlurXPostProcess = new ThinSSAO2BlurPostProcess(this.name + \" BlurX\", this._scene.getEngine(), true);\r\n        this._ssaoBlurYPostProcess = new ThinSSAO2BlurPostProcess(this.name + \" BlurY\", this._scene.getEngine(), false);\r\n        this._ssaoCombinePostProcess = new ThinSSAO2CombinePostProcess(this.name + \" Combiner\", this._scene.getEngine());\r\n    }\r\n\r\n    /**\r\n     * Disposes of the pipeline\r\n     */\r\n    public dispose(): void {\r\n        this._ssaoPostProcess?.dispose();\r\n        this._ssaoBlurXPostProcess?.dispose();\r\n        this._ssaoBlurYPostProcess?.dispose();\r\n        this._ssaoCombinePostProcess?.dispose();\r\n    }\r\n}\r\n"]}

package/PostProcesses/thinSSAO2BlurPostProcess.d.ts

@@ -0,0 +1,26 @@
+import type { Nullable, AbstractEngine, EffectWrapperCreationOptions } from "../index.js";
+import { EffectWrapper } from "../Materials/effectRenderer.js";
+/**
+ * @internal
+ */
+export declare class ThinSSAO2BlurPostProcess extends EffectWrapper {
+    static readonly FragmentUrl = "ssao2";
+    static readonly Uniforms: string[];
+    static readonly Samplers: string[];
+    protected _gatherImports(useWebGPU: boolean, list: Promise<any>[]): void;
+    constructor(name: string, engine: Nullable<AbstractEngine> | undefined, isHorizontal: boolean, options?: EffectWrapperCreationOptions);
+    private readonly _isHorizontal;
+    private _bypassBlur;
+    textureSize: number;
+    bilateralSamples: number;
+    bilateralSoften: number;
+    bilateralTolerance: number;
+    set bypassBlur(b: boolean);
+    get bypassBlur(): boolean;
+    private _expensiveBlur;
+    set expensiveBlur(b: boolean);
+    get expensiveBlur(): boolean;
+    bind(noDefaultBindings?: boolean): void;
+    private _getSamplersForBlur;
+    private _getDefinesForBlur;
+}

package/PostProcesses/thinSSAO2BlurPostProcess.js

@@ -0,0 +1,81 @@
+import { EffectWrapper } from "../Materials/effectRenderer.js";
+import { Engine } from "../Engines/engine.js";
+/**
+ * @internal
+ */
+export class ThinSSAO2BlurPostProcess extends EffectWrapper {
+    _gatherImports(useWebGPU, list) {
+        if (useWebGPU) {
+            this._webGPUReady = true;
+            list.push(import("../ShadersWGSL/ssao2.fragment.js"));
+        }
+        else {
+            list.push(import("../Shaders/ssao2.fragment.js"));
+        }
+    }
+    constructor(name, engine = null, isHorizontal, options) {
+        super({
+            ...options,
+            name,
+            engine: engine || Engine.LastCreatedEngine,
+            useShaderStore: true,
+            useAsPostProcess: true,
+            fragmentShader: ThinSSAO2BlurPostProcess.FragmentUrl,
+            uniforms: ThinSSAO2BlurPostProcess.Uniforms,
+            samplers: ThinSSAO2BlurPostProcess.Samplers,
+            defines: "#define BLUR\n" + (isHorizontal ? "#define BLUR_H\n" : ""),
+        });
+        this._bypassBlur = false;
+        this.textureSize = 0;
+        this.bilateralSamples = 16;
+        this.bilateralSoften = 0;
+        this.bilateralTolerance = 0;
+        this._expensiveBlur = true;
+        this._isHorizontal = isHorizontal;
+        const defines = this._getDefinesForBlur(this.expensiveBlur, this.bypassBlur);
+        const samplers = this._getSamplersForBlur(this.bypassBlur);
+        this.updateEffect(defines, null, samplers);
+    }
+    set bypassBlur(b) {
+        const defines = this._getDefinesForBlur(this.expensiveBlur, b);
+        const samplers = this._getSamplersForBlur(b);
+        this.updateEffect(defines, null, samplers);
+        this._bypassBlur = b;
+    }
+    get bypassBlur() {
+        return this._bypassBlur;
+    }
+    set expensiveBlur(b) {
+        const defines = this._getDefinesForBlur(b, this._bypassBlur);
+        this.updateEffect(defines);
+        this._expensiveBlur = b;
+    }
+    get expensiveBlur() {
+        return this._expensiveBlur;
+    }
+    bind(noDefaultBindings = false) {
+        super.bind(noDefaultBindings);
+        const effect = this._drawWrapper.effect;
+        effect.setFloat("outSize", this.textureSize);
+        effect.setInt("samples", this.bilateralSamples);
+        effect.setFloat("soften", this.bilateralSoften);
+        effect.setFloat("tolerance", this.bilateralTolerance);
+    }
+    _getSamplersForBlur(disabled) {
+        return disabled ? ["textureSampler"] : ["textureSampler", "depthSampler"];
+    }
+    _getDefinesForBlur(bilateral, disabled) {
+        let define = "#define BLUR\n";
+        if (disabled) {
+            define += "#define BLUR_BYPASS\n";
+        }
+        if (!bilateral) {
+            define += "#define BLUR_LEGACY\n";
+        }
+        return this._isHorizontal ? define + "#define BLUR_H\n" : define;
+    }
+}
+ThinSSAO2BlurPostProcess.FragmentUrl = "ssao2";
+ThinSSAO2BlurPostProcess.Uniforms = ["outSize", "samples", "soften", "tolerance"];
+ThinSSAO2BlurPostProcess.Samplers = ["textureSampler", "depthSampler"];
+//# sourceMappingURL=thinSSAO2BlurPostProcess.js.map

package/PostProcesses/thinSSAO2BlurPostProcess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thinSSAO2BlurPostProcess.js","sourceRoot":"","sources":["../../../../dev/core/src/PostProcesses/thinSSAO2BlurPostProcess.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Nullable, AbstractEngine, EffectWrapperCreationOptions } from \"core/index\";\r\nimport { EffectWrapper } from \"../Materials/effectRenderer\";\r\nimport { Engine } from \"../Engines/engine\";\r\n\r\n/**\r\n * @internal\r\n */\r\nexport class ThinSSAO2BlurPostProcess extends EffectWrapper {\r\n    public static readonly FragmentUrl = \"ssao2\";\r\n\r\n    public static readonly Uniforms = [\"outSize\", \"samples\", \"soften\", \"tolerance\"];\r\n\r\n    public static readonly Samplers = [\"textureSampler\", \"depthSampler\"];\r\n\r\n    protected override _gatherImports(useWebGPU: boolean, list: Promise<any>[]) {\r\n        if (useWebGPU) {\r\n            this._webGPUReady = true;\r\n            list.push(import(\"../ShadersWGSL/ssao2.fragment\"));\r\n        } else {\r\n            list.push(import(\"../Shaders/ssao2.fragment\"));\r\n        }\r\n    }\r\n\r\n    constructor(name: string, engine: Nullable<AbstractEngine> = null, isHorizontal: boolean, options?: EffectWrapperCreationOptions) {\r\n        super({\r\n            ...options,\r\n            name,\r\n            engine: engine || Engine.LastCreatedEngine!,\r\n            useShaderStore: true,\r\n            useAsPostProcess: true,\r\n            fragmentShader: ThinSSAO2BlurPostProcess.FragmentUrl,\r\n            uniforms: ThinSSAO2BlurPostProcess.Uniforms,\r\n            samplers: ThinSSAO2BlurPostProcess.Samplers,\r\n            defines: \"#define BLUR\\n\" + (isHorizontal ? \"#define BLUR_H\\n\" : \"\"),\r\n        });\r\n\r\n        this._isHorizontal = isHorizontal;\r\n\r\n        const defines = this._getDefinesForBlur(this.expensiveBlur, this.bypassBlur);\r\n        const samplers = this._getSamplersForBlur(this.bypassBlur);\r\n\r\n        this.updateEffect(defines, null, samplers);\r\n    }\r\n\r\n    private readonly _isHorizontal: boolean;\r\n    private _bypassBlur: boolean = false;\r\n\r\n    public textureSize: number = 0;\r\n\r\n    public bilateralSamples: number = 16;\r\n\r\n    public bilateralSoften: number = 0;\r\n\r\n    public bilateralTolerance: number = 0;\r\n\r\n    public set bypassBlur(b: boolean) {\r\n        const defines = this._getDefinesForBlur(this.expensiveBlur, b);\r\n        const samplers = this._getSamplersForBlur(b);\r\n\r\n        this.updateEffect(defines, null, samplers);\r\n\r\n        this._bypassBlur = b;\r\n    }\r\n    public get bypassBlur(): boolean {\r\n        return this._bypassBlur;\r\n    }\r\n\r\n    private _expensiveBlur: boolean = true;\r\n\r\n    public set expensiveBlur(b: boolean) {\r\n        const defines = this._getDefinesForBlur(b, this._bypassBlur);\r\n\r\n        this.updateEffect(defines);\r\n\r\n        this._expensiveBlur = b;\r\n    }\r\n    public get expensiveBlur(): boolean {\r\n        return this._expensiveBlur;\r\n    }\r\n\r\n    public override bind(noDefaultBindings = false) {\r\n        super.bind(noDefaultBindings);\r\n\r\n        const effect = this._drawWrapper.effect!;\r\n\r\n        effect.setFloat(\"outSize\", this.textureSize);\r\n        effect.setInt(\"samples\", this.bilateralSamples);\r\n        effect.setFloat(\"soften\", this.bilateralSoften);\r\n        effect.setFloat(\"tolerance\", this.bilateralTolerance);\r\n    }\r\n\r\n    private _getSamplersForBlur(disabled: boolean): Array<string> {\r\n        return disabled ? [\"textureSampler\"] : [\"textureSampler\", \"depthSampler\"];\r\n    }\r\n\r\n    private _getDefinesForBlur(bilateral: boolean, disabled: boolean): string {\r\n        let define = \"#define BLUR\\n\";\r\n        if (disabled) {\r\n            define += \"#define BLUR_BYPASS\\n\";\r\n        }\r\n        if (!bilateral) {\r\n            define += \"#define BLUR_LEGACY\\n\";\r\n        }\r\n        return this._isHorizontal ? define + \"#define BLUR_H\\n\" : define;\r\n    }\r\n}\r\n"]}

package/PostProcesses/thinSSAO2CombinePostProcess.d.ts

@@ -0,0 +1,15 @@
+import type { Nullable, AbstractEngine, EffectWrapperCreationOptions, Camera } from "../index.js";
+import { EffectWrapper } from "../Materials/effectRenderer.js";
+/**
+ * @internal
+ */
+export declare class ThinSSAO2CombinePostProcess extends EffectWrapper {
+    static readonly FragmentUrl = "ssaoCombine";
+    static readonly Uniforms: string[];
+    static readonly Samplers: string[];
+    protected _gatherImports(useWebGPU: boolean, list: Promise<any>[]): void;
+    constructor(name: string, engine?: Nullable<AbstractEngine>, options?: EffectWrapperCreationOptions);
+    camera: Nullable<Camera>;
+    useViewportInCombineStage: boolean;
+    bind(noDefaultBindings?: boolean): void;
+}

package/PostProcesses/thinSSAO2CombinePostProcess.js

@@ -0,0 +1,48 @@
+import { EffectWrapper } from "../Materials/effectRenderer.js";
+import { Engine } from "../Engines/engine.js";
+import { TmpVectors } from "../Maths/math.vector.js";
+/**
+ * @internal
+ */
+export class ThinSSAO2CombinePostProcess extends EffectWrapper {
+    _gatherImports(useWebGPU, list) {
+        if (useWebGPU) {
+            this._webGPUReady = true;
+            list.push(import("../ShadersWGSL/ssaoCombine.fragment.js"));
+        }
+        else {
+            list.push(import("../Shaders/ssaoCombine.fragment.js"));
+        }
+    }
+    constructor(name, engine = null, options) {
+        super({
+            ...options,
+            name,
+            engine: engine || Engine.LastCreatedEngine,
+            useShaderStore: true,
+            useAsPostProcess: true,
+            fragmentShader: ThinSSAO2CombinePostProcess.FragmentUrl,
+            uniforms: ThinSSAO2CombinePostProcess.Uniforms,
+            samplers: ThinSSAO2CombinePostProcess.Samplers,
+        });
+        this.camera = null;
+        this.useViewportInCombineStage = true;
+    }
+    bind(noDefaultBindings = false) {
+        super.bind(noDefaultBindings);
+        const effect = this._drawWrapper.effect;
+        if (this.camera) {
+            const viewport = this.camera.viewport;
+            if (this.useViewportInCombineStage) {
+                effect.setVector4("viewport", TmpVectors.Vector4[0].copyFromFloats(viewport.x, viewport.y, viewport.width, viewport.height));
+            }
+            else {
+                effect.setVector4("viewport", TmpVectors.Vector4[0].copyFromFloats(0, 0, 1, 1));
+            }
+        }
+    }
+}
+ThinSSAO2CombinePostProcess.FragmentUrl = "ssaoCombine";
+ThinSSAO2CombinePostProcess.Uniforms = ["viewport"];
+ThinSSAO2CombinePostProcess.Samplers = ["originalColor"];
+//# sourceMappingURL=thinSSAO2CombinePostProcess.js.map

package/PostProcesses/thinSSAO2CombinePostProcess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thinSSAO2CombinePostProcess.js","sourceRoot":"","sources":["../../../../dev/core/src/PostProcesses/thinSSAO2CombinePostProcess.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,gCAA+B;AAEpD;;GAEG;AACH,MAAM,OAAO,2BAA4B,SAAQ,aAAa;IAOvC,cAAc,CAAC,SAAkB,EAAE,IAAoB;QACtE,IAAI,SAAS,EAAE,CAAC;YACZ,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,qCAAqC,CAAC,CAAC,CAAC;QAC7D,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,iCAAiC,CAAC,CAAC,CAAC;QACzD,CAAC;IACL,CAAC;IAED,YAAY,IAAY,EAAE,SAAmC,IAAI,EAAE,OAAsC;QACrG,KAAK,CAAC;YACF,GAAG,OAAO;YACV,IAAI;YACJ,MAAM,EAAE,MAAM,IAAI,MAAM,CAAC,iBAAkB;YAC3C,cAAc,EAAE,IAAI;YACpB,gBAAgB,EAAE,IAAI;YACtB,cAAc,EAAE,2BAA2B,CAAC,WAAW;YACvD,QAAQ,EAAE,2BAA2B,CAAC,QAAQ;YAC9C,QAAQ,EAAE,2BAA2B,CAAC,QAAQ;SACjD,CAAC,CAAC;QAGA,WAAM,GAAqB,IAAI,CAAC;QAEhC,8BAAyB,GAAG,IAAI,CAAC;IAJxC,CAAC;IAMe,IAAI,CAAC,iBAAiB,GAAG,KAAK;QAC1C,KAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAE9B,MAAM,MAAM,GAAG,IAAI,CAAC,YAAY,CAAC,MAAO,CAAC;QAEzC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC;YACtC,IAAI,IAAI,CAAC,yBAAyB,EAAE,CAAC;gBACjC,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;YACjI,CAAC;iBAAM,CAAC;gBACJ,MAAM,CAAC,UAAU,CAAC,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;YACpF,CAAC;QACL,CAAC;IACL,CAAC;;AA7CsB,uCAAW,GAAG,aAAa,AAAhB,CAAiB;AAE5B,oCAAQ,GAAG,CAAC,UAAU,CAAC,AAAf,CAAgB;AAExB,oCAAQ,GAAG,CAAC,eAAe,CAAC,AAApB,CAAqB","sourcesContent":["import type { Nullable, AbstractEngine, EffectWrapperCreationOptions, Camera } from \"core/index\";\r\nimport { EffectWrapper } from \"../Materials/effectRenderer\";\r\nimport { Engine } from \"../Engines/engine\";\r\nimport { TmpVectors } from \"core/Maths/math.vector\";\r\n\r\n/**\r\n * @internal\r\n */\r\nexport class ThinSSAO2CombinePostProcess extends EffectWrapper {\r\n    public static readonly FragmentUrl = \"ssaoCombine\";\r\n\r\n    public static readonly Uniforms = [\"viewport\"];\r\n\r\n    public static readonly Samplers = [\"originalColor\"];\r\n\r\n    protected override _gatherImports(useWebGPU: boolean, list: Promise<any>[]) {\r\n        if (useWebGPU) {\r\n            this._webGPUReady = true;\r\n            list.push(import(\"../ShadersWGSL/ssaoCombine.fragment\"));\r\n        } else {\r\n            list.push(import(\"../Shaders/ssaoCombine.fragment\"));\r\n        }\r\n    }\r\n\r\n    constructor(name: string, engine: Nullable<AbstractEngine> = null, options?: EffectWrapperCreationOptions) {\r\n        super({\r\n            ...options,\r\n            name,\r\n            engine: engine || Engine.LastCreatedEngine!,\r\n            useShaderStore: true,\r\n            useAsPostProcess: true,\r\n            fragmentShader: ThinSSAO2CombinePostProcess.FragmentUrl,\r\n            uniforms: ThinSSAO2CombinePostProcess.Uniforms,\r\n            samplers: ThinSSAO2CombinePostProcess.Samplers,\r\n        });\r\n    }\r\n\r\n    public camera: Nullable<Camera> = null;\r\n\r\n    public useViewportInCombineStage = true;\r\n\r\n    public override bind(noDefaultBindings = false) {\r\n        super.bind(noDefaultBindings);\r\n\r\n        const effect = this._drawWrapper.effect!;\r\n\r\n        if (this.camera) {\r\n            const viewport = this.camera.viewport;\r\n            if (this.useViewportInCombineStage) {\r\n                effect.setVector4(\"viewport\", TmpVectors.Vector4[0].copyFromFloats(viewport.x, viewport.y, viewport.width, viewport.height));\r\n            } else {\r\n                effect.setVector4(\"viewport\", TmpVectors.Vector4[0].copyFromFloats(0, 0, 1, 1));\r\n            }\r\n        }\r\n    }\r\n}\r\n"]}

package/PostProcesses/thinSSAO2PostProcess.d.ts

@@ -0,0 +1,45 @@
+import type { Nullable, Scene, EffectWrapperCreationOptions } from "../index.js";
+import { EffectWrapper } from "../Materials/effectRenderer.js";
+import { Camera } from "../Cameras/camera.js";
+/**
+ * @internal
+ */
+export declare class ThinSSAO2PostProcess extends EffectWrapper {
+    private static readonly ORTHO_DEPTH_PROJECTION;
+    private static readonly PERSPECTIVE_DEPTH_PROJECTION;
+    static readonly FragmentUrl = "ssao2";
+    static readonly Uniforms: string[];
+    static readonly Samplers: string[];
+    protected _gatherImports(useWebGPU: boolean, list: Promise<any>[]): void;
+    camera: Nullable<Camera>;
+    private _textureWidth;
+    get textureWidth(): number;
+    set textureWidth(width: number);
+    private _textureHeight;
+    get textureHeight(): number;
+    set textureHeight(height: number);
+    private _samples;
+    set samples(n: number);
+    get samples(): number;
+    totalStrength: number;
+    radius: number;
+    maxZ: number;
+    minZAspect: number;
+    base: number;
+    private _epsilon;
+    set epsilon(n: number);
+    get epsilon(): number;
+    private _scene;
+    private _randomTexture;
+    private _sampleSphere;
+    constructor(name: string, scene: Scene, options?: EffectWrapperCreationOptions);
+    bind(noDefaultBindings?: boolean): void;
+    dispose(): void;
+    private _createRandomTexture;
+    private _bits;
+    private _radicalInverseVdC;
+    private _hammersley;
+    private _hemisphereSampleUniform;
+    private _generateHemisphere;
+    private _getDefinesForSSAO;
+}