@loaders.gl/tiles 4.0.0-alpha.4 → 4.0.0-alpha.6

package/dist/tileset/tileset-3d.d.ts

@@ -0,0 +1,217 @@
+import { Matrix4, Vector3 } from '@math.gl/core';
+import { Stats } from '@probe.gl/stats';
+import { RequestScheduler, LoaderWithParser, LoaderOptions } from '@loaders.gl/loader-utils';
+import { FrameState } from './helpers/frame-state';
+import { Tile3D } from './tile-3d';
+import { Viewport } from '../types';
+import { TilesetTraverser } from './tileset-traverser';
+export type Tileset3DProps = {
+    throttleRequests?: boolean;
+    maxRequests?: number;
+    loadOptions?: LoaderOptions;
+    loadTiles?: boolean;
+    basePath?: string;
+    maximumMemoryUsage?: number;
+    maximumTilesSelected?: number;
+    debounceTime?: number;
+    description?: string;
+    attributions?: string[];
+    ellipsoid?: object;
+    modelMatrix?: Matrix4;
+    maximumScreenSpaceError?: number;
+    viewportTraversersMap?: any;
+    updateTransforms?: boolean;
+    viewDistanceScale?: number;
+    onTileLoad?: (tile: Tile3D) => any;
+    onTileUnload?: (tile: Tile3D) => any;
+    onTileError?: (tile: Tile3D, message: string, url: string) => any;
+    contentLoader?: (tile: Tile3D) => Promise<void>;
+    onTraversalComplete?: (selectedTiles: Tile3D[]) => Tile3D[];
+};
+type Props = {
+    description: string;
+    ellipsoid: object;
+    modelMatrix: Matrix4;
+    throttleRequests: boolean;
+    maximumMemoryUsage: number;
+    maximumTilesSelected: number;
+    debounceTime: number;
+    onTileLoad: (tile: Tile3D) => any;
+    onTileUnload: (tile: Tile3D) => any;
+    onTileError: (tile: Tile3D, message: string, url: string) => any;
+    onTraversalComplete: (selectedTiles: Tile3D[]) => Tile3D[];
+    maximumScreenSpaceError: number;
+    viewportTraversersMap: any;
+    attributions: string[];
+    maxRequests: number;
+    loadTiles: boolean;
+    loadOptions: LoaderOptions;
+    updateTransforms: boolean;
+    viewDistanceScale: number;
+    basePath: string;
+    contentLoader?: (tile: Tile3D) => Promise<void>;
+    i3s: {
+        [key: string]: any;
+    };
+};
+export declare class Tileset3D {
+    options: Props;
+    loadOptions: {
+        [key: string]: any;
+    };
+    type: string;
+    tileset: {
+        [key: string]: any;
+    };
+    loader: LoaderWithParser;
+    url: string;
+    basePath: string;
+    modelMatrix: Matrix4;
+    ellipsoid: any;
+    lodMetricType: string;
+    lodMetricValue: number;
+    refine: string;
+    root: Tile3D | null;
+    roots: {
+        [key: string]: Tile3D;
+    };
+    asset: {
+        [key: string]: any;
+    };
+    description: string;
+    properties: any;
+    extras: any;
+    attributions: any;
+    credits: any;
+    stats: Stats;
+    /** flags that contain information about data types in nested tiles */
+    contentFormats: {
+        draco: boolean;
+        meshopt: boolean;
+        dds: boolean;
+        ktx2: boolean;
+    };
+    traverseCounter: number;
+    geometricError: number;
+    selectedTiles: Tile3D[];
+    private updatePromise;
+    tilesetInitializationPromise: Promise<void>;
+    cartographicCenter: Vector3 | null;
+    cartesianCenter: Vector3 | null;
+    zoom: number;
+    boundingVolume: any;
+    gpuMemoryUsageInBytes: any;
+    dynamicScreenSpaceErrorComputedDensity: any;
+    _traverser: TilesetTraverser;
+    private _cache;
+    _requestScheduler: RequestScheduler;
+    _frameNumber: number;
+    private _queryParamsString;
+    private _queryParams;
+    private _extensionsUsed;
+    private _tiles;
+    private _pendingCount;
+    private lastUpdatedVieports;
+    private _requestedTiles;
+    private _emptyTiles;
+    private frameStateData;
+    maximumMemoryUsage: number;
+    /**
+     * Create a new Tileset3D
+     * @param json
+     * @param props
+     */
+    constructor(json: any, options?: Tileset3DProps);
+    /** Release resources */
+    destroy(): void;
+    /** Is the tileset loaded (update needs to have been called at least once) */
+    isLoaded(): boolean;
+    get tiles(): object[];
+    get frameNumber(): number;
+    get queryParams(): string;
+    setProps(props: Tileset3DProps): void;
+    /** @deprecated */
+    setOptions(options: Tileset3DProps): void;
+    /**
+     * Return a loadable tile url for a specific tile subpath
+     * @param tilePath a tile subpath
+     */
+    getTileUrl(tilePath: string): string;
+    hasExtension(extensionName: string): boolean;
+    /**
+     * Update visible tiles relying on a list of viewports
+     * @param viewports - list of viewports
+     * @deprecated
+     */
+    update(viewports?: Viewport[] | Viewport | null): void;
+    /**
+     * Update visible tiles relying on a list of viewports.
+     * Do it with debounce delay to prevent update spam
+     * @param viewports viewports
+     * @returns Promise of new frameNumber
+     */
+    selectTiles(viewports?: Viewport[] | Viewport | null): Promise<number>;
+    /**
+     * Update visible tiles relying on a list of viewports
+     * @param viewports viewports
+     */
+    private doUpdate;
+    /**
+     * Check if traversal is needed for particular viewport
+     * @param {string} viewportId - id of a viewport
+     * @return {boolean}
+     */
+    _needTraverse(viewportId: string): boolean;
+    /**
+     * The callback to post-process tiles after traversal procedure
+     * @param frameState - frame state for tile culling
+     */
+    _onTraversalEnd(frameState: FrameState): void;
+    /**
+     * Update tiles relying on data from all traversers
+     */
+    _updateTiles(): void;
+    _tilesChanged(oldSelectedTiles: any, selectedTiles: any): boolean;
+    _loadTiles(): void;
+    _unloadTiles(): void;
+    _updateStats(): void;
+    _initializeTileSet(tilesetJson: any): Promise<void>;
+    /**
+     * Called during initialize Tileset to initialize the tileset's cartographic center (longitude, latitude) and zoom.
+     * These metrics help apps center view on tileset
+     * For I3S there is extent (<1.8 version) or fullExtent (>=1.8 version) to calculate view props
+     * @returns
+     */
+    private calculateViewPropsI3S;
+    /**
+     * Called during initialize Tileset to initialize the tileset's cartographic center (longitude, latitude) and zoom.
+     * These metrics help apps center view on tileset.
+     * For 3DTiles the root tile data is used to calculate view props.
+     * @returns
+     */
+    private calculateViewPropsTiles3D;
+    _initializeStats(): void;
+    _initializeTileHeaders(tilesetJson: any, parentTileHeader: any): Tile3D;
+    _initializeTraverser(): any;
+    _destroyTileHeaders(parentTile: any): void;
+    _loadTile(tile: any): Promise<void>;
+    _onTileLoadError(tile: any, error: any): void;
+    _onTileLoad(tile: any, loaded: any): void;
+    /**
+     * Update information about data types in nested tiles
+     * @param tile instance of a nested Tile3D
+     */
+    private updateContentTypes;
+    _onStartTileLoading(): void;
+    _onEndTileLoading(): void;
+    _addTileToCache(tile: any): void;
+    _updateCacheStats(tile: any): void;
+    _unloadTile(tile: any): void;
+    _destroy(): void;
+    _destroySubtree(tile: any): void;
+    _destroyTile(tile: any): void;
+    _initializeTiles3DTileset(tilesetJson: any): void;
+    _initializeI3STileset(): void;
+}
+export {};
+//# sourceMappingURL=tileset-3d.d.ts.map

package/dist/tileset/tileset-3d.d.ts.map

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