@loaders.gl/3d-tiles 4.0.0-alpha.1 → 4.0.0-alpha.11

package/dist/types.d.ts

@@ -0,0 +1,335 @@
+import type { GLTFPostprocessed } from '@loaders.gl/gltf';
+import { LoaderWithParser } from '@loaders.gl/loader-utils';
+import { Matrix4, Vector3 } from '@math.gl/core';
+import { TILESET_TYPE, LOD_METRIC_TYPE, TILE_TYPE, TILE_REFINEMENT } from '@loaders.gl/tiles';
+export type FeatureTableJson = {
+    [key: string]: any[];
+};
+export type B3DMContent = {
+    batchTableJson?: FeatureTableJson;
+    byteLength: number;
+    byteOffset: number;
+    cartesianModelMatrix: Matrix4;
+    cartesianOrigin: Vector3;
+    cartographicModelMatrix: Matrix4;
+    cartographicOrigin: Vector3;
+    featureIds?: number[] | null;
+    featureTableBinary?: Uint8Array;
+    featureTableJson?: FeatureTableJson;
+    gltf?: GLTFPostprocessed;
+    gltfUpAxis: string;
+    header: GLTFHeader;
+    magic: number;
+    modelMatrix: Matrix4;
+    rotateYtoZ: boolean;
+    rtcCenter: [number, number, number];
+    type: string;
+    version: number;
+};
+export type GLTFHeader = {
+    batchLength?: number;
+    batchTableBinaryByteLength: number;
+    batchTableJsonByteLength: number;
+    featureTableBinaryByteLength: number;
+    featureTableJsonByteLength: number;
+};
+/**
+ * A 3D Tiles tileset JSON
+ * https://github.com/CesiumGS/3d-tiles/tree/main/specification#property-reference
+ */
+export type Tiles3DTilesetJSON = {
+    /** Metadata about the entire tileset.
+     * https://github.com/CesiumGS/3d-tiles/tree/main/specification#asset
+     */
+    asset: {
+        /** The 3D Tiles version. The version defines the JSON schema for the tileset JSON and the base set of tile formats. */
+        version: string;
+        /** Application-specific version of this tileset, e.g., for when an existing tileset is updated. */
+        tilesetVersion?: string;
+        /** Dictionary object with extension-specific objects. */
+        extensions?: object;
+        /** Application-specific data. */
+        extras?: any;
+        /** Not mentioned in 1.0 spec but some tilesets contain this option */
+        gltfUpAxis?: string;
+    };
+    /** A dictionary object of metadata about per-feature properties. */
+    properties?: Record<string, TilesetProperty>;
+    /** The error, in meters, introduced if this tileset is not rendered. At runtime, the geometric error is used to compute screen space error (SSE), i.e., the error measured in pixels. */
+    geometricError: number;
+    /** A tile in a 3D Tiles tileset. */
+    root: Tiles3DTileJSON;
+    /** Names of 3D Tiles extensions used somewhere in this tileset. */
+    extensionsUsed?: string[];
+    /** Names of 3D Tiles extensions required to properly load this tileset. */
+    extensionsRequired?: string[];
+    /** Dictionary object with extension-specific objects. */
+    extensions?: object;
+    /** Application-specific data. */
+    extras?: any;
+};
+/** TilesetJSON postprocessed by Tiles3DLoader */
+export type Tiles3DTilesetJSONPostprocessed = Omit<Tiles3DTilesetJSON, 'root'> & {
+    /**
+     * Loader used
+     * @deprecated
+     */
+    loader: LoaderWithParser;
+    /** URL used to load a tileset resource */
+    url: string;
+    /** HTTP request query string */
+    queryString: string;
+    /** base path that non-absolute paths in tileset are relative to. */
+    basePath: string;
+    /** tileset type */
+    type: TILESET_TYPE.TILES3D;
+    /** LOD metric type */
+    lodMetricType: LOD_METRIC_TYPE.GEOMETRIC_ERROR;
+    /** LOD metric value */
+    lodMetricValue: number;
+    /** Postprocessed root */
+    root: Tiles3DTileJSONPostprocessed;
+};
+/**
+ * A tile in a 3D Tiles tileset.
+ * https://github.com/CesiumGS/3d-tiles/tree/main/specification#tile
+ */
+export type Tiles3DTileJSON = {
+    /** A bounding volume that encloses a tile or its content. */
+    boundingVolume: Tile3DBoundingVolume;
+    /** A bounding volume that encloses a tile or its content. */
+    viewerRequestVolume?: object;
+    /** The error, in meters, introduced if this tile is rendered and its children are not. At runtime, the geometric error is used to compute screen space error (SSE), i.e., the error measured in pixels. */
+    geometricError: number;
+    /**
+     * Specifies if additive or replacement refinement is used when traversing the tileset for rendering. This property is required for the root tile of a tileset; it is optional for all other tiles.
+     * The default is to inherit from the parent tile.
+     */
+    refine?: string;
+    /** A floating-point 4x4 affine transformation matrix, stored in column-major order, that transforms the tile's content */
+    transform?: number[];
+    /** Metadata about the tile's content and a link to the content. */
+    content?: Tiles3DTileContentJSON;
+    /** An array of objects that define child tiles. */
+    children: Tiles3DTileJSON[];
+    /** Dictionary object with extension-specific objects. */
+    extensions?: object;
+    /** Application-specific data. */
+    extras?: any;
+    /** 3DTiles v1.1 properties
+     * https://github.com/CesiumGS/3d-tiles/blob/draft-1.1/specification/schema/tile.schema.json
+     */
+    /** This object allows a tile to be implicitly subdivided. Tile and content availability and metadata is stored in subtrees which are referenced externally. */
+    implicitTiling?: ImplicitTilingData;
+};
+export type Tiles3DTileJSONPostprocessed = Omit<Tiles3DTileJSON, 'refine' | 'children'> & {
+    /** Unique ID */
+    id?: string;
+    /** Content full URL */
+    contentUrl?: string;
+    /** LOD metric type */
+    lodMetricType?: LOD_METRIC_TYPE.GEOMETRIC_ERROR;
+    /** LOD metric value */
+    lodMetricValue?: number;
+    /** Duplicate of transform */
+    transformMatrix?: number[];
+    /** Type of tile */
+    type?: TILE_TYPE | string;
+    /**
+     * Specifies if additive or replacement refinement is used when traversing the tileset for rendering. This property is required for the root tile of a tileset; it is optional for all other tiles.
+     * The default is to inherit from the parent tile.
+     */
+    refine?: TILE_REFINEMENT | string;
+    /** An array of objects that define child tiles. */
+    children: Tiles3DTileJSONPostprocessed[];
+};
+/** Metadata about the tile's content and a link to the content. */
+export type Tiles3DTileContentJSON = {
+    /** A uri that points to the tile's content. When the uri is relative, it is relative to the referring tileset JSON file. */
+    uri: string;
+    /** url doesn't allign the spec but we support it same way as uri */
+    url?: string;
+    /** A bounding volume that encloses a tile or its content. At least one bounding volume property is required. Bounding volumes include box, region, or sphere. */
+    boundingVolume?: Tile3DBoundingVolume;
+    /** Dictionary object with extension-specific objects. */
+    extensions?: object;
+    /** Application-specific data. */
+    extras?: any;
+};
+/** A bounding volume that encloses a tile or its content.
+ * https://github.com/CesiumGS/3d-tiles/tree/main/specification#bounding-volume
+ */
+export type Tile3DBoundingVolume = {
+    /** An array of 12 numbers that define an oriented bounding box. The first three elements define the x, y, and z values for the center of the box.
+     * The next three elements (with indices 3, 4, and 5) define the x axis direction and half-length. The next three elements (indices 6, 7, and 8) define
+     * the y axis direction and half-length. The last three elements (indices 9, 10, and 11) define the z axis direction and half-length. */
+    box?: number[];
+    /** An array of four numbers that define a bounding sphere. The first three elements define the x, y, and z values for the center of the sphere.
+     * The last element (with index 3) defines the radius in meters. */
+    sphere?: number[];
+    /** An array of six numbers that define a bounding geographic region in EPSG:4979 coordinates with the order [west, south, east, north, minimum height, maximum height].
+     * Longitudes and latitudes are in radians, and heights are in meters above (or below) the WGS84 ellipsoid. */
+    region?: number[];
+    /** Dictionary object with extension-specific objects. */
+    extensions?: object;
+    /** Application-specific data. */
+    extras?: any;
+};
+/**
+ * A dictionary object of metadata about per-feature properties.
+ * https://github.com/CesiumGS/3d-tiles/tree/main/specification#properties
+ */
+export type TilesetProperty = {
+    /** The maximum value of this property of all the features in the tileset. */
+    maximum: number;
+    /** The minimum value of this property of all the features in the tileset. */
+    minimum: number;
+    /** Dictionary object with extension-specific objects. */
+    extensions?: object;
+    /** Application-specific data. */
+    extras?: any;
+};
+export type Tiles3DTileContent = {
+    /** Common properties */
+    byteOffset?: number;
+    type?: string;
+    featureIds?: null;
+    /** 3DTile header */
+    magic?: number;
+    version?: number;
+    byteLength?: number;
+    /** 3DTile tables header */
+    header?: {
+        featureTableJsonByteLength?: number;
+        featureTableBinaryByteLength?: number;
+        batchTableJsonByteLength?: number;
+        batchTableBinaryByteLength?: number;
+        batchLength?: number;
+    };
+    /** 3DTile tables */
+    featureTableJson?: {
+        BATCH_LENGTH?: number;
+    } | Record<string, any>;
+    featureTableBinary?: Uint8Array;
+    batchTableJson?: Record<string, (string | number)[]>;
+    batchTableBinary?: Uint8Array;
+    rtcCenter?: number[];
+    /** 3DTile glTF */
+    gltfArrayBuffer?: ArrayBuffer;
+    gltfByteOffset?: number;
+    gltfByteLength?: number;
+    rotateYtoZ?: boolean;
+    gltfUpAxis?: 'x' | 'X' | 'y' | 'Y' | 'z' | 'Z';
+    gltfUrl?: string;
+    gpuMemoryUsageInBytes?: number;
+    gltf?: GLTFPostprocessed;
+    /** For Composite tiles */
+    tilesLength?: number;
+    tiles?: Tiles3DTileContent[];
+    /** For Instances model and Pointcloud tiles */
+    featuresLength?: number;
+    /** For Instanced model tiles */
+    gltfFormat?: number;
+    eastNorthUp?: boolean;
+    normalUp?: number[];
+    normalRight?: number[];
+    hasCustomOrientation?: boolean;
+    octNormalUp?: number[];
+    octNormalRight?: number[];
+    instances?: {
+        modelMatrix: Matrix4;
+        batchId: number;
+    }[];
+    /** For Pointcloud tiles */
+    attributes?: {
+        positions: null | number[];
+        colors: null | number[] | {
+            type: number;
+            value: Uint8ClampedArray;
+            size: number;
+            normalized: boolean;
+        };
+        normals: null | number[] | {
+            type: number;
+            size: number;
+            value: Float32Array;
+        };
+        batchIds: null | number[];
+    };
+    constantRGBA?: number[];
+    isQuantized?: boolean;
+    isTranslucent?: boolean;
+    isRGB565?: boolean;
+    isOctEncoded16P?: boolean;
+    pointsLength?: number;
+    pointCount?: number;
+    batchIds?: number[];
+    hasPositions?: boolean;
+    hasColors?: boolean;
+    hasNormals?: boolean;
+    hasBatchIds?: boolean;
+    quantizedVolumeScale?: Vector3;
+    quantizedVolumeOffset?: Vector3;
+    quantizedRange?: number;
+    isQuantizedDraco?: boolean;
+    octEncodedRange?: number;
+    isOctEncodedDraco?: boolean;
+};
+/**
+ * 3DTILES_implicit_tiling types
+ * Spec - https://github.com/CesiumGS/3d-tiles/tree/main/extensions/3DTILES_implicit_tiling#subtree-file-format
+ */
+export type Subtree = {
+    buffers: Buffer[];
+    bufferViews: BufferView[];
+    tileAvailability: Availability;
+    contentAvailability: Availability;
+    childSubtreeAvailability: Availability;
+};
+export type Availability = {
+    constant?: 0 | 1;
+    bufferView?: number;
+    explicitBitstream?: ExplicitBitstream;
+};
+export type ExplicitBitstream = Uint8Array;
+/**
+ * Spec - https://github.com/CesiumGS/3d-tiles/tree/main/extensions/3DTILES_implicit_tiling#subdivision-scheme
+ */
+export type SubdivisionScheme = 'QUADTREE' | 'OCTREE';
+type Buffer = {
+    name: string;
+    uri?: string;
+    byteLength: number;
+};
+type BufferView = {
+    buffer: number;
+    byteOffset: number;
+    byteLength: number;
+};
+/**
+ * Spec - https://github.com/CesiumGS/3d-tiles/tree/main/extensions/3DTILES_implicit_tiling
+ */
+export type ImplicitTilingExensionData = ImplicitTilingData & {
+    maximumLevel?: number;
+};
+/** 3DTiles v1.1 types */
+/**
+ * This object allows a tile to be implicitly subdivided. Tile and content availability and metadata is stored in subtrees which are referenced externally.
+ * https://github.com/CesiumGS/3d-tiles/blob/draft-1.1/specification/schema/tile.implicitTiling.schema.json
+ * */
+type ImplicitTilingData = {
+    /** A string describing the subdivision scheme used within the tileset. */
+    subdivisionScheme: 'QUADTREE' | 'OCTREE' | string;
+    /** The number of distinct levels in each subtree. For example, a quadtree with `subtreeLevels = 2` will have subtrees with 5 nodes (one root and 4 children). */
+    subtreeLevels: number;
+    /** The numbers of the levels in the tree with available tiles. */
+    availableLevels: number;
+    /** An object describing the location of subtree files. */
+    subtrees: {
+        /** A template URI pointing to subtree files. A subtree is a fixed-depth (defined by `subtreeLevels`) portion of the tree to keep memory use bounded.
+         * The URI of each file is substituted with the subtree root's global level, x, and y. For subdivision scheme `OCTREE`, z shall also be given. Relative paths are relative to the tileset JSON. */
+        uri: string;
+    };
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -1,2 +1,2 @@
-export {};
-//# sourceMappingURL=types.js.map
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@loaders.gl/3d-tiles",
-  "version": "4.0.0-alpha.1",
+  "version": "4.0.0-alpha.11",
   "description": "3D Tiles, an open standard for streaming massive heterogeneous 3D geospatial datasets.",
   "license": "MIT",
   "publishConfig": {
@@ -20,9 +20,9 @@
     "point cloud",
     "pointcloud"
   ],
-  "types": "src/index.ts",
-  "main": "dist/index.js",
-  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "main": "dist/es5/index.js",
+  "module": "dist/esm/index.js",
   "sideEffects": false,
   "files": [
     "src",
@@ -31,19 +31,20 @@
   ],
   "scripts": {
     "pre-build": "npm run build-bundle",
-    "build-bundle": "esbuild src/bundle.ts --bundle --outfile=dist/bundle.js"
+    "build-bundle": "esbuild src/bundle.ts --bundle --outfile=dist/dist.min.js"
   },
   "dependencies": {
-    "@loaders.gl/draco": "4.0.0-alpha.1",
-    "@loaders.gl/gltf": "4.0.0-alpha.1",
-    "@loaders.gl/loader-utils": "4.0.0-alpha.1",
-    "@loaders.gl/math": "4.0.0-alpha.1",
-    "@loaders.gl/tiles": "4.0.0-alpha.1",
+    "@loaders.gl/draco": "4.0.0-alpha.11",
+    "@loaders.gl/gltf": "4.0.0-alpha.11",
+    "@loaders.gl/loader-utils": "4.0.0-alpha.11",
+    "@loaders.gl/math": "4.0.0-alpha.11",
+    "@loaders.gl/tiles": "4.0.0-alpha.11",
     "@math.gl/core": "^3.5.1",
-    "@math.gl/geospatial": "^3.5.1"
+    "@math.gl/geospatial": "^3.5.1",
+    "long": "^5.2.1"
   },
   "peerDependencies": {
-    "@loaders.gl/core": "^3.0.0"
+    "@loaders.gl/core": "^4.0.0-alpha.8"
   },
-  "gitHead": "e48f5534fe7188c810f23f965a440c144b3cf6d0"
+  "gitHead": "bc680098cfea790c67b7fb95bab96e8d9288d34f"
 }

