@gnsx/three 0.185.16 → 0.186.0

package/examples/jsm/Addons.js

@@ -92,11 +92,13 @@ export * from './loaders/EXRLoader.js';
 export * from './loaders/FBXLoader.js';
 export * from './loaders/FontLoader.js';
 export * from './loaders/GCodeLoader.js';
+export * from './loaders/GLTFGaussianSplatLoaderExtension.js';
 export * from './loaders/GLTFLoader.js';
 export * from './loaders/HDRLoader.js';
 export * from './loaders/HDRCubeTextureLoader.js';
 export * from './loaders/IESLoader.js';
 export * from './loaders/KMZLoader.js';
+export * from './loaders/KSPLATLoader.js';
 export * from './loaders/KTX2Loader.js';
 export * from './loaders/KTXLoader.js';
 export * from './loaders/LDrawLoader.js';
@@ -104,12 +106,6 @@ export * from './loaders/LUT3dlLoader.js';
 export * from './loaders/LUTCubeLoader.js';
 export * from './loaders/LUTImageLoader.js';
 export * from './loaders/LWOLoader.js';
-// WITH_GENESYS
-// LottieLoader is excluded from the Addons barrel because it imports lottie-web from a CDN URL
-// (https://cdn.jsdelivr.net/npm/lottie-web@5.13.0/+esm), which Node.js/TSX cannot resolve in test
-// environments. The loader is also deprecated in r185 and scheduled for removal in r186.
-// export * from './loaders/LottieLoader.js';
-// !WITH_GENESYS
 export * from './loaders/MD2Loader.js';
 export * from './loaders/MDDLoader.js';
 export * from './loaders/MTLLoader.js';
@@ -120,6 +116,8 @@ export * from './loaders/PDBLoader.js';
 export * from './loaders/PLYLoader.js';
 export * from './loaders/PVRLoader.js';
 export * from './loaders/RGBELoader.js';
+export * from './loaders/SPLATLoader.js';
+export * from './loaders/SPZLoader.js';
 export * from './loaders/UltraHDRLoader.js';
 export * from './loaders/STLLoader.js';
 export * from './loaders/SVGLoader.js';
@@ -155,6 +153,7 @@ export * from './misc/MorphAnimMesh.js';
 export * from './misc/MorphBlendMesh.js';
 export * from './misc/ProgressiveLightMap.js';
 export * from './misc/RollerCoaster.js';
+export * from './misc/Sculptor.js';
 export * from './misc/TileCreasedNormalsPlugin.js';
 export * from './misc/TubePainter.js';
 export * from './misc/Volume.js';
@@ -166,6 +165,7 @@ export * from './modifiers/SimplifyModifier.js';
 export * from './modifiers/TessellateModifier.js';
 
 export * from './objects/GroundedSkybox.js';
+export * from './objects/GaussianSplat.js';
 export * from './objects/Lensflare.js';
 export * from './objects/MarchingCubes.js';
 export * from './objects/Reflector.js';

package/examples/jsm/controls/ArcballControls.js

