@plastic-software/three 0.175.14 → 0.179.0

package/examples/jsm/postprocessing/GTAOPass.js

@@ -38,6 +38,7 @@ import { SimplexNoise } from '../math/SimplexNoise.js';
  * ```
  *
  * @augments Pass
+ * @three_import import { GTAOPass } from 'three/addons/postprocessing/GTAOPass.js';
  */
 class GTAOPass extends Pass {
 
@@ -102,7 +103,7 @@ class GTAOPass extends Pass {
 		 */
 		this.output = 0;
 		this._renderGBuffer = true;
-		this._visibilityCache = new Map();
+		this._visibilityCache = [];
 
 		/**
 		 * The AO blend intensity.
@@ -241,7 +242,7 @@ class GTAOPass extends Pass {
 	 * Sets the size of the pass.
 	 *
 	 * @param {number} width - The width to set.
-	 * @param {number} height - The width to set.
+	 * @param {number} height - The height to set.
 	 */
 	setSize( width, height ) {
 
@@ -366,7 +367,7 @@ class GTAOPass extends Pass {
 	}
 
 	/**
-	 * Updates the GTAO material from the given paramter object.
+	 * Updates the GTAO material from the given parameter object.
 	 *
 	 * @param {Object} parameters - The GTAO material parameters.
 	 */
@@ -420,7 +421,7 @@ class GTAOPass extends Pass {
 	}
 
 	/**
-	 * Updates the Denoise material from the given paramter object.
+	 * Updates the Denoise material from the given parameter object.
 	 *
 	 * @param {Object} parameters - The denoise parameters.
 	 */
@@ -654,9 +655,12 @@ class GTAOPass extends Pass {
 
 		scene.traverse( function ( object ) {
 
-			cache.set( object, object.visible );
+			if ( ( object.isPoints || object.isLine || object.isLine2 ) && object.visible ) {
 
-			if ( object.isPoints || object.isLine ) object.visible = false;
+				object.visible = false;
+				cache.push( object );
+
+			}
 
 		} );
 
@@ -664,17 +668,15 @@ class GTAOPass extends Pass {
 
 	_restoreVisibility() {
 
-		const scene = this.scene;
 		const cache = this._visibilityCache;
 
-		scene.traverse( function ( object ) {
+		for ( let i = 0; i < cache.length; i ++ ) {
 
-			const visible = cache.get( object );
-			object.visible = visible;
+			cache[ i ].visible = true;
 
-		} );
+		}
 
-		cache.clear();
+		cache.length = 0;
 
 	}
 

package/examples/jsm/postprocessing/GlitchPass.js

@@ -18,6 +18,7 @@ import { DigitalGlitch } from '../shaders/DigitalGlitch.js';
  * ```
  *
  * @augments Pass
