@luma.gl/shaders 0.0.0-stage → 10.0.0-alpha.11

package/dist/modules/engine/skin/skin.cjs

@@ -0,0 +1,212 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var skin_exports = {};
+__export(skin_exports, {
+  SKIN_MAX_JOINTS: () => SKIN_MAX_JOINTS,
+  fs: () => fs,
+  skin: () => skin,
+  source: () => source,
+  vs: () => vs
+});
+module.exports = __toCommonJS(skin_exports);
+var import_core = require("@math.gl/core");
+const SKIN_MAX_JOINTS = 64;
+const source = (
+  /* wgsl */
+  `
+struct skinUniforms {
+  jointMatrix: array<mat4x4<f32>, ${SKIN_MAX_JOINTS}>,
+};
+
+@group(0) @binding(auto) var<uniform> skin: skinUniforms;
+
+#ifdef HAS_INSTANCED_SKIN
+@group(0) @binding(auto) var<storage, read> skinJointMatrices: array<mat4x4<f32>>;
+
+fn getInstancedSkinMatrix(
+  weights: vec4f,
+  joints: vec4u,
+  instanceIndex: u32,
+  jointsPerInstance: u32
+) -> mat4x4<f32> {
+  let firstJoint = instanceIndex * jointsPerInstance;
+  return (weights.x * skinJointMatrices[firstJoint + joints.x])
+       + (weights.y * skinJointMatrices[firstJoint + joints.y])
+       + (weights.z * skinJointMatrices[firstJoint + joints.z])
+       + (weights.w * skinJointMatrices[firstJoint + joints.w]);
+}
+#else
+#ifdef HAS_LARGE_SKIN
+@group(0) @binding(auto) var<storage, read> skinJointMatrices: array<mat4x4<f32>>;
+#endif
+#endif
+
+fn getSkinMatrix(weights: vec4f, joints: vec4u) -> mat4x4<f32> {
+#ifdef HAS_LARGE_SKIN
+  return (weights.x * skinJointMatrices[joints.x])
+       + (weights.y * skinJointMatrices[joints.y])
+       + (weights.z * skinJointMatrices[joints.z])
+       + (weights.w * skinJointMatrices[joints.w]);
+#else
+  return (weights.x * skin.jointMatrix[joints.x])
+       + (weights.y * skin.jointMatrix[joints.y])
+       + (weights.z * skin.jointMatrix[joints.z])
+       + (weights.w * skin.jointMatrix[joints.w]);
+#endif
+}
+`
+);
+const vs = (
+  /* glsl */
+  `
+layout(std140) uniform skinUniforms {
+  mat4 jointMatrix[SKIN_MAX_JOINTS];
+} skin;
+
+#ifdef HAS_INSTANCED_SKIN
+uniform highp sampler2D skinJointMatrices;
+
+mat4 getInstancedJointMatrix(uint jointIndex, uint instanceIndex) {
+  int firstColumn = int(jointIndex * 4u);
+  int row = int(instanceIndex);
+  return mat4(
+    texelFetch(skinJointMatrices, ivec2(firstColumn, row), 0),
+    texelFetch(skinJointMatrices, ivec2(firstColumn + 1, row), 0),
+    texelFetch(skinJointMatrices, ivec2(firstColumn + 2, row), 0),
+    texelFetch(skinJointMatrices, ivec2(firstColumn + 3, row), 0)
+  );
+}
+
+mat4 getInstancedSkinMatrix(
+  vec4 weights,
+  uvec4 joints,
+  uint instanceIndex,
+  uint jointsPerInstance
+) {
+  return (weights.x * getInstancedJointMatrix(joints.x, instanceIndex))
+       + (weights.y * getInstancedJointMatrix(joints.y, instanceIndex))
+       + (weights.z * getInstancedJointMatrix(joints.z, instanceIndex))
+       + (weights.w * getInstancedJointMatrix(joints.w, instanceIndex));
+}
+#else
+#ifdef HAS_LARGE_SKIN
+uniform highp sampler2D skinJointMatrices;
+
+mat4 getSkinJointMatrix(uint jointIndex) {
+  int firstColumn = int(jointIndex * 4u);
+  return mat4(
+    texelFetch(skinJointMatrices, ivec2(firstColumn, 0), 0),
+    texelFetch(skinJointMatrices, ivec2(firstColumn + 1, 0), 0),
+    texelFetch(skinJointMatrices, ivec2(firstColumn + 2, 0), 0),
+    texelFetch(skinJointMatrices, ivec2(firstColumn + 3, 0), 0)
+  );
+}
+#endif
+#endif
+
+mat4 getSkinMatrix(vec4 weights, uvec4 joints) {
+#ifdef HAS_LARGE_SKIN
+  return (weights.x * getSkinJointMatrix(joints.x))
+       + (weights.y * getSkinJointMatrix(joints.y))
+       + (weights.z * getSkinJointMatrix(joints.z))
+       + (weights.w * getSkinJointMatrix(joints.w));
+#else
+  return (weights.x * skin.jointMatrix[joints.x])
+       + (weights.y * skin.jointMatrix[joints.y])
+       + (weights.z * skin.jointMatrix[joints.z])
+       + (weights.w * skin.jointMatrix[joints.w]);
+#endif
+}
+
+`
+);
+const fs = (
+  /* glsl */
+  ``
+);
+const skin = {
+  props: {},
+  uniforms: {},
+  bindings: {},
+  name: "skin",
+  bindingLayout: [
+    { name: "skin", group: 0 },
+    { name: "skinJointMatrices", group: 0, visibility: 1 }
+  ],
+  dependencies: [],
+  source,
+  vs,
+  fs,
+  defines: {
+    SKIN_MAX_JOINTS
+  },
+  getUniforms: (props = {}, _previousUniforms) => {
+    var _a, _b;
+    const { jointMatrices, skinJointMatrices, scenegraphsFromGLTF, skinIndex = 0, meshWorldMatrix } = props;
+    const bindings = skinJointMatrices ? { skinJointMatrices } : {};
+    if (jointMatrices) {
+      return { jointMatrix: makeJointPalette(jointMatrices), ...bindings };
+    }
+    const sourceSkin = (_b = (_a = scenegraphsFromGLTF == null ? void 0 : scenegraphsFromGLTF.gltf) == null ? void 0 : _a.skins) == null ? void 0 : _b[skinIndex];
+    if (!sourceSkin) {
+      return { jointMatrix: [], ...bindings };
+    }
+    const { inverseBindMatrices, joints, skeleton } = sourceSkin;
+    const nodeMap = scenegraphsFromGLTF.gltfNodeIndexToNodeMap;
+    const matrices = /* @__PURE__ */ new Map();
+    const root = skeleton === void 0 ? void 0 : nodeMap == null ? void 0 : nodeMap.get(skeleton);
+    const roots = root ? [root] : scenegraphsFromGLTF.scenes || [];
+    for (const sceneRoot of roots) {
+      sceneRoot.preorderTraversal((node, { worldMatrix }) => {
+        matrices.set(node.id, worldMatrix);
+      });
+    }
+    const inverseMeshMatrix = meshWorldMatrix ? new import_core.Matrix4(meshWorldMatrix).invert() : null;
+    const jointPalette = new Float32Array(SKIN_MAX_JOINTS * 16);
+    const inverseBindValues = inverseBindMatrices == null ? void 0 : inverseBindMatrices.value;
+    for (let jointIndex = 0; jointIndex < Math.min(joints.length, SKIN_MAX_JOINTS); jointIndex++) {
+      const jointNode = nodeMap == null ? void 0 : nodeMap.get(joints[jointIndex]);
+      if (!jointNode) {
+        continue;
+      }
+      const worldMatrix = matrices.get(jointNode.id) || jointNode.matrix;
+      const jointMatrix = inverseMeshMatrix ? new import_core.Matrix4(inverseMeshMatrix).multiplyRight(worldMatrix) : new import_core.Matrix4(worldMatrix);
+      if (inverseBindValues && inverseBindValues.length >= (jointIndex + 1) * 16) {
+        jointMatrix.multiplyRight(new import_core.Matrix4(Array.from(inverseBindValues.slice(jointIndex * 16, (jointIndex + 1) * 16))));
+      }
+      jointPalette.set(jointMatrix, jointIndex * 16);
+    }
+    return { jointMatrix: jointPalette, ...bindings };
+  },
+  uniformTypes: {
+    jointMatrix: ["mat4x4<f32>", SKIN_MAX_JOINTS]
+  }
+};
+function makeJointPalette(jointMatrices) {
+  const jointPalette = new Float32Array(SKIN_MAX_JOINTS * 16);
+  jointPalette.set(jointMatrices instanceof Float32Array ? jointMatrices.subarray(0, jointPalette.length) : jointMatrices.slice(0, jointPalette.length));
+  return jointPalette;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  SKIN_MAX_JOINTS,
+  fs,
+  skin,
+  source,
+  vs
+});