@@ -2563,7 +2563,7 @@ class ArcballControls extends Controls {
 	 * Rotates camera around its direction axis passing by a given point by a given angle.
 	 *
 	 * @private
-	 * @param {Vector3} point - The point where the rotation axis is passing trough.
+	 * @param {Vector3} point - The point where the rotation axis is passing through.
 	 * @param {number} angle - Angle in radians.
 	 * @returns {Object} The computed transformation matrix.
 	 */

package/examples/jsm/controls/FirstPersonControls.js

@@ -262,25 +262,51 @@ class FirstPersonControls extends Controls {
 
 		if ( this.enabled === false ) return;
 
-		const moveForward = this._keyForward || this._pointerForward;
-		const moveBackward = this._keyBackward || this._pointerBackward;
+		let drive = ( this._keyForward ? 1 : 0 ) - ( this._keyBackward ? 1 : 0 );
+		let lookMove = ( this._pointerForward ? 1 : 0 ) - ( this._pointerBackward ? 1 : 0 );
 
-		const forward = moveForward || ( this.autoForward && ! moveBackward );
-
-		// target velocity in the object's local space
-
-		_targetVelocity.set(
-			( this._moveRight ? 1 : 0 ) - ( this._moveLeft ? 1 : 0 ),
-			( this._moveUp ? 1 : 0 ) - ( this._moveDown ? 1 : 0 ),
-			( moveBackward ? 1 : 0 ) - ( forward ? 1 : 0 )
-		).multiplyScalar( this.movementSpeed );
+		if ( this.autoForward && drive === 0 && lookMove === 0 ) lookMove = 1;
 
 		// faster forward movement the higher the camera is
 
-		if ( forward && this.heightSpeed ) {
+		let forwardSpeed = this.movementSpeed;
+
+		if ( this.heightSpeed ) {
 
 			const y = MathUtils.clamp( this.object.position.y, this.heightMin, this.heightMax );
-			_targetVelocity.z -= ( y - this.heightMin ) * this.heightCoef;
+			forwardSpeed += ( y - this.heightMin ) * this.heightCoef;
+
+		}
+
+		// target velocity in world space: keys are world axis aligned, moving in the
+		// XZ plane from the camera's yaw only (R / F along world Y), while pointer
+		// and touch input moves along the look direction
+
+		const yaw = MathUtils.degToRad( this._lon );
+		const sinYaw = Math.sin( yaw );
+		const cosYaw = Math.cos( yaw );
+
+		let strafe = ( this._moveRight ? 1 : 0 ) - ( this._moveLeft ? 1 : 0 );
+		let climb = ( this._moveUp ? 1 : 0 ) - ( this._moveDown ? 1 : 0 );
+
+		// normalize combined key input so diagonal movement isn't faster
+
+		const keyScale = 1 / Math.max( 1, Math.sqrt( strafe * strafe + climb * climb + drive * drive ) );
+
+		strafe *= this.movementSpeed * keyScale;
+		climb *= this.movementSpeed * keyScale;
+		drive *= ( drive > 0 ? forwardSpeed : this.movementSpeed ) * keyScale;
+
+		_targetVelocity.set(
+			sinYaw * drive - cosYaw * strafe,
+			climb,
+			cosYaw * drive + sinYaw * strafe
+		);
+
+		if ( lookMove !== 0 ) {
+
+			_lookDirection.set( 0, 0, - 1 ).applyQuaternion( this.object.quaternion );
+			_targetVelocity.addScaledVector( _lookDirection, lookMove * ( lookMove > 0 ? forwardSpeed : this.movementSpeed ) );
 
 		}
 
@@ -288,9 +314,7 @@ class FirstPersonControls extends Controls {
 
 		this._velocity.lerp( _targetVelocity, this.dampingFactor );
 
-		this.object.translateX( this._velocity.x * delta );
-		this.object.translateY( this._velocity.y * delta );
-		this.object.translateZ( this._velocity.z * delta );
+		this.object.position.addScaledVector( this._velocity, delta );
 
 		let verticalLookRatio = 1;
 
@@ -447,8 +471,8 @@ function onKeyDown( event ) {
 		case 'ArrowRight':
 		case 'KeyD': this._moveRight = true; break;
 
-		case 'KeyE': this._moveUp = true; break;
-		case 'KeyQ': this._moveDown = true; break;
+		case 'KeyR': this._moveUp = true; break;
+		case 'KeyF': this._moveDown = true; break;
 
 	}
 
@@ -470,8 +494,8 @@ function onKeyUp( event ) {
 		case 'ArrowRight':
 		case 'KeyD': this._moveRight = false; break;
 
-		case 'KeyE': this._moveUp = false; break;
-		case 'KeyQ': this._moveDown = false; break;
+		case 'KeyR': this._moveUp = false; break;
+		case 'KeyF': this._moveDown = false; break;
 
 	}
 

package/examples/jsm/controls/OrbitControls.js

@@ -511,6 +511,8 @@ class OrbitControls extends Controls {
 
 	disconnect() {
 
+		this.state = _STATE.NONE;
+
 		this.domElement.removeEventListener( 'pointerdown', this._onPointerDown );
 		this.domElement.ownerDocument.removeEventListener( 'pointermove', this._onPointerMove );
 		this.domElement.ownerDocument.removeEventListener( 'pointerup', this._onPointerUp );
@@ -523,8 +525,15 @@ class OrbitControls extends Controls {
 
 		const document = this.domElement.getRootNode(); // offscreen canvas compatibility
 		document.removeEventListener( 'keydown', this._interceptControlDown, { capture: true } );
+		document.removeEventListener( 'keyup', this._interceptControlUp, { capture: true } );
+
+		this._controlActive = false;
+
+		this._pointers.length = 0;
+		this._pointerPositions = {};
 
 		this.domElement.style.touchAction = ''; // Restore touch scroll
+		this.domElement.style.cursor = 'auto';
 
 	}
 

package/examples/jsm/controls/TrackballControls.js

@@ -97,6 +97,14 @@ class TrackballControls extends Controls {
 		 */
 		this.panSpeed = 0.3;
 
+		/**
+		 * The roll speed used for multi-touch roll.
+		 *
+		 * @type {number}
+		 * @default 1
+		 */
+		this.rollSpeed = 1.0;
+
 		/**
 		 * Whether rotation is disabled or not.
 		 *
@@ -121,6 +129,15 @@ class TrackballControls extends Controls {
 		 */
 		this.noPan = false;
 
+		/**
+		 * Whether two finger twist gesture rolls
+		 * the camera around its view axis or not.
+		 *
+		 * @type {boolean}
+		 * @default false
+		 */
+		this.multiTouchRoll = false;
+
 		/**
 		 * Whether damping is disabled or not.
 		 *
@@ -209,10 +226,14 @@ class TrackballControls extends Controls {
 		this.keyState = _STATE.NONE;
 
 		this._lastPosition = new Vector3();
+		this._lastUp = new Vector3();
 		this._lastZoom = 1;
 		this._touchZoomDistanceStart = 0;
 		this._touchZoomDistanceEnd = 0;
+		this._touchRollAngle = 0;
+		this._touchRollPointerIds = '';
 		this._lastAngle = 0;
+		this._lastRollAngle = 0;
 
 		this._eye = new Vector3();
 
@@ -331,6 +352,12 @@ class TrackballControls extends Controls {
 
 			this._rotateCamera();
 
+			if ( this.multiTouchRoll === true ) {
+
+				this._rollCamera();
+
+			}
+
 		}
 
 		if ( ! this.noZoom ) {
@@ -353,11 +380,15 @@ class TrackballControls extends Controls {
 
 			this.object.lookAt( this.target );
 
-			if ( this._lastPosition.distanceToSquared( this.object.position ) > _EPS ) {
+			const positionChanged = this._lastPosition.distanceToSquared( this.object.position ) > _EPS;
+			const rollChanged = this._lastUp.distanceToSquared( this.object.up ) > _EPS;
+
+			if ( positionChanged || rollChanged ) {
 
 				this.dispatchEvent( _changeEvent );
 
 				this._lastPosition.copy( this.object.position );
+				this._lastUp.copy( this.object.up );
 
 			}
 
@@ -365,11 +396,16 @@ class TrackballControls extends Controls {
 
 			this.object.lookAt( this.target );
 
-			if ( this._lastPosition.distanceToSquared( this.object.position ) > _EPS || this._lastZoom !== this.object.zoom ) {
+			const positionChanged = this._lastPosition.distanceToSquared( this.object.position ) > _EPS;
+			const rollChanged = this._lastUp.distanceToSquared( this.object.up ) > _EPS;
+			const zoomChanged = this._lastZoom !== this.object.zoom;
+
+			if ( positionChanged || rollChanged || zoomChanged ) {
 
 				this.dispatchEvent( _changeEvent );
 
 				this._lastPosition.copy( this.object.position );
+				this._lastUp.copy( this.object.up );
 				this._lastZoom = this.object.zoom;
 
 			}
@@ -404,6 +440,7 @@ class TrackballControls extends Controls {
 		this.dispatchEvent( _changeEvent );
 
 		this._lastPosition.copy( this.object.position );
+		this._lastUp.copy( this.object.up );
 		this._lastZoom = this.object.zoom;
 
 	}
@@ -489,6 +526,76 @@ class TrackballControls extends Controls {
 
 	}
 
+	_rollCamera() {
+
+		const angle = this._getTouchRollAngle();
+
+		if ( angle ) {
+
+			this._lastRollAngle = angle * this.rollSpeed;
+
+		} else if ( ! this.staticMoving && this._lastRollAngle ) {
+
+			this._lastRollAngle *= Math.sqrt( 1.0 - this.dynamicDampingFactor );
+
+		} else {
+
+			return;
+
+		}
+
+		_eyeDirection.copy( this._eye ).normalize();
+		_quaternion.setFromAxisAngle( _eyeDirection, this._lastRollAngle );
+
+		this.object.up.applyQuaternion( _quaternion );
+
+	}
+
+	_getTouchRollAngle() {
+
+		const first = this._pointers[ 0 ];
+		const second = this._pointers[ 1 ];
+
+		if ( second === undefined || first.pointerType !== 'touch' || second.pointerType !== 'touch' ) {
+
+			this._touchRollPointerIds = '';
+			return 0;
+
+		}
+
+		const pointerIds = `${ first.pointerId },${ second.pointerId }`;
+
+		const positionFirst = this._pointerPositions[ first.pointerId ];
+		const positionSecond = this._pointerPositions[ second.pointerId ];
+
+		const rollAngle = Math.atan2( positionSecond.y - positionFirst.y, positionSecond.x - positionFirst.x );
+
+		// fingers changed or new gesture started
+		if ( pointerIds !== this._touchRollPointerIds ) {
+
+			this._touchRollPointerIds = pointerIds;
+			this._touchRollAngle = rollAngle;
+			return 0;
+
+		}
+
+		let angle = rollAngle - this._touchRollAngle;
+		this._touchRollAngle = rollAngle;
+
+		if ( angle > Math.PI ) {
+
+			angle -= 2 * Math.PI;
+
+		} else if ( angle < - Math.PI ) {
+
+			angle += 2 * Math.PI;
+
+		}
+
+		return angle;
+
+	}
+
 	_zoomCamera() {
 
 		let factor;
@@ -839,7 +946,6 @@ function onMouseMove( event ) {
 
 	if ( state === _STATE.ROTATE && ! this.noRotate ) {
 
-		this._movePrev.copy( this._moveCurr );
 		this._moveCurr.copy( this._getMouseOnCircle( event.pageX, event.pageY ) );
 
 	} else if ( state === _STATE.ZOOM && ! this.noZoom ) {
@@ -939,7 +1045,6 @@ function onTouchMove( event ) {
 	switch ( this._pointers.length ) {
 
 		case 1:
-			this._movePrev.copy( this._moveCurr );
 			this._moveCurr.copy( this._getMouseOnCircle( event.pageX, event.pageY ) );
 			break;
 

package/examples/jsm/csm/CSMShadowNode.js

@@ -491,6 +491,16 @@ class CSMShadowNode extends ShadowBaseNode {
 
 	}
 
+	build( builder ) {
+
+		// register before the shadow nodes so `updateBefore()` runs first
+
+		builder.addSequentialNode( this );
+
+		return super.build( builder );
+
+	}
+
 	setup( builder ) {
 
 		if ( this.camera === null ) this._init( builder );
@@ -562,6 +572,9 @@ class CSMShadowNode extends ShadowBaseNode {
 			lwLight.target.position.copy( _center );
 			lwLight.target.position.add( _lightDirection );
 
+			lwLight.updateMatrixWorld();
+			lwLight.target.updateMatrixWorld();
+
 		}
 
 	}

package/examples/jsm/exporters/GLTFExporter.js

@@ -19,8 +19,8 @@ import {
 	RGBAFormat,
 	RepeatWrapping,
 	Scene,
-	Source,
 	SRGBColorSpace,
+	TextureSource,
 	CompressedTexture,
 	Vector3,
 	Quaternion,
@@ -246,7 +246,7 @@ class GLTFExporter {
 	 * Sets the texture utils for this exporter. Only relevant when compressed textures have to be exported.
 	 *
 	 * Depending on whether you use {@link WebGLRenderer} or {@link WebGPURenderer}, you must inject the
-	 * corresponding texture utils {@link WebGLTextureUtils} or {@link WebGPUTextureUtils}.
+	 * corresponding texture utils {@link module:WebGLTextureUtils} or {@link module:WebGPUTextureUtils}.
 	 *
 	 * @param {WebGLTextureUtils|WebGPUTextureUtils} utils - The texture utils.
 	 * @return {GLTFExporter} A reference to this exporter.
@@ -616,7 +616,8 @@ class GLTFWriter {
 			attributesNormalized: new Map(),
 			materials: new Map(),
 			textures: new Map(),
-			images: new Map()
+			images: new Map(),
+			normalMaps: new Map()
 		};
 
 		this.textureUtils = null;
@@ -651,7 +652,8 @@ class GLTFWriter {
 			onlyVisible: true,
 			maxTextureSize: Infinity,
 			animations: [],
-			includeCustomExtensions: false
+			includeCustomExtensions: false,
+			copyright: null
 		}, options );
 
 		if ( this.options.animations.length > 0 ) {
@@ -686,6 +688,8 @@ class GLTFWriter {
 		// Update bytelength of the single buffer.
 		if ( json.buffers && json.buffers.length > 0 ) json.buffers[ 0 ].byteLength = blob.size;
 
+		if ( options.copyright ) json.asset.copyright = options.copyright;
+
 		if ( options.binary === true ) {
 
 			// https://github.com/KhronosGroup/glTF/blob/master/specification/2.0/README.md#glb-file-format-specification
@@ -1029,7 +1033,7 @@ class GLTFWriter {
 
 		const texture = reference.clone();
 
-		texture.source = new Source( canvas );
+		texture.source = new TextureSource( canvas );
 		texture.colorSpace = NoColorSpace;
 		texture.channel = ( metalnessMap || roughnessMap ).channel;
 
@@ -1091,7 +1095,7 @@ class GLTFWriter {
 		context.putImageData( imageData, 0, 0 );
 
 		const texture = normalMap.clone();
-		texture.source = new Source( canvas );
+		texture.source = new TextureSource( canvas );
 
 		return texture;
 
@@ -1750,7 +1754,18 @@ class GLTFWriter {
 
 			if ( flipX || flipY ) {
 
-				normalMap = await this.buildNormalMapTextureAsync( material.normalMap, flipX, flipY );
+				if ( cache.normalMaps.has( material.normalMap ) === false ) cache.normalMaps.set( material.normalMap, {} );
+
+				const cachedVariants = cache.normalMaps.get( material.normalMap );
+				const cacheKey = `${flipX}:${flipY}`;
+
+				if ( cachedVariants[ cacheKey ] === undefined ) {
+
+					cachedVariants[ cacheKey ] = await this.buildNormalMapTextureAsync( material.normalMap, flipX, flipY );
+
+				}
+
+				normalMap = cachedVariants[ cacheKey ];
 
 			}
 
@@ -3821,6 +3836,7 @@ GLTFExporter.Utils = {
  * @property {Array<AnimationClip>|Array<Array<AnimationClip>>} [animations=[]] - List of animations to be included in the export. When exporting a single 3D object or scene, this is a flat list of clips.
  * When exporting an array of multiple scenes, this must be a nested array with one list of clips per scene, matched to the input by index.
  * @property {boolean} [includeCustomExtensions=false] - Export custom glTF extensions defined on an object's `userData.gltfExtensions` property.
+ * @property {string} [copyright=null] - Export with a copyright notice embedded in the glTF.
  **/
 
 /**

package/examples/jsm/exporters/USDZExporter.js

@@ -156,7 +156,7 @@ class USDZExporter {
 	 * Sets the texture utils for this exporter. Only relevant when compressed textures have to be exported.
 	 *
 	 * Depending on whether you use {@link WebGLRenderer} or {@link WebGPURenderer}, you must inject the
-	 * corresponding texture utils {@link WebGLTextureUtils} or {@link WebGPUTextureUtils}.
+	 * corresponding texture utils {@link module:WebGLTextureUtils} or {@link module:WebGPUTextureUtils}.
 	 *
 	 * @param {WebGLTextureUtils|WebGPUTextureUtils} utils - The texture utils.
 	 */
@@ -342,7 +342,7 @@ class USDZExporter {
 
 		}
 
-		return zipSync( files, { level: 0 } );
+		return zipSync( files, { level: 0, mtime: new Date() } );
 
 	}