@loaders.gl/3d-tiles 4.2.0-alpha.4 → 4.2.0-alpha.5

package/dist/lib/encoders/encode-3d-tile-batched-model.js

@@ -1,40 +1,45 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT AND Apache-2.0
+// Copyright vis.gl contributors
+// This file is derived from the Cesium code base under Apache 2 license
+// See LICENSE.md and https://github.com/AnalyticalGraphicsInc/cesium/blob/master/LICENSE.md
 import { padToNBytes, copyBinaryToDataView, copyPaddedStringToDataView } from '@loaders.gl/loader-utils';
 import { MAGIC_ARRAY } from "../constants.js";
 import { encode3DTileHeader, encode3DTileByteLength } from "./helpers/encode-3d-tile-header.js";
+// Procedurally encode the tile array dataView for testing purposes
 export function encodeBatchedModel3DTile(tile, dataView, byteOffset, options) {
-  const {
-    featuresLength = 0,
-    batchTable
-  } = tile;
-  const featureTableJson = {
-    BATCH_LENGTH: featuresLength
-  };
-  const featureTableJsonString = JSON.stringify(featureTableJson);
-  const batchTableJsonString = batchTable ? JSON.stringify(batchTable) : '';
-  const featureTableJsonByteLength = padToNBytes(featureTableJsonString.length, 8);
-  const batchTableJsonByteLength = batchTableJsonString ? padToNBytes(batchTableJsonString.length, 8) : 0;
-  tile = {
-    magic: MAGIC_ARRAY.BATCHED_MODEL,
-    ...tile
-  };
-  const byteOffsetStart = byteOffset;
-  byteOffset = encode3DTileHeader(tile, dataView, byteOffset);
-  if (dataView) {
-    dataView.setUint32(12, featureTableJsonByteLength, true);
-    dataView.setUint32(16, 0, true);
-    dataView.setUint32(20, batchTableJsonByteLength, true);
-    dataView.setUint32(24, 0, true);
-  }
-  byteOffset += 16;
-  byteOffset = copyPaddedStringToDataView(dataView, byteOffset, featureTableJsonString, 8);
-  if (batchTable) {
-    byteOffset = copyPaddedStringToDataView(dataView, byteOffset, batchTableJsonString, 8);
-  }
-  const gltfEncoded = tile.gltfEncoded;
-  if (gltfEncoded) {
-    byteOffset = copyBinaryToDataView(dataView, byteOffset, gltfEncoded, gltfEncoded.byteLength);
-  }
-  encode3DTileByteLength(dataView, byteOffsetStart, byteOffset - byteOffsetStart);
-  return byteOffset;
+    const { featuresLength = 0, batchTable } = tile;
+    const featureTableJson = {
+        BATCH_LENGTH: featuresLength
+    };
+    const featureTableJsonString = JSON.stringify(featureTableJson);
+    const batchTableJsonString = batchTable ? JSON.stringify(batchTable) : '';
+    const featureTableJsonByteLength = padToNBytes(featureTableJsonString.length, 8);
+    const batchTableJsonByteLength = batchTableJsonString
+        ? padToNBytes(batchTableJsonString.length, 8)
+        : 0;
+    // Add default magic for this tile type
+    tile = { magic: MAGIC_ARRAY.BATCHED_MODEL, ...tile };
+    const byteOffsetStart = byteOffset;
+    byteOffset = encode3DTileHeader(tile, dataView, byteOffset);
+    if (dataView) {
+        dataView.setUint32(12, featureTableJsonByteLength, true); // featureTableJsonByteLength
+        dataView.setUint32(16, 0, true); // featureTableBinaryByteLength
+        dataView.setUint32(20, batchTableJsonByteLength, true); // batchTableJsonByteLength
+        dataView.setUint32(24, 0, true); // batchTableBinaryByteLength
+    }
+    byteOffset += 16;
+    // TODO feature table binary
+    byteOffset = copyPaddedStringToDataView(dataView, byteOffset, featureTableJsonString, 8);
+    if (batchTable) {
+        byteOffset = copyPaddedStringToDataView(dataView, byteOffset, batchTableJsonString, 8);
+    }
+    // Add encoded GLTF to the end of data
+    const gltfEncoded = tile.gltfEncoded;
+    if (gltfEncoded) {
+        byteOffset = copyBinaryToDataView(dataView, byteOffset, gltfEncoded, gltfEncoded.byteLength);
+    }
+    // Go "back" and rewrite the tile's `byteLength` now that we know the value
+    encode3DTileByteLength(dataView, byteOffsetStart, byteOffset - byteOffsetStart);
+    return byteOffset;
 }