package/dist/modules/engine/skin/skin.d.ts

@@ -0,0 +1,52 @@
+import type { ShaderBinding as Binding } from "../../../types.js";
+/** Fits comfortably inside the minimum portable WebGL uniform-block limit. */
+export declare const SKIN_MAX_JOINTS = 64;
+export declare const source = "\nstruct skinUniforms {\n  jointMatrix: array<mat4x4<f32>, 64>,\n};\n\n@group(0) @binding(auto) var<uniform> skin: skinUniforms;\n\n#ifdef HAS_INSTANCED_SKIN\n@group(0) @binding(auto) var<storage, read> skinJointMatrices: array<mat4x4<f32>>;\n\nfn getInstancedSkinMatrix(\n  weights: vec4f,\n  joints: vec4u,\n  instanceIndex: u32,\n  jointsPerInstance: u32\n) -> mat4x4<f32> {\n  let firstJoint = instanceIndex * jointsPerInstance;\n  return (weights.x * skinJointMatrices[firstJoint + joints.x])\n       + (weights.y * skinJointMatrices[firstJoint + joints.y])\n       + (weights.z * skinJointMatrices[firstJoint + joints.z])\n       + (weights.w * skinJointMatrices[firstJoint + joints.w]);\n}\n#else\n#ifdef HAS_LARGE_SKIN\n@group(0) @binding(auto) var<storage, read> skinJointMatrices: array<mat4x4<f32>>;\n#endif\n#endif\n\nfn getSkinMatrix(weights: vec4f, joints: vec4u) -> mat4x4<f32> {\n#ifdef HAS_LARGE_SKIN\n  return (weights.x * skinJointMatrices[joints.x])\n       + (weights.y * skinJointMatrices[joints.y])\n       + (weights.z * skinJointMatrices[joints.z])\n       + (weights.w * skinJointMatrices[joints.w]);\n#else\n  return (weights.x * skin.jointMatrix[joints.x])\n       + (weights.y * skin.jointMatrix[joints.y])\n       + (weights.z * skin.jointMatrix[joints.z])\n       + (weights.w * skin.jointMatrix[joints.w]);\n#endif\n}\n";
+export declare const vs = "\nlayout(std140) uniform skinUniforms {\n  mat4 jointMatrix[SKIN_MAX_JOINTS];\n} skin;\n\n#ifdef HAS_INSTANCED_SKIN\nuniform highp sampler2D skinJointMatrices;\n\nmat4 getInstancedJointMatrix(uint jointIndex, uint instanceIndex) {\n  int firstColumn = int(jointIndex * 4u);\n  int row = int(instanceIndex);\n  return mat4(\n    texelFetch(skinJointMatrices, ivec2(firstColumn, row), 0),\n    texelFetch(skinJointMatrices, ivec2(firstColumn + 1, row), 0),\n    texelFetch(skinJointMatrices, ivec2(firstColumn + 2, row), 0),\n    texelFetch(skinJointMatrices, ivec2(firstColumn + 3, row), 0)\n  );\n}\n\nmat4 getInstancedSkinMatrix(\n  vec4 weights,\n  uvec4 joints,\n  uint instanceIndex,\n  uint jointsPerInstance\n) {\n  return (weights.x * getInstancedJointMatrix(joints.x, instanceIndex))\n       + (weights.y * getInstancedJointMatrix(joints.y, instanceIndex))\n       + (weights.z * getInstancedJointMatrix(joints.z, instanceIndex))\n       + (weights.w * getInstancedJointMatrix(joints.w, instanceIndex));\n}\n#else\n#ifdef HAS_LARGE_SKIN\nuniform highp sampler2D skinJointMatrices;\n\nmat4 getSkinJointMatrix(uint jointIndex) {\n  int firstColumn = int(jointIndex * 4u);\n  return mat4(\n    texelFetch(skinJointMatrices, ivec2(firstColumn, 0), 0),\n    texelFetch(skinJointMatrices, ivec2(firstColumn + 1, 0), 0),\n    texelFetch(skinJointMatrices, ivec2(firstColumn + 2, 0), 0),\n    texelFetch(skinJointMatrices, ivec2(firstColumn + 3, 0), 0)\n  );\n}\n#endif\n#endif\n\nmat4 getSkinMatrix(vec4 weights, uvec4 joints) {\n#ifdef HAS_LARGE_SKIN\n  return (weights.x * getSkinJointMatrix(joints.x))\n       + (weights.y * getSkinJointMatrix(joints.y))\n       + (weights.z * getSkinJointMatrix(joints.z))\n       + (weights.w * getSkinJointMatrix(joints.w));\n#else\n  return (weights.x * skin.jointMatrix[joints.x])\n       + (weights.y * skin.jointMatrix[joints.y])\n       + (weights.z * skin.jointMatrix[joints.z])\n       + (weights.w * skin.jointMatrix[joints.w]);\n#endif\n}\n\n";
+export declare const fs = "";
+export type SkinProps = {
+    /** Existing glTF scenegraph input retained for backwards compatibility. */
+    scenegraphsFromGLTF?: any;
+    /** Source skin selected when the scene contains more than one skeleton. */
+    skinIndex?: number;
+    /** Adapter-owned joint palette, already expressed in the skinned mesh's local space. */
+    jointMatrices?: Float32Array | readonly number[];
+    /** Instance-packed joint palettes: WebGPU storage buffer or WebGL float texture. */
+    skinJointMatrices?: Binding;
+    /** Optional mesh transform used to convert world-space joints into mesh-local space. */
+    meshWorldMatrix?: readonly number[];
+};
+export type SkinUniforms = {
+    jointMatrix?: any;
+};
+type SkinBindings = {
+    /** WebGPU read-only storage or WebGL vertex-sampled float texture. */
+    skinJointMatrices?: Binding;
+};
+export declare const skin: {
+    readonly props: SkinProps;
+    readonly uniforms: SkinUniforms;
+    readonly bindings: SkinBindings;
+    readonly name: "skin";
+    readonly bindingLayout: readonly [{
+        readonly name: "skin";
+        readonly group: 0;
+    }, {
+        readonly name: "skinJointMatrices";
+        readonly group: 0;
+        readonly visibility: 1;
+    }];
+    readonly dependencies: [];
+    readonly source: "\nstruct skinUniforms {\n  jointMatrix: array<mat4x4<f32>, 64>,\n};\n\n@group(0) @binding(auto) var<uniform> skin: skinUniforms;\n\n#ifdef HAS_INSTANCED_SKIN\n@group(0) @binding(auto) var<storage, read> skinJointMatrices: array<mat4x4<f32>>;\n\nfn getInstancedSkinMatrix(\n  weights: vec4f,\n  joints: vec4u,\n  instanceIndex: u32,\n  jointsPerInstance: u32\n) -> mat4x4<f32> {\n  let firstJoint = instanceIndex * jointsPerInstance;\n  return (weights.x * skinJointMatrices[firstJoint + joints.x])\n       + (weights.y * skinJointMatrices[firstJoint + joints.y])\n       + (weights.z * skinJointMatrices[firstJoint + joints.z])\n       + (weights.w * skinJointMatrices[firstJoint + joints.w]);\n}\n#else\n#ifdef HAS_LARGE_SKIN\n@group(0) @binding(auto) var<storage, read> skinJointMatrices: array<mat4x4<f32>>;\n#endif\n#endif\n\nfn getSkinMatrix(weights: vec4f, joints: vec4u) -> mat4x4<f32> {\n#ifdef HAS_LARGE_SKIN\n  return (weights.x * skinJointMatrices[joints.x])\n       + (weights.y * skinJointMatrices[joints.y])\n       + (weights.z * skinJointMatrices[joints.z])\n       + (weights.w * skinJointMatrices[joints.w]);\n#else\n  return (weights.x * skin.jointMatrix[joints.x])\n       + (weights.y * skin.jointMatrix[joints.y])\n       + (weights.z * skin.jointMatrix[joints.z])\n       + (weights.w * skin.jointMatrix[joints.w]);\n#endif\n}\n";
+    readonly vs: "\nlayout(std140) uniform skinUniforms {\n  mat4 jointMatrix[SKIN_MAX_JOINTS];\n} skin;\n\n#ifdef HAS_INSTANCED_SKIN\nuniform highp sampler2D skinJointMatrices;\n\nmat4 getInstancedJointMatrix(uint jointIndex, uint instanceIndex) {\n  int firstColumn = int(jointIndex * 4u);\n  int row = int(instanceIndex);\n  return mat4(\n    texelFetch(skinJointMatrices, ivec2(firstColumn, row), 0),\n    texelFetch(skinJointMatrices, ivec2(firstColumn + 1, row), 0),\n    texelFetch(skinJointMatrices, ivec2(firstColumn + 2, row), 0),\n    texelFetch(skinJointMatrices, ivec2(firstColumn + 3, row), 0)\n  );\n}\n\nmat4 getInstancedSkinMatrix(\n  vec4 weights,\n  uvec4 joints,\n  uint instanceIndex,\n  uint jointsPerInstance\n) {\n  return (weights.x * getInstancedJointMatrix(joints.x, instanceIndex))\n       + (weights.y * getInstancedJointMatrix(joints.y, instanceIndex))\n       + (weights.z * getInstancedJointMatrix(joints.z, instanceIndex))\n       + (weights.w * getInstancedJointMatrix(joints.w, instanceIndex));\n}\n#else\n#ifdef HAS_LARGE_SKIN\nuniform highp sampler2D skinJointMatrices;\n\nmat4 getSkinJointMatrix(uint jointIndex) {\n  int firstColumn = int(jointIndex * 4u);\n  return mat4(\n    texelFetch(skinJointMatrices, ivec2(firstColumn, 0), 0),\n    texelFetch(skinJointMatrices, ivec2(firstColumn + 1, 0), 0),\n    texelFetch(skinJointMatrices, ivec2(firstColumn + 2, 0), 0),\n    texelFetch(skinJointMatrices, ivec2(firstColumn + 3, 0), 0)\n  );\n}\n#endif\n#endif\n\nmat4 getSkinMatrix(vec4 weights, uvec4 joints) {\n#ifdef HAS_LARGE_SKIN\n  return (weights.x * getSkinJointMatrix(joints.x))\n       + (weights.y * getSkinJointMatrix(joints.y))\n       + (weights.z * getSkinJointMatrix(joints.z))\n       + (weights.w * getSkinJointMatrix(joints.w));\n#else\n  return (weights.x * skin.jointMatrix[joints.x])\n       + (weights.y * skin.jointMatrix[joints.y])\n       + (weights.z * skin.jointMatrix[joints.z])\n       + (weights.w * skin.jointMatrix[joints.w]);\n#endif\n}\n\n";
+    readonly fs: "";
+    readonly defines: {
+        readonly SKIN_MAX_JOINTS: 64;
+    };
+    readonly getUniforms: (props?: SkinProps, _previousUniforms?: SkinUniforms) => SkinUniforms & SkinBindings;
+    readonly uniformTypes: {
+        readonly jointMatrix: readonly ["mat4x4<f32>", 64];
+    };
+};
+export {};
+//# sourceMappingURL=skin.d.ts.map

