three-stdlib 2.35.6 → 2.35.8

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

package/shaders/LuminosityShader.d.cts

@@ -0,0 +1,13 @@
+/**
+ * Luminosity
+ * http://en.wikipedia.org/wiki/Luminosity
+ */
+export declare const LuminosityShader: {
+    uniforms: {
+        tDiffuse: {
+            value: null;
+        };
+    };
+    vertexShader: string;
+    fragmentShader: string;
+};

package/shaders/MirrorShader.d.cts

@@ -0,0 +1,18 @@
+/**
+ * Mirror Shader
+ * Copies half the input to the other half
+ *
+ * side: side of input to mirror (0 = left, 1 = right, 2 = top, 3 = bottom)
+ */
+export declare const MirrorShader: {
+    uniforms: {
+        tDiffuse: {
+            value: null;
+        };
+        side: {
+            value: number;
+        };
+    };
+    vertexShader: string;
+    fragmentShader: string;
+};

package/shaders/NormalMapShader.d.cts

@@ -0,0 +1,23 @@
+import type { Vector2 } from 'three';
+/**
+ * Normal map shader
+ * - compute normals from heightmap
+ */
+export declare const NormalMapShader: {
+    uniforms: {
+        heightMap: {
+            value: null;
+        };
+        resolution: {
+            value: Vector2;
+        };
+        scale: {
+            value: Vector2;
+        };
+        height: {
+            value: number;
+        };
+    };
+    vertexShader: string;
+    fragmentShader: string;
+};

package/shaders/NormalMapShader.d.ts

@@ -1,4 +1,4 @@
-import { Vector2 } from 'three';
+import type { Vector2 } from 'three';
 /**
  * Normal map shader
  * - compute normals from heightmap

package/shaders/ParallaxShader.d.cts

@@ -0,0 +1,28 @@
+export declare const ParallaxShader: {
+    modes: {
+        none: string;
+        basic: string;
+        steep: string;
+        occlusion: string;
+        relief: string;
+    };
+    uniforms: {
+        bumpMap: {
+            value: null;
+        };
+        map: {
+            value: null;
+        };
+        parallaxScale: {
+            value: null;
+        };
+        parallaxMinLayers: {
+            value: null;
+        };
+        parallaxMaxLayers: {
+            value: null;
+        };
+    };
+    vertexShader: string;
+    fragmentShader: string;
+};

package/shaders/PixelShader.d.cts

@@ -0,0 +1,18 @@
+/**
+ * Pixelation shader
+ */
+export declare const PixelShader: {
+    uniforms: {
+        tDiffuse: {
+            value: null;
+        };
+        resolution: {
+            value: null;
+        };
+        pixelSize: {
+            value: number;
+        };
+    };
+    vertexShader: string;
+    fragmentShader: string;
+};

package/shaders/RGBShiftShader.d.cts

@@ -0,0 +1,24 @@
+/**
+ * RGB Shift Shader
+ * Shifts red and blue channels from center in opposite directions
+ * Ported from http://kriss.cx/tom/2009/05/rgb-shift/
+ * by Tom Butterworth / http://kriss.cx/tom/
+ *
+ * amount: shift distance (1 is width of input)
+ * angle: shift angle in radians
+ */
+export declare const RGBShiftShader: {
+    uniforms: {
+        tDiffuse: {
+            value: null;
+        };
+        amount: {
+            value: number;
+        };
+        angle: {
+            value: number;
+        };
+    };
+    vertexShader: string;
+    fragmentShader: string;
+};

package/shaders/SAOShader.d.cts

@@ -0,0 +1,25 @@
+import type { Matrix4, Vector2 } from 'three';
+import type { IUniform, Texture } from 'three';
+import type { IShader } from './types.d.cts';
+export type SAOShaderDefines = Record<'DEPTH_PACKING' | 'DIFFUSE_TEXTURE' | 'NORMAL_TEXTURE' | 'NUM_RINGS' | 'NUM_SAMPLES' | 'PERSPECTIVE_CAMERA', number>;
+export type SAOShaderUniforms = {
+    bias: IUniform<number>;
+    cameraFar: IUniform<number>;
+    cameraInverseProjectionMatrix: IUniform<Matrix4>;
+    cameraNear: IUniform<number>;
+    cameraProjectionMatrix: IUniform<Matrix4>;
+    intensity: IUniform<number>;
+    kernelRadius: IUniform<number>;
+    minResolution: IUniform<number>;
+    randomSeed: IUniform<number>;
+    scale: IUniform<number>;
+    size: IUniform<Vector2>;
+    tDepth: IUniform<Texture | null>;
+    tDiffuse: IUniform<Texture | null>;
+    tNormal: IUniform<Texture | null>;
+};
+export interface ISAOShader extends IShader<SAOShaderUniforms, SAOShaderDefines> {
+    defines: SAOShaderDefines;
+    needsUpdate?: boolean;
+}
+export declare const SAOShader: ISAOShader;

package/shaders/SAOShader.d.ts