-//# sourceMappingURL=encode-3d-tile-batched-model.js.map

package/dist/lib/encoders/encode-3d-tile-composite.js

@@ -1,21 +1,23 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT AND Apache-2.0
+// Copyright vis.gl contributors
+// This file is derived from the Cesium code base under Apache 2 license
+// See LICENSE.md and https://github.com/AnalyticalGraphicsInc/cesium/blob/master/LICENSE.md
 import { MAGIC_ARRAY } from "../constants.js";
 import { encode3DTileHeader, encode3DTileByteLength } from "./helpers/encode-3d-tile-header.js";
 export function encodeComposite3DTile(tile, dataView, byteOffset, options, encode3DTile) {
-  tile = {
-    magic: MAGIC_ARRAY.COMPOSITE,
-    tiles: [],
-    ...tile
-  };
-  const byteOffsetStart = byteOffset;
-  byteOffset += encode3DTileHeader(tile, dataView, byteOffset);
-  if (dataView) {
-    dataView.setUint32(byteOffset, tile.tiles.length, true);
-  }
-  byteOffset += 4;
-  for (let i = 0; i < tile.tiles.length; ++i) {
-    byteOffset += encode3DTile(tile.tiles[i], dataView, byteOffset, options);
-  }
-  encode3DTileByteLength(dataView, byteOffsetStart, byteOffset - byteOffsetStart);
-  return byteOffset;
+    // Add default magic for this tile type
+    tile = { magic: MAGIC_ARRAY.COMPOSITE, tiles: [], ...tile };
+    const byteOffsetStart = byteOffset;
+    byteOffset += encode3DTileHeader(tile, dataView, byteOffset);
+    if (dataView) {
+        dataView.setUint32(byteOffset, tile.tiles.length, true); // tilesLength
+    }
+    byteOffset += 4;
+    for (let i = 0; i < tile.tiles.length; ++i) {
+        byteOffset += encode3DTile(tile.tiles[i], dataView, byteOffset, options);
+    }
+    // Go "back" and rewrite the tile's `byteLength` now that we know the value
+    encode3DTileByteLength(dataView, byteOffsetStart, byteOffset - byteOffsetStart);
+    return byteOffset;
 }
-//# sourceMappingURL=encode-3d-tile-composite.js.map

package/dist/lib/encoders/encode-3d-tile-instanced-model.js

@@ -1,36 +1,37 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT AND Apache-2.0
+// Copyright vis.gl contributors
+// This file is derived from the Cesium code base under Apache 2 license
+// See LICENSE.md and https://github.com/AnalyticalGraphicsInc/cesium/blob/master/LICENSE.md
 import { copyStringToDataView } from '@loaders.gl/loader-utils';
 import { MAGIC_ARRAY } from "../constants.js";
 import { encode3DTileHeader, encode3DTileByteLength } from "./helpers/encode-3d-tile-header.js";
