angular-three-postprocessing 4.0.0-next.98 → 4.0.0

package/README.md

@@ -2,6 +2,10 @@
 
 This is the main entry point for post-processing effects in Angular Three. It provides a way to apply various visual effects to your 3D scene after it has been rendered. This library relies on `maath`, `three-stdlib`, and `postprocessing` as dependencies.
 
+## Documentation
+
+All public APIs are documented with JSDoc comments. Your IDE will provide inline documentation, parameter hints, and examples as you code.
+
 ## Installation
 
 ```bash
@@ -14,7 +18,16 @@ npm install angular-three-postprocessing three-stdlib maath postprocessing
 
 This is a wrapper component that manages and applies post-processing effects to your scene. It takes content children of effects and applies them in the order they are provided.
 
-### Object Inputs (NgtpEffectComposerOptions)
+### Usage
+
+```html
+<ngtp-effect-composer [options]="{ multisampling: 0 }">
+	<ngtp-bloom [options]="{ luminanceThreshold: 0.9, intensity: 0.5 }" />
+	<ngtp-vignette [options]="{ darkness: 0.5 }" />
+</ngtp-effect-composer>
+```
+
+### Options (NgtpEffectComposerOptions)
 
 | Property           | Description                                                                                       | Default Value |
 | ------------------ | ------------------------------------------------------------------------------------------------- | ------------- |
@@ -30,30 +43,76 @@ This is a wrapper component that manages and applies post-processing effects to
 | `camera`           | The camera to use for rendering. If not provided, the default camera from the store will be used. | undefined     |
 | `scene`            | The scene to render. If not provided, the default scene from the store will be used.              | undefined     |
 
-````html
-<ngtp-effect-composer [options]="{ multisampling: 0, frameBufferType: FloatType, enableNormalPass: true }">
-	<ngtp-bloom />
-</ngtp-effect-composer>
-```
-````
+## Effects
+
+All effects are available from `angular-three-postprocessing`:
 
-### NgtpEffectComposerApi
+| Effect                    | Selector                    | Description                           |
+| ------------------------- | --------------------------- | ------------------------------------- |
+| `NgtpAscii`               | `ngtp-ascii`                | ASCII art effect                      |
+| `NgtpBloom`               | `ngtp-bloom`                | Bloom/glow effect                     |
+| `NgtpBrightnessContrast`  | `ngtp-brightness-contrast`  | Brightness and contrast adjustment    |
+| `NgtpChromaticAberration` | `ngtp-chromatic-aberration` | Chromatic aberration effect           |
+| `NgtpColorAverage`        | `ngtp-color-average`        | Color averaging effect                |
+| `NgtpColorDepth`          | `ngtp-color-depth`          | Color depth reduction                 |
+| `NgtpDepth`               | `ngtp-depth`                | Depth visualization                   |
+| `NgtpDepthOfField`        | `ngtp-depth-of-field`       | Depth of field effect                 |
+| `NgtpDotScreen`           | `ngtp-dot-screen`           | Dot screen effect                     |
+| `NgtpFXAA`                | `ngtp-fxaa`                 | Fast approximate anti-aliasing        |
+| `NgtpGlitch`              | `ngtp-glitch`               | Glitch effect                         |
+| `NgtpGodRays`             | `ngtp-god-rays`             | God rays/light shafts                 |
+| `NgtpGrid`                | `ngtp-grid`                 | Grid overlay                          |
+| `NgtpHueSaturation`       | `ngtp-hue-saturation`       | Hue and saturation adjustment         |
+| `NgtpLensFlare`           | `ngtp-lens-flare`           | Lens flare effect                     |
+| `NgtpLUT`                 | `ngtp-lut`                  | LUT (Look-Up Table) color grading     |
+| `NgtpNoise`               | `ngtp-noise`                | Noise effect                          |
+| `NgtpOutline`             | `ngtp-outline`              | Outline effect                        |
+| `NgtpPixelation`          | `ngtp-pixelation`           | Pixelation effect                     |
+| `NgtpScanline`            | `ngtp-scanline`             | Scanline effect                       |
+| `NgtpSelectiveBloom`      | `ngtp-selective-bloom`      | Selective bloom on specific objects   |
+| `NgtpSepia`               | `ngtp-sepia`                | Sepia tone effect                     |
+| `NgtpShockWave`           | `ngtp-shock-wave`           | Shock wave distortion                 |
+| `NgtpSMAA`                | `ngtp-smaa`                 | Subpixel morphological anti-aliasing  |
+| `NgtpTiltShift`           | `ngtp-tilt-shift`           | Tilt-shift blur                       |
+| `NgtpTiltShift2`          | `ngtp-tilt-shift-2`         | Alternative tilt-shift implementation |
+| `NgtpToneMapping`         | `ngtp-tone-mapping`         | Tone mapping                          |
+| `NgtpVignette`            | `ngtp-vignette`             | Vignette darkening                    |
+| `NgtpWater`               | `ngtp-water`                | Water effect                          |
 
