three-stdlib 2.35.7 → 2.35.8

package/shaders/ColorifyShader.d.ts

@@ -1,4 +1,4 @@
-import { Color } from 'three';
+import type { Color } from 'three';
 /**
  * Colorify shader
  */

package/shaders/ConvolutionShader.d.cts

@@ -0,0 +1,21 @@
+import type { Vector2 } from 'three';
+/**
+ * Convolution shader
+ * ported from o3d sample to WebGL / GLSL
+ * http://o3d.googlecode.com/svn/trunk/samples/convolution.html
+ */
+import type { IUniform, Texture } from 'three';
+import type { IShader } from './types.d.cts';
+export type ConvolutionShaderDefines = {
+    KERNEL_SIZE_FLOAT: string;
+    KERNEL_SIZE_INT: string;
+};
+export type ConvolutionShaderUniforms = {
+    cKernel: IUniform<number[]>;
+    tDiffuse: IUniform<Texture | null>;
+    uImageIncrement: IUniform<Vector2>;
+};
+export interface IConvolutionShader extends IShader<ConvolutionShaderUniforms, ConvolutionShaderDefines> {
+    buildKernel: (sigma: number) => number[];
+}
+export declare const ConvolutionShader: IConvolutionShader;

package/shaders/ConvolutionShader.d.ts

@@ -1,11 +1,11 @@
-import { Vector2 } from 'three';
+import type { Vector2 } from 'three';
 /**
  * Convolution shader
  * ported from o3d sample to WebGL / GLSL
  * http://o3d.googlecode.com/svn/trunk/samples/convolution.html
  */
 import type { IUniform, Texture } from 'three';
