three-stdlib 2.16.0 → 2.16.2

package/renderers/webgpu/WebGPUUniform.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("three");class t{constructor(e,t=null){this.name=e,this.value=t,this.boundary=0,this.itemSize=0,this.offset=0}setValue(e){this.value=e}getValue(){return this.value}}exports.ColorUniform=class extends t{constructor(t,r=new e.Color){super(t,r),this.boundary=16,this.itemSize=3,Object.defineProperty(this,"isColorUniform",{value:!0})}},exports.FloatUniform=class extends t{constructor(e,t=0){super(e,t),this.boundary=4,this.itemSize=1,Object.defineProperty(this,"isFloatUniform",{value:!0})}},exports.Matrix3Uniform=class extends t{constructor(t,r=new e.Matrix3){super(t,r),this.boundary=48,this.itemSize=12,Object.defineProperty(this,"isMatrix3Uniform",{value:!0})}},exports.Matrix4Uniform=class extends t{constructor(t,r=new e.Matrix4){super(t,r),this.boundary=64,this.itemSize=16,Object.defineProperty(this,"isMatrix4Uniform",{value:!0})}},exports.Vector2Uniform=class extends t{constructor(t,r=new e.Vector2){super(t,r),this.boundary=8,this.itemSize=2,Object.defineProperty(this,"isVector2Uniform",{value:!0})}},exports.Vector3Uniform=class extends t{constructor(t,r=new e.Vector3){super(t,r),this.boundary=16,this.itemSize=3,Object.defineProperty(this,"isVector3Uniform",{value:!0})}},exports.Vector4Uniform=class extends t{constructor(t,r=new e.Vector4){super(t,r),this.boundary=16,this.itemSize=4,Object.defineProperty(this,"isVector4Uniform",{value:!0})}};

package/renderers/webgpu/WebGPUUniform.js

@@ -1,81 +1,107 @@
-"use strict";
-Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
-const THREE = require("three");
+import { Vector2, Vector3, Vector4, Color, Matrix3, Matrix4 } from 'three';
+
 class WebGPUUniform {
   constructor(name, value = null) {
     this.name = name;
     this.value = value;
-    this.boundary = 0;
+    this.boundary = 0; // used to build the uniform buffer according to the STD140 layout
+
     this.itemSize = 0;
-    this.offset = 0;
+    this.offset = 0; // this property is set by WebGPUUniformsGroup and marks the start position in the uniform buffer
   }
+
   setValue(value) {
     this.value = value;
   }
+
   getValue() {
     return this.value;
   }
+
 }
+
 class FloatUniform extends WebGPUUniform {
   constructor(name, value = 0) {
     super(name, value);
     this.boundary = 4;
     this.itemSize = 1;
-    Object.defineProperty(this, "isFloatUniform", { value: true });
+    Object.defineProperty(this, 'isFloatUniform', {
+      value: true
+    });
   }
+
 }
