@plastic-software/three 0.175.14 → 0.179.0

package/examples/jsm/loaders/usd/USDCParser.js

@@ -0,0 +1,17 @@
+import {
+	Group
+} from 'three';
+
+class USDCParser {
+
+	parse( buffer ) {
+
+		// TODO
+
+		return new Group();
+
+	}
+
+}
+
+export { USDCParser };

package/examples/jsm/materials/LDrawConditionalLineMaterial.js

@@ -12,6 +12,7 @@ import {
  * import the class from `LDrawConditionalLineNodeMaterial.js`.
  *
  * @augments ShaderMaterial
+ * @three_import import { LDrawConditionalLineMaterial } from 'three/addons/materials/LDrawConditionalLineMaterial.js';
  */
 class LDrawConditionalLineMaterial extends ShaderMaterial {
 

package/examples/jsm/materials/LDrawConditionalLineNodeMaterial.js

@@ -8,6 +8,7 @@ import { attribute, cameraProjectionMatrix, dot, float, Fn, modelViewMatrix, mod
  * import the class from `LDrawConditionalLineMaterial.js`.
  *
  * @augments NodeMaterial
+ * @three_import import { LDrawConditionalLineMaterial } from 'three/addons/materials/LDrawConditionalLineMaterial.js';
  */
 class LDrawConditionalLineMaterial extends NodeMaterial {
 

package/examples/jsm/materials/MeshPostProcessingMaterial.js

@@ -23,6 +23,7 @@ import { MeshPhysicalMaterial } from 'three';
  * This would then create the possibility of SSR and IR depending on material properties such as `roughness`, `metalness` and `reflectivity`.
  *
  * @augments MeshPhysicalMaterial
+ * @three_import import { MeshPostProcessingMaterial } from 'three/addons/materials/MeshPostProcessingMaterial.js';
  */
 class MeshPostProcessingMaterial extends MeshPhysicalMaterial {
 

package/examples/jsm/math/Capsule.js

@@ -7,6 +7,8 @@ import {
  * It can be thought of as a swept sphere, where a sphere is moved along a line segment.
  *
  * Capsules are often used as bounding volumes (next to AABBs and bounding spheres).
+ *
+ * @three_import import { Capsule } from 'three/addons/math/Capsule.js';
  */
 class Capsule {
 

package/examples/jsm/math/ColorConverter.js

@@ -6,6 +6,7 @@ const _hsl = {};
  * A utility class with helper functions for color conversion.
  *
  * @hideconstructor
+ * @three_import import { ColorConverter } from 'three/addons/math/ColorConverter.js';
  */
 class ColorConverter {
 

package/examples/jsm/math/ConvexHull.js

@@ -20,6 +20,8 @@ const _triangle = new Triangle();
  *
  * This Quickhull 3D implementation is a port of [quickhull3d]{@link https://github.com/maurizzzio/quickhull3d/}
  * by Mauricio Poppe.
+ *
+ * @three_import import { ConvexHull } from 'three/addons/math/ConvexHull.js';
  */
 class ConvexHull {
 

package/examples/jsm/math/ImprovedNoise.js

@@ -1,3 +1,7 @@
+import { MathUtils } from 'three';
+
+const { lerp } = MathUtils;
+
 const _p = [ 151, 160, 137, 91, 90, 15, 131, 13, 201, 95, 96, 53, 194, 233, 7, 225, 140, 36, 103, 30, 69, 142, 8, 99, 37, 240, 21, 10,
 	 23, 190, 6, 148, 247, 120, 234, 75, 0, 26, 197, 62, 94, 252, 219, 203, 117, 35, 11, 32, 57, 177, 33, 88, 237, 149, 56, 87,
 	 174, 20, 125, 136, 171, 168, 68, 175, 74, 165, 71, 134, 139, 48, 27, 166, 77, 146, 158, 231, 83, 111, 229, 122, 60, 211,
@@ -21,12 +25,6 @@ function fade( t ) {
 
 }
 
-function lerp( t, a, b ) {
-
-	return a + t * ( b - a );
-
-}
-
 function grad( hash, x, y, z ) {
 
 	const h = hash & 15;
@@ -40,6 +38,8 @@ function grad( hash, x, y, z ) {
  *
  * The code is based on [IMPROVED NOISE]{@link https://cs.nyu.edu/~perlin/noise/}
  * by Ken Perlin, 2002.
+ *
+ * @three_import import { ImprovedNoise } from 'three/addons/math/ImprovedNoise.js';
  */
 class ImprovedNoise {
 
@@ -67,14 +67,19 @@ class ImprovedNoise {
 
 		const A = _p[ X ] + Y, AA = _p[ A ] + Z, AB = _p[ A + 1 ] + Z, B = _p[ X + 1 ] + Y, BA = _p[ B ] + Z, BB = _p[ B + 1 ] + Z;
 
-		return lerp( w, lerp( v, lerp( u, grad( _p[ AA ], x, y, z ),
-			grad( _p[ BA ], xMinus1, y, z ) ),
-		lerp( u, grad( _p[ AB ], x, yMinus1, z ),
-			grad( _p[ BB ], xMinus1, yMinus1, z ) ) ),
-		lerp( v, lerp( u, grad( _p[ AA + 1 ], x, y, zMinus1 ),
-			grad( _p[ BA + 1 ], xMinus1, y, zMinus1 ) ),
-		lerp( u, grad( _p[ AB + 1 ], x, yMinus1, zMinus1 ),
-			grad( _p[ BB + 1 ], xMinus1, yMinus1, zMinus1 ) ) ) );
+		return lerp(
+			lerp(
+				lerp( grad( _p[ AA ], x, y, z ), grad( _p[ BA ], xMinus1, y, z ), u ),
+				lerp( grad( _p[ AB ], x, yMinus1, z ), grad( _p[ BB ], xMinus1, yMinus1, z ), u ),
+				v
+			),
+			lerp(
+				lerp( grad( _p[ AA + 1 ], x, y, zMinus1 ), grad( _p[ BA + 1 ], xMinus1, y, zMinus1 ), u ),
+				lerp( grad( _p[ AB + 1 ], x, yMinus1, zMinus1 ), grad( _p[ BB + 1 ], xMinus1, yMinus1, zMinus1 ), u ),
+				v
+			),
+			w
+		);
 
 	}
 

package/examples/jsm/math/Lut.js

@@ -12,6 +12,8 @@ import {
  * const lut = new Lut( 'rainbow', 512 );
  * const color = lut.getColor( 0.5 );
  * ```
+ *
+ * @three_import import { Lut } from 'three/addons/math/Lut.js';
  */
 class Lut {
 

package/examples/jsm/math/MeshSurfaceSampler.js

@@ -40,6 +40,8 @@ const _uva = new Vector2(), _uvb = new Vector2(), _uvc = new Vector2();
  *
  * scene.add( mesh );
  * ```
+ *
+ * @three_import import { MeshSurfaceSampler } from 'three/addons/math/MeshSurfaceSampler.js';
  */
 class MeshSurfaceSampler {
 

package/examples/jsm/math/OBB.js

@@ -39,6 +39,8 @@ const localRay = new Ray();
 
 /**
  * Represents an oriented bounding box (OBB) in 3D space.
+ *
+ * @three_import import { OBB } from 'three/addons/math/OBB.js';
  */
 class OBB {
 

package/examples/jsm/math/Octree.js

@@ -96,6 +96,8 @@ function lineToLineClosestPoints( line1, line2, target1 = null, target2 = null )
  * const octree = new Octree().fromGraphNode( scene );
  * const result = octree.capsuleIntersect( playerCollider ); // collision detection
  * ```
+ *
+ * @three_import import { Octree } from 'three/addons/math/Octree.js';
  */
 class Octree {
 
@@ -128,6 +130,23 @@ class Octree {
 		 */
 		this.layers = new Layers();
 
+		/**
+		 * The number of triangles a leaf can store before it is split.
+		 *
+		 * @type {number}
+		 * @default 8
+		 */
+		this.trianglesPerLeaf = 8;
+
+		/**
+		 * The maximum level of the Octree. It defines the maximum
+		 * hierarchical depth of the data structure.
+		 *
+		 * @type {number}
+		 * @default 16
+		 */
+		this.maxLevel = 16;
+
 		// private
 
 		this.subTrees = [];
@@ -229,7 +248,7 @@ class Octree {
 
 			const len = subTrees[ i ].triangles.length;
 
-			if ( len > 8 && level < 16 ) {
+			if ( len > this.trianglesPerLeaf && level < this.maxLevel ) {
 
 				subTrees[ i ].split( level + 1 );
 

package/examples/jsm/math/SimplexNoise.js

@@ -3,6 +3,8 @@
  *
  * The code is based on [Simplex noise demystified]{@link https://web.archive.org/web/20210210162332/http://staffwww.itn.liu.se/~stegu/simplexnoise/simplexnoise.pdf}
  * by Stefan Gustavson, 2005.
+ *
+ * @three_import import { SimplexNoise } from 'three/addons/math/SimplexNoise.js';
  */
 class SimplexNoise {
 

package/examples/jsm/misc/ConvexObjectBreaker.js

@@ -24,7 +24,9 @@ const _v1 = new Vector3();
  *
  * Note: This lib adds member variables to object's userData member (see prepareBreakableObject function)
  * Use with caution and read the code when using with other libs.
-*/
+ *
+ * @three_import import { ConvexObjectBreaker } from 'three/addons/misc/ConvexObjectBreaker.js';
+ */
 class ConvexObjectBreaker {
 
 	/**

package/examples/jsm/misc/GPUComputationRenderer.js

@@ -98,6 +98,8 @@ import { FullScreenQuad } from '../postprocessing/Pass.js';
  * gpuCompute.doRenderTarget( myFilter1, myRenderTarget );
  * gpuCompute.doRenderTarget( myFilter2, outputRenderTarget );
  * ```
+ *
+ * @three_import import { GPUComputationRenderer } from 'three/addons/misc/GPUComputationRenderer.js';
  */
 class GPUComputationRenderer {
 

package/examples/jsm/misc/Gyroscope.js

@@ -19,6 +19,7 @@ const _scaleWorld = new Vector3();
  * respect to the world.
  *
  * @augments Object3D
+ * @three_import import { Gyroscope } from 'three/addons/misc/Gyroscope.js';
  */
 class Gyroscope extends Object3D {
 

package/examples/jsm/misc/MD2Character.js

@@ -13,6 +13,8 @@ import { MD2Loader } from '../loaders/MD2Loader.js';
 /**
  * This class represents a management component for animated MD2
  * character assets.
+ *
+ * @three_import import { MD2Character } from 'three/addons/misc/MD2Character.js';
  */
 class MD2Character {
 

package/examples/jsm/misc/MD2CharacterComplex.js

@@ -13,6 +13,8 @@ import { MorphBlendMesh } from '../misc/MorphBlendMesh.js';
 /**
  * This class represents a management component for animated MD2
  * character assets. It provides a larger API compared to {@link MD2Character}.
+ *
+ * @three_import import { MD2CharacterComplex } from 'three/addons/misc/MD2CharacterComplex.js';
  */
 class MD2CharacterComplex {
 
@@ -78,12 +80,12 @@ class MD2CharacterComplex {
 		this.backAcceleration = 600;
 
 		/**
-		 * The character's front decceleration.
+		 * The character's front deceleration.
 		 *
 		 * @type {number}
 		 * @default 600
 		 */
-		this.frontDecceleration = 600;
+		this.frontDeceleration = 600;
 
 		/**
 		 * The character's angular speed.
@@ -684,7 +686,7 @@ class MD2CharacterComplex {
 			if ( this.speed > 0 ) {
 
 				const k = exponentialEaseOut( this.speed / this.maxSpeed );
-				this.speed = MathUtils.clamp( this.speed - k * delta * this.frontDecceleration, 0, this.maxSpeed );
+				this.speed = MathUtils.clamp( this.speed - k * delta * this.frontDeceleration, 0, this.maxSpeed );
 
 			} else {
 

package/examples/jsm/misc/MorphAnimMesh.js

@@ -10,6 +10,7 @@ import {
  * without any transitions or fading between animation changes.
  *
  * @augments Mesh
+ * @three_import import { MorphAnimMesh } from 'three/addons/misc/MorphAnimMesh.js';
  */
 class MorphAnimMesh extends Mesh {
 

package/examples/jsm/misc/MorphBlendMesh.js

@@ -10,6 +10,7 @@ import {
  * fading options.
  *
  * @augments Mesh
+ * @three_import import { MorphBlendMesh } from 'three/addons/misc/MorphBlendMesh.js';
  */
 class MorphBlendMesh extends Mesh {
 

package/examples/jsm/misc/ProgressiveLightMap.js

@@ -16,6 +16,8 @@ import { potpack } from '../libs/potpack.module.js';
  *
  * This class can only be used with {@link WebGLRenderer}.
  * When using {@link WebGPURenderer}, import from `ProgressiveLightMapGPU.js`.
+ *
+ * @three_import import { ProgressiveLightMap } from 'three/addons/misc/ProgressiveLightMap.js';
  */
 class ProgressiveLightMap {
 

package/examples/jsm/misc/ProgressiveLightMapGPU.js

@@ -18,6 +18,8 @@ import { potpack } from '../libs/potpack.module.js';
  *
  * This class can only be used with {@link WebGPURenderer}.
  * When using {@link WebGLRenderer}, import from `ProgressiveLightMap.js`.
+ *
+ * @three_import import { ProgressiveLightMap } from 'three/addons/misc/ProgressiveLightMapGPU.js';
  */
 class ProgressiveLightMap {
 

package/examples/jsm/misc/RollerCoaster.js

@@ -12,6 +12,7 @@ import {
  * A procedural roller coaster geometry.
  *
  * @augments BufferGeometry
+ * @three_import import { RollerCoasterGeometry } from 'three/addons/misc/RollerCoaster.js';
  */
 class RollerCoasterGeometry extends BufferGeometry {
 
@@ -237,6 +238,7 @@ class RollerCoasterGeometry extends BufferGeometry {
  * A procedural roller coaster lifters geometry.
  *
  * @augments BufferGeometry
+ * @three_import import { RollerCoasterLiftersGeometry } from 'three/addons/misc/RollerCoaster.js';
  */
 class RollerCoasterLiftersGeometry extends BufferGeometry {
 
@@ -424,6 +426,7 @@ class RollerCoasterLiftersGeometry extends BufferGeometry {
  * A procedural roller coaster shadow geometry.
  *
  * @augments BufferGeometry
+ * @three_import import { RollerCoasterShadowGeometry } from 'three/addons/misc/RollerCoaster.js';
  */
 class RollerCoasterShadowGeometry extends BufferGeometry {
 
@@ -507,6 +510,7 @@ class RollerCoasterShadowGeometry extends BufferGeometry {
  * A procedural sky geometry.
  *
  * @augments BufferGeometry
+ * @three_import import { SkyGeometry } from 'three/addons/misc/RollerCoaster.js';
  */
 class SkyGeometry extends BufferGeometry {
 
@@ -548,6 +552,7 @@ class SkyGeometry extends BufferGeometry {
  * A procedural trees geometry.
  *
  * @augments BufferGeometry
+ * @three_import import { TreesGeometry } from 'three/addons/misc/RollerCoaster.js';
  */
 class TreesGeometry extends BufferGeometry {
 

package/examples/jsm/misc/TubePainter.js

@@ -21,6 +21,7 @@ import {
  *
  * @name TubePainter
  * @class
+ * @three_import import { TubePainter } from 'three/addons/misc/TubePainter.js';
  */
 function TubePainter() {
 

package/examples/jsm/misc/Volume.js

@@ -8,6 +8,8 @@ import { VolumeSlice } from '../misc/VolumeSlice.js';
 /**
  * This class had been written to handle the output of the {@link NRRDLoader}.
  * It contains a volume of data and information about it. For now it only handles 3 dimensional data.
+ *
+ * @three_import import { Volume } from 'three/addons/misc/Volume.js';
  */
 class Volume {
 

package/examples/jsm/misc/VolumeSlice.js

@@ -13,6 +13,7 @@ import {
  * This class has been made to hold a slice of a volume data.
  *
  * @see {@link Volume}
+ * @three_import import { VolumeSlice } from 'three/addons/misc/VolumeSlice.js';
  */
 class VolumeSlice {
 

package/examples/jsm/modifiers/CurveModifier.js

@@ -203,6 +203,8 @@ vec3 transformedNormal = normalMatrix * (basis * objectNormal);
  *
  * This module can only be used with {@link WebGLRenderer}. When using {@link WebGPURenderer},
  * import the class from `CurveModifierGPU.js`.
+ *
+ * @three_import import { Flow } from 'three/addons/modifiers/CurveModifier.js';
  */
 export class Flow {
 
@@ -296,6 +298,7 @@ const _matrix = new Matrix4();
  * This module can only be used with {@link WebGLRenderer}.
  *
  * @augments Flow
+ * @three_import import { InstancedFlow } from 'three/addons/modifiers/CurveModifier.js';
  */
 export class InstancedFlow extends Flow {
 

package/examples/jsm/modifiers/CurveModifierGPU.js

@@ -164,6 +164,8 @@ function modifyShader( material, uniforms, numberOfCurves ) {
  *
  * This module can only be used with {@link WebGPURenderer}. When using {@link WebGLRenderer},
  * import the class from `CurveModifier.js`.
+ *
+ * @three_import import { Flow } from 'three/addons/modifiers/CurveModifierGPU.js';
  */
 export class Flow {
 

package/examples/jsm/modifiers/EdgeSplitModifier.js

@@ -17,6 +17,8 @@ const _C = new Vector3();
  * const modifier = new EdgeSplitModifier();
  * geometry = modifier.modify( geometry, Math.PI * 0.4 );
  * ```
+ *
+ * @three_import import { EdgeSplitModifier } from 'three/addons/modifiers/EdgeSplitModifier.js';
  */
 class EdgeSplitModifier {
 

package/examples/jsm/modifiers/SimplifyModifier.js

@@ -21,6 +21,8 @@ const _cb = new Vector3(), _ab = new Vector3();
  * const modifier = new SimplifyModifier();
  * geometry = modifier.modify( geometry );
  * ```
+ *
+ * @three_import import { SimplifyModifier } from 'three/addons/modifiers/SimplifyModifier.js';
  */
 class SimplifyModifier {
 

package/examples/jsm/modifiers/TessellateModifier.js

@@ -14,6 +14,8 @@ import {
  * const modifier = new TessellateModifier( 8, 6 );
  * geometry = modifier.modify( geometry );
  * ```
+ *
+ * @three_import import { TessellateModifier } from 'three/addons/modifiers/TessellateModifier.js';
  */
 class TessellateModifier {
 

package/examples/jsm/objects/GroundedSkybox.js

@@ -15,6 +15,7 @@ import { Mesh, MeshBasicMaterial, SphereGeometry, Vector3 } from 'three';
  * ```
  *
  * @augments Mesh
+ * @three_import import { GroundedSkybox } from 'three/addons/objects/GroundedSkybox.js';
  */
 class GroundedSkybox extends Mesh {
 

package/examples/jsm/objects/Lensflare.js

@@ -33,6 +33,7 @@ import {
  * ```
  *
  * @augments Mesh
+ * @three_import import { Lensflare } from 'three/addons/objects/Lensflare.js';
  */
 class Lensflare extends Mesh {
 
@@ -338,6 +339,8 @@ class Lensflare extends Mesh {
 
 /**
  * Represents a single flare that can be added to a {@link Lensflare} container.
+ *
+ * @three_import import { LensflareElement } from 'three/addons/objects/Lensflare.js';
  */
 class LensflareElement {
 

package/examples/jsm/objects/LensflareMesh.js

@@ -36,6 +36,7 @@ import { texture, textureLoad, uv, ivec2, vec2, vec4, positionGeometry, referenc
  * ```
  *
  * @augments Mesh
+ * @three_import import { LensflareMesh } from 'three/addons/objects/LensflareMesh.js';
  */
 class LensflareMesh extends Mesh {
 
@@ -109,7 +110,7 @@ class LensflareMesh extends Mesh {
 		material1a.type = 'Lensflare-1a';
 
 		material1a.vertexNode = vertexNode;
-		material1a.fragmentNode = vec4( 1.0, 0.0, 1.0, 1.0 );
+		material1a.colorNode = vec4( 1.0, 0.0, 1.0, 1.0 );
 
 		const material1b = new NodeMaterial();
 
@@ -120,7 +121,7 @@ class LensflareMesh extends Mesh {
 		material1b.type = 'Lensflare-1b';
 
 		material1b.vertexNode = vertexNode;
-		material1b.fragmentNode = texture( tempMap, vec2( uv().flipY() ) );
+		material1b.colorNode = texture( tempMap, vec2( uv().flipY() ) );
 
 		// the following object is used for occlusionMap generation
 
@@ -173,7 +174,7 @@ class LensflareMesh extends Mesh {
 
 		} )();
 
-		material2.fragmentNode = Fn( () => {
+		material2.colorNode = Fn( () => {
 
 			const color = reference( 'color', 'color' );
 			const map = reference( 'map', 'texture' );

package/examples/jsm/objects/MarchingCubes.js

@@ -12,6 +12,8 @@ import {
  * A marching cubes implementation.
  *
  * Port of: {@link http://webglsamples.org/blob/blob.html}
+ *
+ * @three_import import { MarchingCubes } from 'three/addons/objects/MarchingCubes.js';
  */
 class MarchingCubes extends Mesh {
 

package/examples/jsm/objects/Reflector.js

@@ -32,6 +32,7 @@ import {
  * ```
  *
  * @augments Mesh
+ * @three_import import { Reflector } from 'three/addons/objects/Reflector.js';
  */
 class Reflector extends Mesh {
 

package/examples/jsm/objects/ReflectorForSSRPass.js

@@ -19,6 +19,7 @@ import {
  * A special version of {@link Reflector} for usage with {@link SSRPass}.
  *
  * @augments Mesh
+ * @three_import import { ReflectorForSSRPass } from 'three/addons/objects/ReflectorForSSRPass.js';
  */
 class ReflectorForSSRPass extends Mesh {
 

package/examples/jsm/objects/Refractor.js

@@ -33,6 +33,7 @@ import {
  * ```
  *
  * @augments Mesh
+ * @three_import import { Refractor } from 'three/addons/objects/Refractor.js';
  */
 class Refractor extends Mesh {
 

package/examples/jsm/objects/ShadowMesh.js

@@ -23,6 +23,7 @@ const _shadowMatrix = new Matrix4();
  * ```
  *
  * @augments Mesh
+ * @three_import import { ShadowMesh } from 'three/addons/objects/ShadowMesh.js';
  */
 class ShadowMesh extends Mesh {
 

package/examples/jsm/objects/Sky.js

@@ -27,7 +27,8 @@ import {
  * ```
  *
  * @augments Mesh
-*/
+ * @three_import import { Sky } from 'three/addons/objects/Sky.js';
+ */
 class Sky extends Mesh {
 
 	/**