-import type { IShader } from './types';
+import type { IShader } from './types.d.ts';
 export type ConvolutionShaderDefines = {
     KERNEL_SIZE_FLOAT: string;
     KERNEL_SIZE_INT: string;

package/shaders/CopyShader.d.cts

@@ -0,0 +1,12 @@
+/**
+ * Full-screen textured quad shader
+ */
+import type { IUniform, Texture } from 'three';
+import type { IShader } from './types.d.cts';
+export type CopyShaderUniforms = {
+    opacity: IUniform<number>;
+    tDiffuse: IUniform<Texture | null>;
+};
+export interface ICopyShader extends IShader<CopyShaderUniforms> {
+}
+export declare const CopyShader: ICopyShader;

package/shaders/CopyShader.d.ts

@@ -2,7 +2,7 @@
  * Full-screen textured quad shader
  */
 import type { IUniform, Texture } from 'three';
-import type { IShader } from './types';
+import type { IShader } from './types.d.ts';
 export type CopyShaderUniforms = {
     opacity: IUniform<number>;
     tDiffuse: IUniform<Texture | null>;

package/shaders/DOFMipMapShader.d.cts

@@ -0,0 +1,23 @@
+/**
+ * Depth-of-field shader using mipmaps
+ * - from Matt Handley @applmak
+ * - requires power-of-2 sized render target with enabled mipmaps
+ */
+export declare const DOFMipMapShader: {
+    uniforms: {
+        tColor: {
+            value: null;
+        };
+        tDepth: {
+            value: null;
+        };
+        focus: {
+            value: number;
+        };
+        maxblur: {
+            value: number;
+        };
+    };
+    vertexShader: string;
+    fragmentShader: string;
+};

package/shaders/DepthLimitedBlurShader.d.cts

@@ -0,0 +1,28 @@
+import type { Vector2 } from 'three';
+import type { IUniform, Texture } from 'three';
+import type { IShader } from './types.d.cts';
+export type DepthLimitedBlurShaderDefines = {
+    DEPTH_PACKING: number;
+    KERNEL_RADIUS: number;
+    PERSPECTIVE_CAMERA: number;
+};
+export type DepthLimitedBlurShaderUniforms = {
+    cameraFar: IUniform<number>;
+    cameraNear: IUniform<number>;
+    depthCutoff: IUniform<number>;
+    sampleUvOffsets: IUniform<Vector2[]>;
+    sampleWeights: IUniform<number[]>;
+    size: IUniform<Vector2>;
+    tDepth: IUniform<Texture | null>;
+    tDiffuse: IUniform<Texture | null>;
+};
+export interface IDepthLimitedBlurShader extends IShader<DepthLimitedBlurShaderUniforms, DepthLimitedBlurShaderDefines> {
+    defines: DepthLimitedBlurShaderDefines;
+    needsUpdate?: boolean;
+}
+export declare const DepthLimitedBlurShader: IDepthLimitedBlurShader;
+export declare const BlurShaderUtils: {
+    createSampleWeights: (kernelRadius: number, stdDev: number) => number[];
+    createSampleOffsets: (kernelRadius: number, uvIncrement: Vector2) => Vector2[];
+    configure: (shader: IDepthLimitedBlurShader, kernelRadius: number, stdDev: number, uvIncrement: Vector2) => void;
+};

package/shaders/DepthLimitedBlurShader.d.ts

@@ -1,6 +1,6 @@
-import { Vector2 } from 'three';
+import type { Vector2 } from 'three';
 import type { IUniform, Texture } from 'three';
-import type { IShader } from './types';
+import type { IShader } from './types.d.ts';
 export type DepthLimitedBlurShaderDefines = {
     DEPTH_PACKING: number;
     KERNEL_RADIUS: number;

package/shaders/DigitalGlitch.d.cts

@@ -0,0 +1,39 @@
+export declare const DigitalGlitch: {
+    uniforms: {
+        tDiffuse: {
+            value: null;
+        };
+        tDisp: {
+            value: null;
+        };
+        byp: {
+            value: number;
+        };
+        amount: {
+            value: number;
+        };
+        angle: {
+            value: number;
+        };
+        seed: {
+            value: number;
+        };
+        seed_x: {
+            value: number;
+        };
+        seed_y: {
+            value: number;
+        };
+        distortion_x: {
+            value: number;
+        };
+        distortion_y: {
+            value: number;
+        };
+        col_s: {
+            value: number;
+        };
+    };
+    vertexShader: string;
+    fragmentShader: string;
+};

package/shaders/DotScreenShader.d.cts

@@ -0,0 +1,27 @@
+import type { Vector2 } from 'three';
+/**
+ * Dot screen shader
+ * based on glfx.js sepia shader
+ * https://github.com/evanw/glfx.js
+ */
+export declare const DotScreenShader: {
+    uniforms: {
+        tDiffuse: {
+            value: null;
+        };
+        tSize: {
+            value: Vector2;
+        };
+        center: {
+            value: Vector2;
+        };
+        angle: {
+            value: number;
+        };
+        scale: {
+            value: number;
+        };
+    };
+    vertexShader: string;
+    fragmentShader: string;
+};

package/shaders/DotScreenShader.d.ts

@@ -1,4 +1,4 @@
-import { Vector2 } from 'three';
+import type { Vector2 } from 'three';
 /**
  * Dot screen shader
  * based on glfx.js sepia shader

package/shaders/FXAAShader.d.cts

@@ -0,0 +1,19 @@
+import type { Vector2 } from 'three';
+/**
+ * NVIDIA FXAA by Timothy Lottes
+ * http://timothylottes.blogspot.com/2011/06/fxaa3-source-released.html
+ * - WebGL port by @supereggbert
+ * http://www.glge.org/demos/fxaa/
+ */
+export declare const FXAAShader: {
+    uniforms: {
+        tDiffuse: {
+            value: null;
+        };
+        resolution: {
+            value: Vector2;
+        };
+    };
+    vertexShader: string;
+    fragmentShader: string;
+};

package/shaders/FXAAShader.d.ts

@@ -1,4 +1,4 @@
-import { Vector2 } from 'three';
+import type { Vector2 } from 'three';
 /**
  * NVIDIA FXAA by Timothy Lottes
  * http://timothylottes.blogspot.com/2011/06/fxaa3-source-released.html

package/shaders/FilmShader.d.cts

@@ -0,0 +1,43 @@
+/**
+ * Film grain & scanlines shader
+ *
+ * - ported from HLSL to WebGL / GLSL
+ * http://www.truevision3d.com/forums/showcase/staticnoise_colorblackwhite_scanline_shaders-t18698.0.html
+ *
+ * Screen Space Static Postprocessor
+ *
+ * Produces an analogue noise overlay similar to a film grain / TV static
+ *
+ * Original implementation and noise algorithm
+ * Pat 'Hawthorne' Shearon
+ *
+ * Optimized scanlines + noise version with intensity scaling
+ * Georg 'Leviathan' Steinrohder
+ *
+ * This version is provided under a Creative Commons Attribution 3.0 License
+ * http://creativecommons.org/licenses/by/3.0/
+ */
+export declare const FilmShader: {
+    uniforms: {
+        tDiffuse: {
+            value: null;
+        };
+        time: {
+            value: number;
+        };
+        nIntensity: {
+            value: number;
+        };
+        sIntensity: {
+            value: number;
+        };
+        sCount: {
+            value: number;
+        };
+        grayscale: {
+            value: number;
+        };
+    };
+    vertexShader: string;
+    fragmentShader: string;
+};

package/shaders/FocusShader.d.cts

@@ -0,0 +1,26 @@
+/**
+ * Focus shader
+ * based on PaintEffect postprocess from ro.me
+ * http://code.google.com/p/3-dreams-of-black/source/browse/deploy/js/effects/PaintEffect.js
+ */
+export declare const FocusShader: {
+    uniforms: {
+        tDiffuse: {
+            value: null;
+        };
+        screenWidth: {
+            value: number;
+        };
+        screenHeight: {
+            value: number;
+        };
+        sampleDistance: {
+            value: number;
+        };
+        waveFactor: {
+            value: number;
+        };
+    };
+    vertexShader: string;
+    fragmentShader: string;
+};

package/shaders/FreiChenShader.d.cts

@@ -0,0 +1,19 @@
+import type { Vector2 } from 'three';
+/**
+ * Edge Detection Shader using Frei-Chen filter
+ * Based on http://rastergrid.com/blog/2011/01/frei-chen-edge-detector
+ *
+ * aspect: vec2 of (1/width, 1/height)
+ */
+export declare const FreiChenShader: {
+    uniforms: {
+        tDiffuse: {
+            value: null;
+        };
+        aspect: {
+            value: Vector2;
+        };
+    };
+    vertexShader: string;
+    fragmentShader: string;
+};

package/shaders/FreiChenShader.d.ts

@@ -1,4 +1,4 @@
-import { Vector2 } from 'three';
+import type { Vector2 } from 'three';
 /**
  * Edge Detection Shader using Frei-Chen filter
  * Based on http://rastergrid.com/blog/2011/01/frei-chen-edge-detector

package/shaders/FresnelShader.d.cts

@@ -0,0 +1,24 @@
+/**
+ * Based on Nvidia Cg tutorial
+ */
+export declare const FresnelShader: {
+    uniforms: {
+        mRefractionRatio: {
+            value: number;
+        };
+        mFresnelBias: {
+            value: number;
+        };
+        mFresnelPower: {
+            value: number;
+        };
+        mFresnelScale: {
+            value: number;
+        };
+        tCube: {
+            value: null;
+        };
+    };
+    vertexShader: string;
+    fragmentShader: string;
+};

package/shaders/GammaCorrectionShader.d.cts

@@ -0,0 +1,12 @@
+/**
+ * Gamma Correction Shader
+ * http://en.wikipedia.org/wiki/gamma_correction
+ */
+import type { IUniform, Texture } from 'three';
+import type { IShader } from './types.d.cts';
+export type GammaCorrectionShaderUniforms = {
+    tDiffuse: IUniform<Texture | null>;
+};
+export interface IGammaCorrectionShader extends IShader<GammaCorrectionShaderUniforms> {
+}
+export declare const GammaCorrectionShader: IGammaCorrectionShader;

package/shaders/GammaCorrectionShader.d.ts

@@ -3,7 +3,7 @@
  * http://en.wikipedia.org/wiki/gamma_correction
  */
 import type { IUniform, Texture } from 'three';
-import type { IShader } from './types';
+import type { IShader } from './types.d.ts';
 export type GammaCorrectionShaderUniforms = {
     tDiffuse: IUniform<Texture | null>;
 };

package/shaders/GodRaysShader.d.cts

@@ -0,0 +1,97 @@
+import type { Color, Vector3 } from 'three';
+/**
+ * God-rays (crepuscular rays)
+ *
+ * Similar implementation to the one used by Crytek for CryEngine 2 [Sousa2008].
+ * Blurs a mask generated from the depth map along radial lines emanating from the light
+ * source. The blur repeatedly applies a blur filter of increasing support but constant
+ * sample count to produce a blur filter with large support.
+ *
+ * My implementation performs 3 passes, similar to the implementation from Sousa. I found
+ * just 6 samples per pass produced acceptible results. The blur is applied three times,
+ * with decreasing filter support. The result is equivalent to a single pass with
+ * 6*6*6 = 216 samples.
+ *
+ * References:
+ *
+ * Sousa2008 - Crysis Next Gen Effects, GDC2008, http://www.crytek.com/sites/default/files/GDC08_SousaT_CrysisEffects.ppt
+ */
+export declare const GodRaysDepthMaskShader: {
+    uniforms: {
+        tInput: {
+            value: null;
+        };
+    };
+    vertexShader: string;
+    fragmentShader: string;
+};
+/**
+ * The god-ray generation shader.
+ *
+ * First pass:
+ *
+ * The depth map is blurred along radial lines towards the "sun". The
+ * output is written to a temporary render target (I used a 1/4 sized
+ * target).
+ *
+ * Pass two & three:
+ *
+ * The results of the previous pass are re-blurred, each time with a
+ * decreased distance between samples.
+ */
+export declare const GodRaysGenerateShader: {
+    uniforms: {
+        tInput: {
+            value: null;
+        };
+        fStepSize: {
+            value: number;
+        };
+        vSunPositionScreenSpace: {
+            value: Vector3;
+        };
+    };
+    vertexShader: string;
+    fragmentShader: string;
+};
+/**
+ * Additively applies god rays from texture tGodRays to a background (tColors).
+ * fGodRayIntensity attenuates the god rays.
+ */
+export declare const GodRaysCombineShader: {
+    uniforms: {
+        tColors: {
+            value: null;
+        };
+        tGodRays: {
+            value: null;
+        };
+        fGodRayIntensity: {
+            value: number;
+        };
+    };
+    vertexShader: string;
+    fragmentShader: string;
+};
+/**
+ * A dodgy sun/sky shader. Makes a bright spot at the sun location. Would be
+ * cheaper/faster/simpler to implement this as a simple sun sprite.
+ */
+export declare const GodRaysFakeSunShader: {
+    uniforms: {
+        vSunPositionScreenSpace: {
+            value: Vector3;
+        };
+        fAspect: {
+            value: number;
+        };
+        sunColor: {
+            value: Color;
+        };
+        bgColor: {
+            value: Color;
+        };
+    };
+    vertexShader: string;
+    fragmentShader: string;
+};

package/shaders/GodRaysShader.d.ts

@@ -1,4 +1,4 @@
-import { Color, Vector3 } from 'three';
+import type { Color, Vector3 } from 'three';
 /**
  * God-rays (crepuscular rays)
  *

package/shaders/HalftoneShader.d.cts

@@ -0,0 +1,51 @@
+/**
+ * RGB Halftone shader for three.js.
+ *	NOTE:
+ * 		Shape (1 = Dot, 2 = Ellipse, 3 = Line, 4 = Square)
+ *		Blending Mode (1 = Linear, 2 = Multiply, 3 = Add, 4 = Lighter, 5 = Darker)
+ */
+export declare const HalftoneShader: {
+    uniforms: {
+        tDiffuse: {
+            value: null;
+        };
+        shape: {
+            value: number;
+        };
+        radius: {
+            value: number;
+        };
+        rotateR: {
+            value: number;
+        };
+        rotateG: {
+            value: number;
+        };
+        rotateB: {
+            value: number;
+        };
+        scatter: {
+            value: number;
+        };
+        width: {
+            value: number;
+        };
+        height: {
+            value: number;
+        };
+        blending: {
+            value: number;
+        };
+        blendingMode: {
+            value: number;
+        };
+        greyscale: {
+            value: boolean;
+        };
+        disable: {
+            value: boolean;
+        };
+    };
+    vertexShader: string;
+    fragmentShader: string;
+};

package/shaders/HorizontalBlurShader.d.cts

@@ -0,0 +1,18 @@
+/**
+ * Two pass Gaussian blur filter (horizontal and vertical blur shaders)
+ * - described in http://www.gamerendering.com/2008/10/11/gaussian-blur-filter-shader/
+ *   and used in http://www.cake23.de/traveling-wavefronts-lit-up.html
+ *
+ * - 9 samples per pass
+ * - standard deviation 2.7
+ * - "h" and "v" parameters should be set to "1 / width" and "1 / height"
+ */
+import type { IUniform, Texture } from 'three';
+import type { IShader } from './types.d.cts';
+export type HorizontalBlurShaderUniforms = {
+    tDiffuse: IUniform<Texture | null>;
+    h: IUniform<number>;
+};
+export interface IHorizontalBlurShader extends IShader<HorizontalBlurShaderUniforms> {
+}
+export declare const HorizontalBlurShader: IHorizontalBlurShader;

package/shaders/HorizontalBlurShader.d.ts

@@ -8,7 +8,7 @@
  * - "h" and "v" parameters should be set to "1 / width" and "1 / height"
  */
 import type { IUniform, Texture } from 'three';
-import type { IShader } from './types';
+import type { IShader } from './types.d.ts';
 export type HorizontalBlurShaderUniforms = {
     tDiffuse: IUniform<Texture | null>;
     h: IUniform<number>;

package/shaders/HorizontalTiltShiftShader.d.cts

@@ -0,0 +1,23 @@
+/**
+ * Simple fake tilt-shift effect, modulating two pass Gaussian blur (see above) by vertical position
+ *
+ * - 9 samples per pass
+ * - standard deviation 2.7
+ * - "h" and "v" parameters should be set to "1 / width" and "1 / height"
+ * - "r" parameter control where "focused" horizontal line lies
+ */
+export declare const HorizontalTiltShiftShader: {
+    uniforms: {
+        tDiffuse: {
+            value: null;
+        };
+        h: {
+            value: number;
+        };
+        r: {
+            value: number;
+        };
+    };
+    vertexShader: string;
+    fragmentShader: string;
+};

package/shaders/HueSaturationShader.d.cts

@@ -0,0 +1,21 @@
+/**
+ * Hue and saturation adjustment
+ * https://github.com/evanw/glfx.js
+ * hue: -1 to 1 (-1 is 180 degrees in the negative direction, 0 is no change, etc.
+ * saturation: -1 to 1 (-1 is solid gray, 0 is no change, and 1 is maximum contrast)
+ */
+export declare const HueSaturationShader: {
+    uniforms: {
+        tDiffuse: {
+            value: null;
+        };
+        hue: {
+            value: number;
+        };
+        saturation: {
+            value: number;
+        };
+    };
+    vertexShader: string;
+    fragmentShader: string;
+};

package/shaders/KaleidoShader.d.cts

@@ -0,0 +1,24 @@
+/**
+ * Kaleidoscope Shader
+ * Radial reflection around center point
+ * Ported from: http://pixelshaders.com/editor/
+ * by Toby Schachman / http://tobyschachman.com/
+ *
+ * sides: number of reflections
+ * angle: initial angle in radians
+ */
+export declare const KaleidoShader: {
+    uniforms: {
+        tDiffuse: {
+            value: null;
+        };
+        sides: {
+            value: number;
+        };
+        angle: {
+            value: number;
+        };
+    };
+    vertexShader: string;
+    fragmentShader: string;
+};

package/shaders/LuminosityHighPassShader.d.cts

@@ -0,0 +1,27 @@
+import type { Color } from 'three';
+/**
+ * Luminosity
+ * http://en.wikipedia.org/wiki/Luminosity
+ */
+export declare const LuminosityHighPassShader: {
+    shaderID: string;
+    uniforms: {
+        tDiffuse: {
+            value: null;
+        };
+        luminosityThreshold: {
+            value: number;
+        };
+        smoothWidth: {
+            value: number;
+        };
+        defaultColor: {
+            value: Color;
+        };
+        defaultOpacity: {
+            value: number;
+        };
+    };
+    vertexShader: string;
+    fragmentShader: string;
+};

package/shaders/LuminosityHighPassShader.d.ts

@@ -1,4 +1,4 @@
-import { Color } from 'three';
+import type { Color } from 'three';
 /**
  * Luminosity
  * http://en.wikipedia.org/wiki/Luminosity