+// Procedurally encode the tile array buffer for testing purposes
+// eslint-disable-next-line max-statements
 export function encodeInstancedModel3DTile(tile, dataView, byteOffset, options) {
-  const {
-    featuresLength = 1,
-    gltfFormat = 1,
-    gltfUri = ''
-  } = tile;
-  const gltfUriByteLength = gltfUri.length;
-  const featureTableJson = {
-    INSTANCES_LENGTH: featuresLength,
-    POSITION: new Array(featuresLength * 3).fill(0)
-  };
-  const featureTableJsonString = JSON.stringify(featureTableJson);
-  const featureTableJsonByteLength = featureTableJsonString.length;
-  tile = {
-    magic: MAGIC_ARRAY.INSTANCED_MODEL,
-    ...tile
-  };
-  const byteOffsetStart = byteOffset;
-  byteOffset = encode3DTileHeader(tile, dataView, 0);
-  if (dataView) {
-    dataView.setUint32(12, featureTableJsonByteLength, true);
-    dataView.setUint32(16, 0, true);
-    dataView.setUint32(20, 0, true);
-    dataView.setUint32(24, 0, true);
-    dataView.setUint32(28, gltfFormat, true);
-  }
-  byteOffset += 20;
-  byteOffset += copyStringToDataView(dataView, byteOffset, featureTableJsonString, featureTableJsonByteLength);
-  byteOffset += copyStringToDataView(dataView, byteOffset, gltfUri, gltfUriByteLength);
-  encode3DTileByteLength(dataView, byteOffsetStart, byteOffset - byteOffsetStart);
-  return byteOffset;
+    const { featuresLength = 1, gltfFormat = 1, gltfUri = '' } = tile;
+    const gltfUriByteLength = gltfUri.length;
+    const featureTableJson = {
+        INSTANCES_LENGTH: featuresLength,
+        POSITION: new Array(featuresLength * 3).fill(0)
+    };
+    const featureTableJsonString = JSON.stringify(featureTableJson);
+    const featureTableJsonByteLength = featureTableJsonString.length;
+    // Add default magic for this tile type
+    tile = { magic: MAGIC_ARRAY.INSTANCED_MODEL, ...tile };
+    const byteOffsetStart = byteOffset;
+    byteOffset = encode3DTileHeader(tile, dataView, 0);
+    if (dataView) {
+        dataView.setUint32(12, featureTableJsonByteLength, true); // featureTableJsonByteLength
+        dataView.setUint32(16, 0, true); // featureTableBinaryByteLength
+        dataView.setUint32(20, 0, true); // batchTableJsonByteLength
+        dataView.setUint32(24, 0, true); // batchTableBinaryByteLength
+        dataView.setUint32(28, gltfFormat, true); // gltfFormat
+    }
+    byteOffset += 20;
+    byteOffset += copyStringToDataView(dataView, byteOffset, featureTableJsonString, featureTableJsonByteLength);
+    byteOffset += copyStringToDataView(dataView, byteOffset, gltfUri, gltfUriByteLength);
+    // Go "back" and rewrite the tile's `byteLength` now that we know the value
+    encode3DTileByteLength(dataView, byteOffsetStart, byteOffset - byteOffsetStart);
+    return byteOffset;
 }
-//# sourceMappingURL=encode-3d-tile-instanced-model.js.map

package/dist/lib/encoders/encode-3d-tile-point-cloud.js

