@plastic-software/three 0.167.4 → 0.174.0

package/examples/jsm/Addons.js

@@ -1,9 +1,5 @@
 export * from './animation/AnimationClipCreator.js';
 export * from './animation/CCDIKSolver.js';
-export * from './animation/MMDAnimationHelper.js';
-export * from './animation/MMDPhysics.js';
-
-export * from './cameras/CinematicCamera.js';
 
 export { default as WebGL } from './capabilities/WebGL.js';
 
@@ -42,7 +38,6 @@ export * from './exporters/DRACOExporter.js';
 export * from './exporters/EXRExporter.js';
 export * from './exporters/GLTFExporter.js';
 export * from './exporters/KTX2Exporter.js';
-export * from './exporters/MMDExporter.js';
 export * from './exporters/OBJExporter.js';
 export * from './exporters/PLYExporter.js';
 export * from './exporters/STLExporter.js';
@@ -104,11 +99,9 @@ export * from './loaders/LDrawLoader.js';
 export * from './loaders/LUT3dlLoader.js';
 export * from './loaders/LUTCubeLoader.js';
 export * from './loaders/LWOLoader.js';
-export * from './loaders/LogLuvLoader.js';
 export * from './loaders/LottieLoader.js';
 export * from './loaders/MD2Loader.js';
 export * from './loaders/MDDLoader.js';
-export * from './loaders/MMDLoader.js';
 export * from './loaders/MTLLoader.js';
 export * from './loaders/NRRDLoader.js';
 export * from './loaders/OBJLoader.js';
@@ -125,7 +118,6 @@ export * from './loaders/TDSLoader.js';
 export * from './loaders/TGALoader.js';
 export * from './loaders/TIFFLoader.js';
 export * from './loaders/TTFLoader.js';
-export * from './loaders/TiltLoader.js';
 export * from './loaders/USDZLoader.js';
 export * from './loaders/VOXLoader.js';
 export * from './loaders/VRMLLoader.js';
@@ -133,6 +125,8 @@ export * from './loaders/VTKLoader.js';
 export * from './loaders/XYZLoader.js';
 
 export * from './materials/MeshGouraudMaterial.js';
+export * from './materials/LDrawConditionalLineMaterial.js';
+export * from './materials/MeshPostProcessingMaterial.js';
 
 export * from './math/Capsule.js';
 export * from './math/ColorConverter.js';
@@ -173,9 +167,6 @@ export * from './objects/ShadowMesh.js';
 export * from './objects/Sky.js';
 export * from './objects/Water.js';
 export { Water as Water2 } from './objects/Water2.js';
-export * from './objects/SkyMesh.js';
-export * from './objects/WaterMesh.js';
-export { WaterMesh as Water2Mesh } from './objects/Water2Mesh.js';
 
 export * from './physics/AmmoPhysics.js';
 export * from './physics/RapierPhysics.js';
@@ -245,7 +236,6 @@ export * from './shaders/HueSaturationShader.js';
 export * from './shaders/KaleidoShader.js';
 export * from './shaders/LuminosityHighPassShader.js';
 export * from './shaders/LuminosityShader.js';
-export * from './shaders/MMDToonShader.js';
 export * from './shaders/MirrorShader.js';
 export * from './shaders/NormalMapShader.js';
 export * from './shaders/OutputShader.js';
@@ -272,16 +262,14 @@ export * from './textures/FlakesTexture.js';
 
 export * as BufferGeometryUtils from './utils/BufferGeometryUtils.js';
 export * as CameraUtils from './utils/CameraUtils.js';
-export * from './utils/GPUStatsPanel.js';
 export * as GeometryCompressionUtils from './utils/GeometryCompressionUtils.js';
 export * as GeometryUtils from './utils/GeometryUtils.js';
 export * from './utils/LDrawUtils.js';
