@loaders.gl/scene 5.0.0-alpha.8 → 5.0.0-beta.1

package/dist/gltf/lib/extensions/KHR_texture_basisu.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/gltf/lib/extensions/KHR_texture_basisu.ts"],
+  "sourcesContent": ["// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\n// GLTF EXTENSION: KHR_texture_basisu\n// https://github.com/KhronosGroup/glTF/tree/main/extensions/2.0/Khronos/KHR_texture_basisu\n/* eslint-disable camelcase */\n\nimport type {GLTF_KHR_texture_basisu} from '../types/gltf-json-schema';\nimport type {GLTFWithBuffers} from '../types/gltf-types';\nimport type {GLTFLoaderOptions} from '../../gltf-loader-types';\n\nimport {GLTFIterator} from '../api/gltf-iterator';\n\nconst KHR_TEXTURE_BASISU = 'KHR_texture_basisu';\n\n/** Extension name */\nexport const name = KHR_TEXTURE_BASISU;\n\n/**\n * Replaces a texture source reference with the extension texture\n * Done in preprocess() to prevent load of default image\n */\nexport function preprocess(gltfData: GLTFWithBuffers, options: GLTFLoaderOptions): void {\n  void options;\n  const iterator = new GLTFIterator(gltfData);\n\n  for (const texture of iterator.textures) {\n    const extension = iterator.getExtension<GLTF_KHR_texture_basisu>(texture, KHR_TEXTURE_BASISU);\n    if (extension) {\n      // TODO - if multiple texture extensions are present which one wins?\n      texture.source = extension.source;\n      iterator.removeExtension(texture, KHR_TEXTURE_BASISU);\n    }\n  }\n\n  // Remove the top-level extension\n  iterator.removeExtension(KHR_TEXTURE_BASISU);\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAYA,2BAA2B;AAE3B,IAAM,qBAAqB;AAGpB,IAAM,OAAO;AAMb,SAAS,WAAW,UAA2B,SAAkC;AACtF,OAAK;AACL,QAAM,WAAW,IAAI,kCAAa,QAAQ;AAE1C,aAAW,WAAW,SAAS,UAAU;AACvC,UAAM,YAAY,SAAS,aAAsC,SAAS,kBAAkB;AAC5F,QAAI,WAAW;AAEb,cAAQ,SAAS,UAAU;AAC3B,eAAS,gBAAgB,SAAS,kBAAkB;AAAA,IACtD;AAAA,EACF;AAGA,WAAS,gBAAgB,kBAAkB;AAC7C;",
+  "names": []
+}

package/dist/gltf/lib/extensions/KHR_texture_basisu.d.ts

@@ -0,0 +1,10 @@
+import type { GLTFWithBuffers } from "../types/gltf-types.js";
+import type { GLTFLoaderOptions } from "../../gltf-loader-types.js";
+/** Extension name */
+export declare const name = "KHR_texture_basisu";
+/**
+ * Replaces a texture source reference with the extension texture
+ * Done in preprocess() to prevent load of default image
+ */
+export declare function preprocess(gltfData: GLTFWithBuffers, options: GLTFLoaderOptions): void;
+//# sourceMappingURL=KHR_texture_basisu.d.ts.map

package/dist/gltf/lib/extensions/KHR_texture_basisu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KHR_texture_basisu.d.ts","sourceRoot":"","sources":["../../../../src/gltf/lib/extensions/KHR_texture_basisu.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAC,eAAe,EAAC,+BAA4B;AACzD,OAAO,KAAK,EAAC,iBAAiB,EAAC,mCAAgC;AAM/D,qBAAqB;AACrB,eAAO,MAAM,IAAI,uBAAqB,CAAC;AAEvC;;;GAGG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAetF"}

package/dist/gltf/lib/extensions/KHR_texture_basisu.js

@@ -0,0 +1,26 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+import { GLTFIterator } from "../api/gltf-iterator.js";
+const KHR_TEXTURE_BASISU = 'KHR_texture_basisu';
+/** Extension name */
+export const name = KHR_TEXTURE_BASISU;
+/**
+ * Replaces a texture source reference with the extension texture
+ * Done in preprocess() to prevent load of default image
+ */
+export function preprocess(gltfData, options) {
+    void options;
+    const iterator = new GLTFIterator(gltfData);
+    for (const texture of iterator.textures) {
+        const extension = iterator.getExtension(texture, KHR_TEXTURE_BASISU);
+        if (extension) {
+            // TODO - if multiple texture extensions are present which one wins?
+            texture.source = extension.source;
+            iterator.removeExtension(texture, KHR_TEXTURE_BASISU);
+        }
+    }
+    // Remove the top-level extension
+    iterator.removeExtension(KHR_TEXTURE_BASISU);
+}
+//# sourceMappingURL=KHR_texture_basisu.js.map

package/dist/gltf/lib/extensions/KHR_texture_basisu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KHR_texture_basisu.js","sourceRoot":"","sources":["../../../../src/gltf/lib/extensions/KHR_texture_basisu.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,+BAA+B;AAC/B,oCAAoC;AAUpC,OAAO,EAAC,YAAY,EAAC,gCAA6B;AAElD,MAAM,kBAAkB,GAAG,oBAAoB,CAAC;AAEhD,qBAAqB;AACrB,MAAM,CAAC,MAAM,IAAI,GAAG,kBAAkB,CAAC;AAEvC;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,QAAyB,EAAE,OAA0B;IAC9E,KAAK,OAAO,CAAC;IACb,MAAM,QAAQ,GAAG,IAAI,YAAY,CAAC,QAAQ,CAAC,CAAC;IAE5C,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;QACxC,MAAM,SAAS,GAAG,QAAQ,CAAC,YAAY,CAA0B,OAAO,EAAE,kBAAkB,CAAC,CAAC;QAC9F,IAAI,SAAS,EAAE,CAAC;YACd,oEAAoE;YACpE,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;YAClC,QAAQ,CAAC,eAAe,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,iCAAiC;IACjC,QAAQ,CAAC,eAAe,CAAC,kBAAkB,CAAC,CAAC;AAC/C,CAAC"}