@@ -1,39 +1,38 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT AND Apache-2.0
+// Copyright vis.gl contributors
+// This file is derived from the Cesium code base under Apache 2 license
+// See LICENSE.md and https://github.com/AnalyticalGraphicsInc/cesium/blob/master/LICENSE.md
 import { MAGIC_ARRAY } from "../constants.js";
 import { encode3DTileHeader, encode3DTileByteLength } from "./helpers/encode-3d-tile-header.js";
 import { padStringToByteAlignment, copyStringToDataView, copyBinaryToDataView } from '@loaders.gl/loader-utils';
 const DEFAULT_FEATURE_TABLE_JSON = {
-  POINTS_LENGTH: 1,
-  POSITIONS: {
-    byteOffset: 0
-  }
+    POINTS_LENGTH: 1,
+    POSITIONS: {
+        byteOffset: 0
+    }
 };
 export function encodePointCloud3DTile(tile, dataView, byteOffset, options) {
-  const {
-    featureTableJson = DEFAULT_FEATURE_TABLE_JSON
-  } = tile;
-  let featureTableJsonString = JSON.stringify(featureTableJson);
-  featureTableJsonString = padStringToByteAlignment(featureTableJsonString, 4);
-  const {
-    featureTableJsonByteLength = featureTableJsonString.length
-  } = tile;
-  const featureTableBinary = new ArrayBuffer(12);
-  const featureTableBinaryByteLength = featureTableBinary.byteLength;
-  tile = {
-    magic: MAGIC_ARRAY.POINT_CLOUD,
-    ...tile
-  };
-  const byteOffsetStart = byteOffset;
-  byteOffset += encode3DTileHeader(tile, dataView, 0);
-  if (dataView) {
-    dataView.setUint32(byteOffset + 0, featureTableJsonByteLength, true);
-    dataView.setUint32(byteOffset + 4, featureTableBinaryByteLength, true);
-    dataView.setUint32(byteOffset + 8, 0, true);
-    dataView.setUint32(byteOffset + 12, 0, true);
-  }
-  byteOffset += 16;
-  byteOffset += copyStringToDataView(dataView, byteOffset, featureTableJsonString, featureTableJsonByteLength);
-  byteOffset += copyBinaryToDataView(dataView, byteOffset, featureTableBinary, featureTableBinaryByteLength);
-  encode3DTileByteLength(dataView, byteOffsetStart, byteOffset - byteOffsetStart);
-  return byteOffset;
+    const { featureTableJson = DEFAULT_FEATURE_TABLE_JSON } = tile;
+    let featureTableJsonString = JSON.stringify(featureTableJson);
+    featureTableJsonString = padStringToByteAlignment(featureTableJsonString, 4);
+    const { featureTableJsonByteLength = featureTableJsonString.length } = tile;
+    const featureTableBinary = new ArrayBuffer(12); // Enough space to hold 3 floats
+    const featureTableBinaryByteLength = featureTableBinary.byteLength;
+    // Add default magic for this tile type
+    tile = { magic: MAGIC_ARRAY.POINT_CLOUD, ...tile };
+    const byteOffsetStart = byteOffset;
+    byteOffset += encode3DTileHeader(tile, dataView, 0);
+    if (dataView) {
+        dataView.setUint32(byteOffset + 0, featureTableJsonByteLength, true); // featureTableJsonByteLength
+        dataView.setUint32(byteOffset + 4, featureTableBinaryByteLength, true); // featureTableBinaryByteLength
+        dataView.setUint32(byteOffset + 8, 0, true); // batchTableJsonByteLength
+        dataView.setUint32(byteOffset + 12, 0, true); // batchTableBinaryByteLength
+    }
+    byteOffset += 16;
+    byteOffset += copyStringToDataView(dataView, byteOffset, featureTableJsonString, featureTableJsonByteLength);
+    byteOffset += copyBinaryToDataView(dataView, byteOffset, featureTableBinary, featureTableBinaryByteLength);
+    // Go "back" and rewrite the tile's `byteLength` now that we know the value
+    encode3DTileByteLength(dataView, byteOffsetStart, byteOffset - byteOffsetStart);
+    return byteOffset;
 }
-//# sourceMappingURL=encode-3d-tile-point-cloud.js.map

package/dist/lib/encoders/encode-3d-tile.js

@@ -1,3 +1,8 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT AND Apache-2.0
+// Copyright vis.gl contributors
+// This file is derived from the Cesium code base under Apache 2 license
+// See LICENSE.md and https://github.com/AnalyticalGraphicsInc/cesium/blob/master/LICENSE.md
 import { TILE3D_TYPE } from "../constants.js";
 import { assert } from '@loaders.gl/loader-utils';
 import { encodeComposite3DTile } from "./encode-3d-tile-composite.js";