+ * @three_import import { GlitchPass } from 'three/addons/postprocessing/GlitchPass.js';
  */
 class GlitchPass extends Pass {
 
@@ -50,7 +51,7 @@ class GlitchPass extends Pass {
 		} );
 
 		/**
-		 * Whether to noticeably increase the effect instensity or not.
+		 * Whether to noticeably increase the effect intensity or not.
 		 *
 		 * @type {boolean}
 		 * @default false

package/examples/jsm/postprocessing/HalftonePass.js

@@ -26,6 +26,7 @@ import { HalftoneShader } from '../shaders/HalftoneShader.js';
  * ```
  *
  * @augments Pass
+ * @three_import import { HalftonePass } from 'three/addons/postprocessing/HalftonePass.js';
  */
 class HalftonePass extends Pass {
 
@@ -107,7 +108,7 @@ class HalftonePass extends Pass {
 	 * Sets the size of the pass.
 	 *
 	 * @param {number} width - The width to set.
-	 * @param {number} height - The width to set.
+	 * @param {number} height - The height to set.
 	 */
  	setSize( width, height ) {
 

package/examples/jsm/postprocessing/LUTPass.js

@@ -65,6 +65,7 @@ const LUTShader = {
  * ```
  *
  * @augments ShaderPass
+ * @three_import import { LUTPass } from 'three/addons/postprocessing/LUTPass.js';
  */
 class LUTPass extends ShaderPass {
 

package/examples/jsm/postprocessing/MaskPass.js

@@ -12,6 +12,7 @@ import { Pass } from './Pass.js';
  * ```
  *
  * @augments Pass
+ * @three_import import { MaskPass } from 'three/addons/postprocessing/MaskPass.js';
  */
 class MaskPass extends Pass {
 

package/examples/jsm/postprocessing/OutlinePass.js

@@ -26,6 +26,7 @@ import { CopyShader } from '../shaders/CopyShader.js';
  * ```
  *
  * @augments Pass
+ * @three_import import { OutlinePass } from 'three/addons/postprocessing/OutlinePass.js';
  */
 class OutlinePass extends Pass {
 
@@ -268,7 +269,7 @@ class OutlinePass extends Pass {
 	 * Sets the size of the pass.
 	 *
 	 * @param {number} width - The width to set.
-	 * @param {number} height - The width to set.
+	 * @param {number} height - The height to set.
 	 */
 	setSize( width, height ) {
 
@@ -493,37 +494,37 @@ class OutlinePass extends Pass {
 
 		function VisibilityChangeCallBack( object ) {
 
-			if ( object.isMesh || object.isSprite ) {
+			if ( object.isPoints || object.isLine || object.isLine2 ) {
 
-				// only meshes and sprites are supported by OutlinePass
+				// the visibility of points and lines is always set to false in order to
+				// not affect the outline computation
 
-				if ( ! selectionCache.has( object ) ) {
+				if ( bVisible === true ) {
 
-					const visibility = object.visible;
+					object.visible = visibilityCache.get( object ); // restore
 
-					if ( bVisible === false || visibilityCache.get( object ) === true ) {
+				} else {
 
-						object.visible = bVisible;
+					visibilityCache.set( object, object.visible );
+					object.visible = bVisible;
 
-					}
+				}
 
-					visibilityCache.set( object, visibility );
+			} else if ( object.isMesh || object.isSprite) {
 
-				}
+				// only meshes and sprites are supported by OutlinePass
 
-			} else if ( object.isPoints || object.isLine ) {
+				if ( ! selectionCache.has( object ) ) {
 
-				// the visibility of points and lines is always set to false in order to
-				// not affect the outline computation
+					const visibility = object.visible;
 
-				if ( bVisible === true ) {
+					if ( bVisible === false || visibilityCache.get( object ) === true ) {
 
-					object.visible = visibilityCache.get( object ); // restore
+						object.visible = bVisible;
 
-				} else {
+					}
 
-					visibilityCache.set( object, object.visible );
-					object.visible = bVisible;
+					visibilityCache.set( object, visibility );
 
 				}
 
@@ -557,7 +558,8 @@ class OutlinePass extends Pass {
 			},
 
 			vertexShader:
-				`#include <morphtarget_pars_vertex>
+				`#include <batching_pars_vertex>
+				#include <morphtarget_pars_vertex>
 				#include <skinning_pars_vertex>
 
 				varying vec4 projTexCoord;
@@ -566,6 +568,7 @@ class OutlinePass extends Pass {
 
 				void main() {
 
+					#include <batching_vertex>
 					#include <skinbase_vertex>
 					#include <begin_vertex>
 					#include <morphtarget_vertex>

package/examples/jsm/postprocessing/OutputPass.js

@@ -28,6 +28,7 @@ import { OutputShader } from '../shaders/OutputShader.js';
  * ```
  *
  * @augments Pass
+ * @three_import import { OutputPass } from 'three/addons/postprocessing/OutputPass.js';
  */
 class OutputPass extends Pass {
 

package/examples/jsm/postprocessing/Pass.js

@@ -11,6 +11,7 @@ import {
  * This module is only relevant for post processing with {@link WebGLRenderer}.
  *
  * @abstract
+ * @three_import import { Pass } from 'three/addons/postprocessing/Pass.js';
  */
 class Pass {
 
@@ -68,7 +69,7 @@ class Pass {
 	 *
 	 * @abstract
 	 * @param {number} width - The width to set.
-	 * @param {number} height - The width to set.
+	 * @param {number} height - The height to set.
 	 */
 	setSize( /* width, height */ ) {}
 
@@ -132,6 +133,7 @@ const _geometry = new FullscreenTriangleGeometry();
  * This module can only be used with {@link WebGLRenderer}.
  *
  * @augments Mesh
+ * @three_import import { FullScreenQuad } from 'three/addons/postprocessing/Pass.js';
  */
 class FullScreenQuad {
 

package/examples/jsm/postprocessing/RenderPass.js

@@ -13,6 +13,7 @@ import { Pass } from './Pass.js';
  * ```
  *
  * @augments Pass
+ * @three_import import { RenderPass } from 'three/addons/postprocessing/RenderPass.js';
  */
 class RenderPass extends Pass {
 

package/examples/jsm/postprocessing/RenderPixelatedPass.js

@@ -19,6 +19,7 @@ import { Pass, FullScreenQuad } from './Pass.js';
  * ```
  *
  * @augments Pass
+ * @three_import import { RenderPixelatedPass } from 'three/addons/postprocessing/RenderPixelatedPass.js';
  */
 class RenderPixelatedPass extends Pass {
 
@@ -120,7 +121,7 @@ class RenderPixelatedPass extends Pass {
 	 * Sets the size of the pass.
 	 *
 	 * @param {number} width - The width to set.
-	 * @param {number} height - The width to set.
+	 * @param {number} height - The height to set.
 	 */
 	setSize( width, height ) {
 

package/examples/jsm/postprocessing/RenderTransitionPass.js

@@ -16,6 +16,7 @@ import { FullScreenQuad, Pass } from './Pass.js';
  * ```
  *
  * @augments Pass
+ * @three_import import { RenderTransitionPass } from 'three/addons/postprocessing/RenderTransitionPass.js';
  */
 class RenderTransitionPass extends Pass {
 
@@ -82,7 +83,7 @@ class RenderTransitionPass extends Pass {
 	 * Sets the transition factor. Must be in the range `[0,1]`.
 	 * This value determines to what degree both scenes are mixed.
 	 *
-	 * @param {boolenumberan} value - The transition factor.
+	 * @param {boolean|number} value - The transition factor.
 	 */
 	setTransition( value ) {
 
@@ -116,7 +117,7 @@ class RenderTransitionPass extends Pass {
 	 * Sets the texture threshold. This value defined how strong the texture effects
 	 * the transition. Must be in the range `[0,1]` (0 means full effect, 1 means no effect).
 	 *
-	 * @param {boolenumberan} value - The threshold value.
+	 * @param {boolean|number} value - The threshold value.
 	 */
 	setTextureThreshold( value ) {
 
@@ -128,7 +129,7 @@ class RenderTransitionPass extends Pass {
 	 * Sets the size of the pass.
 	 *
 	 * @param {number} width - The width to set.
-	 * @param {number} height - The width to set.
+	 * @param {number} height - The height to set.
 	 */
 	setSize( width, height ) {
 

package/examples/jsm/postprocessing/SAOPass.js

@@ -33,6 +33,7 @@ import { CopyShader } from '../shaders/CopyShader.js';
  * ```
  *
  * @augments Pass
+ * @three_import import { SAOPass } from 'three/addons/postprocessing/SAOPass.js';
  */
 class SAOPass extends Pass {
 
@@ -82,7 +83,7 @@ class SAOPass extends Pass {
 		this._oldClearAlpha = 1;
 
 		/**
-		 * The SAO paramter.
+		 * The SAO parameter.
 		 *
 		 * @type {Object}
 		 */
@@ -293,7 +294,7 @@ class SAOPass extends Pass {
 	 * Sets the size of the pass.
 	 *
 	 * @param {number} width - The width to set.
-	 * @param {number} height - The width to set.
+	 * @param {number} height - The height to set.
 	 */
 	setSize( width, height ) {
 

package/examples/jsm/postprocessing/SMAAPass.js

@@ -12,7 +12,7 @@ import { SMAABlendShader, SMAAEdgesShader, SMAAWeightsShader } from '../shaders/
 
 /**
  * A pass for applying SMAA. Unlike {@link FXAAPass}, `SMAAPass` operates in
- * `linar-srgb` so this pass must be executed before {@link OutputPass}.
+ * `linear-srgb` so this pass must be executed before {@link OutputPass}.
  *
  * ```js
  * const smaaPass = new SMAAPass();
@@ -20,6 +20,7 @@ import { SMAABlendShader, SMAAEdgesShader, SMAAWeightsShader } from '../shaders/
  * ```
  *
  * @augments Pass
+ * @three_import import { SMAAPass } from 'three/addons/postprocessing/SMAAPass.js';
  */
 class SMAAPass extends Pass {
 
@@ -177,7 +178,7 @@ class SMAAPass extends Pass {
 	 * Sets the size of the pass.
 	 *
 	 * @param {number} width - The width to set.
-	 * @param {number} height - The width to set.
+	 * @param {number} height - The height to set.
 	 */
 	setSize( width, height ) {
 

package/examples/jsm/postprocessing/SSAARenderPass.js

@@ -21,6 +21,7 @@ import { CopyShader } from '../shaders/CopyShader.js';
  * ```
  *
  * @augments Pass
+ * @three_import import { SSAARenderPass } from 'three/addons/postprocessing/SSAARenderPass.js';
  */
 class SSAARenderPass extends Pass {
 
@@ -140,7 +141,7 @@ class SSAARenderPass extends Pass {
 	 * Sets the size of the pass.
 	 *
 	 * @param {number} width - The width to set.
-	 * @param {number} height - The width to set.
+	 * @param {number} height - The height to set.
 	 */
 	setSize( width, height ) {
 

package/examples/jsm/postprocessing/SSAOPass.js

@@ -39,6 +39,7 @@ import { CopyShader } from '../shaders/CopyShader.js';
  * ```
  *
  * @augments Pass
+ * @three_import import { SSAOPass } from 'three/addons/postprocessing/SSAOPass.js';
  */
 class SSAOPass extends Pass {
 
@@ -138,7 +139,7 @@ class SSAOPass extends Pass {
 		 */
 		this.maxDistance = 0.1;
 
-		this._visibilityCache = new Map();
+		this._visibilityCache = [];
 
 		//
 
@@ -350,7 +351,7 @@ class SSAOPass extends Pass {
 	 * Sets the size of the pass.
 	 *
 	 * @param {number} width - The width to set.
-	 * @param {number} height - The width to set.
+	 * @param {number} height - The height to set.
 	 */
 	setSize( width, height ) {
 
@@ -488,9 +489,12 @@ class SSAOPass extends Pass {
 
 		scene.traverse( function ( object ) {
 
-			cache.set( object, object.visible );
+			if ( ( object.isPoints || object.isLine || object.isLine2 ) && object.visible ) {
 
-			if ( object.isPoints || object.isLine ) object.visible = false;
+				object.visible = false;
+				cache.push( object );
+
+			}
 
 		} );
 
@@ -498,17 +502,15 @@ class SSAOPass extends Pass {
 
 	_restoreVisibility() {
 
-		const scene = this.scene;
 		const cache = this._visibilityCache;
 
-		scene.traverse( function ( object ) {
+		for ( let i = 0; i < cache.length; i ++ ) {
 
-			const visible = cache.get( object );
-			object.visible = visible;
+			cache[ i ].visible = true;
 
-		} );
+		}
 
-		cache.clear();
+		cache.length = 0;
 
 	}
 

package/examples/jsm/postprocessing/SSRPass.js

@@ -34,6 +34,7 @@ import { CopyShader } from '../shaders/CopyShader.js';
  * ```
  *
  * @augments Pass
+ * @three_import import { SSRPass } from 'three/addons/postprocessing/SSRPass.js';
  */
 class SSRPass extends Pass {
 
@@ -100,7 +101,7 @@ class SSRPass extends Pass {
 		this.groundReflector = groundReflector;
 
 		/**
-		 * The opactiy.
+		 * The opacity.
 		 *
 		 * @type {number}
 		 * @default 0.5
@@ -221,7 +222,7 @@ class SSRPass extends Pass {
 		this._distanceAttenuation = SSRShader.defines.DISTANCE_ATTENUATION;
 
 		/**
-		 * Whether to use distance attenutation or not.
+		 * Whether to use distance attenuation or not.
 		 *
 		 * @name SSRPass#distanceAttenuation
 		 * @type {boolean}
@@ -653,7 +654,7 @@ class SSRPass extends Pass {
 	 * Sets the size of the pass.
 	 *
 	 * @param {number} width - The width to set.
-	 * @param {number} height - The width to set.
+	 * @param {number} height - The height to set.
 	 */
 	setSize( width, height ) {
 

package/examples/jsm/postprocessing/SavePass.js

@@ -17,6 +17,7 @@ import { CopyShader } from '../shaders/CopyShader.js';
  * ```
  *
  * @augments Pass
+ * @three_import import { SavePass } from 'three/addons/postprocessing/SavePass.js';
  */
 class SavePass extends Pass {
 
@@ -104,7 +105,7 @@ class SavePass extends Pass {
 	 * Sets the size of the pass.
 	 *
 	 * @param {number} width - The width to set.
-	 * @param {number} height - The width to set.
+	 * @param {number} height - The height to set.
 	 */
 	setSize( width, height ) {
 

package/examples/jsm/postprocessing/ShaderPass.js

@@ -15,6 +15,7 @@ import { Pass, FullScreenQuad } from './Pass.js';
  * ```
  *
  * @augments Pass
+ * @three_import import { ShaderPass } from 'three/addons/postprocessing/ShaderPass.js';
  */
 class ShaderPass extends Pass {
 

package/examples/jsm/postprocessing/TAARenderPass.js

@@ -20,6 +20,7 @@ import { SSAARenderPass } from './SSAARenderPass.js';
  * ```
  *
  * @augments SSAARenderPass
+ * @three_import import { TAARenderPass } from 'three/addons/postprocessing/TAARenderPass.js';
  */
 class TAARenderPass extends SSAARenderPass {
 

package/examples/jsm/postprocessing/TexturePass.js

@@ -17,6 +17,7 @@ import { CopyShader } from '../shaders/CopyShader.js';
  * ```
  *
  * @augments Pass
+ * @three_import import { TexturePass } from 'three/addons/postprocessing/TexturePass.js';
  */
 class TexturePass extends Pass {
 

package/examples/jsm/postprocessing/UnrealBloomPass.js

@@ -31,6 +31,7 @@ import { LuminosityHighPassShader } from '../shaders/LuminosityHighPassShader.js
  * ```
  *
  * @augments Pass
+ * @three_import import { UnrealBloomPass } from 'three/addons/postprocessing/UnrealBloomPass.js';
  */
 class UnrealBloomPass extends Pass {
 
@@ -241,7 +242,7 @@ class UnrealBloomPass extends Pass {
 	 * Sets the size of the pass.
 	 *
 	 * @param {number} width - The width to set.
-	 * @param {number} height - The width to set.
+	 * @param {number} height - The height to set.
 	 */
 	setSize( width, height ) {
 

package/examples/jsm/renderers/CSS2DRenderer.js

@@ -9,6 +9,7 @@ import {
  * The only type of 3D object that is supported by {@link CSS2DRenderer}.
  *
  * @augments Object3D
+ * @three_import import { CSS2DObject } from 'three/addons/renderers/CSS2DRenderer.js';
  */
 class CSS2DObject extends Object3D {
 
@@ -103,6 +104,8 @@ const _b = new Vector3();
  * scene graph. All other types of renderable 3D objects (like meshes or point clouds) are ignored.
  *
  * `CSS2DRenderer` only supports 100% browser and display zoom.
+ *
+ * @three_import import { CSS2DRenderer } from 'three/addons/renderers/CSS2DRenderer.js';
  */
 class CSS2DRenderer {
 

package/examples/jsm/renderers/CSS3DRenderer.js

@@ -15,6 +15,7 @@ const _scale = new Vector3();
  * The base 3D object that is supported by {@link CSS3DRenderer}.
  *
  * @augments Object3D
+ * @three_import import { CSS3DObject } from 'three/addons/renderers/CSS3DRenderer.js';
  */
 class CSS3DObject extends Object3D {
 
@@ -86,6 +87,7 @@ class CSS3DObject extends Object3D {
  * DOM elements as sprites.
  *
  * @augments CSS3DObject
+ * @three_import import { CSS3DSprite } from 'three/addons/renderers/CSS3DRenderer.js';
  */
 class CSS3DSprite extends CSS3DObject {
 
@@ -148,6 +150,8 @@ const _matrix2 = new Matrix4();
  *
  * So `CSS3DRenderer` is just focused on ordinary DOM elements. These elements are wrapped into special
  * 3D objects ({@link CSS3DObject} or {@link CSS3DSprite}) and then added to the scene graph.
+ *
+ * @three_import import { CSS3DRenderer } from 'three/addons/renderers/CSS3DRenderer.js';
  */
 class CSS3DRenderer {
 

package/examples/jsm/renderers/Projector.js

@@ -124,6 +124,8 @@ class RenderableSprite {
  * This class can project a given scene in 3D space into a 2D representation
  * used for rendering with a 2D API. `Projector` is currently used by {@link SVGRenderer}
  * and was previously used by the legacy `CanvasRenderer`.
+ *
+ * @three_import import { Projector } from 'three/addons/renderers/Projector.js';
  */
 class Projector {
 

package/examples/jsm/renderers/SVGRenderer.js

@@ -19,6 +19,7 @@ import {
  * Can be used to wrap SVG elements into a 3D object.
  *
  * @augments Object3D
+ * @three_import import { SVGObject } from 'three/addons/renderers/SVGRenderer.js';
  */
 class SVGObject extends Object3D {
 
@@ -69,6 +70,8 @@ class SVGObject extends Object3D {
  * - No advanced shading.
  * - No texture support.
  * - No shadow support.
+ *
+ * @three_import import { SVGRenderer } from 'three/addons/renderers/SVGRenderer.js';
  */
 class SVGRenderer {
 

package/examples/jsm/shaders/ACESFilmicToneMappingShader.js

@@ -1,4 +1,7 @@
-/** @module ACESFilmicToneMappingShader */
+/**
+ * @module ACESFilmicToneMappingShader
+ * @three_import import { ACESFilmicToneMappingShader } from 'three/addons/shaders/ACESFilmicToneMappingShader.js';
+ */
 
 /**
  * ACES Filmic Tone Mapping Shader by Stephen Hill.

package/examples/jsm/shaders/AfterimageShader.js

@@ -1,4 +1,7 @@
-/** @module AfterimageShader */
+/**
+ * @module AfterimageShader
+ * @three_import import { AfterimageShader } from 'three/addons/shaders/AfterimageShader.js';
+ */
 
 /**
  * Inspired by [Three.js FBO motion trails]{@link https://codepen.io/brunoimbrizi/pen/MoRJaN?page=1&}.

package/examples/jsm/shaders/BasicShader.js

@@ -1,4 +1,7 @@
-/** @module BasicShader */
+/**
+ * @module BasicShader
+ * @three_import import { BasicShader } from 'three/addons/shaders/BasicShader.js';
+ */
 
 /**
  * Simple shader for testing.

package/examples/jsm/shaders/BleachBypassShader.js

@@ -1,5 +1,8 @@
 
-/** @module BleachBypassShader */
+/**
+ * @module BleachBypassShader
+ * @three_import import { BleachBypassShader } from 'three/addons/shaders/BleachBypassShader.js';
+ */
 
 /**
  * Bleach bypass shader [http://en.wikipedia.org/wiki/Bleach_bypass] based on

package/examples/jsm/shaders/BlendShader.js

@@ -1,4 +1,7 @@
-/** @module BlendShader */
+/**
+ * @module BlendShader
+ * @three_import import { BlendShader } from 'three/addons/shaders/BlendShader.js';
+ */
 
 /**
  * Blends two textures.