+
 class Vector2Uniform extends WebGPUUniform {
-  constructor(name, value = new THREE.Vector2()) {
+  constructor(name, value = new Vector2()) {
     super(name, value);
     this.boundary = 8;
     this.itemSize = 2;
-    Object.defineProperty(this, "isVector2Uniform", { value: true });
+    Object.defineProperty(this, 'isVector2Uniform', {
+      value: true
+    });
   }
+
 }
+
 class Vector3Uniform extends WebGPUUniform {
-  constructor(name, value = new THREE.Vector3()) {
+  constructor(name, value = new Vector3()) {
     super(name, value);
     this.boundary = 16;
     this.itemSize = 3;
-    Object.defineProperty(this, "isVector3Uniform", { value: true });
+    Object.defineProperty(this, 'isVector3Uniform', {
+      value: true
+    });
   }
+
 }
+
 class Vector4Uniform extends WebGPUUniform {
-  constructor(name, value = new THREE.Vector4()) {
+  constructor(name, value = new Vector4()) {
     super(name, value);
     this.boundary = 16;
     this.itemSize = 4;
-    Object.defineProperty(this, "isVector4Uniform", { value: true });
+    Object.defineProperty(this, 'isVector4Uniform', {
+      value: true
+    });
   }
+
 }
+
 class ColorUniform extends WebGPUUniform {
-  constructor(name, value = new THREE.Color()) {
+  constructor(name, value = new Color()) {
     super(name, value);
     this.boundary = 16;
     this.itemSize = 3;
-    Object.defineProperty(this, "isColorUniform", { value: true });
+    Object.defineProperty(this, 'isColorUniform', {
+      value: true
+    });
   }
+
 }
+
 class Matrix3Uniform extends WebGPUUniform {
-  constructor(name, value = new THREE.Matrix3()) {
+  constructor(name, value = new Matrix3()) {
     super(name, value);
     this.boundary = 48;
     this.itemSize = 12;
-    Object.defineProperty(this, "isMatrix3Uniform", { value: true });
+    Object.defineProperty(this, 'isMatrix3Uniform', {
+      value: true
+    });
   }
+
 }
+
 class Matrix4Uniform extends WebGPUUniform {
-  constructor(name, value = new THREE.Matrix4()) {
+  constructor(name, value = new Matrix4()) {
     super(name, value);
     this.boundary = 64;
     this.itemSize = 16;
-    Object.defineProperty(this, "isMatrix4Uniform", { value: true });
+    Object.defineProperty(this, 'isMatrix4Uniform', {
+      value: true
+    });
   }
+
 }
-exports.ColorUniform = ColorUniform;
-exports.FloatUniform = FloatUniform;
-exports.Matrix3Uniform = Matrix3Uniform;
-exports.Matrix4Uniform = Matrix4Uniform;
-exports.Vector2Uniform = Vector2Uniform;
-exports.Vector3Uniform = Vector3Uniform;
-exports.Vector4Uniform = Vector4Uniform;
+
+export { ColorUniform, FloatUniform, Matrix3Uniform, Matrix4Uniform, Vector2Uniform, Vector3Uniform, Vector4Uniform };

package/renderers/webgpu/WebGPUUniformsGroup.cjs.js

@@ -0,0 +1 @@
+"use strict";var t=require("./WebGPUBinding.cjs.js"),e=require("./constants.cjs.js");module.exports=class extends t{constructor(t){super(t),this.uniforms=[],this.onBeforeUpdate=function(){},this.bytesPerElement=Float32Array.BYTES_PER_ELEMENT,this.type=e.GPUBindingType.UniformBuffer,this.visibility=GPUShaderStage.VERTEX,this.usage=GPUBufferUsage.UNIFORM|GPUBufferUsage.COPY_DST,this.array=null,this.bufferGPU=null,Object.defineProperty(this,"isUniformsGroup",{value:!0})}addUniform(t){return this.uniforms.push(t),this}removeUniform(t){const e=this.uniforms.indexOf(t);return-1!==e&&this.uniforms.splice(e,1),this}setOnBeforeUpdate(t){return this.onBeforeUpdate=t,this}getByteLength(){let t=0;for(let e=0,r=this.uniforms.length;e<r;e++){const r=this.uniforms[e],s=t%16,i=16-s;0!==s&&i-r.boundary<0&&(t+=16-s),r.offset=t/this.bytesPerElement,t+=r.itemSize*this.bytesPerElement}return t}update(){let t=!1;for(let e of this.uniforms)!0===this.updateByType(e)&&(t=!0);return t}updateByType(t){return t.isFloatUniform?this.updateNumber(t):t.isVector2Uniform?this.updateVector2(t):t.isVector3Uniform?this.updateVector3(t):t.isVector4Uniform?this.updateVector4(t):t.isColorUniform?this.updateColor(t):t.isMatrix3Uniform?this.updateMatrix3(t):t.isMatrix4Uniform?this.updateMatrix4(t):void console.error("THREE.WebGPUUniformsGroup: Unsupported uniform type.",t)}updateNumber(t){let e=!1;const r=this.array,s=t.getValue(),i=t.offset;return r[i]!==s&&(r[i]=s,e=!0),e}updateVector2(t){let e=!1;const r=this.array,s=t.getValue(),i=t.offset;return r[i+0]===s.x&&r[i+1]===s.y||(r[i+0]=s.x,r[i+1]=s.y,e=!0),e}updateVector3(t){let e=!1;const r=this.array,s=t.getValue(),i=t.offset;return r[i+0]===s.x&&r[i+1]===s.y&&r[i+2]===s.z||(r[i+0]=s.x,r[i+1]=s.y,r[i+2]=s.z,e=!0),e}updateVector4(t){let e=!1;const r=this.array,s=t.getValue(),i=t.offset;return r[i+0]===s.x&&r[i+1]===s.y&&r[i+2]===s.z&&r[i+4]===s.w||(r[i+0]=s.x,r[i+1]=s.y,r[i+2]=s.z,r[i+3]=s.w,e=!0),e}updateColor(t){let e=!1;const r=this.array,s=t.getValue(),i=t.offset;return r[i+0]===s.r&&r[i+1]===s.g&&r[i+2]===s.b||(r[i+0]=s.r,r[i+1]=s.g,r[i+2]=s.b,e=!0),e}updateMatrix3(t){let e=!1;const r=this.array,s=t.getValue().elements,i=t.offset;return r[i+0]===s[0]&&r[i+1]===s[1]&&r[i+2]===s[2]&&r[i+4]===s[3]&&r[i+5]===s[4]&&r[i+6]===s[5]&&r[i+8]===s[6]&&r[i+9]===s[7]&&r[i+10]===s[8]||(r[i+0]=s[0],r[i+1]=s[1],r[i+2]=s[2],r[i+4]=s[3],r[i+5]=s[4],r[i+6]=s[5],r[i+8]=s[6],r[i+9]=s[7],r[i+10]=s[8],e=!0),e}updateMatrix4(t){let e=!1;const r=this.array,s=t.getValue().elements,i=t.offset;return!1===function(t,e,r){for(let s=0,i=e.length;s<i;s++)if(t[r+s]!==e[s])return!1;return!0}(r,s,i)&&(r.set(s,i),e=!0),e}};

package/renderers/webgpu/WebGPUUniformsGroup.js

@@ -1,117 +1,144 @@
-"use strict";
-const WebGPUBinding = require("./WebGPUBinding.js");
-const constants = require("./constants.js");
+import WebGPUBinding from './WebGPUBinding.js';
+import { GPUBindingType } from './constants.js';
+
 class WebGPUUniformsGroup extends WebGPUBinding {
   constructor(name) {
-    super(name);
+    super(name); // the order of uniforms in this array must match the order of uniforms in the shader
+
     this.uniforms = [];
-    this.onBeforeUpdate = function() {
-    };
+
+    this.onBeforeUpdate = function () {};
+
     this.bytesPerElement = Float32Array.BYTES_PER_ELEMENT;
-    this.type = constants.GPUBindingType.UniformBuffer;
+    this.type = GPUBindingType.UniformBuffer;
     this.visibility = GPUShaderStage.VERTEX;
     this.usage = GPUBufferUsage.UNIFORM | GPUBufferUsage.COPY_DST;
-    this.array = null;
-    this.bufferGPU = null;
-    Object.defineProperty(this, "isUniformsGroup", { value: true });
+    this.array = null; // set by the renderer
+
+    this.bufferGPU = null; // set by the renderer
+
+    Object.defineProperty(this, 'isUniformsGroup', {
+      value: true
+    });
   }
+
   addUniform(uniform) {
     this.uniforms.push(uniform);
     return this;
   }
+
   removeUniform(uniform) {
     const index = this.uniforms.indexOf(uniform);
+
     if (index !== -1) {
       this.uniforms.splice(index, 1);
     }
+
     return this;
   }
+
   setOnBeforeUpdate(callback) {
     this.onBeforeUpdate = callback;
     return this;
   }
+
   getByteLength() {
-    let offset = 0;
-    const chunkSize = 16;
+    let offset = 0; // global buffer offset in bytes
+
+    const chunkSize = 16; // size of a chunk in bytes (STD140 layout)
+
     for (let i = 0, l = this.uniforms.length; i < l; i++) {
-      const uniform = this.uniforms[i];
+      const uniform = this.uniforms[i]; // offset within a single chunk in bytes
+
       const chunkOffset = offset % chunkSize;
-      const remainingSizeInChunk = chunkSize - chunkOffset;
+      const remainingSizeInChunk = chunkSize - chunkOffset; // check for chunk overflow
+
       if (chunkOffset !== 0 && remainingSizeInChunk - uniform.boundary < 0) {
+        // add padding and adjust offset
         offset += chunkSize - chunkOffset;
       }
+
       uniform.offset = offset / this.bytesPerElement;
       offset += uniform.itemSize * this.bytesPerElement;
     }
+
     return offset;
   }
+
   update() {
     let updated = false;
+
     for (let uniform of this.uniforms) {
       if (this.updateByType(uniform) === true) {
         updated = true;
       }
     }
+
     return updated;
   }
+
   updateByType(uniform) {
-    if (uniform.isFloatUniform)
-      return this.updateNumber(uniform);
-    if (uniform.isVector2Uniform)
-      return this.updateVector2(uniform);
-    if (uniform.isVector3Uniform)
-      return this.updateVector3(uniform);
-    if (uniform.isVector4Uniform)
-      return this.updateVector4(uniform);
-    if (uniform.isColorUniform)
-      return this.updateColor(uniform);
-    if (uniform.isMatrix3Uniform)
-      return this.updateMatrix3(uniform);
-    if (uniform.isMatrix4Uniform)
-      return this.updateMatrix4(uniform);
-    console.error("THREE.WebGPUUniformsGroup: Unsupported uniform type.", uniform);
+    if (uniform.isFloatUniform) return this.updateNumber(uniform);
+    if (uniform.isVector2Uniform) return this.updateVector2(uniform);
+    if (uniform.isVector3Uniform) return this.updateVector3(uniform);
+    if (uniform.isVector4Uniform) return this.updateVector4(uniform);
+    if (uniform.isColorUniform) return this.updateColor(uniform);
+    if (uniform.isMatrix3Uniform) return this.updateMatrix3(uniform);
+    if (uniform.isMatrix4Uniform) return this.updateMatrix4(uniform);
+    console.error('THREE.WebGPUUniformsGroup: Unsupported uniform type.', uniform);
   }
+
   updateNumber(uniform) {
     let updated = false;
     const a = this.array;
     const v = uniform.getValue();
     const offset = uniform.offset;
+
     if (a[offset] !== v) {
       a[offset] = v;
       updated = true;
     }
+
     return updated;
   }
+
   updateVector2(uniform) {
     let updated = false;
     const a = this.array;
     const v = uniform.getValue();
     const offset = uniform.offset;
+
     if (a[offset + 0] !== v.x || a[offset + 1] !== v.y) {
       a[offset + 0] = v.x;
       a[offset + 1] = v.y;
       updated = true;
     }
+
     return updated;
   }
+
   updateVector3(uniform) {
     let updated = false;
     const a = this.array;
     const v = uniform.getValue();
     const offset = uniform.offset;
+
     if (a[offset + 0] !== v.x || a[offset + 1] !== v.y || a[offset + 2] !== v.z) {
       a[offset + 0] = v.x;
       a[offset + 1] = v.y;
       a[offset + 2] = v.z;
       updated = true;
     }
+
     return updated;
   }
+
   updateVector4(uniform) {
     let updated = false;
     const a = this.array;
     const v = uniform.getValue();
     const offset = uniform.offset;
+
     if (a[offset + 0] !== v.x || a[offset + 1] !== v.y || a[offset + 2] !== v.z || a[offset + 4] !== v.w) {
       a[offset + 0] = v.x;
       a[offset + 1] = v.y;
@@ -119,26 +146,32 @@ class WebGPUUniformsGroup extends WebGPUBinding {
       a[offset + 3] = v.w;
       updated = true;
     }
+
     return updated;
   }
+
   updateColor(uniform) {
     let updated = false;
     const a = this.array;
     const c = uniform.getValue();
     const offset = uniform.offset;
+
     if (a[offset + 0] !== c.r || a[offset + 1] !== c.g || a[offset + 2] !== c.b) {
       a[offset + 0] = c.r;
       a[offset + 1] = c.g;
       a[offset + 2] = c.b;
       updated = true;
     }
+
     return updated;
   }
+
   updateMatrix3(uniform) {
     let updated = false;
     const a = this.array;
     const e = uniform.getValue().elements;
     const offset = uniform.offset;
+
     if (a[offset + 0] !== e[0] || a[offset + 1] !== e[1] || a[offset + 2] !== e[2] || a[offset + 4] !== e[3] || a[offset + 5] !== e[4] || a[offset + 6] !== e[5] || a[offset + 8] !== e[6] || a[offset + 9] !== e[7] || a[offset + 10] !== e[8]) {
       a[offset + 0] = e[0];
       a[offset + 1] = e[1];
@@ -151,25 +184,32 @@ class WebGPUUniformsGroup extends WebGPUBinding {
       a[offset + 10] = e[8];
       updated = true;
     }
+
     return updated;
   }
+
   updateMatrix4(uniform) {
     let updated = false;
     const a = this.array;
     const e = uniform.getValue().elements;
     const offset = uniform.offset;
+
     if (arraysEqual(a, e, offset) === false) {
       a.set(e, offset);
       updated = true;
     }
+
     return updated;
   }
+
 }
+
 function arraysEqual(a, b, offset) {
   for (let i = 0, l = b.length; i < l; i++) {
-    if (a[offset + i] !== b[i])
-      return false;
+    if (a[offset + i] !== b[i]) return false;
   }
+
   return true;
 }
-module.exports = WebGPUUniformsGroup;
+
+export default WebGPUUniformsGroup;

package/renderers/webgpu/constants.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});exports.BlendColorFactor=211,exports.GPUAddressMode={ClampToEdge:"clamp-to-edge",Repeat:"repeat",MirrorRepeat:"mirror-repeat"},exports.GPUBindingType={UniformBuffer:"uniform-buffer",StorageBuffer:"storage-buffer",ReadonlyStorageBuffer:"readonly-storage-buffer",Sampler:"sampler",ComparisonSampler:"comparison-sampler",SampledTexture:"sampled-texture",MultisampledTexture:"multisampled-texture",ReadonlyStorageTexture:"readonly-storage-texture",WriteonlyStorageTexture:"writeonly-storage-texture"},exports.GPUBlendFactor={Zero:"zero",One:"one",SrcColor:"src-color",OneMinusSrcColor:"one-minus-src-color",SrcAlpha:"src-alpha",OneMinusSrcAlpha:"one-minus-src-alpha",DstColor:"dst-color",OneMinusDstColor:"one-minus-dst-color",DstAlpha:"dst-alpha",OneMinusDstAlpha:"one-minus-dst-alpha",SrcAlphaSaturated:"src-alpha-saturated",BlendColor:"blend-color",OneMinusBlendColor:"one-minus-blend-color"},exports.GPUBlendOperation={Add:"add",Subtract:"subtract",ReverseSubtract:"reverse-subtract",Min:"min",Max:"max"},exports.GPUColorWriteFlags={None:0,Red:1,Green:2,Blue:4,Alpha:8,All:15},exports.GPUCompareFunction={Never:"never",Less:"less",Equal:"equal",LessEqual:"less-equal",Greater:"greater",NotEqual:"not-equal",GreaterEqual:"greater-equal",Always:"always"},exports.GPUCullMode={None:"none",Front:"front",Back:"back"},exports.GPUFilterMode={Linear:"linear",Nearest:"nearest"},exports.GPUFrontFace={CCW:"ccw",CW:"cw"},exports.GPUIndexFormat={Uint16:"uint16",Uint32:"uint32"},exports.GPUInputStepMode={Vertex:"vertex",Instance:"instance"},exports.GPULoadOp={Load:"load"},exports.GPUPrimitiveTopology={PointList:"point-list",LineList:"line-list",LineStrip:"line-strip",TriangleList:"triangle-list",TriangleStrip:"triangle-strip"},exports.GPUStencilOperation={Keep:"keep",Zero:"zero",Replace:"replace",Invert:"invert",IncrementClamp:"increment-clamp",DecrementClamp:"decrement-clamp",IncrementWrap:"increment-wrap",DecrementWrap:"decrement-wrap"},exports.GPUStoreOp={Store:"store",Clear:"clear"},exports.GPUTextureDimension={OneD:"1d",TwoD:"2d",ThreeD:"3d"},exports.GPUTextureFormat={R8Unorm:"r8unorm",R8Snorm:"r8snorm",R8Uint:"r8uint",R8Sint:"r8sint",R16Uint:"r16uint",R16Sint:"r16sint",R16Float:"r16float",RG8Unorm:"rg8unorm",RG8Snorm:"rg8snorm",RG8Uint:"rg8uint",RG8Sint:"rg8sint",R32Uint:"r32uint",R32Sint:"r32sint",R32Float:"r32float",RG16Uint:"rg16uint",RG16Sint:"rg16sint",RG16Float:"rg16float",RGBA8Unorm:"rgba8unorm",RGBA8UnormSRGB:"rgba8unorm-srgb",RGBA8Snorm:"rgba8snorm",RGBA8Uint:"rgba8uint",RGBA8Sint:"rgba8sint",BRGA8Unorm:"bgra8unorm",BRGA8UnormSRGB:"bgra8unorm-srgb",RGB9E5UFloat:"rgb9e5ufloat",RGB10A2Unorm:"rgb10a2unorm",RG11B10uFloat:"rgb10a2unorm",RG32Uint:"rg32uint",RG32Sint:"rg32sint",RG32Float:"rg32float",RGBA16Uint:"rgba16uint",RGBA16Sint:"rgba16sint",RGBA16Float:"rgba16float",RGBA32Uint:"rgba32uint",RGBA32Sint:"rgba32sint",RGBA32Float:"rgba32float",Stencil8:"stencil8",Depth16Unorm:"depth16unorm",Depth24Plus:"depth24plus",Depth24PlusStencil8:"depth24plus-stencil8",Depth32Float:"depth32float",BC1RGBAUnorm:"bc1-rgba-unorm",BC1RGBAUnormSRGB:"bc1-rgba-unorm-srgb",BC2RGBAUnorm:"bc2-rgba-unorm",BC2RGBAUnormSRGB:"bc2-rgba-unorm-srgb",BC3RGBAUnorm:"bc3-rgba-unorm",BC3RGBAUnormSRGB:"bc3-rgba-unorm-srgb",BC4RUnorm:"bc4-r-unorm",BC4RSNorm:"bc4-r-snorm",BC5RGUnorm:"bc5-rg-unorm",BC5RGSnorm:"bc5-rg-snorm",BC6HRGBUFloat:"bc6h-rgb-ufloat",BC6HRGBFloat:"bc6h-rgb-float",BC7RGBAUnorm:"bc7-rgba-unorm",BC7RGBAUnormSRGB:"bc7-rgba-srgb",Depth24UnormStencil8:"depth24unorm-stencil8",Depth32FloatStencil8:"depth32float-stencil8"},exports.GPUTextureViewDimension={OneD:"1d",TwoD:"2d",TwoDArray:"2d-array",Cube:"cube",CubeArray:"cube-array",ThreeD:"3d"},exports.GPUVertexFormat={Uchar2:"uchar2",Uchar4:"uchar4",Char2:"char2",Char4:"char4",Uchar2Norm:"uchar2norm",Uchar4Norm:"uchar4norm",Char2Norm:"char2norm",Char4Norm:"char4norm",Ushort2:"ushort2",Ushort4:"ushort4",Short2:"short2",Short4:"short4",Ushort2Norm:"ushort2norm",Ushort4Norm:"ushort4norm",Short2Norm:"short2norm",Short4Norm:"short4norm",Half2:"half2",Half4:"half4",Float:"float",Float2:"float2",Float3:"float3",Float4:"float4",Uint:"uint",Uint2:"uint2",Uint3:"uint3",Uint4:"uint4",Int:"int",Int2:"int2",Int3:"int3",Int4:"int4"},exports.OneMinusBlendColorFactor=212;