package/dist/gltf/lib/extensions/KHR_texture_transform.cjs

@@ -0,0 +1,258 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name2 in all)
+    __defProp(target, name2, { get: all[name2], 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);
+
+// src/gltf/lib/extensions/KHR_texture_transform.ts
+var KHR_texture_transform_exports = {};
+__export(KHR_texture_transform_exports, {
+  decode: () => decode,
+  name: () => name
+});
+module.exports = __toCommonJS(KHR_texture_transform_exports);
+var import_core = require("@math.gl/core");
+var import_gltf_utils = require("../gltf-utils/gltf-utils.cjs");
+var import_gltf_constants = require("../gltf-utils/gltf-constants.cjs");
+var import_gltf_iterator = require("../api/gltf-iterator.cjs");
+var import_loader_utils = require("@loaders.gl/core/loader-utils");
+var KHR_TEXTURE_TRANSFORM = "KHR_texture_transform";
+var name = KHR_TEXTURE_TRANSFORM;
+var scratchVector = new import_core.Vector3();
+var scratchRotationMatrix = new import_core.Matrix3();
+var scratchScaleMatrix = new import_core.Matrix3();
+async function decode(gltfData, options) {
+  const iterator = new import_gltf_iterator.GLTFIterator(gltfData);
+  const hasExtension = iterator.hasExtension(KHR_TEXTURE_TRANSFORM);
+  if (!hasExtension || !options.gltf?.loadBuffers) {
+    return;
+  }
+  const materials = gltfData.json.materials || [];
+  for (let i = 0; i < materials.length; i++) {
+    transformTexCoords(i, gltfData, iterator);
+  }
+  if (!materials.some((material) => findTextureInfos(material).length > 0)) {
+    iterator.removeExtension(KHR_TEXTURE_TRANSFORM);
+  }
+}
+function transformTexCoords(materialIndex, gltfData, iterator) {
+  const material = gltfData.json.materials?.[materialIndex];
+  const materialTextures = findTextureInfos(material);
+  const processedTransforms = /* @__PURE__ */ new Map();
+  let nextTexCoord = getNextTexCoord(gltfData);
+  for (const textureInfo of materialTextures) {
+    const extension = textureInfo.extensions?.[KHR_TEXTURE_TRANSFORM];
+    if (extension) {
+      const sourceTexCoord = extension.texCoord ?? textureInfo.texCoord ?? 0;
+      const transformKey = getTransformKey(sourceTexCoord, extension);
+      let transformParameters = processedTransforms.get(transformKey);
+      if (!transformParameters) {
+        transformParameters = {
+          sourceTexCoord,
+          texCoord: nextTexCoord,
+          matrix: makeTransformationMatrix(extension)
+        };
+        if (!transformPrimitives(gltfData, materialIndex, transformParameters)) {
+          continue;
+        }
+        nextTexCoord++;
+        processedTransforms.set(transformKey, transformParameters);
+      }
+      textureInfo.texCoord = transformParameters.texCoord;
+      removeObjectExtension(iterator, textureInfo, KHR_TEXTURE_TRANSFORM);
+      if (textureInfo.extensions && Object.keys(textureInfo.extensions).length === 0) {
+        delete textureInfo.extensions;
+      }
+    }
+  }
+}
+function removeObjectExtension(iterator, object, extensionName) {
+  if (object.extensions?.[extensionName] !== void 0) {
+    iterator.recordRemovedExtension(extensionName);
+    delete object.extensions[extensionName];
+  }
+}
+function findTextureInfos(value) {
+  if (!value || typeof value !== "object") {
+    return [];
+  }
+  const object = value;
+  const textureInfos = [];
+  const extensions = object.extensions;
+  if (Number.isFinite(object.index) && extensions?.[KHR_TEXTURE_TRANSFORM]) {
+    textureInfos.push(object);
+  }
+  for (const [key, nestedValue] of Object.entries(object)) {
+    if (key !== "extras") {
+      textureInfos.push(...findTextureInfos(nestedValue));
+    }
+  }
+  return textureInfos;
+}
+function getNextTexCoord(gltfData) {
+  let maximumTexCoord = -1;
+  for (const mesh of gltfData.json.meshes || []) {
+    for (const primitive of mesh.primitives) {
+      for (const attributeName of Object.keys(primitive.attributes)) {
+        const match = /^TEXCOORD_(\d+)$/.exec(attributeName);
+        if (match) {
+          maximumTexCoord = Math.max(maximumTexCoord, Number(match[1]));
+        }
+      }
+    }
+  }
+  return maximumTexCoord + 1;
+}
+function getTransformKey(sourceTexCoord, extension) {
+  const { offset = [0, 0], rotation = 0, scale = [1, 1] } = extension;
+  return JSON.stringify([sourceTexCoord, offset, rotation, scale]);
+}
+function transformPrimitives(gltfData, materialIndex, transformParameters) {
+  const primitives = [];
+  const meshes = gltfData.json.meshes || [];
+  for (const mesh of meshes) {
+    for (const primitive of mesh.primitives) {
+      const material = primitive.material;
+      if (Number.isFinite(material) && materialIndex === material) {
+        primitives.push(primitive);
+      }
+    }
+  }
+  if (primitives.length === 0 || primitives.some(
+    (primitive) => !canTransformPrimitive(gltfData, primitive, transformParameters.sourceTexCoord)
+  )) {
+    return false;
+  }
+  for (const primitive of primitives) {
+    transformPrimitive(gltfData, primitive, transformParameters);
+  }
+  return true;
+}
+function canTransformPrimitive(gltfData, primitive, sourceTexCoord) {
+  const texCoordAccessor = primitive.attributes[`TEXCOORD_${sourceTexCoord}`];
+  const decodedAccessor = texCoordAccessor;
+  if (ArrayBuffer.isView(decodedAccessor?.value)) {
+    return true;
+  }
+  if (!Number.isFinite(texCoordAccessor)) {
+    return false;
+  }
+  const accessor = gltfData.json.accessors?.[texCoordAccessor];
+  if (!accessor || accessor.bufferView === void 0 || accessor.sparse) {
+    return false;
+  }
+  const bufferView = gltfData.json.bufferViews?.[accessor.bufferView];
+  return Boolean(bufferView && gltfData.buffers[bufferView.buffer]);
+}
+function transformPrimitive(gltfData, primitive, transformParameters) {
+  const { sourceTexCoord, texCoord, matrix } = transformParameters;
+  const texCoordAccessor = primitive.attributes[`TEXCOORD_${sourceTexCoord}`];
+  const decodedAccessor = texCoordAccessor;
+  if (ArrayBuffer.isView(decodedAccessor?.value)) {
+    const result = new Float32Array(decodedAccessor.count * 2);
+    for (let index = 0; index < decodedAccessor.count; index++) {
+      transformCoordinatePair(
+        decodedAccessor.value.subarray(index * 2, index * 2 + 2),
+        decodedAccessor,
+        matrix,
+        result,
+        index * 2
+      );
+    }
+    createAttribute(texCoord, decodedAccessor, primitive, gltfData, result);
+    return;
+  }
+  if (Number.isFinite(texCoordAccessor)) {
+    const accessor = gltfData.json.accessors?.[texCoordAccessor];
+    if (accessor && accessor.bufferView !== void 0) {
+      const bufferView = gltfData.json.bufferViews?.[accessor.bufferView];
+      if (bufferView) {
+        const { arrayBuffer, byteOffset: bufferByteOffset } = gltfData.buffers[bufferView.buffer];
+        const byteOffset = (bufferByteOffset || 0) + (accessor.byteOffset || 0) + (bufferView.byteOffset || 0);
+        const { ArrayType, length } = (0, import_gltf_utils.getAccessorArrayTypeAndLength)(accessor, bufferView);
+        const bytes = import_gltf_constants.BYTES[accessor.componentType];
+        const components = import_gltf_constants.COMPONENTS[accessor.type];
+        const elementAddressScale = bufferView.byteStride || bytes * components;
+        const result = new Float32Array(length);
+        for (let i = 0; i < accessor.count; i++) {
+          const uv = new ArrayType(arrayBuffer, byteOffset + i * elementAddressScale, 2);
+          transformCoordinatePair(uv, accessor, matrix, result, i * components);
+        }
+        createAttribute(texCoord, accessor, primitive, gltfData, result);
+      }
+    }
+  }
+}
+function transformCoordinatePair(textureCoordinates, accessor, matrix, result, offset) {
+  const signed = accessor.componentType === 5120 || accessor.componentType === 5122;
+  const divisor = 2 ** (import_gltf_constants.BYTES[accessor.componentType] * 8 - (signed ? 1 : 0)) - 1;
+  scratchVector.set(
+    accessor.normalized ? Math.max(textureCoordinates[0] / divisor, -1) : textureCoordinates[0],
+    accessor.normalized ? Math.max(textureCoordinates[1] / divisor, -1) : textureCoordinates[1],
+    1
+  );
+  scratchVector.transformByMatrix3(matrix);
+  result.set([scratchVector[0], scratchVector[1]], offset);
+}
+function createAttribute(newTexCoord, originalAccessor, primitive, gltfData, newTexCoordArray) {
+  gltfData.buffers.push({
+    arrayBuffer: (0, import_loader_utils.ensureArrayBuffer)(newTexCoordArray.buffer),
+    byteOffset: 0,
+    byteLength: newTexCoordArray.buffer.byteLength
+  });
+  gltfData.json.bufferViews = gltfData.json.bufferViews || [];
+  const bufferViews = gltfData.json.bufferViews;
+  bufferViews.push({
+    buffer: gltfData.buffers.length - 1,
+    byteLength: newTexCoordArray.buffer.byteLength,
+    byteOffset: 0
+  });
+  const accessors = gltfData.json.accessors;
+  if (!accessors) {
+    return;
+  }
+  accessors.push({
+    bufferView: bufferViews?.length - 1,
+    byteOffset: 0,
+    componentType: 5126,
+    count: originalAccessor.count,
+    type: "VEC2"
+  });
+  primitive.attributes[`TEXCOORD_${newTexCoord}`] = accessors.length - 1;
+}
+function makeTransformationMatrix(extensionData) {
+  const { offset = [0, 0], rotation = 0, scale = [1, 1] } = extensionData;
+  const translationMatrix = new import_core.Matrix3().set(1, 0, 0, 0, 1, 0, offset[0], offset[1], 1);
+  const rotationMatrix = scratchRotationMatrix.set(
+    Math.cos(rotation),
+    Math.sin(rotation),
+    0,
+    -Math.sin(rotation),
+    Math.cos(rotation),
+    0,
+    0,
+    0,
+    1
+  );
+  const scaleMatrix = scratchScaleMatrix.set(scale[0], 0, 0, 0, scale[1], 0, 0, 0, 1);
+  return translationMatrix.multiplyRight(rotationMatrix).multiplyRight(scaleMatrix);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  decode,
+  name
+});
+//# sourceMappingURL=KHR_texture_transform.cjs.map