package/dist/modules/engine/skin/skin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skin.d.ts","sourceRoot":"","sources":["../../../../src/modules/engine/skin/skin.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAC,aAAa,IAAI,OAAO,EAAC,0BAAuB;AAK7D,8EAA8E;AAC9E,eAAO,MAAM,eAAe,KAAK,CAAC;AAElC,eAAO,MAAM,MAAM,40CAyClB,CAAC;AAEF,eAAO,MAAM,EAAE,68DA6Dd,CAAC;AAEF,eAAO,MAAM,EAAE,KACd,CAAC;AAEF,MAAM,MAAM,SAAS,GAAG;IACtB,2EAA2E;IAC3E,mBAAmB,CAAC,EAAE,GAAG,CAAC;IAC1B,2EAA2E;IAC3E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wFAAwF;IACxF,aAAa,CAAC,EAAE,YAAY,GAAG,SAAS,MAAM,EAAE,CAAC;IACjD,oFAAoF;IACpF,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,wFAAwF;IACxF,eAAe,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,WAAW,CAAC,EAAE,GAAG,CAAC;CACnB,CAAC;AAEF,KAAK,YAAY,GAAG;IAClB,sEAAsE;IACtE,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,CAAC;AAEF,eAAO,MAAM,IAAI;oBACF,SAAS;uBACN,YAAY;uBACZ,YAAY;;;;;;;;;;;;;;;;;mCAiBnB,SAAS,sBACI,YAAY,KAC/B,YAAY,GAAG,YAAY;;;;CAyDwC,CAAC"}