@@ -5,25 +10,24 @@ import { encodeBatchedModel3DTile } from "./encode-3d-tile-batched-model.js";
 import { encodeInstancedModel3DTile } from "./encode-3d-tile-instanced-model.js";
 import { encodePointCloud3DTile } from "./encode-3d-tile-point-cloud.js";
 export default function encode3DTile(tile, options) {
-  const byteLength = encode3DTileToDataView(tile, null, 0, options);
-  const arrayBuffer = new ArrayBuffer(byteLength);
-  const dataView = new DataView(arrayBuffer);
-  encode3DTileToDataView(tile, dataView, 0, options);
-  return arrayBuffer;
+    const byteLength = encode3DTileToDataView(tile, null, 0, options);
+    const arrayBuffer = new ArrayBuffer(byteLength);
+    const dataView = new DataView(arrayBuffer);
+    encode3DTileToDataView(tile, dataView, 0, options);
+    return arrayBuffer;
 }
 function encode3DTileToDataView(tile, dataView, byteOffset, options) {
-  assert(typeof tile.type === 'string');
-  switch (tile.type) {
-    case TILE3D_TYPE.COMPOSITE:
-      return encodeComposite3DTile(tile, dataView, byteOffset, options, encode3DTileToDataView);
-    case TILE3D_TYPE.POINT_CLOUD:
-      return encodePointCloud3DTile(tile, dataView, byteOffset, options);
-    case TILE3D_TYPE.BATCHED_3D_MODEL:
-      return encodeBatchedModel3DTile(tile, dataView, byteOffset, options);
-    case TILE3D_TYPE.INSTANCED_3D_MODEL:
-      return encodeInstancedModel3DTile(tile, dataView, byteOffset, options);
-    default:
-      throw new Error('3D Tiles: unknown tile type');
-  }
+    assert(typeof tile.type === 'string');
+    switch (tile.type) {
+        case TILE3D_TYPE.COMPOSITE:
+            return encodeComposite3DTile(tile, dataView, byteOffset, options, encode3DTileToDataView);
+        case TILE3D_TYPE.POINT_CLOUD:
+            return encodePointCloud3DTile(tile, dataView, byteOffset, options);
+        case TILE3D_TYPE.BATCHED_3D_MODEL:
+            return encodeBatchedModel3DTile(tile, dataView, byteOffset, options);
+        case TILE3D_TYPE.INSTANCED_3D_MODEL:
+            return encodeInstancedModel3DTile(tile, dataView, byteOffset, options);
+        default:
+            throw new Error('3D Tiles: unknown tile type');
+    }
 }
-//# sourceMappingURL=encode-3d-tile.js.map

package/dist/lib/encoders/helpers/encode-3d-tile-header.js

@@ -1,28 +1,28 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright vis.gl contributors
+// HELPER ENCODERS
 import { assert } from '@loaders.gl/loader-utils';
 export function encode3DTileHeader(tile, dataView, byteOffset) {
-  const HEADER_SIZE = 12;
-  if (!dataView) {
-    return byteOffset + HEADER_SIZE;
-  }
-  const {
-    magic,
-    version = 1,
-    byteLength = 12
-  } = tile;
-  assert(Array.isArray(magic) && Number.isFinite(version) && Number.isFinite(byteLength));
-  dataView.setUint8(byteOffset + 0, magic[0]);
-  dataView.setUint8(byteOffset + 1, magic[1]);
-  dataView.setUint8(byteOffset + 2, magic[2]);
-  dataView.setUint8(byteOffset + 3, magic[3]);
-  dataView.setUint32(byteOffset + 4, version, true);
-  dataView.setUint32(byteOffset + 8, byteLength, true);
-  byteOffset += HEADER_SIZE;
-  return byteOffset;
+    const HEADER_SIZE = 12;
+    if (!dataView) {
+        return byteOffset + HEADER_SIZE;
+    }
+    const { magic, version = 1, byteLength = 12 } = tile;
+    assert(Array.isArray(magic) && Number.isFinite(version) && Number.isFinite(byteLength));
+    dataView.setUint8(byteOffset + 0, magic[0]);
+    dataView.setUint8(byteOffset + 1, magic[1]);
+    dataView.setUint8(byteOffset + 2, magic[2]);
+    dataView.setUint8(byteOffset + 3, magic[3]);
+    dataView.setUint32(byteOffset + 4, version, true); // version
+    dataView.setUint32(byteOffset + 8, byteLength, true); // byteLength
+    byteOffset += HEADER_SIZE;
+    return byteOffset;
 }