-This is an interface that provides access to the underlying `NgtpEffectComposer` instance, as well as the `camera` and `scene` being used. It also includes references to the `NormalPass` and `DepthDownsamplingPass` if they are enabled
+### Effect Example
 
-```ts
-export interface NgtpEffectComposerApi {
-	composer: EffectComposer;
-	camera: Camera;
-	scene: Scene;
-	normalPass: NormalPass | null;
-	downSamplingPass: DepthDownsamplingPass | null;
-	resolutionScale?: number;
-}
+```typescript
+import { Component, CUSTOM_ELEMENTS_SCHEMA } from '@angular/core';
+import { NgtpEffectComposer, NgtpBloom, NgtpVignette, NgtpNoise } from 'angular-three-postprocessing';
+
+@Component({
+	template: `
+		<ngtp-effect-composer>
+			<ngtp-bloom [options]="{ luminanceThreshold: 0.9, luminanceSmoothing: 0.025, intensity: 0.5 }" />
+			<ngtp-noise [options]="{ opacity: 0.02 }" />
+			<ngtp-vignette [options]="{ eskil: false, offset: 0.1, darkness: 1.1 }" />
+		</ngtp-effect-composer>
+	`,
+	imports: [NgtpEffectComposer, NgtpBloom, NgtpVignette, NgtpNoise],
+	schemas: [CUSTOM_ELEMENTS_SCHEMA],
+})
+export class PostProcessing {}
 ```
 
-To retrieve the `NgtpEffectComposerApi` for components within `<ngtp-effect-composer />`, you can use the `injectEffectComposerApi` function.
+## N8AO (Ambient Occlusion)
 
-## Effects
+A separate sub-library provides N8 Ambient Occlusion:
+
+```bash
+npm install n8ao
+```
 
-TBD
+```typescript
+import { NgtpN8AO } from 'angular-three-postprocessing/n8ao';
+```
+
+```html
+<ngtp-effect-composer [options]="{ enableNormalPass: true }">
+	<ngtp-n8ao [options]="{ aoRadius: 0.5, intensity: 1 }" />
+</ngtp-effect-composer>
+```

package/fesm2022/angular-three-postprocessing-n8ao.mjs

@@ -1,6 +1,6 @@
 import { N8AOPostPass } from 'n8ao';
 import * as i0 from '@angular/core';
-import { input, inject, computed, effect, Component, CUSTOM_ELEMENTS_SCHEMA, ChangeDetectionStrategy } from '@angular/core';
+import { input, inject, computed, effect, ChangeDetectionStrategy, CUSTOM_ELEMENTS_SCHEMA, Component } from '@angular/core';
 import { pick, applyProps, NgtArgs } from 'angular-three';
 import { NgtpEffectComposer } from 'angular-three-postprocessing';
 import { mergeInputs } from 'ngxtension/inject-inputs';
@@ -28,15 +28,46 @@ const defaultOptions = {
     transparencyAware: false,
     accumulate: false,
 };
+/**
+ * Angular component that applies N8AO (N8 Ambient Occlusion) to the scene.
+ *
+ * N8AO is a high-quality screen-space ambient occlusion effect that adds
+ * realistic shadowing to crevices, corners, and areas where objects meet.
+ * It provides various quality presets and fine-grained control over the
+ * AO appearance.
+ *
+ * @example
+ * ```html
+ * <ngtp-effect-composer>
+ *   <ngtp-n8ao [options]="{ intensity: 3, aoRadius: 2 }" />
+ * </ngtp-effect-composer>
+ * ```
+ *
+ * @example
+ * ```html
+ * <!-- Using quality preset -->
+ * <ngtp-effect-composer>
+ *   <ngtp-n8ao [options]="{ quality: 'high' }" />
+ * </ngtp-effect-composer>
+ * ```
+ */
 class NgtpN8AO {
     constructor() {
-        this.options = input(defaultOptions, { transform: mergeInputs(defaultOptions) });
+        /**
+         * Configuration options for the N8AO effect.
+         * @see NgtpN8AOOptions
+         */
+        this.options = input(defaultOptions, { ...(ngDevMode ? { debugName: "options" } : {}), transform: mergeInputs(defaultOptions) });
         this.quality = pick(this.options, 'quality');
         this.effectComposer = inject(NgtpEffectComposer);
+        /**
+         * The underlying N8AOPostPass instance.
+         * Created with the scene and camera from the effect composer.
+         */
         this.effect = computed(() => {
             const [scene, camera] = [this.effectComposer.scene(), this.effectComposer.camera()];
             return new N8AOPostPass(scene, camera);
-        });
+        }, ...(ngDevMode ? [{ debugName: "effect" }] : []));
         effect(() => {
             const n8aoEffect = this.effect();
             if (!n8aoEffect)
@@ -52,6 +83,10 @@ class NgtpN8AO {
             onCleanup(() => effect.dispose());
         });
     }
+    /**
+     * Applies a quality preset to the effect.
+     * Converts the quality string to title case and calls the effect's setQuality method.
+     */
     setQualityEffect() {
         const effect = this.effect();
         if (!effect)
@@ -62,12 +97,12 @@ class NgtpN8AO {
         const titleCaseQuality = quality.charAt(0).toUpperCase() + quality.slice(1);
         effect.setQuality(titleCaseQuality);
     }
-    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "19.2.1", ngImport: i0, type: NgtpN8AO, deps: [], target: i0.ɵɵFactoryTarget.Component }); }
-    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "19.2.1", type: NgtpN8AO, isStandalone: true, selector: "ngtp-n8ao", inputs: { options: { classPropertyName: "options", publicName: "options", isSignal: true, isRequired: false, transformFunction: null } }, ngImport: i0, template: `
+    static { this.ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.0.6", ngImport: i0, type: NgtpN8AO, deps: [], target: i0.ɵɵFactoryTarget.Component }); }
+    static { this.ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.1.0", version: "21.0.6", type: NgtpN8AO, isStandalone: true, selector: "ngtp-n8ao", inputs: { options: { classPropertyName: "options", publicName: "options", isSignal: true, isRequired: false, transformFunction: null } }, ngImport: i0, template: `
 		<ngt-primitive *args="[effect()]" />
 	`, isInline: true, dependencies: [{ kind: "directive", type: NgtArgs, selector: "ng-template[args]", inputs: ["args"] }], changeDetection: i0.ChangeDetectionStrategy.OnPush }); }
 }
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.1", ngImport: i0, type: NgtpN8AO, decorators: [{
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.0.6", ngImport: i0, type: NgtpN8AO, decorators: [{
             type: Component,
             args: [{
                     selector: 'ngtp-n8ao',
@@ -78,7 +113,7 @@ i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "19.2.1", ngImpor
                     schemas: [CUSTOM_ELEMENTS_SCHEMA],
                     changeDetection: ChangeDetectionStrategy.OnPush,
                 }]
-        }], ctorParameters: () => [] });
+        }], ctorParameters: () => [], propDecorators: { options: [{ type: i0.Input, args: [{ isSignal: true, alias: "options", required: false }] }] } });
 
 /**
  * Generated bundle index. Do not edit.

package/fesm2022/angular-three-postprocessing-n8ao.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"angular-three-postprocessing-n8ao.mjs","sources":["../../../../libs/postprocessing/n8ao/src/lib/n8ao.ts","../../../../libs/postprocessing/n8ao/src/angular-three-postprocessing-n8ao.ts"],"sourcesContent":["// @ts-expect-error - n8ao is not typed\nimport { N8AOPostPass } from 'n8ao';\n\nimport {\n\tChangeDetectionStrategy,\n\tComponent,\n\tcomputed,\n\tCUSTOM_ELEMENTS_SCHEMA,\n\teffect,\n\tinject,\n\tinput,\n} from '@angular/core';\nimport { applyProps, NgtArgs, pick } from 'angular-three';\nimport { NgtpEffectComposer } from 'angular-three-postprocessing';\nimport { mergeInputs } from 'ngxtension/inject-inputs';\nimport * as THREE from 'three';\n\nexport interface NgtpN8AOOptions {\n\taoRadius: number;\n\taoTones: number;\n\tdistanceFalloff: number;\n\tintensity: number;\n\tbiasOffset: number;\n\tbiasMultiplier: number;\n\taoSamples: number;\n\tdenoiseSamples: number;\n\tdenoiseRadius: number;\n\tcolor: THREE.ColorRepresentation;\n\thalfRes: boolean;\n\tdepthAwareUpsampling: boolean;\n\tscreenSpaceRadius: boolean;\n\trenderMode: 0 | 1 | 2 | 3 | 4;\n\tdenoiseIterations: number;\n\ttransparencyAware: boolean;\n\tgammaCorrection: boolean;\n\tlogarithmicDepthBuffer: boolean;\n\tcolorMultiply: boolean;\n\taccumulate: boolean;\n\tquality?: 'performance' | 'low' | 'medium' | 'high' | 'ultra';\n}\n\nconst defaultOptions: NgtpN8AOOptions = {\n\taoSamples: 16,\n\taoRadius: 5.0,\n\taoTones: 0.0,\n\tdenoiseSamples: 8,\n\tdenoiseRadius: 12,\n\tdistanceFalloff: 1.0,\n\tintensity: 5,\n\tdenoiseIterations: 2.0,\n\trenderMode: 0,\n\tbiasOffset: 0.0,\n\tbiasMultiplier: 0.0,\n\tcolor: 'black',\n\tgammaCorrection: true,\n\tlogarithmicDepthBuffer: false,\n\tscreenSpaceRadius: false,\n\thalfRes: false,\n\tdepthAwareUpsampling: true,\n\tcolorMultiply: true,\n\ttransparencyAware: false,\n\taccumulate: false,\n};\n\n@Component({\n\tselector: 'ngtp-n8ao',\n\ttemplate: `\n\t\t<ngt-primitive *args=\"[effect()]\" />\n\t`,\n\timports: [NgtArgs],\n\tschemas: [CUSTOM_ELEMENTS_SCHEMA],\n\tchangeDetection: ChangeDetectionStrategy.OnPush,\n})\nexport class NgtpN8AO {\n\toptions = input(defaultOptions, { transform: mergeInputs(defaultOptions) });\n\n\tprivate quality = pick(this.options, 'quality');\n\n\tprivate effectComposer = inject(NgtpEffectComposer);\n\n\tprotected effect = computed(() => {\n\t\tconst [scene, camera] = [this.effectComposer.scene(), this.effectComposer.camera()];\n\t\treturn new N8AOPostPass(scene, camera);\n\t});\n\n\tconstructor() {\n\t\teffect(() => {\n\t\t\tconst n8aoEffect = this.effect();\n\t\t\tif (!n8aoEffect) return;\n\n\t\t\tconst { quality: _, ...configurations } = this.options();\n\t\t\tapplyProps(n8aoEffect.configuration, configurations);\n\t\t});\n\n\t\teffect(() => {\n\t\t\tthis.setQualityEffect();\n\t\t});\n\n\t\teffect((onCleanup) => {\n\t\t\tconst effect = this.effect();\n\t\t\tonCleanup(() => effect.dispose());\n\t\t});\n\t}\n\n\tprivate setQualityEffect() {\n\t\tconst effect = this.effect();\n\t\tif (!effect) return;\n\n\t\tconst quality = this.quality();\n\t\tif (!quality) return;\n\n\t\tconst titleCaseQuality = quality.charAt(0).toUpperCase() + quality.slice(1);\n\t\teffect.setQuality(titleCaseQuality);\n\t}\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":";;;;;;;AAAA;AAyCA,MAAM,cAAc,GAAoB;AACvC,IAAA,SAAS,EAAE,EAAE;AACb,IAAA,QAAQ,EAAE,GAAG;AACb,IAAA,OAAO,EAAE,GAAG;AACZ,IAAA,cAAc,EAAE,CAAC;AACjB,IAAA,aAAa,EAAE,EAAE;AACjB,IAAA,eAAe,EAAE,GAAG;AACpB,IAAA,SAAS,EAAE,CAAC;AACZ,IAAA,iBAAiB,EAAE,GAAG;AACtB,IAAA,UAAU,EAAE,CAAC;AACb,IAAA,UAAU,EAAE,GAAG;AACf,IAAA,cAAc,EAAE,GAAG;AACnB,IAAA,KAAK,EAAE,OAAO;AACd,IAAA,eAAe,EAAE,IAAI;AACrB,IAAA,sBAAsB,EAAE,KAAK;AAC7B,IAAA,iBAAiB,EAAE,KAAK;AACxB,IAAA,OAAO,EAAE,KAAK;AACd,IAAA,oBAAoB,EAAE,IAAI;AAC1B,IAAA,aAAa,EAAE,IAAI;AACnB,IAAA,iBAAiB,EAAE,KAAK;AACxB,IAAA,UAAU,EAAE,KAAK;CACjB;MAWY,QAAQ,CAAA;AAYpB,IAAA,WAAA,GAAA;AAXA,QAAA,IAAA,CAAA,OAAO,GAAG,KAAK,CAAC,cAAc,EAAE,EAAE,SAAS,EAAE,WAAW,CAAC,cAAc,CAAC,EAAE,CAAC;QAEnE,IAAO,CAAA,OAAA,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,CAAC;AAEvC,QAAA,IAAA,CAAA,cAAc,GAAG,MAAM,CAAC,kBAAkB,CAAC;AAEzC,QAAA,IAAA,CAAA,MAAM,GAAG,QAAQ,CAAC,MAAK;YAChC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC;AACnF,YAAA,OAAO,IAAI,YAAY,CAAC,KAAK,EAAE,MAAM,CAAC;AACvC,SAAC,CAAC;QAGD,MAAM,CAAC,MAAK;AACX,YAAA,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,EAAE;AAChC,YAAA,IAAI,CAAC,UAAU;gBAAE;AAEjB,YAAA,MAAM,EAAE,OAAO,EAAE,CAAC,EAAE,GAAG,cAAc,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE;AACxD,YAAA,UAAU,CAAC,UAAU,CAAC,aAAa,EAAE,cAAc,CAAC;AACrD,SAAC,CAAC;QAEF,MAAM,CAAC,MAAK;YACX,IAAI,CAAC,gBAAgB,EAAE;AACxB,SAAC,CAAC;AAEF,QAAA,MAAM,CAAC,CAAC,SAAS,KAAI;AACpB,YAAA,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE;YAC5B,SAAS,CAAC,MAAM,MAAM,CAAC,OAAO,EAAE,CAAC;AAClC,SAAC,CAAC;;IAGK,gBAAgB,GAAA;AACvB,QAAA,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE;AAC5B,QAAA,IAAI,CAAC,MAAM;YAAE;AAEb,QAAA,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE;AAC9B,QAAA,IAAI,CAAC,OAAO;YAAE;AAEd,QAAA,MAAM,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;AAC3E,QAAA,MAAM,CAAC,UAAU,CAAC,gBAAgB,CAAC;;8GAvCxB,QAAQ,EAAA,IAAA,EAAA,EAAA,EAAA,MAAA,EAAA,EAAA,CAAA,eAAA,CAAA,SAAA,EAAA,CAAA,CAAA;AAAR,IAAA,SAAA,IAAA,CAAA,IAAA,GAAA,EAAA,CAAA,oBAAA,CAAA,EAAA,UAAA,EAAA,QAAA,EAAA,OAAA,EAAA,QAAA,EAAA,IAAA,EAAA,QAAQ,EAPV,YAAA,EAAA,IAAA,EAAA,QAAA,EAAA,WAAA,EAAA,MAAA,EAAA,EAAA,OAAA,EAAA,EAAA,iBAAA,EAAA,SAAA,EAAA,UAAA,EAAA,SAAA,EAAA,QAAA,EAAA,IAAA,EAAA,UAAA,EAAA,KAAA,EAAA,iBAAA,EAAA,IAAA,EAAA,EAAA,EAAA,QAAA,EAAA,EAAA,EAAA,QAAA,EAAA;;AAET,CAAA,CAAA,EAAA,QAAA,EAAA,IAAA,EAAA,YAAA,EAAA,CAAA,EAAA,IAAA,EAAA,WAAA,EAAA,IAAA,EACS,OAAO,EAAA,QAAA,EAAA,mBAAA,EAAA,MAAA,EAAA,CAAA,MAAA,CAAA,EAAA,CAAA,EAAA,eAAA,EAAA,EAAA,CAAA,uBAAA,CAAA,MAAA,EAAA,CAAA,CAAA;;2FAIL,QAAQ,EAAA,UAAA,EAAA,CAAA;kBATpB,SAAS;AAAC,YAAA,IAAA,EAAA,CAAA;AACV,oBAAA,QAAQ,EAAE,WAAW;AACrB,oBAAA,QAAQ,EAAE;;AAET,CAAA,CAAA;oBACD,OAAO,EAAE,CAAC,OAAO,CAAC;oBAClB,OAAO,EAAE,CAAC,sBAAsB,CAAC;oBACjC,eAAe,EAAE,uBAAuB,CAAC,MAAM;AAC/C,iBAAA;;;ACxED;;AAEG;;;;"}
+{"version":3,"file":"angular-three-postprocessing-n8ao.mjs","sources":["../../../../libs/postprocessing/n8ao/src/lib/n8ao.ts","../../../../libs/postprocessing/n8ao/src/angular-three-postprocessing-n8ao.ts"],"sourcesContent":["// @ts-expect-error - n8ao is not typed\nimport { N8AOPostPass } from 'n8ao';\n\nimport {\n\tChangeDetectionStrategy,\n\tComponent,\n\tcomputed,\n\tCUSTOM_ELEMENTS_SCHEMA,\n\teffect,\n\tinject,\n\tinput,\n} from '@angular/core';\nimport { applyProps, NgtArgs, pick } from 'angular-three';\nimport { NgtpEffectComposer } from 'angular-three-postprocessing';\nimport { mergeInputs } from 'ngxtension/inject-inputs';\nimport * as THREE from 'three';\n\n/**\n * Configuration options for the N8AO (N8 Ambient Occlusion) effect.\n *\n * N8AO is a high-quality, screen-space ambient occlusion implementation\n * that provides realistic shadowing in crevices and corners.\n */\nexport interface NgtpN8AOOptions {\n\t/**\n\t * Radius of the ambient occlusion effect in world units.\n\t * @default 5.0\n\t */\n\taoRadius: number;\n\n\t/**\n\t * Number of tones for AO gradient.\n\t * @default 0.0\n\t */\n\taoTones: number;\n\n\t/**\n\t * How quickly the AO effect falls off with distance.\n\t * @default 1.0\n\t */\n\tdistanceFalloff: number;\n\n\t/**\n\t * Intensity/strength of the ambient occlusion effect.\n\t * @default 5\n\t */\n\tintensity: number;\n\n\t/**\n\t * Bias offset for depth comparison.\n\t * @default 0.0\n\t */\n\tbiasOffset: number;\n\n\t/**\n\t * Bias multiplier for depth comparison.\n\t * @default 0.0\n\t */\n\tbiasMultiplier: number;\n\n\t/**\n\t * Number of samples for ambient occlusion calculation.\n\t * Higher values = better quality but slower.\n\t * @default 16\n\t */\n\taoSamples: number;\n\n\t/**\n\t * Number of samples for denoising.\n\t * @default 8\n\t */\n\tdenoiseSamples: number;\n\n\t/**\n\t * Radius of the denoising filter.\n\t * @default 12\n\t */\n\tdenoiseRadius: number;\n\n\t/**\n\t * Color of the ambient occlusion shadows.\n\t * @default 'black'\n\t */\n\tcolor: THREE.ColorRepresentation;\n\n\t/**\n\t * Whether to render at half resolution for better performance.\n\t * @default false\n\t */\n\thalfRes: boolean;\n\n\t/**\n\t * Whether to use depth-aware upsampling when using half resolution.\n\t * @default true\n\t */\n\tdepthAwareUpsampling: boolean;\n\n\t/**\n\t * Whether to use screen-space radius instead of world-space.\n\t * @default false\n\t */\n\tscreenSpaceRadius: boolean;\n\n\t/**\n\t * Render mode for debugging and visualization.\n\t * 0: Combined, 1: AO only, 2: Normals, 3: Depth, 4: Denoise\n\t * @default 0\n\t */\n\trenderMode: 0 | 1 | 2 | 3 | 4;\n\n\t/**\n\t * Number of iterations for the denoising filter.\n\t * @default 2.0\n\t */\n\tdenoiseIterations: number;\n\n\t/**\n\t * Whether to handle transparent objects correctly.\n\t * @default false\n\t */\n\ttransparencyAware: boolean;\n\n\t/**\n\t * Whether to apply gamma correction.\n\t * @default true\n\t */\n\tgammaCorrection: boolean;\n\n\t/**\n\t * Whether to use logarithmic depth buffer.\n\t * @default false\n\t */\n\tlogarithmicDepthBuffer: boolean;\n\n\t/**\n\t * Whether to multiply the color instead of darkening.\n\t * @default true\n\t */\n\tcolorMultiply: boolean;\n\n\t/**\n\t * Whether to accumulate samples over frames for better quality.\n\t * @default false\n\t */\n\taccumulate: boolean;\n\n\t/**\n\t * Quality preset that overrides individual settings.\n\t * Options: 'performance', 'low', 'medium', 'high', 'ultra'\n\t * @default undefined\n\t */\n\tquality?: 'performance' | 'low' | 'medium' | 'high' | 'ultra';\n}\n\nconst defaultOptions: NgtpN8AOOptions = {\n\taoSamples: 16,\n\taoRadius: 5.0,\n\taoTones: 0.0,\n\tdenoiseSamples: 8,\n\tdenoiseRadius: 12,\n\tdistanceFalloff: 1.0,\n\tintensity: 5,\n\tdenoiseIterations: 2.0,\n\trenderMode: 0,\n\tbiasOffset: 0.0,\n\tbiasMultiplier: 0.0,\n\tcolor: 'black',\n\tgammaCorrection: true,\n\tlogarithmicDepthBuffer: false,\n\tscreenSpaceRadius: false,\n\thalfRes: false,\n\tdepthAwareUpsampling: true,\n\tcolorMultiply: true,\n\ttransparencyAware: false,\n\taccumulate: false,\n};\n\n/**\n * Angular component that applies N8AO (N8 Ambient Occlusion) to the scene.\n *\n * N8AO is a high-quality screen-space ambient occlusion effect that adds\n * realistic shadowing to crevices, corners, and areas where objects meet.\n * It provides various quality presets and fine-grained control over the\n * AO appearance.\n *\n * @example\n * ```html\n * <ngtp-effect-composer>\n *   <ngtp-n8ao [options]=\"{ intensity: 3, aoRadius: 2 }\" />\n * </ngtp-effect-composer>\n * ```\n *\n * @example\n * ```html\n * <!-- Using quality preset -->\n * <ngtp-effect-composer>\n *   <ngtp-n8ao [options]=\"{ quality: 'high' }\" />\n * </ngtp-effect-composer>\n * ```\n */\n@Component({\n\tselector: 'ngtp-n8ao',\n\ttemplate: `\n\t\t<ngt-primitive *args=\"[effect()]\" />\n\t`,\n\timports: [NgtArgs],\n\tschemas: [CUSTOM_ELEMENTS_SCHEMA],\n\tchangeDetection: ChangeDetectionStrategy.OnPush,\n})\nexport class NgtpN8AO {\n\t/**\n\t * Configuration options for the N8AO effect.\n\t * @see NgtpN8AOOptions\n\t */\n\toptions = input(defaultOptions, { transform: mergeInputs(defaultOptions) });\n\n\tprivate quality = pick(this.options, 'quality');\n\n\tprivate effectComposer = inject(NgtpEffectComposer);\n\n\t/**\n\t * The underlying N8AOPostPass instance.\n\t * Created with the scene and camera from the effect composer.\n\t */\n\tprotected effect = computed(() => {\n\t\tconst [scene, camera] = [this.effectComposer.scene(), this.effectComposer.camera()];\n\t\treturn new N8AOPostPass(scene, camera);\n\t});\n\n\tconstructor() {\n\t\teffect(() => {\n\t\t\tconst n8aoEffect = this.effect();\n\t\t\tif (!n8aoEffect) return;\n\n\t\t\tconst { quality: _, ...configurations } = this.options();\n\t\t\tapplyProps(n8aoEffect.configuration, configurations);\n\t\t});\n\n\t\teffect(() => {\n\t\t\tthis.setQualityEffect();\n\t\t});\n\n\t\teffect((onCleanup) => {\n\t\t\tconst effect = this.effect();\n\t\t\tonCleanup(() => effect.dispose());\n\t\t});\n\t}\n\n\t/**\n\t * Applies a quality preset to the effect.\n\t * Converts the quality string to title case and calls the effect's setQuality method.\n\t */\n\tprivate setQualityEffect() {\n\t\tconst effect = this.effect();\n\t\tif (!effect) return;\n\n\t\tconst quality = this.quality();\n\t\tif (!quality) return;\n\n\t\tconst titleCaseQuality = quality.charAt(0).toUpperCase() + quality.slice(1);\n\t\teffect.setQuality(titleCaseQuality);\n\t}\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './index';\n"],"names":[],"mappings":"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"}