-export * from './utils/PackedPhongMaterial.js';
 export * as SceneUtils from './utils/SceneUtils.js';
 export * from './utils/ShadowMapViewer.js';
 export * as SkeletonUtils from './utils/SkeletonUtils.js';
 export * as SortUtils from './utils/SortUtils.js';
-export * from './utils/TextureUtils.js';
+export * from './utils/WebGLTextureUtils.js';
 export * from './utils/UVsDebug.js';
 export * from './utils/WorkerPool.js';
 

package/examples/jsm/animation/AnimationClipCreator.js

@@ -92,7 +92,7 @@ class AnimationClipCreator {
 	static CreateMaterialColorAnimation( duration, colors ) {
 
 		const times = [], values = [],
-			timeStep = duration / colors.length;
+			timeStep = ( colors.length > 1 ) ? duration / ( colors.length - 1 ) : 0;
 
 		for ( let i = 0; i < colors.length; i ++ ) {
 

package/examples/jsm/animation/CCDIKSolver.js

@@ -28,7 +28,7 @@ const _matrix = new Matrix4();
 
 /**
  * CCD Algorithm
- *  - https://sites.google.com/site/auraliusproject/ccd-algorithm
+ *  - https://web.archive.org/web/20221206080850/https://sites.google.com/site/auraliusproject/ccd-algorithm
  *
  * // ik parameter example
  * //
@@ -57,6 +57,22 @@ class CCDIKSolver {
 		this.mesh = mesh;
 		this.iks = iks;
 
+		this._initialQuaternions = [];
+		this._workingQuaternion = new Quaternion();
+
+		for ( const ik of iks ) {
+
+			const chainQuats = [];
+			for ( let i = 0; i < ik.links.length; i ++ ) {
+
+			  chainQuats.push( new Quaternion() );
+
+			}
+
+			this._initialQuaternions.push( chainQuats );
+
+		}
+
 		this._valid();
 
 	}
@@ -64,15 +80,16 @@ class CCDIKSolver {
 	/**
 	 * Update all IK bones.
 	 *
+	 * @param {number} [globalBlendFactor=1.0] - Blend factor applied if an IK chain doesn't have its own .blendFactor.
 	 * @return {CCDIKSolver}
 	 */
-	update() {
+	update( globalBlendFactor = 1.0 ) {
 
 		const iks = this.iks;
 
 		for ( let i = 0, il = iks.length; i < il; i ++ ) {
 
-			this.updateOne( iks[ i ] );
+			this.updateOne( iks[ i ], globalBlendFactor );
 
 		}
 
@@ -84,11 +101,15 @@ class CCDIKSolver {
 	 * Update one IK bone
 	 *
 	 * @param {Object} ik parameter
+	 * @param {number} [overrideBlend=1.0] - If the ik object does not define .blendFactor, this value is used.
 	 * @return {CCDIKSolver}
 	 */
-	updateOne( ik ) {
+	updateOne( ik, overrideBlend = 1.0 ) {
 
+		const chainBlend = ik.blendFactor !== undefined ? ik.blendFactor : overrideBlend;
 		const bones = this.mesh.skeleton.bones;
+		const chainIndex = this.iks.indexOf( ik );
+		const initialQuaternions = this._initialQuaternions[ chainIndex ];
 
 		// for reference overhead reduction in loop
 		const math = Math;
@@ -103,6 +124,17 @@ class CCDIKSolver {
 		const links = ik.links;
 		const iteration = ik.iteration !== undefined ? ik.iteration : 1;
 
+		if ( chainBlend < 1.0 ) {
+
+			for ( let j = 0; j < links.length; j ++ ) {
+
+			  const linkIndex = links[ j ].index;
+			  initialQuaternions[ j ].copy( bones[ linkIndex ].quaternion );
+
+			}
+
+		}
+
 		for ( let i = 0; i < iteration; i ++ ) {
 
 			let rotated = false;
@@ -111,8 +143,7 @@ class CCDIKSolver {
 
 				const link = bones[ links[ j ].index ];
 
-				// skip this link and following links.
-				// this skip is used for MMD performance optimization.
+				// skip this link and following links
 				if ( links[ j ].enabled === false ) break;
 
 				const limitation = links[ j ].limitation;
@@ -206,7 +237,23 @@ class CCDIKSolver {
 
 		}
 
-		return this;
+		if ( chainBlend < 1.0 ) {
+
+			for ( let j = 0; j < links.length; j ++ ) {
+
+			  const linkIndex = links[ j ].index;
+			  const link = bones[ linkIndex ];
+
+			  this._workingQuaternion.copy( initialQuaternions[ j ] ).slerp( link.quaternion, chainBlend );
+
+			  link.quaternion.copy( this._workingQuaternion );
+			  link.updateMatrixWorld( true );
+
+			}
+
+		}
+
+		  return this;
 
 	}
 
@@ -278,13 +325,14 @@ function setPositionOfBoneToAttributeArray( array, index, bone, matrixWorldInv )
 
 /**
  * Visualize IK bones
- *
- * @param {SkinnedMesh} mesh
- * @param {Array<Object>} iks
- * @param {number} sphereSize
  */
 class CCDIKHelper extends Object3D {
 
+	/**
+	 * @param {SkinnedMesh} mesh
+ 	 * @param {Array<Object>} [iks=[]]
+ 	 * @param {number} [sphereSize=0.25]
+	 */
 	constructor( mesh, iks = [], sphereSize = 0.25 ) {
 
 		super();
@@ -331,6 +379,8 @@ class CCDIKHelper extends Object3D {
 
 	/**
 	 * Updates IK bones visualization.
+	 *
+	 * @param {boolean} force
 	 */
 	updateMatrixWorld( force ) {
 

package/examples/jsm/capabilities/WebGL.js

@@ -1,20 +1,5 @@
 class WebGL {
 
-	static isWebGLAvailable() {
-
-		try {
-
-			const canvas = document.createElement( 'canvas' );
-			return !! ( window.WebGLRenderingContext && ( canvas.getContext( 'webgl' ) || canvas.getContext( 'experimental-webgl' ) ) );
-
-		} catch ( e ) {
-
-			return false;
-
-		}
-
-	}
-
 	static isWebGL2Available() {
 
 		try {
@@ -47,12 +32,6 @@ class WebGL {
 
 	}
 
-	static getWebGLErrorMessage() {
-
-		return this.getErrorMessage( 1 );
-
-	}
-
 	static getWebGL2ErrorMessage() {
 
 		return this.getErrorMessage( 2 );
@@ -103,6 +82,33 @@ class WebGL {
 
 	}
 
+	// @deprecated, r168
+
+	static isWebGLAvailable() {
+
+		console.warn( 'isWebGLAvailable() has been deprecated and will be removed in r178. Use isWebGL2Available() instead.' );
+
+		try {
+
+			const canvas = document.createElement( 'canvas' );
+			return !! ( window.WebGLRenderingContext && ( canvas.getContext( 'webgl' ) || canvas.getContext( 'experimental-webgl' ) ) );
+
+		} catch ( e ) {
+
+			return false;
+
+		}
+
+	}
+
+	static getWebGLErrorMessage() {
+
+		console.warn( 'getWebGLErrorMessage() has been deprecated and will be removed in r178. Use getWebGL2ErrorMessage() instead.' );
+
+		return this.getErrorMessage( 1 );
+
+	}
+
 }
 
 export default WebGL;

package/examples/jsm/capabilities/WebGPU.js

@@ -1,13 +1,4 @@
-if ( self.GPUShaderStage === undefined ) {
-
-	self.GPUShaderStage = { VERTEX: 1, FRAGMENT: 2, COMPUTE: 4 };
-
-}
-
-// statics
-
-let isAvailable = navigator.gpu !== undefined;
-
+let isAvailable = ( typeof navigator !== 'undefined' && navigator.gpu !== undefined );
 
 if ( typeof window !== 'undefined' && isAvailable ) {