package/dist/modules/engine/skin/skin.js

@@ -0,0 +1,179 @@
+// luma.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+import { Matrix4 } from '@math.gl/core';
+/** Fits comfortably inside the minimum portable WebGL uniform-block limit. */
+export const SKIN_MAX_JOINTS = 64;
+export const source = /* wgsl */ `
+struct skinUniforms {
+  jointMatrix: array<mat4x4<f32>, ${SKIN_MAX_JOINTS}>,
+};
+
+@group(0) @binding(auto) var<uniform> skin: skinUniforms;
+
+#ifdef HAS_INSTANCED_SKIN
+@group(0) @binding(auto) var<storage, read> skinJointMatrices: array<mat4x4<f32>>;
+
+fn getInstancedSkinMatrix(
+  weights: vec4f,
+  joints: vec4u,
+  instanceIndex: u32,
+  jointsPerInstance: u32
+) -> mat4x4<f32> {
+  let firstJoint = instanceIndex * jointsPerInstance;
+  return (weights.x * skinJointMatrices[firstJoint + joints.x])
+       + (weights.y * skinJointMatrices[firstJoint + joints.y])
+       + (weights.z * skinJointMatrices[firstJoint + joints.z])
+       + (weights.w * skinJointMatrices[firstJoint + joints.w]);
+}
+#else
+#ifdef HAS_LARGE_SKIN
+@group(0) @binding(auto) var<storage, read> skinJointMatrices: array<mat4x4<f32>>;
+#endif
+#endif
+
+fn getSkinMatrix(weights: vec4f, joints: vec4u) -> mat4x4<f32> {
+#ifdef HAS_LARGE_SKIN
+  return (weights.x * skinJointMatrices[joints.x])
+       + (weights.y * skinJointMatrices[joints.y])
+       + (weights.z * skinJointMatrices[joints.z])
+       + (weights.w * skinJointMatrices[joints.w]);
+#else
+  return (weights.x * skin.jointMatrix[joints.x])
+       + (weights.y * skin.jointMatrix[joints.y])
+       + (weights.z * skin.jointMatrix[joints.z])
+       + (weights.w * skin.jointMatrix[joints.w]);
+#endif
+}
+`;
+export const vs = /* glsl */ `\
+
+layout(std140) uniform skinUniforms {
+  mat4 jointMatrix[SKIN_MAX_JOINTS];
+} skin;
+
+#ifdef HAS_INSTANCED_SKIN
+uniform highp sampler2D skinJointMatrices;
+
+mat4 getInstancedJointMatrix(uint jointIndex, uint instanceIndex) {
+  int firstColumn = int(jointIndex * 4u);
+  int row = int(instanceIndex);
+  return mat4(
+    texelFetch(skinJointMatrices, ivec2(firstColumn, row), 0),
+    texelFetch(skinJointMatrices, ivec2(firstColumn + 1, row), 0),
+    texelFetch(skinJointMatrices, ivec2(firstColumn + 2, row), 0),
+    texelFetch(skinJointMatrices, ivec2(firstColumn + 3, row), 0)
+  );
+}
+
+mat4 getInstancedSkinMatrix(
+  vec4 weights,
+  uvec4 joints,
+  uint instanceIndex,
+  uint jointsPerInstance
+) {
+  return (weights.x * getInstancedJointMatrix(joints.x, instanceIndex))
+       + (weights.y * getInstancedJointMatrix(joints.y, instanceIndex))
+       + (weights.z * getInstancedJointMatrix(joints.z, instanceIndex))
+       + (weights.w * getInstancedJointMatrix(joints.w, instanceIndex));
+}
+#else
+#ifdef HAS_LARGE_SKIN
+uniform highp sampler2D skinJointMatrices;
+
+mat4 getSkinJointMatrix(uint jointIndex) {
+  int firstColumn = int(jointIndex * 4u);
+  return mat4(
+    texelFetch(skinJointMatrices, ivec2(firstColumn, 0), 0),
+    texelFetch(skinJointMatrices, ivec2(firstColumn + 1, 0), 0),
+    texelFetch(skinJointMatrices, ivec2(firstColumn + 2, 0), 0),
+    texelFetch(skinJointMatrices, ivec2(firstColumn + 3, 0), 0)
+  );
+}
+#endif
+#endif
+
+mat4 getSkinMatrix(vec4 weights, uvec4 joints) {
+#ifdef HAS_LARGE_SKIN
+  return (weights.x * getSkinJointMatrix(joints.x))
+       + (weights.y * getSkinJointMatrix(joints.y))
+       + (weights.z * getSkinJointMatrix(joints.z))
+       + (weights.w * getSkinJointMatrix(joints.w));
+#else
+  return (weights.x * skin.jointMatrix[joints.x])
+       + (weights.y * skin.jointMatrix[joints.y])
+       + (weights.z * skin.jointMatrix[joints.z])
+       + (weights.w * skin.jointMatrix[joints.w]);
+#endif
+}
+
+`;
+export const fs = /* glsl */ `\
+`;
+export const skin = {
+    props: {},
+    uniforms: {},
+    bindings: {},
+    name: 'skin',
+    bindingLayout: [
+        { name: 'skin', group: 0 },
+        { name: 'skinJointMatrices', group: 0, visibility: 1 }
+    ],
+    dependencies: [],
+    source,
+    vs,
+    fs,
+    defines: {
+        SKIN_MAX_JOINTS
+    },
+    getUniforms: (props = {}, _previousUniforms) => {
+        const { jointMatrices, skinJointMatrices, scenegraphsFromGLTF, skinIndex = 0, meshWorldMatrix } = props;
+        const bindings = skinJointMatrices ? { skinJointMatrices } : {};
+        if (jointMatrices) {
+            return { jointMatrix: makeJointPalette(jointMatrices), ...bindings };
+        }
+        const sourceSkin = scenegraphsFromGLTF?.gltf?.skins?.[skinIndex];
+        if (!sourceSkin) {
+            return { jointMatrix: [], ...bindings };
+        }
+        const { inverseBindMatrices, joints, skeleton } = sourceSkin;
+        const nodeMap = scenegraphsFromGLTF.gltfNodeIndexToNodeMap;
+        const matrices = new Map();
+        const root = skeleton === undefined ? undefined : nodeMap?.get(skeleton);
+        const roots = root ? [root] : scenegraphsFromGLTF.scenes || [];
+        for (const sceneRoot of roots) {
+            sceneRoot.preorderTraversal((node, { worldMatrix }) => {
+                matrices.set(node.id, worldMatrix);
+            });
+        }
+        const inverseMeshMatrix = meshWorldMatrix ? new Matrix4(meshWorldMatrix).invert() : null;
+        const jointPalette = new Float32Array(SKIN_MAX_JOINTS * 16);
+        const inverseBindValues = inverseBindMatrices?.value;
+        for (let jointIndex = 0; jointIndex < Math.min(joints.length, SKIN_MAX_JOINTS); jointIndex++) {
+            const jointNode = nodeMap?.get(joints[jointIndex]);
+            if (!jointNode) {
+                continue;
+            }
+            const worldMatrix = matrices.get(jointNode.id) || jointNode.matrix;
+            const jointMatrix = inverseMeshMatrix
+                ? new Matrix4(inverseMeshMatrix).multiplyRight(worldMatrix)
+                : new Matrix4(worldMatrix);
+            if (inverseBindValues && inverseBindValues.length >= (jointIndex + 1) * 16) {
+                jointMatrix.multiplyRight(new Matrix4(Array.from(inverseBindValues.slice(jointIndex * 16, (jointIndex + 1) * 16))));
+            }
+            jointPalette.set(jointMatrix, jointIndex * 16);
+        }
+        return { jointMatrix: jointPalette, ...bindings };
+    },
+    uniformTypes: {
+        jointMatrix: ['mat4x4<f32>', SKIN_MAX_JOINTS]
+    }
+};
+function makeJointPalette(jointMatrices) {
+    const jointPalette = new Float32Array(SKIN_MAX_JOINTS * 16);
+    jointPalette.set(jointMatrices instanceof Float32Array
+        ? jointMatrices.subarray(0, jointPalette.length)
+        : jointMatrices.slice(0, jointPalette.length));
+    return jointPalette;
+}
+//# sourceMappingURL=skin.js.map