@@ -1,6 +1,6 @@
-import { Matrix4, Vector2 } from 'three';
+import type { Matrix4, Vector2 } from 'three';
 import type { IUniform, Texture } from 'three';
-import type { IShader } from './types';
+import type { IShader } from './types.d.ts';
 export type SAOShaderDefines = Record<'DEPTH_PACKING' | 'DIFFUSE_TEXTURE' | 'NORMAL_TEXTURE' | 'NUM_RINGS' | 'NUM_SAMPLES' | 'PERSPECTIVE_CAMERA', number>;
 export type SAOShaderUniforms = {
     bias: IUniform<number>;

package/shaders/SMAAShader.d.cts

@@ -0,0 +1,60 @@
+import type { Vector2 } from 'three';
+/**
+ * WebGL port of Subpixel Morphological Antialiasing (SMAA) v2.8
+ * Preset: SMAA 1x Medium (with color edge detection)
+ * https://github.com/iryoku/smaa/releases/tag/v2.8
+ */
+export declare const SMAAEdgesShader: {
+    defines: {
+        SMAA_THRESHOLD: string;
+    };
+    uniforms: {
+        tDiffuse: {
+            value: null;
+        };
+        resolution: {
+            value: Vector2;
+        };
+    };
+    vertexShader: string;
+    fragmentShader: string;
+};
+export declare const SMAAWeightsShader: {
+    defines: {
+        SMAA_MAX_SEARCH_STEPS: string;
+        SMAA_AREATEX_MAX_DISTANCE: string;
+        SMAA_AREATEX_PIXEL_SIZE: string;
+        SMAA_AREATEX_SUBTEX_SIZE: string;
+    };
+    uniforms: {
+        tDiffuse: {
+            value: null;
+        };
+        tArea: {
+            value: null;
+        };
+        tSearch: {
+            value: null;
+        };
+        resolution: {
+            value: Vector2;
+        };
+    };
+    vertexShader: string;
+    fragmentShader: string;
+};
+export declare const SMAABlendShader: {
+    uniforms: {
+        tDiffuse: {
+            value: null;
+        };
+        tColor: {
+            value: null;
+        };
+        resolution: {
+            value: Vector2;
+        };
+    };
+    vertexShader: string;
+    fragmentShader: string;
+};

package/shaders/SMAAShader.d.ts

@@ -1,4 +1,4 @@
-import { Vector2 } from 'three';
+import type { Vector2 } from 'three';
 /**
  * WebGL port of Subpixel Morphological Antialiasing (SMAA) v2.8
  * Preset: SMAA 1x Medium (with color edge detection)

package/shaders/SSAOShader.d.cts

@@ -0,0 +1,86 @@
+import type { Matrix4, Vector2 } from 'three';
+/**
+ * References:
+ * http://john-chapman-graphics.blogspot.com/2013/01/ssao-tutorial.html
+ * https://learnopengl.com/Advanced-Lighting/SSAO
+ * https://github.com/McNopper/OpenGL/blob/master/Example28/shader/ssao.frag.glsl
+ */
+export declare const SSAOShader: {
+    defines: {
+        PERSPECTIVE_CAMERA: number;
+        KERNEL_SIZE: number;
+    };
+    uniforms: {
+        tDiffuse: {
+            value: null;
+        };
+        tNormal: {
+            value: null;
+        };
+        tDepth: {
+            value: null;
+        };
+        tNoise: {
+            value: null;
+        };
+        kernel: {
+            value: null;
+        };
+        cameraNear: {
+            value: null;
+        };
+        cameraFar: {
+            value: null;
+        };
+        resolution: {
+            value: Vector2;
+        };
+        cameraProjectionMatrix: {
+            value: Matrix4;
+        };
+        cameraInverseProjectionMatrix: {
+            value: Matrix4;
+        };
+        kernelRadius: {
+            value: number;
+        };
+        minDistance: {
+            value: number;
+        };
+        maxDistance: {
+            value: number;
+        };
+    };
+    vertexShader: string;
+    fragmentShader: string;
+};
+export declare const SSAODepthShader: {
+    defines: {
+        PERSPECTIVE_CAMERA: number;
+    };
+    uniforms: {
+        tDepth: {
+            value: null;
+        };
+        cameraNear: {
+            value: null;
+        };
+        cameraFar: {
+            value: null;
+        };
+    };
+    vertexShader: string;
+    fragmentShader: string;
+};
+export declare const SSAOBlurShader: {
+    uniforms: {
+        tDiffuse: {
+            value: null;
+        };
+        resolution: {
+            value: Vector2;
+        };
+    };
+    vertexShader: string;
+    fragmentShader: string;
+};

package/shaders/SSAOShader.d.ts

@@ -1,4 +1,4 @@
-import { Matrix4, Vector2 } from 'three';
+import type { Matrix4, Vector2 } from 'three';
 /**
  * References:
  * http://john-chapman-graphics.blogspot.com/2013/01/ssao-tutorial.html