+// Bytelength is sometimes only known at the end of writing a tile
 export function encode3DTileByteLength(dataView, byteOffsetTileStart, byteLength) {
-  if (!dataView) {
-    return;
-  }
-  dataView.setUint32(byteOffsetTileStart + 8, byteLength, true);
+    if (!dataView) {
+        return;
+    }
+    dataView.setUint32(byteOffsetTileStart + 8, byteLength, true); // byteLength
 }
-//# sourceMappingURL=encode-3d-tile-header.js.map

package/dist/lib/ion/ion.js

@@ -1,64 +1,65 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright vis.gl contributors
+// Minimal support to load tilsets from the Cesium ION services
 import { fetchFile } from '@loaders.gl/core';
 import { assert } from '@loaders.gl/loader-utils';
 const CESIUM_ION_URL = 'https://api.cesium.com/v1/assets';
+// Returns `{url, headers, type, attributions}` for an ion tileset
 export async function getIonTilesetMetadata(accessToken, assetId) {
-  if (!assetId) {
-    const assets = await getIonAssets(accessToken);
-    for (const item of assets.items) {
-      if (item.type === '3DTILES') {
-        assetId = item.id;
-      }
+    // Step 1, if no asset id, look for first 3DTILES asset associated with this token.
+    if (!assetId) {
+        const assets = await getIonAssets(accessToken);
+        for (const item of assets.items) {
+            if (item.type === '3DTILES') {
+                assetId = item.id;
+            }
+        }
     }
-  }
-  const ionAssetMetadata = await getIonAssetMetadata(accessToken, assetId);
-  const {
-    type,
-    url
-  } = ionAssetMetadata;
-  assert(type === '3DTILES' && url);
-  ionAssetMetadata.headers = {
-    Authorization: `Bearer ${ionAssetMetadata.accessToken}`
-  };
-  return ionAssetMetadata;
+    // Step 2: Query metdatadata for this asset.
+    const ionAssetMetadata = await getIonAssetMetadata(accessToken, assetId);
+    const { type, url } = ionAssetMetadata;
+    assert(type === '3DTILES' && url);
+    // Prepare a headers object for fetch
+    ionAssetMetadata.headers = {
+        Authorization: `Bearer ${ionAssetMetadata.accessToken}`
+    };
+    return ionAssetMetadata;
 }
+// Return a list of all assets associated with accessToken
 export async function getIonAssets(accessToken) {
-  assert(accessToken);
-  const url = CESIUM_ION_URL;
-  const headers = {
-    Authorization: `Bearer ${accessToken}`
-  };
-  const response = await fetchFile(url, {
-    headers
-  });
-  if (!response.ok) {
-    throw new Error(response.statusText);
-  }
-  return await response.json();
+    assert(accessToken);
+    const url = CESIUM_ION_URL;
+    const headers = { Authorization: `Bearer ${accessToken}` };
+    const response = await fetchFile(url, { headers });
+    if (!response.ok) {
+        throw new Error(response.statusText);
+    }
+    return await response.json();
 }
+// Return metadata for a specific asset associated with token
 export async function getIonAssetMetadata(accessToken, assetId) {
-  assert(accessToken, assetId);
-  const headers = {
-    Authorization: `Bearer ${accessToken}`
-  };
-  const url = `${CESIUM_ION_URL}/${assetId}`;
-  let response = await fetchFile(`${url}`, {
-    headers
-  });
-  if (!response.ok) {
-    throw new Error(response.statusText);
-  }
-  let metadata = await response.json();
-  response = await fetchFile(`${url}/endpoint`, {
-    headers
-  });
-  if (!response.ok) {
-    throw new Error(response.statusText);
-  }
-  const tilesetInfo = await response.json();
-  metadata = {
-    ...metadata,
-    ...tilesetInfo
-  };
-  return metadata;
+    assert(accessToken, assetId);
+    const headers = { Authorization: `Bearer ${accessToken}` };
+    const url = `${CESIUM_ION_URL}/${assetId}`;
+    // https://cesium.com/docs/rest-api/#operation/getAsset
+    // Retrieves metadata information about a specific asset.
+    let response = await fetchFile(`${url}`, { headers });
+    if (!response.ok) {
+        throw new Error(response.statusText);
+    }
+    let metadata = await response.json();
+    // https://cesium.com/docs/rest-api/#operation/getAssetEndpoint
+    // Retrieves information and credentials that allow you to access the tiled asset data for visualization and analysis.
+    response = await fetchFile(`${url}/endpoint`, { headers });
+    if (!response.ok) {
+        throw new Error(response.statusText);
+    }
+    const tilesetInfo = await response.json();
+    // extract dataset description
+    metadata = {
+        ...metadata,
+        ...tilesetInfo
+    };
+    return metadata;
 }
-//# sourceMappingURL=ion.js.map

package/dist/lib/parsers/helpers/normalize-3d-tile-colors.d.ts

@@ -1,5 +1,5 @@
 import { Tile3DBatchTable } from '@loaders.gl/3d-tiles';
-import { Tiles3DTileContent } from '../../../types';
+import { Tiles3DTileContent } from "../../../types.js";
 export declare function normalize3DTileColorAttribute(tile: Tiles3DTileContent, colors: Uint8ClampedArray | null, batchTable?: Tile3DBatchTable): {
     type: number;
     value: Uint8ClampedArray;

package/dist/lib/parsers/helpers/normalize-3d-tile-colors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalize-3d-tile-colors.d.ts","sourceRoot":"","sources":["../../../../src/lib/parsers/helpers/normalize-3d-tile-colors.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAC,kBAAkB,EAAC,MAAM,gBAAgB,CAAC;AAGlD,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,iBAAiB,GAAG,IAAI,EAChC,UAAU,CAAC,EAAE,gBAAgB,GAC5B;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAC,GAAG,IAAI,CA6DpF"}
+{"version":3,"file":"normalize-3d-tile-colors.d.ts","sourceRoot":"","sources":["../../../../src/lib/parsers/helpers/normalize-3d-tile-colors.ts"],"names":[],"mappings":"AAIA,OAAO,EAAC,gBAAgB,EAAC,MAAM,sBAAsB,CAAC;AAEtD,OAAO,EAAC,kBAAkB,EAAC,0BAAuB;AAGlD,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,kBAAkB,EACxB,MAAM,EAAE,iBAAiB,GAAG,IAAI,EAChC,UAAU,CAAC,EAAE,gBAAgB,GAC5B;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,OAAO,CAAA;CAAC,GAAG,IAAI,CA6DpF"}

package/dist/lib/parsers/helpers/normalize-3d-tile-colors.js

@@ -1,58 +1,64 @@
+// loaders.gl
+// SPDX-License-Identifier: MIT
+// Copyright vis.gl contributors
 import { decodeRGB565, GL } from '@loaders.gl/math';
+/* eslint-disable complexity*/
 export function normalize3DTileColorAttribute(tile, colors, batchTable) {
-  if (!colors && (!tile || !tile.batchIds || !batchTable)) {
-    return null;
-  }
-  const {
-    batchIds,
-    isRGB565,
-    pointCount = 0
-  } = tile;
-  if (batchIds && batchTable) {
-    const colorArray = new Uint8ClampedArray(pointCount * 3);
-    for (let i = 0; i < pointCount; i++) {
-      const batchId = batchIds[i];
-      const dimensions = batchTable.getProperty(batchId, 'dimensions');
-      const color = dimensions.map(d => d * 255);
-      colorArray[i * 3] = color[0];
-      colorArray[i * 3 + 1] = color[1];
-      colorArray[i * 3 + 2] = color[2];
+    // no colors defined
+    if (!colors && (!tile || !tile.batchIds || !batchTable)) {
+        return null;
     }
-    return {
-      type: GL.UNSIGNED_BYTE,
-      value: colorArray,
-      size: 3,
-      normalized: true
-    };
-  }
-  if (colors && isRGB565) {
-    const colorArray = new Uint8ClampedArray(pointCount * 3);
-    for (let i = 0; i < pointCount; i++) {
-      const color = decodeRGB565(colors[i]);
-      colorArray[i * 3] = color[0];
-      colorArray[i * 3 + 1] = color[1];
-      colorArray[i * 3 + 2] = color[2];
+    const { batchIds, isRGB565, pointCount = 0 } = tile;
+    // Batch table, look up colors in table
+    if (batchIds && batchTable) {
+        const colorArray = new Uint8ClampedArray(pointCount * 3);
+        for (let i = 0; i < pointCount; i++) {
+            const batchId = batchIds[i];
+            // TODO figure out what is `dimensions` used for
+            const dimensions = batchTable.getProperty(batchId, 'dimensions');
+            const color = dimensions.map((d) => d * 255);
+            colorArray[i * 3] = color[0];
+            colorArray[i * 3 + 1] = color[1];
+            colorArray[i * 3 + 2] = color[2];
+        }
+        return {
+            type: GL.UNSIGNED_BYTE,
+            value: colorArray,
+            size: 3,
+            normalized: true
+        };
     }
+    // RGB565 case, convert to RGB
+    if (colors && isRGB565) {
+        const colorArray = new Uint8ClampedArray(pointCount * 3);
+        for (let i = 0; i < pointCount; i++) {
+            const color = decodeRGB565(colors[i]);
+            colorArray[i * 3] = color[0];
+            colorArray[i * 3 + 1] = color[1];
+            colorArray[i * 3 + 2] = color[2];
+        }
+        return {
+            type: GL.UNSIGNED_BYTE,
+            value: colorArray,
+            size: 3,
+            normalized: true
+        };
+    }
+    // RGB case (tile.isTranslucent)
+    if (colors && colors.length === pointCount * 3) {
+        return {
+            type: GL.UNSIGNED_BYTE,
+            value: colors,
+            size: 3,
+            normalized: true
+        };
+    }
+    // DEFAULT: RGBA case
     return {
-      type: GL.UNSIGNED_BYTE,
-      value: colorArray,
-      size: 3,
-      normalized: true
-    };
-  }
-  if (colors && colors.length === pointCount * 3) {
-    return {
-      type: GL.UNSIGNED_BYTE,
-      value: colors,
-      size: 3,
-      normalized: true
+        type: GL.UNSIGNED_BYTE,
+        value: colors || new Uint8ClampedArray(),
+        size: 4,
+        normalized: true
     };
-  }
-  return {
-    type: GL.UNSIGNED_BYTE,
-    value: colors || new Uint8ClampedArray(),
-    size: 4,
-    normalized: true
-  };
 }
-//# sourceMappingURL=normalize-3d-tile-colors.js.map
+/* eslint-enable complexity*/

package/dist/lib/parsers/helpers/normalize-3d-tile-normals.d.ts

@@ -1,4 +1,4 @@
-import { Tiles3DTileContent } from '../../../types';
+import { Tiles3DTileContent } from "../../../types.js";
 export declare function normalize3DTileNormalAttribute(tile: Tiles3DTileContent, normals: Float32Array | null): {
     type: number;
     size: number;

package/dist/lib/parsers/helpers/normalize-3d-tile-normals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalize-3d-tile-normals.d.ts","sourceRoot":"","sources":["../../../../src/lib/parsers/helpers/normalize-3d-tile-normals.ts"],"names":[],"mappings":"AAMA,OAAO,EAAC,kBAAkB,EAAC,MAAM,gBAAgB,CAAC;AAIlD,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,kBAAkB,EACxB,OAAO,EAAE,YAAY,GAAG,IAAI,GAC3B;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAC,GAAG,IAAI,CAyB1D"}
+{"version":3,"file":"normalize-3d-tile-normals.d.ts","sourceRoot":"","sources":["../../../../src/lib/parsers/helpers/normalize-3d-tile-normals.ts"],"names":[],"mappings":"AAMA,OAAO,EAAC,kBAAkB,EAAC,0BAAuB;AAIlD,wBAAgB,8BAA8B,CAC5C,IAAI,EAAE,kBAAkB,EACxB,OAAO,EAAE,YAAY,GAAG,IAAI,GAC3B;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,YAAY,CAAA;CAAC,GAAG,IAAI,CAyB1D"}