@plastic-software/three 0.175.14 → 0.179.0

package/examples/jsm/geometries/BoxLineGeometry.js

@@ -14,6 +14,7 @@ import {
  * ```
  *
  * @augments BufferGeometry
+ * @three_import import { BoxLineGeometry } from 'three/addons/geometries/BoxLineGeometry.js';
  */
 class BoxLineGeometry extends BufferGeometry {
 

package/examples/jsm/geometries/ConvexGeometry.js

@@ -16,6 +16,7 @@ import { ConvexHull } from '../math/ConvexHull.js';
  * ```
  *
  * @augments BufferGeometry
+ * @three_import import { ConvexGeometry } from 'three/addons/geometries/ConvexGeometry.js';
  */
 class ConvexGeometry extends BufferGeometry {
 

package/examples/jsm/geometries/DecalGeometry.js

@@ -25,6 +25,7 @@ import {
  * ```
  *
  * @augments BufferGeometry
+ * @three_import import { DecalGeometry } from 'three/addons/geometries/DecalGeometry.js';
  */
 class DecalGeometry extends BufferGeometry {
 

package/examples/jsm/geometries/ParametricFunctions.js

@@ -1,5 +1,8 @@
 
-/** @module ParametricFunctions */
+/**
+ * @module ParametricFunctions
+ * @three_import import * as ParametricFunctions from 'three/addons/geometries/ParametricFunctions.js';
+ */
 
 /**
  * A parametric function representing the Klein bottle.

package/examples/jsm/geometries/ParametricGeometry.js

@@ -17,6 +17,7 @@ import {
  * ```
  *
  * @augments BufferGeometry
+ * @three_import import { ParametricGeometry } from 'three/addons/geometries/ParametricGeometry.js';
  */
 class ParametricGeometry extends BufferGeometry {
 

package/examples/jsm/geometries/RoundedBoxGeometry.js

@@ -49,6 +49,7 @@ function getUv( faceDirVector, normal, uvAxis, projectionAxis, radius, sideLengt
  * ```
  *
  * @augments BoxGeometry
+ * @three_import import { RoundedBoxGeometry } from 'three/addons/geometries/RoundedBoxGeometry.js';
  */
 class RoundedBoxGeometry extends BoxGeometry {
 
@@ -58,21 +59,40 @@ class RoundedBoxGeometry extends BoxGeometry {
 	 * @param {number} [width=1] - The width. That is, the length of the edges parallel to the X axis.
 	 * @param {number} [height=1] - The height. That is, the length of the edges parallel to the Y axis.
 	 * @param {number} [depth=1] - The depth. That is, the length of the edges parallel to the Z axis.
-	 * @param {number} [segments=2] - Number of segmented that form the rounded corners.
+	 * @param {number} [segments=2] - Number of segments that form the rounded corners.
 	 * @param {number} [radius=0.1] - The radius of the rounded corners.
 	 */
 	constructor( width = 1, height = 1, depth = 1, segments = 2, radius = 0.1 ) {
 
-		// ensure segments is odd so we have a plane connecting the rounded corners
-		segments = segments * 2 + 1;
+		// calculate total segments needed &
+		// ensure it's odd so that we have a plane connecting the rounded corners
+		const totalSegments = segments * 2 + 1;
 
 		// ensure radius isn't bigger than shortest side
 		radius = Math.min( width / 2, height / 2, depth / 2, radius );
 
-		super( 1, 1, 1, segments, segments, segments );
-
-		// if we just have one segment we're the same as a regular box
-		if ( segments === 1 ) return;
+		// start with a unit box geometry, its vertices will be modified to form the rounded box
+		super( 1, 1, 1, totalSegments, totalSegments, totalSegments );
+
+		this.type = 'RoundedBoxGeometry';
+
+		/**
+		 * Holds the constructor parameters that have been
+		 * used to generate the geometry. Any modification
+		 * after instantiation does not change the geometry.
+		 *
+		 * @type {Object}
+		 */
+		this.parameters = {
+			width: width,
+			height: height,
+			depth: depth,
+			segments: segments,
+			radius: radius,
+		};
+
+		// if totalSegments is 1, no rounding is needed - return regular box
+		if ( totalSegments === 1 ) return;
 
 		const geometry2 = this.toNonIndexed();
 
@@ -94,7 +114,7 @@ class RoundedBoxGeometry extends BoxGeometry {
 
 		const faceTris = positions.length / 6;
 		const faceDirVector = new Vector3();
-		const halfSegmentSize = 0.5 / segments;
+		const halfSegmentSize = 0.5 / totalSegments;
 
 		for ( let i = 0, j = 0; i < positions.length; i += 3, j += 2 ) {
 
@@ -171,6 +191,26 @@ class RoundedBoxGeometry extends BoxGeometry {
 
 	}
 
+	/**
+	 * Factory method for creating an instance of this class from the given
+	 * JSON object.
+	 *
+	 * @param {Object} data - A JSON object representing the serialized geometry.
+	 * @returns {RoundedBoxGeometry} A new instance.
+	 */
+	static fromJSON( data ) {
+
+		return new RoundedBoxGeometry(
+			data.width,
+			data.height,
+			data.depth,
+			data.segments,
+			data.radius
+		);
+
+	}
+
+
 }
 
 export { RoundedBoxGeometry };

package/examples/jsm/geometries/TeapotGeometry.js

@@ -26,6 +26,7 @@ import {
  * ```
  *
  * @augments BufferGeometry
+ * @three_import import { TeapotGeometry } from 'three/addons/geometries/TeapotGeometry.js';
  */
 class TeapotGeometry extends BufferGeometry {
 

package/examples/jsm/geometries/TextGeometry.js

@@ -23,6 +23,7 @@ import {
  * ```
  *
  * @augments ExtrudeGeometry
+ * @three_import import { TextGeometry } from 'three/addons/geometries/TextGeometry.js';
  */
 class TextGeometry extends ExtrudeGeometry {
 

package/examples/jsm/helpers/LightProbeHelper.js

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

package/examples/jsm/helpers/LightProbeHelperGPU.js

@@ -18,6 +18,7 @@ import { float, Fn, getShIrradianceAt, normalWorld, uniformArray, uniform, vec4
  *
  * @private
  * @augments Mesh
+ * @three_import import { LightProbeHelper } from 'three/addons/helpers/LightProbeHelperGPU.js';
  */
 class LightProbeHelper extends Mesh {
 

package/examples/jsm/helpers/OctreeHelper.js

@@ -14,6 +14,7 @@ import {
  * ```
  *
  * @augments LineSegments
+ * @three_import import { OctreeHelper } from 'three/addons/helpers/OctreeHelper.js';
  */
 class OctreeHelper extends LineSegments {
 

package/examples/jsm/helpers/PositionalAudioHelper.js

@@ -21,6 +21,7 @@ import {
  * ```
  *
  * @augments Line
+ * @three_import import { PositionalAudioHelper } from 'three/addons/helpers/PositionalAudioHelper.js';
  */
 class PositionalAudioHelper extends Line {
 

package/examples/jsm/helpers/RapierHelper.js

@@ -0,0 +1,59 @@
+import { LineSegments, LineBasicMaterial, BufferAttribute } from 'three';
+/**
+ * This class displays all Rapier Colliders in outline.
+ *
+ * @augments LineSegments
+ * @three_import import { RapierHelper } from 'three/addons/helpers/RapierHelper.js';
+ */
+class RapierHelper extends LineSegments {
+
+	/**
+	 * Constructs a new Rapier debug helper.
+	 *
+	 * @param {RAPIER.world} world - The Rapier world to visualize.
+	 */
+	constructor( world ) {
+
+		super();
+
+		/**
+		 * The Rapier world to visualize.
+		 *
+		 * @type {RAPIER.world}
+		 */
+		this.world = world;
+
+		this.material = new LineBasicMaterial( { vertexColors: true } );
+		this.frustumCulled = false;
+
+	}
+
+	/**
+	 * Call this in the render loop to update the outlines.
+	 */
+	update() {
+
+		const { vertices, colors } = this.world.debugRender();
+
+		this.geometry.deleteAttribute( 'position' );
+		this.geometry.deleteAttribute( 'color' );
+
+		this.geometry.setAttribute( 'position', new BufferAttribute( vertices, 3 ) );
+		this.geometry.setAttribute( 'color', new BufferAttribute( colors, 4 ) );
+
+	}
+
+	/**
+	 * Frees the GPU-related resources allocated by this instance. Call this
+	 * method whenever this instance is no longer used in your app.
+	 */
+	dispose() {
+
+		this.geometry.dispose();
+		this.material.dispose();
+
+	}
+
+}
+
+export { RapierHelper };

package/examples/jsm/helpers/RectAreaLightHelper.js

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

package/examples/jsm/helpers/TextureHelper.js

@@ -18,6 +18,7 @@ import { mergeGeometries } from '../utils/BufferGeometryUtils.js';
  * When using {@link WebGPURenderer}, import from `TextureHelperGPU.js`.
  *
  * @augments Mesh
+ * @three_import import { TextureHelper } from 'three/addons/helpers/TextureHelper.js';
  */
 class TextureHelper extends Mesh {
 

package/examples/jsm/helpers/TextureHelperGPU.js

@@ -20,6 +20,7 @@ import { mergeGeometries } from '../utils/BufferGeometryUtils.js';
  *
  * @private
  * @augments Mesh
+ * @three_import import { TextureHelper } from 'three/addons/helpers/TextureHelperGPU.js';
  */
 class TextureHelper extends Mesh {
 
@@ -50,7 +51,7 @@ class TextureHelper extends Mesh {
 
 			colorNode = texture3D( texture ).sample( uvw );
 
-		} else if ( texture.isDataArrayTexture || texture.isCompressedArrayTexture ) {
+		} else if ( texture.isArrayTexture || texture.isDataArrayTexture || texture.isCompressedArrayTexture ) {
 
 			colorNode = textureNode( texture ).sample( uvw.xy ).depth( uvw.z );
 
@@ -99,7 +100,7 @@ function getImageCount( texture ) {
 
 		return 6;
 
-	} else if ( texture.isDataArrayTexture || texture.isCompressedArrayTexture ) {
+	} else if ( texture.isArrayTexture || texture.isDataArrayTexture || texture.isCompressedArrayTexture ) {
 
 		return texture.image.depth;
 
@@ -121,7 +122,7 @@ function getAlpha( texture ) {
 
 		return 1;
 
-	} else if ( texture.isDataArrayTexture || texture.isCompressedArrayTexture ) {
+	} else if ( texture.isArrayTexture || texture.isDataArrayTexture || texture.isCompressedArrayTexture ) {
 
 		return Math.max( 1 / texture.image.depth, 0.25 );
 
@@ -191,7 +192,7 @@ function createSliceGeometry( texture, width, height, depth ) {
 			const v = texture.flipY ? uv.getY( j ) : 1 - uv.getY( j );
 			const w = sliceCount === 1
 				? 1
-				: texture.isDataArrayTexture || texture.isCompressedArrayTexture
+				: texture.isArrayTexture || texture.isDataArrayTexture || texture.isCompressedArrayTexture
 					? i
 					: i / ( sliceCount - 1 );
 

package/examples/jsm/helpers/VertexNormalsHelper.js

@@ -27,6 +27,7 @@ const _normalMatrix = new Matrix3();
  * ```
  *
  * @augments LineSegments
+ * @three_import import { VertexNormalsHelper } from 'three/addons/helpers/VertexNormalsHelper.js';
  */
 class VertexNormalsHelper extends LineSegments {
 

package/examples/jsm/helpers/VertexTangentsHelper.js

@@ -20,6 +20,7 @@ const _v2 = new Vector3();
  * ```
  *
  * @augments LineSegments
+ * @three_import import { VertexTangentsHelper } from 'three/addons/helpers/VertexTangentsHelper.js';
  */
 class VertexTangentsHelper extends LineSegments {
 

package/examples/jsm/helpers/ViewHelper.js

@@ -26,6 +26,7 @@ import {
  * so it looks along the selected axis.
  *
  * @augments Object3D
+ * @three_import import { ViewHelper } from 'three/addons/helpers/ViewHelper.js';
  */
 class ViewHelper extends Object3D {
 

package/examples/jsm/interactive/HTMLMesh.js

@@ -23,6 +23,7 @@ import {
  * ```
  *
  * @augments Mesh
+ * @three_import import { HTMLMesh } from 'three/addons/interactive/HTMLMesh.js';
  */
 class HTMLMesh extends Mesh {
 
@@ -477,11 +478,13 @@ function html2canvas( element ) {
 
 				}
 
-				if ( element.type === 'color' || element.type === 'text' || element.type === 'number' ) {
+				if ( element.type === 'color' || element.type === 'text' || element.type === 'number' || element.type === 'email' || element.type === 'password' ) {
 
 					clipper.add( { x: x, y: y, width: width, height: height } );
 
-					drawText( style, x + parseInt( style.paddingLeft ), y + parseInt( style.paddingTop ), element.value );
+					const displayValue = element.type === 'password' ? '*'.repeat( element.value.length ) : element.value;
+
+					drawText( style, x + parseInt( style.paddingLeft ), y + parseInt( style.paddingTop ), displayValue );
 
 					clipper.remove();
 
@@ -577,6 +580,12 @@ function htmlevent( element, event, x, y ) {
 
 				}
 
+				if ( element instanceof HTMLInputElement && ( element.type === 'text' || element.type === 'number' || element.type === 'email' || element.type === 'password' ) && ( event === 'mousedown' || event === 'click' ) ) {
+
+					element.focus();
+
+				}
+
 			}
 
 			for ( let i = 0; i < element.childNodes.length; i ++ ) {

package/examples/jsm/interactive/InteractiveGroup.js

@@ -34,6 +34,7 @@ const _raycaster = new Raycaster();
  * group.add( mesh1, mesh2, mesh3 );
  * ```
  * @augments Group
+ * @three_import import { InteractiveGroup } from 'three/addons/interactive/InteractiveGroup.js';
  */
 class InteractiveGroup extends Group {
 

package/examples/jsm/interactive/SelectionBox.js

@@ -37,6 +37,8 @@ const _scale = new Vector3();
  * const selectionBox = new SelectionBox( camera, scene );
  * const selectedObjects = selectionBox.select( startPoint, endPoint );
  * ```
+ *
+ * @three_import import { SelectionBox } from 'three/addons/interactive/SelectionBox.js';
  */
 class SelectionBox {
 

package/examples/jsm/interactive/SelectionHelper.js

@@ -4,6 +4,8 @@ import { Vector2 } from 'three';
  * A helper for {@link SelectionBox}.
  *
  * It visualizes the current selection box with a `div` container element.
+ *
+ * @three_import import { SelectionHelper } from 'three/addons/interactive/SelectionHelper.js';
  */
 class SelectionHelper {