package/dist/modules/engine/skin/skin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skin.js","sourceRoot":"","sources":["../../../../src/modules/engine/skin/skin.ts"],"names":[],"mappings":"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"}

package/dist/modules/engine/transform/transform.cjs

@@ -0,0 +1,72 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var transform_exports = {};
+__export(transform_exports, {
+  transform: () => transform
+});
+module.exports = __toCommonJS(transform_exports);
+const vs = (
+  /* glsl */
+  `attribute float transform_elementID;
+
+// returns half of pixel size, used to move the pixel position to center of the pixel.
+vec2 transform_getPixelSizeHalf(vec2 size) {
+  return vec2(1.) / (2. * size);
+}
+
+// returns current elements pixel indeces [x, y],
+// where x ranges in [0 to texSize-1] and y ranges in [0 to texSize-1]
+vec2 transform_getPixelIndices(vec2 texSize, vec2 pixelSizeHalf) {
+  // Add safe offset (half of pixel height) before doing floor
+  float yIndex = floor((transform_elementID / texSize[0]) + pixelSizeHalf[1]);
+  float xIndex = transform_elementID - (yIndex * texSize[0]);
+  return vec2(xIndex, yIndex);
+}
+
+// returns current elementID's texture co-ordianate
+vec2 transform_getTexCoord(vec2 size) {
+  vec2 pixelSizeHalf = transform_getPixelSizeHalf(size);
+  vec2 indices = transform_getPixelIndices(size, pixelSizeHalf);
+  vec2 coord = indices / size + pixelSizeHalf;
+  return coord;
+}
+
+// returns current elementID's position
+vec2 transform_getPos(vec2 size) {
+  vec2 texCoord = transform_getTexCoord(size);
+  // Change from [0 1] range to [-1 1]
+  vec2 pos = (texCoord * (2.0, 2.0)) - (1., 1.);
+  return pos;
+}
+
+// returns current elementID's pixel value
+vec4 transform_getInput(sampler2D texSampler, vec2 size) {
+  vec2 texCoord = transform_getTexCoord(size);
+  vec4 textureColor = texture2D(texSampler, texCoord);
+  return textureColor;
+}
+`
+);
+const transform = {
+  name: "transform",
+  vs
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  transform
+});