package/src/cesium-ion-loader.ts

@@ -33,6 +33,7 @@ export const CesiumIonLoader: LoaderWithParser = {
   },
   options: {
     'cesium-ion': {
+      // @ts-expect-error
       ...Tiles3DLoader.options['3d-tiles'],
       accessToken: null
     }

package/src/index.ts

@@ -1,6 +1,7 @@
 // LOADERS
 export {Tiles3DLoader} from './tiles-3d-loader';
 export {CesiumIonLoader} from './cesium-ion-loader';
+export {Tile3DSubtreeLoader} from './tile-3d-subtree-loader';
 
 // WRITERS
 export {Tile3DWriter} from './tile-3d-writer';
@@ -12,4 +13,15 @@ export {default as Tile3DBatchTable} from './lib/classes/tile-3d-batch-table';
 // EXPERIMENTAL
 export {TILE3D_TYPE} from './lib/constants';
 export {getIonTilesetMetadata as _getIonTilesetMetadata} from './lib/ion/ion';
-export type {BatchTableJson, B3DMContent, Node3D} from './types';
+export type {
+  FeatureTableJson,
+  B3DMContent,
+  Tile3DBoundingVolume,
+  Tiles3DTileJSON,
+  Tiles3DTileJSONPostprocessed,
+  Tiles3DTilesetJSON,
+  Tiles3DTilesetJSONPostprocessed,
+  Tiles3DTileContent,
+  ImplicitTilingExensionData
+} from './types';
+export type {Tiles3DLoaderOptions} from './tiles-3d-loader';

package/src/lib/classes/{tile-3d-batch-table.js → tile-3d-batch-table.ts}

@@ -21,6 +21,16 @@ const IGNORED_PROPERTY_FIELDS = {
 
 // The size of this array equals the maximum instance count among all loaded tiles, which has the potential to be large.
 export default class Tile3DBatchTableParser {
+  json;
+  binary;
+  featureCount;
+  _extensions;
+  // Copy all top-level property fields from the json object, ignoring special fields
+  _properties;
+  _binaryProperties;
+  // TODO: hierarchy support is only partially implemented and not tested
+  _hierarchy;
+
   constructor(json, binary, featureCount, options = {}) {
     assert(featureCount >= 0);
     this.json = json || {};
@@ -49,11 +59,11 @@ export default class Tile3DBatchTableParser {
     return this.json && this.json.extensions && this.json.extensions[extensionName];
   }
 
-  memorySizeInBytes() {
+  memorySizeInBytes(): number {
     return 0;
   }
 
-  isClass(batchId, className) {
+  isClass(batchId, className: string): boolean {
     this._checkBatchId(batchId);
     assert(typeof className === 'string', className);
 
@@ -178,7 +188,7 @@ export default class Tile3DBatchTableParser {
   _checkBatchId(batchId) {
     const valid = batchId >= 0 && batchId < this.featureCount;
     if (!valid) {
-      throw new Error(`batchId not in range [0, featureCount - 1].`);
+      throw new Error('batchId not in range [0, featureCount - 1].');
     }
   }
 
@@ -191,7 +201,7 @@ export default class Tile3DBatchTableParser {
   }
 
   _initializeBinaryProperties() {
-    let binaryProperties = null;
+    let binaryProperties: Record<string, any> | null = null;
     for (const name in this._properties) {
       const property = this._properties[name];
       const binaryProperty = this._initializeBinaryProperty(name, property);

package/src/lib/classes/{tile-3d-feature-table.js → tile-3d-feature-table.ts}

@@ -6,11 +6,14 @@ import {GL, GLType} from '@loaders.gl/math';
 // Reference:
 // https://github.com/AnalyticalGraphicsInc/cesium/blob/1de96d087f0b17575eb1a3f736407b348c765d59/Source/Scene/Cesium3DTileFeatureTable.js
 export default class Tile3DFeatureTable {
+  json;
+  buffer;
+  featuresLength = 0;
+  _cachedTypedArrays = {};
+
   constructor(featureTableJson, featureTableBinary) {
     this.json = featureTableJson;
     this.buffer = featureTableBinary;
-    this.featuresLength = 0;
-    this._cachedTypedArrays = {};
   }
 
   getExtension(extensionName) {

package/src/lib/{constants.js → constants.ts}

@@ -6,7 +6,8 @@ export const TILE3D_TYPE = {
   BATCHED_3D_MODEL: 'b3dm',
   INSTANCED_3D_MODEL: 'i3dm',
   GEOMETRY: 'geom',
-  VECTOR: 'vect'
+  VECTOR: 'vect',
+  GLTF: 'glTF'
 };
 
 export const TILE3D_TYPES = Object.keys(TILE3D_TYPE);

package/src/lib/parsers/helpers/{normalize-3d-tile-colors.js → normalize-3d-tile-colors.ts}

@@ -1,13 +1,19 @@
+import {Tile3DBatchTable} from '@loaders.gl/3d-tiles';
 import {decodeRGB565, GL} from '@loaders.gl/math';
+import {Tiles3DTileContent} from '../../../types';
 
 /* eslint-disable complexity*/
-export function normalize3DTileColorAttribute(tile, colors, batchTable) {
+export function normalize3DTileColorAttribute(
+  tile: Tiles3DTileContent,
+  colors: Uint8ClampedArray | null,
+  batchTable?: Tile3DBatchTable
+): {type: number; value: Uint8ClampedArray; size: number; normalized: boolean} | null {
   // no colors defined
   if (!colors && (!tile || !tile.batchIds || !batchTable)) {
     return null;
   }
 
-  const {batchIds, isRGB565, pointCount} = tile;
+  const {batchIds, isRGB565, pointCount = 0} = tile;
   // Batch table, look up colors in table
   if (batchIds && batchTable) {
     const colorArray = new Uint8ClampedArray(pointCount * 3);
@@ -29,7 +35,7 @@ export function normalize3DTileColorAttribute(tile, colors, batchTable) {
   }
 
   // RGB565 case, convert to RGB
-  if (isRGB565) {
+  if (colors && isRGB565) {
     const colorArray = new Uint8ClampedArray(pointCount * 3);
     for (let i = 0; i < pointCount; i++) {
       const color = decodeRGB565(colors[i]);
@@ -58,7 +64,7 @@ export function normalize3DTileColorAttribute(tile, colors, batchTable) {
   // DEFAULT: RGBA case
   return {
     type: GL.UNSIGNED_BYTE,
-    value: colors,
+    value: colors || new Uint8ClampedArray(),
     size: 4,
     normalized: true
   };

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

@@ -0,0 +1,35 @@
+import {Vector3} from '@math.gl/core';
+import {GL, octDecode} from '@loaders.gl/math';
+import {Tiles3DTileContent} from '../../../types';
+
+const scratchNormal = new Vector3();
+
+export function normalize3DTileNormalAttribute(
+  tile: Tiles3DTileContent,
+  normals: Float32Array | null
+): {type: number; size: number; value: Float32Array} | null {
+  if (!normals) {
+    return null;
+  }
+
+  if (tile.isOctEncoded16P) {
+    const decodedArray = new Float32Array((tile.pointsLength || 0) * 3);
+    for (let i = 0; i < (tile.pointsLength || 0); i++) {
+      octDecode(normals[i * 2], normals[i * 2 + 1], scratchNormal);
+      // @ts-ignore
+      scratchNormal.toArray(decodedArray, i * 3);
+    }
+
+    return {
+      type: GL.FLOAT,
+      size: 2,
+      value: decodedArray
+    };
+  }
+
+  return {
+    type: GL.FLOAT,
+    size: 2,
+    value: normals
+  };
+}