three-stdlib 2.15.2 → 2.16.1

package/loaders/lwo/LWO3Parser.js

@@ -1,298 +1,385 @@
-"use strict";
-Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
 function LWO3Parser(IFFParser) {
   this.IFF = IFFParser;
 }
+
 LWO3Parser.prototype = {
   constructor: LWO3Parser,
-  parseBlock: function() {
+  parseBlock: function () {
     this.IFF.debugger.offset = this.IFF.reader.offset;
     this.IFF.debugger.closeForms();
     var blockID = this.IFF.reader.getIDTag();
-    var length = this.IFF.reader.getUint32();
+    var length = this.IFF.reader.getUint32(); // size of data in bytes
+
     this.IFF.debugger.dataOffset = this.IFF.reader.offset;
-    this.IFF.debugger.length = length;
+    this.IFF.debugger.length = length; // Data types may be found in either LWO2 OR LWO3 spec
+
     switch (blockID) {
-      case "FORM":
+      case 'FORM':
+        // form blocks may consist of sub -chunks or sub-forms
         this.IFF.parseForm(length);
         break;
-      case "ICON":
-      case "VMPA":
-      case "BBOX":
-      case "NORM":
-      case "PRE ":
-      case "POST":
-      case "KEY ":
-      case "SPAN":
-      case "TIME":
-      case "CLRS":
-      case "CLRA":
-      case "FILT":
-      case "DITH":
-      case "CONT":
-      case "BRIT":
-      case "SATR":
-      case "HUE ":
-      case "GAMM":
-      case "NEGA":
-      case "IFLT":
-      case "PFLT":
-      case "PROJ":
-      case "AXIS":
-      case "AAST":
-      case "PIXB":
-      case "STCK":
-      case "VALU":
-      case "PNAM":
-      case "INAM":
-      case "GRST":
-      case "GREN":
-      case "GRPT":
-      case "FKEY":
-      case "IKEY":
-      case "CSYS":
-      case "OPAQ":
-      case "CMAP":
-      case "NLOC":
-      case "NZOM":
-      case "NVER":
-      case "NSRV":
-      case "NCRD":
-      case "NMOD":
-      case "NSEL":
-      case "NPRW":
-      case "NPLA":
-      case "VERS":
-      case "ENUM":
-      case "TAG ":
-      case "CGMD":
-      case "CGTY":
-      case "CGST":
-      case "CGEN":
-      case "CGTS":
-      case "CGTE":
-      case "OSMP":
-      case "OMDE":
-      case "OUTR":
-      case "FLAG":
-      case "TRNL":
-      case "SHRP":
-      case "RFOP":
-      case "RSAN":
-      case "TROP":
-      case "RBLR":
-      case "TBLR":
-      case "CLRH":
-      case "CLRF":
-      case "ADTR":
-      case "GLOW":
-      case "LINE":
-      case "ALPH":
-      case "VCOL":
-      case "ENAB":
+      // SKIPPED CHUNKS
+      // MISC skipped
+
+      case 'ICON': // Thumbnail Icon Image
+
+      case 'VMPA': // Vertex Map Parameter
+
+      case 'BBOX': // bounding box
+      // case 'VMMD':
+      // case 'VTYP':
+      // normal maps can be specified, normally on models imported from other applications. Currently ignored
+
+      case 'NORM': // ENVL FORM skipped
+
+      case 'PRE ':
+      case 'POST':
+      case 'KEY ':
+      case 'SPAN': // CLIP FORM skipped
+
+      case 'TIME':
+      case 'CLRS':
+      case 'CLRA':
+      case 'FILT':
+      case 'DITH':
+      case 'CONT':
+      case 'BRIT':
+      case 'SATR':
+      case 'HUE ':
+      case 'GAMM':
+      case 'NEGA':
+      case 'IFLT':
+      case 'PFLT': // Image Map Layer skipped
+
+      case 'PROJ':
+      case 'AXIS':
+      case 'AAST':
+      case 'PIXB':
+      case 'STCK': // Procedural Textures skipped
+
+      case 'VALU': // Gradient Textures skipped
+
+      case 'PNAM':
+      case 'INAM':
+      case 'GRST':
+      case 'GREN':
+      case 'GRPT':
+      case 'FKEY':
+      case 'IKEY': // Texture Mapping Form skipped
+
+      case 'CSYS': // Surface CHUNKs skipped
+
+      case 'OPAQ': // top level 'opacity' checkbox
+
+      case 'CMAP': // clip map
+      // Surface node CHUNKS skipped
+      // These mainly specify the node editor setup in LW
+
+      case 'NLOC':
+      case 'NZOM':
+      case 'NVER':
+      case 'NSRV':
+      case 'NCRD':
+      case 'NMOD':
+      case 'NSEL':
+      case 'NPRW':
+      case 'NPLA':
+      case 'VERS':
+      case 'ENUM':
+      case 'TAG ': // Car Material CHUNKS
+
+      case 'CGMD':
+      case 'CGTY':
+      case 'CGST':
+      case 'CGEN':
+      case 'CGTS':
+      case 'CGTE':
+      case 'OSMP':
+      case 'OMDE':
+      case 'OUTR':
+      case 'FLAG':
+      case 'TRNL':
+      case 'SHRP':
+      case 'RFOP':
+      case 'RSAN':
+      case 'TROP':
+      case 'RBLR':
+      case 'TBLR':
+      case 'CLRH':
+      case 'CLRF':
+      case 'ADTR':
+      case 'GLOW':
+      case 'LINE':
+      case 'ALPH':
+      case 'VCOL':
+      case 'ENAB':
         this.IFF.debugger.skipped = true;
         this.IFF.reader.skip(length);
         break;
-      case "IPIX":
-      case "IMIP":
-      case "IMOD":
-      case "AMOD":
-      case "IINV":
-      case "INCR":
-      case "IAXS":
-      case "IFOT":
-      case "ITIM":
-      case "IWRL":
-      case "IUTI":
-      case "IINX":
-      case "IINY":
-      case "IINZ":
-      case "IREF":
-        if (length === 4)
-          this.IFF.currentNode[blockID] = this.IFF.reader.getInt32();
-        else
-          this.IFF.reader.skip(length);
-        break;
-      case "OTAG":
+      // Texture node chunks (not in spec)
+
+      case 'IPIX': // usePixelBlending
+
+      case 'IMIP': // useMipMaps
+
+      case 'IMOD': // imageBlendingMode
+
+      case 'AMOD': // unknown
+
+      case 'IINV': // imageInvertAlpha
+
+      case 'INCR': // imageInvertColor
+
+      case 'IAXS': // imageAxis ( for non-UV maps)
+
+      case 'IFOT': // imageFallofType
+
+      case 'ITIM': // timing for animated textures
+
+      case 'IWRL':
+      case 'IUTI':
+      case 'IINX':
+      case 'IINY':
+      case 'IINZ':
+      case 'IREF':
+        // possibly a VX for reused texture nodes
+        if (length === 4) this.IFF.currentNode[blockID] = this.IFF.reader.getInt32();else this.IFF.reader.skip(length);
+        break;
+
+      case 'OTAG':
         this.IFF.parseObjectTag();
         break;
-      case "LAYR":
+
+      case 'LAYR':
         this.IFF.parseLayer(length);
         break;
-      case "PNTS":
+
+      case 'PNTS':
         this.IFF.parsePoints(length);
         break;
-      case "VMAP":
+
+      case 'VMAP':
         this.IFF.parseVertexMapping(length);
         break;
-      case "POLS":
+
+      case 'POLS':
         this.IFF.parsePolygonList(length);
         break;
-      case "TAGS":
+
+      case 'TAGS':
         this.IFF.parseTagStrings(length);
         break;
-      case "PTAG":
+
+      case 'PTAG':
         this.IFF.parsePolygonTagMapping(length);
         break;
-      case "VMAD":
+
+      case 'VMAD':
         this.IFF.parseVertexMapping(length, true);
         break;
-      case "DESC":
+      // Misc CHUNKS
+
+      case 'DESC':
+        // Description Line
         this.IFF.currentForm.description = this.IFF.reader.getString();
         break;
-      case "TEXT":
-      case "CMNT":
-      case "NCOM":
+
+      case 'TEXT':
+      case 'CMNT':
+      case 'NCOM':
         this.IFF.currentForm.comment = this.IFF.reader.getString();
         break;
-      case "NAME":
+      // Envelope Form
+
+      case 'NAME':
         this.IFF.currentForm.channelName = this.IFF.reader.getString();
         break;
-      case "WRAP":
+      // Image Map Layer
+
+      case 'WRAP':
         this.IFF.currentForm.wrap = {
           w: this.IFF.reader.getUint16(),
           h: this.IFF.reader.getUint16()
         };
         break;
-      case "IMAG":
+
+      case 'IMAG':
         var index = this.IFF.reader.getVariableLengthIndex();
         this.IFF.currentForm.imageIndex = index;
         break;
-      case "OREF":
+      // Texture Mapping Form
+
+      case 'OREF':
         this.IFF.currentForm.referenceObject = this.IFF.reader.getString();
         break;
-      case "ROID":
+
+      case 'ROID':
         this.IFF.currentForm.referenceObjectID = this.IFF.reader.getUint32();
         break;
-      case "SSHN":
+      // Surface Blocks
+
+      case 'SSHN':
         this.IFF.currentSurface.surfaceShaderName = this.IFF.reader.getString();
         break;
-      case "AOVN":
+
+      case 'AOVN':
         this.IFF.currentSurface.surfaceCustomAOVName = this.IFF.reader.getString();
         break;
-      case "NSTA":
+      // Nodal Blocks
+
+      case 'NSTA':
         this.IFF.currentForm.disabled = this.IFF.reader.getUint16();
         break;
-      case "NRNM":
+
+      case 'NRNM':
         this.IFF.currentForm.realName = this.IFF.reader.getString();
         break;
-      case "NNME":
+
+      case 'NNME':
         this.IFF.currentForm.refName = this.IFF.reader.getString();
         this.IFF.currentSurface.nodes[this.IFF.currentForm.refName] = this.IFF.currentForm;
         break;
-      case "INME":
-        if (!this.IFF.currentForm.nodeName)
-          this.IFF.currentForm.nodeName = [];
+      // Nodal Blocks : connections
+
+      case 'INME':
+        if (!this.IFF.currentForm.nodeName) this.IFF.currentForm.nodeName = [];
         this.IFF.currentForm.nodeName.push(this.IFF.reader.getString());
         break;
-      case "IINN":
-        if (!this.IFF.currentForm.inputNodeName)
-          this.IFF.currentForm.inputNodeName = [];
+
+      case 'IINN':
+        if (!this.IFF.currentForm.inputNodeName) this.IFF.currentForm.inputNodeName = [];
         this.IFF.currentForm.inputNodeName.push(this.IFF.reader.getString());
         break;
-      case "IINM":
-        if (!this.IFF.currentForm.inputName)
-          this.IFF.currentForm.inputName = [];
+
+      case 'IINM':
+        if (!this.IFF.currentForm.inputName) this.IFF.currentForm.inputName = [];
         this.IFF.currentForm.inputName.push(this.IFF.reader.getString());
         break;
-      case "IONM":
-        if (!this.IFF.currentForm.inputOutputName)
-          this.IFF.currentForm.inputOutputName = [];
+
+      case 'IONM':
+        if (!this.IFF.currentForm.inputOutputName) this.IFF.currentForm.inputOutputName = [];
         this.IFF.currentForm.inputOutputName.push(this.IFF.reader.getString());
         break;
-      case "FNAM":
+
+      case 'FNAM':
         this.IFF.currentForm.fileName = this.IFF.reader.getString();
         break;
-      case "CHAN":
-        if (length === 4)
-          this.IFF.currentForm.textureChannel = this.IFF.reader.getIDTag();
-        else
-          this.IFF.reader.skip(length);
+
+      case 'CHAN':
+        // NOTE: ENVL Forms may also have CHAN chunk, however ENVL is currently ignored
+        if (length === 4) this.IFF.currentForm.textureChannel = this.IFF.reader.getIDTag();else this.IFF.reader.skip(length);
         break;
-      case "SMAN":
+      // LWO2 Spec chunks: these are needed since the SURF FORMs are often in LWO2 format
+
+      case 'SMAN':
         var maxSmoothingAngle = this.IFF.reader.getFloat32();
         this.IFF.currentSurface.attributes.smooth = maxSmoothingAngle < 0 ? false : true;
         break;
-      case "COLR":
+      // LWO2: Basic Surface Parameters
+
+      case 'COLR':
         this.IFF.currentSurface.attributes.Color = {
           value: this.IFF.reader.getFloat32Array(3)
         };
-        this.IFF.reader.skip(2);
+        this.IFF.reader.skip(2); // VX: envelope
+
         break;
-      case "LUMI":
+
+      case 'LUMI':
         this.IFF.currentSurface.attributes.Luminosity = {
           value: this.IFF.reader.getFloat32()
         };
         this.IFF.reader.skip(2);
         break;
-      case "SPEC":
+
+      case 'SPEC':
         this.IFF.currentSurface.attributes.Specular = {
           value: this.IFF.reader.getFloat32()
         };
         this.IFF.reader.skip(2);
         break;
-      case "DIFF":
+
+      case 'DIFF':
         this.IFF.currentSurface.attributes.Diffuse = {
           value: this.IFF.reader.getFloat32()
         };
         this.IFF.reader.skip(2);
         break;
-      case "REFL":
+
+      case 'REFL':
         this.IFF.currentSurface.attributes.Reflection = {
           value: this.IFF.reader.getFloat32()
         };
         this.IFF.reader.skip(2);
         break;
-      case "GLOS":
+
+      case 'GLOS':
         this.IFF.currentSurface.attributes.Glossiness = {
           value: this.IFF.reader.getFloat32()
         };
         this.IFF.reader.skip(2);
         break;
-      case "TRAN":
+
+      case 'TRAN':
         this.IFF.currentSurface.attributes.opacity = this.IFF.reader.getFloat32();
         this.IFF.reader.skip(2);
         break;
-      case "BUMP":
+
+      case 'BUMP':
         this.IFF.currentSurface.attributes.bumpStrength = this.IFF.reader.getFloat32();
         this.IFF.reader.skip(2);
         break;
-      case "SIDE":
+
+      case 'SIDE':
         this.IFF.currentSurface.attributes.side = this.IFF.reader.getUint16();
         break;
-      case "RIMG":
+
+      case 'RIMG':
         this.IFF.currentSurface.attributes.reflectionMap = this.IFF.reader.getVariableLengthIndex();
         break;
-      case "RIND":
+
+      case 'RIND':
         this.IFF.currentSurface.attributes.refractiveIndex = this.IFF.reader.getFloat32();
         this.IFF.reader.skip(2);
         break;
-      case "TIMG":
+
+      case 'TIMG':
         this.IFF.currentSurface.attributes.refractionMap = this.IFF.reader.getVariableLengthIndex();
         break;
-      case "IMAP":
+
+      case 'IMAP':
         this.IFF.currentSurface.attributes.imageMapIndex = this.IFF.reader.getUint32();
         break;
-      case "IUVI":
+
+      case 'IUVI':
+        // uv channel name
         this.IFF.currentNode.UVChannel = this.IFF.reader.getString(length);
         break;
-      case "IUTL":
+
+      case 'IUTL':
+        // widthWrappingMode: 0 = Reset, 1 = Repeat, 2 = Mirror, 3 = Edge
         this.IFF.currentNode.widthWrappingMode = this.IFF.reader.getUint32();
         break;
-      case "IVTL":
+
+      case 'IVTL':
+        // heightWrappingMode
         this.IFF.currentNode.heightWrappingMode = this.IFF.reader.getUint32();
         break;
+
       default:
         this.IFF.parseUnknownCHUNK(blockID, length);
     }
-    if (blockID != "FORM") {
+
+    if (blockID != 'FORM') {
       this.IFF.debugger.node = 1;
       this.IFF.debugger.nodeID = blockID;
       this.IFF.debugger.log();
     }
+
     if (this.IFF.reader.offset >= this.IFF.currentFormEnd) {
       this.IFF.currentForm = this.IFF.parentForm;
     }
   }
 };
-exports.LWO3Parser = LWO3Parser;
+
+export { LWO3Parser };

package/math/Capsule.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var t=require("three"),s=function(){var s=new t.Vector3,i=new t.Vector3,n=new t.Vector3;function e(s,i,n){this.start=null==s?new t.Vector3(0,0,0):s,this.end=null==i?new t.Vector3(0,1,0):i,this.radius=null==n?1:n}return Object.assign(e.prototype,{clone:function(){return new e(this.start.clone(),this.end.clone(),this.radius)},set:function(t,s,i){this.start.copy(t),this.end.copy(s),this.radius=i},copy:function(t){this.start.copy(t.start),this.end.copy(t.end),this.radius=t.radius},getCenter:function(t){return t.copy(this.end).add(this.start).multiplyScalar(.5)},translate:function(t){this.start.add(t),this.end.add(t)},checkAABBAxis:function(t,s,i,n,e,a,r,h,c){return(e-t<c||e-i<c)&&(t-a<c||i-a<c)&&(r-s<c||r-n<c)&&(s-h<c||n-h<c)},intersectsBox:function(t){return this.checkAABBAxis(this.start.x,this.start.y,this.end.x,this.end.y,t.min.x,t.max.x,t.min.y,t.max.y,this.radius)&&this.checkAABBAxis(this.start.x,this.start.z,this.end.x,this.end.z,t.min.x,t.max.x,t.min.z,t.max.z,this.radius)&&this.checkAABBAxis(this.start.y,this.start.z,this.end.y,this.end.z,t.min.y,t.max.y,t.min.z,t.max.z,this.radius)},lineLineMinimumPoints:function(t,e){var a,r,h=s.copy(t.end).sub(t.start),c=i.copy(e.end).sub(e.start),d=n.copy(e.start).sub(t.start),o=h.dot(c),u=h.dot(h),l=c.dot(c),x=c.dot(d),y=h.dot(d),m=u*l-o*o;if(Math.abs(m)<1e-10){var p=-x/l,f=(o-x)/l;Math.abs(p-.5)<Math.abs(f-.5)?(a=0,r=p):(a=1,r=f)}else r=((a=(x*o+y*l)/m)*o-x)/l;return r=Math.max(0,Math.min(1,r)),a=Math.max(0,Math.min(1,a)),[h.multiplyScalar(a).add(t.start),c.multiplyScalar(r).add(e.start)]}}),e}();exports.Capsule=s;