package/dist/modules/engine/transform/transform.d.ts

@@ -0,0 +1,6 @@
+/** Private shader module used by `Transform` */
+export declare const transform: {
+    name: string;
+    vs: string;
+};
+//# sourceMappingURL=transform.d.ts.map

package/dist/modules/engine/transform/transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.d.ts","sourceRoot":"","sources":["../../../../src/modules/engine/transform/transform.ts"],"names":[],"mappings":"AA6CA,gDAAgD;AAChD,eAAO,MAAM,SAAS;;;CAGrB,CAAC"}

package/dist/modules/engine/transform/transform.js

@@ -0,0 +1,49 @@
+// luma.gl
+// SPDX-License-Identifier: MIT
+// SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
+const vs = /* glsl */ `\
+attribute float transform_elementID;
+
+// returns half of pixel size, used to move the pixel position to center of the pixel.
+vec2 transform_getPixelSizeHalf(vec2 size) {
+  return vec2(1.) / (2. * size);
+}
+
+// returns current elements pixel indeces [x, y],
+// where x ranges in [0 to texSize-1] and y ranges in [0 to texSize-1]
+vec2 transform_getPixelIndices(vec2 texSize, vec2 pixelSizeHalf) {
+  // Add safe offset (half of pixel height) before doing floor
+  float yIndex = floor((transform_elementID / texSize[0]) + pixelSizeHalf[1]);
+  float xIndex = transform_elementID - (yIndex * texSize[0]);
+  return vec2(xIndex, yIndex);
+}
+
+// returns current elementID's texture co-ordianate
+vec2 transform_getTexCoord(vec2 size) {
+  vec2 pixelSizeHalf = transform_getPixelSizeHalf(size);
+  vec2 indices = transform_getPixelIndices(size, pixelSizeHalf);
+  vec2 coord = indices / size + pixelSizeHalf;
+  return coord;
+}
+
+// returns current elementID's position
+vec2 transform_getPos(vec2 size) {
+  vec2 texCoord = transform_getTexCoord(size);
+  // Change from [0 1] range to [-1 1]
+  vec2 pos = (texCoord * (2.0, 2.0)) - (1., 1.);
+  return pos;
+}
+
+// returns current elementID's pixel value
+vec4 transform_getInput(sampler2D texSampler, vec2 size) {
+  vec2 texCoord = transform_getTexCoord(size);
+  vec4 textureColor = texture2D(texSampler, texCoord);
+  return textureColor;
+}
+`;
+/** Private shader module used by `Transform` */
+export const transform = {
+    name: 'transform',
+    vs
+};
+//# sourceMappingURL=transform.js.map

package/dist/modules/engine/transform/transform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transform.js","sourceRoot":"","sources":["../../../../src/modules/engine/transform/transform.ts"],"names":[],"mappings":"AAAA,UAAU;AACV,+BAA+B;AAC/B,4DAA4D;AAE5D,MAAM,EAAE,GAAG,UAAU,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCrB,CAAC;AAEF,gDAAgD;AAChD,MAAM,CAAC,MAAM,SAAS,GAAG;IACvB,IAAI,EAAE,WAAW;IACjB,EAAE;CACH,CAAC"}