@woosh/meep-engine 2.108.3 → 2.109.0

package/build/meep.cjs

@@ -557,7 +557,7 @@ assert.isArray = function (value, name = 'value') {
 
 /**
  * @template T
- * @param {ArrayLike<T>|T[]} value
+ * @param {ArrayLike<T>|T[]|Uint32Array|Float32Array} value
  * @param {string} name
  */
 assert.isArrayLike = function (value, name = 'value') {
@@ -3608,7 +3608,7 @@ let Quaternion$1 = class Quaternion {
     /**
      *
      * @param {Quaternion} other
-     * @param {number} max_delta
+     * @param {number} max_delta in radians
      */
     rotateTowards(other, max_delta) {
         Quaternion.rotateTowards(this, this, other, max_delta);
@@ -4987,6 +4987,19 @@ class Transform {
         return result;
     }
 
+    /**
+     *
+     * @param {number[]|Float32Array} mat
+     * @returns {Transform}
+     */
+    static fromMatrix(mat) {
+        const result = new Transform();
+
+        result.fromMatrix4(mat);
+
+        return result;
+    }
+
     /**
      * Multiply two transforms, result it written into this one
      * @param {Transform} a
@@ -5000,17 +5013,18 @@ class Transform {
 
     /**
      *
-     * @param {mat4|number[]|Float32Array} m
+     * @param {mat4|number[]|Float32Array} matrix
      */
-    fromMatrix4(m) {
+    fromMatrix4(matrix) {
+
         // we know we are changing the matrix, so we're going to need to disable the flag that sets matrix from position/rotation/scale changes
         const ad = this.getFlag(TransformFlags.AutomaticChangeDetection);
 
         this.clearFlag(TransformFlags.AutomaticChangeDetection);
 
-        this.matrix.set(m);
+        this.matrix.set(matrix);
 
-        decompose_matrix_4_array(m, this.position, this.rotation, this.scale);
+        decompose_matrix_4_array(matrix, this.position, this.rotation, this.scale);
 
         // restore value of the flag
         this.writeFlag(TransformFlags.AutomaticChangeDetection, ad);
@@ -5464,7 +5478,7 @@ const UnsignedShort5551Type = 1018;
 const UnsignedShort565Type = 1019;
 const UnsignedInt248Type = 1020;
 const AlphaFormat = 1021;
-const RGBFormat = 1022;
+const RGBFormat$1 = 1022;
 const RGBAFormat = 1023;
 const LuminanceFormat = 1024;
 const LuminanceAlphaFormat = 1025;
@@ -23396,7 +23410,7 @@ function WebGLProgram( renderer, cacheKey, parameters, bindingStates ) {
 			( parameters.toneMapping !== NoToneMapping ) ? getToneMappingFunction( 'toneMapping', parameters.toneMapping ) : '',
 
 			parameters.dithering ? '#define DITHERING' : '',
-			parameters.format === RGBFormat ? '#define OPAQUE' : '',
+			parameters.format === RGBFormat$1 ? '#define OPAQUE' : '',
 
 			ShaderChunk[ 'encodings_pars_fragment' ], // this code is required here because it is used by the various encoding/decoding function defined below
 			parameters.map ? getTexelDecodingFunction( 'mapTexelToLinear', parameters.mapEncoding ) : '',
@@ -27494,7 +27508,7 @@ function WebGLTextures( _gl, extensions, state, properties, capabilities, utils,
 
 				mipmap = mipmaps[ i ];
 
-				if ( texture.format !== RGBAFormat && texture.format !== RGBFormat ) {
+				if ( texture.format !== RGBAFormat && texture.format !== RGBFormat$1 ) {
 
 					if ( glFormat !== null ) {
 
@@ -27705,7 +27719,7 @@ function WebGLTextures( _gl, extensions, state, properties, capabilities, utils,
 
 					const mipmap = mipmaps[ j ];
 
-					if ( texture.format !== RGBAFormat && texture.format !== RGBFormat ) {
+					if ( texture.format !== RGBAFormat && texture.format !== RGBFormat$1 ) {
 
 						if ( glFormat !== null ) {
 
@@ -28122,7 +28136,7 @@ function WebGLTextures( _gl, extensions, state, properties, capabilities, utils,
 
 		// Handles WebGL2 RGBFormat fallback - #18858
 
-		if ( isWebGL2 && texture.format === RGBFormat && ( texture.type === FloatType || texture.type === HalfFloatType ) ) {
+		if ( isWebGL2 && texture.format === RGBFormat$1 && ( texture.type === FloatType || texture.type === HalfFloatType ) ) {
 
 			texture.format = RGBAFormat;
 
@@ -28467,7 +28481,7 @@ function WebGLUtils( gl, extensions, capabilities ) {
 		}
 
 		if ( p === AlphaFormat ) return 6406;
-		if ( p === RGBFormat ) return 6407;
+		if ( p === RGBFormat$1 ) return 6407;
 		if ( p === RGBAFormat ) return 6408;
 		if ( p === LuminanceFormat ) return 6409;
 		if ( p === LuminanceAlphaFormat ) return 6410;
@@ -29262,7 +29276,7 @@ class WebXRManager extends EventDispatcher {
 							glProjLayer.textureWidth,
 							glProjLayer.textureHeight,
 							{
-								format: attributes.alpha ? RGBAFormat : RGBFormat,
+								format: attributes.alpha ? RGBAFormat : RGBFormat$1,
 								type: UnsignedByteType,
 								depthTexture: new DepthTexture( glProjLayer.textureWidth, glProjLayer.textureHeight, depthType, undefined, undefined, undefined, undefined, undefined, undefined, depthFormat ),
 								stencilBuffer: attributes.stencil,
@@ -34187,7 +34201,7 @@ class VideoTexture extends Texture {
 
 		super( video, mapping, wrapS, wrapT, magFilter, minFilter, format, type, anisotropy );
 
-		this.format = format !== undefined ? format : RGBFormat;
+		this.format = format !== undefined ? format : RGBFormat$1;
 
 		this.minFilter = minFilter !== undefined ? minFilter : LinearFilter;
 		this.magFilter = magFilter !== undefined ? magFilter : LinearFilter;
@@ -58964,7 +58978,7 @@ function writeSample2DDataToDataTexture(sampler, texture) {
             throw new Error('itemSize is 2 and texture.format is not RGFormat');
         }
     } else if (sampler.itemSize === 3) {
-        if (texture.format !== RGBFormat) {
+        if (texture.format !== RGBFormat$1) {
             throw new Error('itemSize is 2 and texture.format is not RGBFormat');
         }
     } else if (sampler.itemSize === 4) {
@@ -59188,7 +59202,7 @@ function channelCountToThreeTextureFormat(count) {
         case 2:
             return RGFormat;
         case 3:
-            return RGBFormat;
+            return RGBFormat$1;
         case 4:
             return RGBAFormat;
         default:
@@ -62743,7 +62757,7 @@ class TerrainLayers {
          * @type {DataTexture2DArray}
          */
         this.texture = new DataTexture2DArray(new Uint8Array(3), 1, 1, 1);
-        this.texture.format = RGBFormat;
+        this.texture.format = RGBFormat$1;
         this.texture.type = UnsignedByteType;
 
         this.texture.wrapS = RepeatWrapping;
@@ -67534,6 +67548,12 @@ const CopyShader = {
 
 };
 
+/**
+ * WebGL constant, declared explicitly to avoid issues with later THREE.js versions where it is absent
+ * @type {number}
+ */
+const RGBFormat = 1022;
+
 /**
  *
  * @param {number} format
@@ -69337,6 +69357,36 @@ function computeSystemName(system) {
     return system.constructor.name;
 }
 
+/**
+ *
+ * @param {Object3D} object
+ */
+function threeUpdateMatrix(object) {
+    object.updateMatrix();
+
+    const children = object.children;
+    for (let i = 0, childCount = children.length; i < childCount; i++) {
+        const child = children[i];
+
+        threeUpdateMatrix(child);
+    }
+}
+
+/**
+ *
+ * @param {Object3D} object3
+ */
+function threeUpdateTransform(object3) {
+
+    /**
+     signal that transformation matrix should be updated
+     @see https://threejs.org/docs/index.html#api/core/Object3D.matrixWorldNeedsUpdate
+     */
+    threeUpdateMatrix(object3);
+
+    object3.updateMatrixWorld(false);
+}
+
 /**
  *
  * @param {Camera} c
@@ -70083,50 +70133,43 @@ function set_camera_aspect_ratio(camera, width, height) {
 
 /**
  *
- * @param {Object3D} object
+ * @param {Camera} camera
  */
-function threeUpdateMatrix(object) {
-    object.updateMatrix();
+function update_camera_transform(camera) {
 
-    const children = object.children;
-    for (let i = 0, childCount = children.length; i < childCount; i++) {
-        const child = children[i];
+    const three_camera = camera.object;
 
-        threeUpdateMatrix(child);
+    if (three_camera === null) {
+        return;
     }
+
+    three_camera.updateProjectionMatrix();
+    threeUpdateTransform(three_camera);
 }
 
 /**
  *
- * @param {Object3D} object3
+ * @param {THREE.Camera} object
+ * @param {Quaternion} rotation
  */
-function threeUpdateTransform(object3) {
+function three_camera_set_transform_rotation(object, rotation) {
 
-    /**
-     signal that transformation matrix should be updated
-     @see https://threejs.org/docs/index.html#api/core/Object3D.matrixWorldNeedsUpdate
+    /*
+    NOTE: I'm not sure why, but three.js camera points in the opposite direction to normal objects
+    See: https://github.com/mrdoob/three.js/blob/412b99a7f26e117ea97f40eb53d010ab81aa3279/src/core/Object3D.js#L282
      */
-    threeUpdateMatrix(object3);
 
-    object3.updateMatrixWorld(false);
-}
-
-/**
- *
- * @param {Camera} camera
- */
-function update_camera_transform(camera) {
+    invertQuaternionOrientation(object.quaternion, rotation);
 
-    const three_camera = camera.object;
+    object.rotation.setFromQuaternion(object.quaternion);
 
-    if (three_camera === null) {
-        return;
-    }
+    // rotation.__setThreeEuler(camera.object.rotation); // seems unnecessary, based on Object3D.lookAt implementation
+    // camera.object.quaternion.set(rotation.x, rotation.y, rotation.z, rotation.w);
+
+    object.updateProjectionMatrix();
+    threeUpdateTransform(object);
+}
 
-    three_camera.updateProjectionMatrix();
-    threeUpdateTransform(three_camera);
-}
-
 class CameraSystem extends System {
     /**
      *
@@ -70215,19 +70258,7 @@ class CameraSystem extends System {
         function synchronizeRotation() {
             const rotation = transform.rotation;
 
-            /*
-            NOTE: I'm not sure why, but three.js camera points in the opposite direction to normal objects
-            See: https://github.com/mrdoob/three.js/blob/412b99a7f26e117ea97f40eb53d010ab81aa3279/src/core/Object3D.js#L282
-             */
-
-            invertQuaternionOrientation(camera.object.quaternion, rotation);
-
-            camera.object.rotation.setFromQuaternion(camera.object.quaternion);
-
-            // rotation.__setThreeEuler(camera.object.rotation); // seems unnecessary, based on Object3D.lookAt implementation
-            // camera.object.quaternion.set(rotation.x, rotation.y, rotation.z, rotation.w);
-
-            update_camera_transform(camera);
+            three_camera_set_transform_rotation(camera.object, rotation);
         }
 
         function rebuild() {
@@ -88350,7 +88381,7 @@ class ColorAndDepthFrameBuffer extends FrameBuffer {
 
         const target = new WebGLMultisampleRenderTarget(size.x, size.y,{ignoreDepth: false});
 
-        target.texture.format = RGBFormat; // note, three.js required RGBA render texture, even though RGB would do here
+        target.texture.format = RGBFormat$1; // note, three.js required RGBA render texture, even though RGB would do here
         target.texture.minFilter = NearestFilter;
         target.texture.magFilter = NearestFilter;
         target.texture.generateMipmaps = false;