package/dist/gltf/lib/extensions/KHR_texture_transform.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../../src/gltf/lib/extensions/KHR_texture_transform.ts"],
+  "sourcesContent": ["// loaders.gl\n// SPDX-License-Identifier: MIT\n// Copyright (c) vis.gl contributors\n\n/**\n * https://github.com/KhronosGroup/glTF/blob/main/extensions/2.0/Khronos/KHR_texture_transform/README.md\n */\n\nimport {Vector3, Matrix3} from '@math.gl/core';\nimport type {GLTFWithBuffers} from '../types/gltf-types';\nimport type {\n  GLTFMeshPrimitive,\n  GLTFAccessor,\n  GLTFMaterialNormalTextureInfo,\n  GLTFMaterialOcclusionTextureInfo,\n  GLTFTextureInfo\n} from '../types/gltf-json-schema';\nimport type {GLTFLoaderOptions} from '../../gltf-loader-types';\n\nimport {getAccessorArrayTypeAndLength} from '../gltf-utils/gltf-utils';\nimport {BYTES, COMPONENTS} from '../gltf-utils/gltf-constants';\nimport {GLTFIterator} from '../api/gltf-iterator';\nimport {ensureArrayBuffer} from '@loaders.gl/core/loader-utils';\n\n/** Extension name */\nconst KHR_TEXTURE_TRANSFORM = 'KHR_texture_transform';\n\nexport const name = KHR_TEXTURE_TRANSFORM;\n\nconst scratchVector = new Vector3();\nconst scratchRotationMatrix = new Matrix3();\nconst scratchScaleMatrix = new Matrix3();\n\n/** Extension textureInfo https://github.com/KhronosGroup/glTF/tree/main/extensions/2.0/Khronos/KHR_texture_transform#gltf-schema-updates */\ntype TextureInfo = {\n  /** The offset of the UV coordinate origin as a factor of the texture dimensions. */\n  offset?: [number, number];\n  /** Rotate the UVs by this many radians counter-clockwise around the origin. This is equivalent to a similar rotation of the image clockwise. */\n  rotation?: number;\n  /** The scale factor applied to the components of the UV coordinates. */\n  scale?: [number, number];\n  /** Overrides the textureInfo texCoord value if supplied, and if this extension is supported. */\n  texCoord?: number;\n};\n/** Intersection of all GLTF textures */\ntype CompoundGLTFTextureInfo = GLTFTextureInfo &\n  GLTFMaterialNormalTextureInfo &\n  GLTFMaterialOcclusionTextureInfo;\n/** Accessor values produced by mesh decoders before glTF postprocessing. */\ntype DecodedTextureAccessor = GLTFAccessor & {\n  /** Packed float or integer UV pairs, in decoded vertex order. */\n  value?: Float32Array | Uint8Array | Uint16Array | Int8Array | Int16Array;\n};\n/** Parameters for TEXCOORD transformation */\ntype TransformParameters = {\n  /** Source texCoord selected by the texture info or extension. */\n  sourceTexCoord: number;\n  /** Generated texCoord containing the transformed values. */\n  texCoord: number;\n  /** Transformation matrix */\n  matrix: Matrix3;\n};\n\n/**\n * The extension entry to process the transformation\n * @param gltfData gltf buffers and json\n * @param options GLTFLoader options\n */\nexport async function decode(gltfData: GLTFWithBuffers, options: GLTFLoaderOptions) {\n  const iterator = new GLTFIterator(gltfData);\n  const hasExtension = iterator.hasExtension(KHR_TEXTURE_TRANSFORM);\n  if (!hasExtension || !options.gltf?.loadBuffers) {\n    return;\n  }\n  const materials = gltfData.json.materials || [];\n  for (let i = 0; i < materials.length; i++) {\n    transformTexCoords(i, gltfData, iterator);\n  }\n  if (!materials.some(material => findTextureInfos(material).length > 0)) {\n    iterator.removeExtension(KHR_TEXTURE_TRANSFORM);\n  }\n}\n\n/**\n * Transform TEXCOORD by material\n * @param materialIndex processing material index\n * @param gltfData gltf buffers and json\n * @param gltfScenegraph glTF scenegraph used to remove decoded extensions\n */\nfunction transformTexCoords(\n  materialIndex: number,\n  gltfData: GLTFWithBuffers,\n  iterator: GLTFIterator\n): void {\n  const material = gltfData.json.materials?.[materialIndex];\n  const materialTextures = findTextureInfos(material);\n  const processedTransforms = new Map<string, TransformParameters>();\n  let nextTexCoord = getNextTexCoord(gltfData);\n\n  for (const textureInfo of materialTextures) {\n    const extension = textureInfo.extensions?.[KHR_TEXTURE_TRANSFORM] as TextureInfo | undefined;\n    if (extension) {\n      const sourceTexCoord = extension.texCoord ?? textureInfo.texCoord ?? 0;\n      const transformKey = getTransformKey(sourceTexCoord, extension);\n      let transformParameters = processedTransforms.get(transformKey);\n      if (!transformParameters) {\n        transformParameters = {\n          sourceTexCoord,\n          texCoord: nextTexCoord,\n          matrix: makeTransformationMatrix(extension)\n        };\n        if (!transformPrimitives(gltfData, materialIndex, transformParameters)) {\n          continue;\n        }\n        nextTexCoord++;\n        processedTransforms.set(transformKey, transformParameters);\n      }\n      textureInfo.texCoord = transformParameters.texCoord;\n      removeObjectExtension(iterator, textureInfo, KHR_TEXTURE_TRANSFORM);\n      if (textureInfo.extensions && Object.keys(textureInfo.extensions).length === 0) {\n        delete textureInfo.extensions;\n      }\n    }\n  }\n}\n\n/** Remove an object extension while preserving top-level extension bookkeeping. */\nfunction removeObjectExtension(\n  iterator: GLTFIterator,\n  object: {extensions?: Record<string, unknown>},\n  extensionName: string\n): void {\n  if (object.extensions?.[extensionName] !== undefined) {\n    iterator.recordRemovedExtension(extensionName);\n    delete object.extensions[extensionName];\n  }\n}\n\n/**\n * Finds texture infos at any nesting level of a material, including KHR_materials_* extensions.\n * @param value material value to inspect\n * @returns texture infos using KHR_texture_transform\n */\nfunction findTextureInfos(value: unknown): CompoundGLTFTextureInfo[] {\n  if (!value || typeof value !== 'object') {\n    return [];\n  }\n  const object = value as Record<string, unknown>;\n  const textureInfos: CompoundGLTFTextureInfo[] = [];\n  const extensions = object.extensions as Record<string, unknown> | undefined;\n  if (Number.isFinite(object.index) && extensions?.[KHR_TEXTURE_TRANSFORM]) {\n    textureInfos.push(object as CompoundGLTFTextureInfo);\n  }\n  for (const [key, nestedValue] of Object.entries(object)) {\n    if (key !== 'extras') {\n      textureInfos.push(...findTextureInfos(nestedValue));\n    }\n  }\n  return textureInfos;\n}\n\n/** Returns the first TEXCOORD set index unused by every primitive. */\nfunction getNextTexCoord(gltfData: GLTFWithBuffers): number {\n  let maximumTexCoord = -1;\n  for (const mesh of gltfData.json.meshes || []) {\n    for (const primitive of mesh.primitives) {\n      for (const attributeName of Object.keys(primitive.attributes)) {\n        const match = /^TEXCOORD_(\\d+)$/.exec(attributeName);\n        if (match) {\n          maximumTexCoord = Math.max(maximumTexCoord, Number(match[1]));\n        }\n      }\n    }\n  }\n  return maximumTexCoord + 1;\n}\n\n/** Returns a stable key for transformations that can share generated attributes. */\nfunction getTransformKey(sourceTexCoord: number, extension: TextureInfo): string {\n  const {offset = [0, 0], rotation = 0, scale = [1, 1]} = extension;\n  return JSON.stringify([sourceTexCoord, offset, rotation, scale]);\n}\n\n/**\n * Transform primitives of the particular material.\n * @param gltfData gltf data\n * @param materialIndex primitives with this material will be transformed\n * @param transformParameters source and generated texture coordinate sets\n * @returns true when every relevant primitive received the generated attribute\n */\nfunction transformPrimitives(\n  gltfData: GLTFWithBuffers,\n  materialIndex: number,\n  transformParameters: TransformParameters\n): boolean {\n  const primitives: GLTFMeshPrimitive[] = [];\n  const meshes = gltfData.json.meshes || [];\n  for (const mesh of meshes) {\n    for (const primitive of mesh.primitives) {\n      const material = primitive.material;\n      if (Number.isFinite(material) && materialIndex === material) {\n        primitives.push(primitive);\n      }\n    }\n  }\n  if (\n    primitives.length === 0 ||\n    primitives.some(\n      primitive => !canTransformPrimitive(gltfData, primitive, transformParameters.sourceTexCoord)\n    )\n  ) {\n    return false;\n  }\n  for (const primitive of primitives) {\n    transformPrimitive(gltfData, primitive, transformParameters);\n  }\n  return true;\n}\n\n/** Returns whether a primitive's source texture coordinates can be transformed without data loss. */\nfunction canTransformPrimitive(\n  gltfData: GLTFWithBuffers,\n  primitive: GLTFMeshPrimitive,\n  sourceTexCoord: number\n): boolean {\n  const texCoordAccessor = primitive.attributes[`TEXCOORD_${sourceTexCoord}`];\n  const decodedAccessor = texCoordAccessor as unknown as DecodedTextureAccessor;\n  if (ArrayBuffer.isView(decodedAccessor?.value)) {\n    return true;\n  }\n  if (!Number.isFinite(texCoordAccessor)) {\n    return false;\n  }\n  const accessor = gltfData.json.accessors?.[texCoordAccessor];\n  if (!accessor || accessor.bufferView === undefined || accessor.sparse) {\n    return false;\n  }\n  const bufferView = gltfData.json.bufferViews?.[accessor.bufferView];\n  return Boolean(bufferView && gltfData.buffers[bufferView.buffer]);\n}\n\n/**\n * Transform `TEXCOORD_0` attribute in the primitive\n * @param gltfData gltf data\n * @param primitive primitive object\n * @param transformParameters texCoord couple and transformation matrix\n */\nfunction transformPrimitive(\n  gltfData: GLTFWithBuffers,\n  primitive: GLTFMeshPrimitive,\n  transformParameters: TransformParameters\n) {\n  const {sourceTexCoord, texCoord, matrix} = transformParameters;\n  const texCoordAccessor = primitive.attributes[`TEXCOORD_${sourceTexCoord}`];\n  const decodedAccessor = texCoordAccessor as unknown as DecodedTextureAccessor;\n  if (ArrayBuffer.isView(decodedAccessor?.value)) {\n    const result = new Float32Array(decodedAccessor.count * 2);\n    for (let index = 0; index < decodedAccessor.count; index++) {\n      transformCoordinatePair(\n        decodedAccessor.value.subarray(index * 2, index * 2 + 2),\n        decodedAccessor,\n        matrix,\n        result,\n        index * 2\n      );\n    }\n    createAttribute(texCoord, decodedAccessor, primitive, gltfData, result);\n    return;\n  }\n  if (Number.isFinite(texCoordAccessor)) {\n    // Get accessor of the `TEXCOORD_0` attribute\n    const accessor = gltfData.json.accessors?.[texCoordAccessor];\n    if (accessor && accessor.bufferView !== undefined) {\n      // Get `bufferView` of the `accessor`\n      const bufferView = gltfData.json.bufferViews?.[accessor.bufferView];\n      if (bufferView) {\n        // Get `arrayBuffer` the `bufferView` look at\n        const {arrayBuffer, byteOffset: bufferByteOffset} = gltfData.buffers[bufferView.buffer];\n        // Resulting byteOffset is sum of the buffer, accessor and bufferView byte offsets\n        const byteOffset =\n          (bufferByteOffset || 0) + (accessor.byteOffset || 0) + (bufferView.byteOffset || 0);\n        // Deduce TypedArray type and its length from `accessor` and `bufferView` data\n        const {ArrayType, length} = getAccessorArrayTypeAndLength(accessor, bufferView);\n        // Number of bytes each component occupies\n        const bytes = BYTES[accessor.componentType];\n        // Number of components. For the `TEXCOORD_0` with `VEC2` type, it must return 2\n        const components = COMPONENTS[accessor.type];\n        // Multiplier to calculate the address of the `TEXCOORD_0` element in the arrayBuffer\n        const elementAddressScale = bufferView.byteStride || bytes * components;\n        // Data transform to Float32Array\n        const result = new Float32Array(length);\n        for (let i = 0; i < accessor.count; i++) {\n          // Take [u, v] couple from the arrayBuffer\n          const uv = new ArrayType(arrayBuffer, byteOffset + i * elementAddressScale, 2);\n          transformCoordinatePair(uv, accessor, matrix, result, i * components);\n        }\n        createAttribute(texCoord, accessor, primitive, gltfData, result);\n      }\n    }\n  }\n}\n\n/** Normalizes one packed UV pair and writes its transformed Float32 coordinates. */\nfunction transformCoordinatePair(\n  textureCoordinates: ArrayLike<number>,\n  accessor: GLTFAccessor,\n  matrix: Matrix3,\n  result: Float32Array,\n  offset: number\n): void {\n  const signed = accessor.componentType === 5120 || accessor.componentType === 5122;\n  const divisor = 2 ** (BYTES[accessor.componentType] * 8 - (signed ? 1 : 0)) - 1;\n  scratchVector.set(\n    accessor.normalized ? Math.max(textureCoordinates[0] / divisor, -1) : textureCoordinates[0],\n    accessor.normalized ? Math.max(textureCoordinates[1] / divisor, -1) : textureCoordinates[1],\n    1\n  );\n  scratchVector.transformByMatrix3(matrix);\n  result.set([scratchVector[0], scratchVector[1]], offset);\n}\n\n/**\n *\n * @param newTexCoord new `texCoord` value\n * @param originalAccessor original accessor object, that store data before transformation\n * @param primitive primitive object\n * @param gltfData gltf data\n * @param newTexCoordArray typed array with data after transformation\n * @returns\n */\nfunction createAttribute(\n  newTexCoord: number,\n  originalAccessor: GLTFAccessor,\n  primitive: GLTFMeshPrimitive,\n  gltfData: GLTFWithBuffers,\n  newTexCoordArray: Float32Array\n) {\n  gltfData.buffers.push({\n    arrayBuffer: ensureArrayBuffer(newTexCoordArray.buffer),\n    byteOffset: 0,\n    byteLength: newTexCoordArray.buffer.byteLength\n  });\n  gltfData.json.bufferViews = gltfData.json.bufferViews || [];\n  const bufferViews = gltfData.json.bufferViews;\n  bufferViews.push({\n    buffer: gltfData.buffers.length - 1,\n    byteLength: newTexCoordArray.buffer.byteLength,\n    byteOffset: 0\n  });\n  const accessors = gltfData.json.accessors;\n  if (!accessors) {\n    return;\n  }\n  accessors.push({\n    bufferView: bufferViews?.length - 1,\n    byteOffset: 0,\n    componentType: 5126,\n    count: originalAccessor.count,\n    type: 'VEC2'\n  });\n  primitive.attributes[`TEXCOORD_${newTexCoord}`] = accessors.length - 1;\n}\n\n/**\n * Construct transformation matrix from the extension data (transition, rotation, scale)\n * @param extensionData extension data\n * @returns transformation matrix\n */\nfunction makeTransformationMatrix(extensionData: TextureInfo): Matrix3 {\n  const {offset = [0, 0], rotation = 0, scale = [1, 1]} = extensionData;\n  const translationMatrix = new Matrix3().set(1, 0, 0, 0, 1, 0, offset[0], offset[1], 1);\n  const rotationMatrix = scratchRotationMatrix.set(\n    Math.cos(rotation),\n    Math.sin(rotation),\n    0,\n    -Math.sin(rotation),\n    Math.cos(rotation),\n    0,\n    0,\n    0,\n    1\n  );\n  const scaleMatrix = scratchScaleMatrix.set(scale[0], 0, 0, 0, scale[1], 0, 0, 0, 1);\n  return translationMatrix.multiplyRight(rotationMatrix).multiplyRight(scaleMatrix);\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/gltf/lib/extensions/KHR_texture_transform.d.ts

@@ -0,0 +1,10 @@
+import type { GLTFWithBuffers } from "../types/gltf-types.js";
+import type { GLTFLoaderOptions } from "../../gltf-loader-types.js";
+export declare const name = "KHR_texture_transform";
+/**
+ * The extension entry to process the transformation
+ * @param gltfData gltf buffers and json
+ * @param options GLTFLoader options
+ */
+export declare function decode(gltfData: GLTFWithBuffers, options: GLTFLoaderOptions): Promise<void>;
+//# sourceMappingURL=KHR_texture_transform.d.ts.map

package/dist/gltf/lib/extensions/KHR_texture_transform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KHR_texture_transform.d.ts","sourceRoot":"","sources":["../../../../src/gltf/lib/extensions/KHR_texture_transform.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAC,eAAe,EAAC,+BAA4B;AAQzD,OAAO,KAAK,EAAC,iBAAiB,EAAC,mCAAgC;AAU/D,eAAO,MAAM,IAAI,0BAAwB,CAAC;AAoC1C;;;;GAIG;AACH,wBAAsB,MAAM,CAAC,QAAQ,EAAE,eAAe,EAAE,OAAO,EAAE,iBAAiB,iBAajF"}

package/dist/gltf/lib/extensions/KHR_texture_transform.js

@@ -0,0 +1,271 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright (c) vis.gl contributors
+/**
+ * https://github.com/KhronosGroup/glTF/blob/main/extensions/2.0/Khronos/KHR_texture_transform/README.md
+ */
+import { Vector3, Matrix3 } from '@math.gl/core';
+import { getAccessorArrayTypeAndLength } from "../gltf-utils/gltf-utils.js";
+import { BYTES, COMPONENTS } from "../gltf-utils/gltf-constants.js";
+import { GLTFIterator } from "../api/gltf-iterator.js";
+import { ensureArrayBuffer } from '@loaders.gl/core/loader-utils';
+/** Extension name */
+const KHR_TEXTURE_TRANSFORM = 'KHR_texture_transform';
+export const name = KHR_TEXTURE_TRANSFORM;
+const scratchVector = new Vector3();
+const scratchRotationMatrix = new Matrix3();
+const scratchScaleMatrix = new Matrix3();
+/**
+ * The extension entry to process the transformation
+ * @param gltfData gltf buffers and json
+ * @param options GLTFLoader options
+ */
+export async function decode(gltfData, options) {
+    const iterator = new GLTFIterator(gltfData);
+    const hasExtension = iterator.hasExtension(KHR_TEXTURE_TRANSFORM);
+    if (!hasExtension || !options.gltf?.loadBuffers) {
+        return;
+    }
+    const materials = gltfData.json.materials || [];
+    for (let i = 0; i < materials.length; i++) {
+        transformTexCoords(i, gltfData, iterator);
+    }
+    if (!materials.some(material => findTextureInfos(material).length > 0)) {
+        iterator.removeExtension(KHR_TEXTURE_TRANSFORM);
+    }
+}
+/**
+ * Transform TEXCOORD by material
+ * @param materialIndex processing material index
+ * @param gltfData gltf buffers and json
+ * @param gltfScenegraph glTF scenegraph used to remove decoded extensions
+ */
+function transformTexCoords(materialIndex, gltfData, iterator) {
+    const material = gltfData.json.materials?.[materialIndex];
+    const materialTextures = findTextureInfos(material);
+    const processedTransforms = new Map();
+    let nextTexCoord = getNextTexCoord(gltfData);
+    for (const textureInfo of materialTextures) {
+        const extension = textureInfo.extensions?.[KHR_TEXTURE_TRANSFORM];
+        if (extension) {
+            const sourceTexCoord = extension.texCoord ?? textureInfo.texCoord ?? 0;
+            const transformKey = getTransformKey(sourceTexCoord, extension);
+            let transformParameters = processedTransforms.get(transformKey);
+            if (!transformParameters) {
+                transformParameters = {
+                    sourceTexCoord,
+                    texCoord: nextTexCoord,
+                    matrix: makeTransformationMatrix(extension)
+                };
+                if (!transformPrimitives(gltfData, materialIndex, transformParameters)) {
+                    continue;
+                }
+                nextTexCoord++;
+                processedTransforms.set(transformKey, transformParameters);
+            }
+            textureInfo.texCoord = transformParameters.texCoord;
+            removeObjectExtension(iterator, textureInfo, KHR_TEXTURE_TRANSFORM);
+            if (textureInfo.extensions && Object.keys(textureInfo.extensions).length === 0) {
+                delete textureInfo.extensions;
+            }
+        }
+    }
+}
+/** Remove an object extension while preserving top-level extension bookkeeping. */
+function removeObjectExtension(iterator, object, extensionName) {
+    if (object.extensions?.[extensionName] !== undefined) {
+        iterator.recordRemovedExtension(extensionName);
+        delete object.extensions[extensionName];
+    }
+}
+/**
+ * Finds texture infos at any nesting level of a material, including KHR_materials_* extensions.
+ * @param value material value to inspect
+ * @returns texture infos using KHR_texture_transform
+ */
+function findTextureInfos(value) {
+    if (!value || typeof value !== 'object') {
+        return [];
+    }
+    const object = value;
+    const textureInfos = [];
+    const extensions = object.extensions;
+    if (Number.isFinite(object.index) && extensions?.[KHR_TEXTURE_TRANSFORM]) {
+        textureInfos.push(object);
+    }
+    for (const [key, nestedValue] of Object.entries(object)) {
+        if (key !== 'extras') {
+            textureInfos.push(...findTextureInfos(nestedValue));
+        }
+    }
+    return textureInfos;
+}
+/** Returns the first TEXCOORD set index unused by every primitive. */
+function getNextTexCoord(gltfData) {
+    let maximumTexCoord = -1;
+    for (const mesh of gltfData.json.meshes || []) {
+        for (const primitive of mesh.primitives) {
+            for (const attributeName of Object.keys(primitive.attributes)) {
+                const match = /^TEXCOORD_(\d+)$/.exec(attributeName);
+                if (match) {
+                    maximumTexCoord = Math.max(maximumTexCoord, Number(match[1]));
+                }
+            }
+        }
+    }
+    return maximumTexCoord + 1;
+}
+/** Returns a stable key for transformations that can share generated attributes. */
+function getTransformKey(sourceTexCoord, extension) {
+    const { offset = [0, 0], rotation = 0, scale = [1, 1] } = extension;
+    return JSON.stringify([sourceTexCoord, offset, rotation, scale]);
+}
+/**
+ * Transform primitives of the particular material.
+ * @param gltfData gltf data
+ * @param materialIndex primitives with this material will be transformed
+ * @param transformParameters source and generated texture coordinate sets
+ * @returns true when every relevant primitive received the generated attribute
+ */
+function transformPrimitives(gltfData, materialIndex, transformParameters) {
+    const primitives = [];
+    const meshes = gltfData.json.meshes || [];
+    for (const mesh of meshes) {
+        for (const primitive of mesh.primitives) {
+            const material = primitive.material;
+            if (Number.isFinite(material) && materialIndex === material) {
+                primitives.push(primitive);
+            }
+        }
+    }
+    if (primitives.length === 0 ||
+        primitives.some(primitive => !canTransformPrimitive(gltfData, primitive, transformParameters.sourceTexCoord))) {
+        return false;
+    }
+    for (const primitive of primitives) {
+        transformPrimitive(gltfData, primitive, transformParameters);
+    }
+    return true;
+}
+/** Returns whether a primitive's source texture coordinates can be transformed without data loss. */
+function canTransformPrimitive(gltfData, primitive, sourceTexCoord) {
+    const texCoordAccessor = primitive.attributes[`TEXCOORD_${sourceTexCoord}`];
+    const decodedAccessor = texCoordAccessor;
+    if (ArrayBuffer.isView(decodedAccessor?.value)) {
+        return true;
+    }
+    if (!Number.isFinite(texCoordAccessor)) {
+        return false;
+    }
+    const accessor = gltfData.json.accessors?.[texCoordAccessor];
+    if (!accessor || accessor.bufferView === undefined || accessor.sparse) {
+        return false;
+    }
+    const bufferView = gltfData.json.bufferViews?.[accessor.bufferView];
+    return Boolean(bufferView && gltfData.buffers[bufferView.buffer]);
+}
+/**
+ * Transform `TEXCOORD_0` attribute in the primitive
+ * @param gltfData gltf data
+ * @param primitive primitive object
+ * @param transformParameters texCoord couple and transformation matrix
+ */
+function transformPrimitive(gltfData, primitive, transformParameters) {
+    const { sourceTexCoord, texCoord, matrix } = transformParameters;
+    const texCoordAccessor = primitive.attributes[`TEXCOORD_${sourceTexCoord}`];
+    const decodedAccessor = texCoordAccessor;
+    if (ArrayBuffer.isView(decodedAccessor?.value)) {
+        const result = new Float32Array(decodedAccessor.count * 2);
+        for (let index = 0; index < decodedAccessor.count; index++) {
+            transformCoordinatePair(decodedAccessor.value.subarray(index * 2, index * 2 + 2), decodedAccessor, matrix, result, index * 2);
+        }
+        createAttribute(texCoord, decodedAccessor, primitive, gltfData, result);
+        return;
+    }
+    if (Number.isFinite(texCoordAccessor)) {
+        // Get accessor of the `TEXCOORD_0` attribute
+        const accessor = gltfData.json.accessors?.[texCoordAccessor];
+        if (accessor && accessor.bufferView !== undefined) {
+            // Get `bufferView` of the `accessor`
+            const bufferView = gltfData.json.bufferViews?.[accessor.bufferView];
+            if (bufferView) {
+                // Get `arrayBuffer` the `bufferView` look at
+                const { arrayBuffer, byteOffset: bufferByteOffset } = gltfData.buffers[bufferView.buffer];
+                // Resulting byteOffset is sum of the buffer, accessor and bufferView byte offsets
+                const byteOffset = (bufferByteOffset || 0) + (accessor.byteOffset || 0) + (bufferView.byteOffset || 0);
+                // Deduce TypedArray type and its length from `accessor` and `bufferView` data
+                const { ArrayType, length } = getAccessorArrayTypeAndLength(accessor, bufferView);
+                // Number of bytes each component occupies
+                const bytes = BYTES[accessor.componentType];
+                // Number of components. For the `TEXCOORD_0` with `VEC2` type, it must return 2
+                const components = COMPONENTS[accessor.type];
+                // Multiplier to calculate the address of the `TEXCOORD_0` element in the arrayBuffer
+                const elementAddressScale = bufferView.byteStride || bytes * components;
+                // Data transform to Float32Array
+                const result = new Float32Array(length);
+                for (let i = 0; i < accessor.count; i++) {
+                    // Take [u, v] couple from the arrayBuffer
+                    const uv = new ArrayType(arrayBuffer, byteOffset + i * elementAddressScale, 2);
+                    transformCoordinatePair(uv, accessor, matrix, result, i * components);
+                }
+                createAttribute(texCoord, accessor, primitive, gltfData, result);
+            }
+        }
+    }
+}
+/** Normalizes one packed UV pair and writes its transformed Float32 coordinates. */
+function transformCoordinatePair(textureCoordinates, accessor, matrix, result, offset) {
+    const signed = accessor.componentType === 5120 || accessor.componentType === 5122;
+    const divisor = 2 ** (BYTES[accessor.componentType] * 8 - (signed ? 1 : 0)) - 1;
+    scratchVector.set(accessor.normalized ? Math.max(textureCoordinates[0] / divisor, -1) : textureCoordinates[0], accessor.normalized ? Math.max(textureCoordinates[1] / divisor, -1) : textureCoordinates[1], 1);
+    scratchVector.transformByMatrix3(matrix);
+    result.set([scratchVector[0], scratchVector[1]], offset);
+}
+/**
+ *
+ * @param newTexCoord new `texCoord` value
+ * @param originalAccessor original accessor object, that store data before transformation
+ * @param primitive primitive object
+ * @param gltfData gltf data
+ * @param newTexCoordArray typed array with data after transformation
+ * @returns
+ */
+function createAttribute(newTexCoord, originalAccessor, primitive, gltfData, newTexCoordArray) {
+    gltfData.buffers.push({
+        arrayBuffer: ensureArrayBuffer(newTexCoordArray.buffer),
+        byteOffset: 0,
+        byteLength: newTexCoordArray.buffer.byteLength
+    });
+    gltfData.json.bufferViews = gltfData.json.bufferViews || [];
+    const bufferViews = gltfData.json.bufferViews;
+    bufferViews.push({
+        buffer: gltfData.buffers.length - 1,
+        byteLength: newTexCoordArray.buffer.byteLength,
+        byteOffset: 0
+    });
+    const accessors = gltfData.json.accessors;
+    if (!accessors) {
+        return;
+    }
+    accessors.push({
+        bufferView: bufferViews?.length - 1,
+        byteOffset: 0,
+        componentType: 5126,
+        count: originalAccessor.count,
+        type: 'VEC2'
+    });
+    primitive.attributes[`TEXCOORD_${newTexCoord}`] = accessors.length - 1;
+}
+/**
+ * Construct transformation matrix from the extension data (transition, rotation, scale)
+ * @param extensionData extension data
+ * @returns transformation matrix
+ */
+function makeTransformationMatrix(extensionData) {
+    const { offset = [0, 0], rotation = 0, scale = [1, 1] } = extensionData;
+    const translationMatrix = new Matrix3().set(1, 0, 0, 0, 1, 0, offset[0], offset[1], 1);
+    const rotationMatrix = scratchRotationMatrix.set(Math.cos(rotation), Math.sin(rotation), 0, -Math.sin(rotation), Math.cos(rotation), 0, 0, 0, 1);
+    const scaleMatrix = scratchScaleMatrix.set(scale[0], 0, 0, 0, scale[1], 0, 0, 0, 1);
+    return translationMatrix.multiplyRight(rotationMatrix).multiplyRight(scaleMatrix);
+}
+//# sourceMappingURL=KHR_texture_transform.js.map