@loaders.gl/tiles 5.0.0-alpha.1 → 5.0.0-alpha.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +14 -3
- package/README.md +26 -0
- package/dist/dist.dev.js +20271 -5055
- package/dist/dist.min.js +3 -1
- package/dist/index.cjs +7849 -2081
- package/dist/index.cjs.map +3 -4
- package/dist/index.d.ts +25 -2
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +11 -0
- package/dist/index.js.map +1 -1
- package/dist/point-cloud/point-cloud-tile.d.ts.map +1 -1
- package/dist/point-cloud/point-cloud-tile.js +3 -0
- package/dist/point-cloud/point-cloud-tile.js.map +1 -1
- package/dist/point-cloud/point-cloud-tileset.d.ts +4 -0
- package/dist/point-cloud/point-cloud-tileset.d.ts.map +1 -1
- package/dist/point-cloud/point-cloud-tileset.js +54 -12
- package/dist/point-cloud/point-cloud-tileset.js.map +1 -1
- package/dist/point-cloud/types.d.ts +17 -0
- package/dist/point-cloud/types.d.ts.map +1 -1
- package/dist/point-cloud/types.js +3 -0
- package/dist/point-cloud/types.js.map +1 -1
- package/dist/raster-set.d.ts +48 -31
- package/dist/raster-set.d.ts.map +1 -1
- package/dist/raster-set.js +104 -24
- package/dist/raster-set.js.map +1 -1
- package/dist/spatial/format-spatial-reference.d.ts +68 -0
- package/dist/spatial/format-spatial-reference.d.ts.map +1 -0
- package/dist/spatial/format-spatial-reference.js +291 -0
- package/dist/spatial/format-spatial-reference.js.map +1 -0
- package/dist/spatial/get-spatial-coordinate-frame.d.ts +20 -0
- package/dist/spatial/get-spatial-coordinate-frame.d.ts.map +1 -0
- package/dist/spatial/get-spatial-coordinate-frame.js +139 -0
- package/dist/spatial/get-spatial-coordinate-frame.js.map +1 -0
- package/dist/spatial/i3s-elevation.d.ts +20 -0
- package/dist/spatial/i3s-elevation.d.ts.map +1 -0
- package/dist/spatial/i3s-elevation.js +90 -0
- package/dist/spatial/i3s-elevation.js.map +1 -0
- package/dist/spatial/i3s-spatial-transformer.d.ts +189 -0
- package/dist/spatial/i3s-spatial-transformer.d.ts.map +1 -0
- package/dist/spatial/i3s-spatial-transformer.js +686 -0
- package/dist/spatial/i3s-spatial-transformer.js.map +1 -0
- package/dist/spatial/normalize-crs-identifier.d.ts +15 -0
- package/dist/spatial/normalize-crs-identifier.d.ts.map +1 -0
- package/dist/spatial/normalize-crs-identifier.js +22 -0
- package/dist/spatial/normalize-crs-identifier.js.map +1 -0
- package/dist/spatial/spatial-coordinate-transformer.d.ts +52 -0
- package/dist/spatial/spatial-coordinate-transformer.d.ts.map +1 -0
- package/dist/spatial/spatial-coordinate-transformer.js +295 -0
- package/dist/spatial/spatial-coordinate-transformer.js.map +1 -0
- package/dist/spatial/spatial-resource-registry.d.ts +44 -0
- package/dist/spatial/spatial-resource-registry.d.ts.map +1 -0
- package/dist/spatial/spatial-resource-registry.js +67 -0
- package/dist/spatial/spatial-resource-registry.js.map +1 -0
- package/dist/spatial/spatial-types.d.ts +190 -0
- package/dist/spatial/spatial-types.d.ts.map +1 -0
- package/dist/spatial/spatial-types.js +192 -0
- package/dist/spatial/spatial-types.js.map +1 -0
- package/dist/spatial/tiles-3d-spatial-transformer.d.ts +32 -0
- package/dist/spatial/tiles-3d-spatial-transformer.d.ts.map +1 -0
- package/dist/spatial/tiles-3d-spatial-transformer.js +175 -0
- package/dist/spatial/tiles-3d-spatial-transformer.js.map +1 -0
- package/dist/tileset-2d/adapter.d.ts +2 -3
- package/dist/tileset-2d/adapter.d.ts.map +1 -1
- package/dist/tileset-2d/tileset-2d.d.ts +2 -3
- package/dist/tileset-2d/tileset-2d.d.ts.map +1 -1
- package/dist/tileset-2d/tileset-2d.js.map +1 -1
- package/dist/tileset-3d/common/indexed-archive-tileset-source.d.ts +3 -3
- package/dist/tileset-3d/common/indexed-archive-tileset-source.d.ts.map +1 -1
- package/dist/tileset-3d/common/indexed-archive-tileset-source.js +9 -4
- package/dist/tileset-3d/common/indexed-archive-tileset-source.js.map +1 -1
- package/dist/tileset-3d/common/tile-3d-contracts.d.ts +63 -0
- package/dist/tileset-3d/common/tile-3d-contracts.d.ts.map +1 -0
- package/dist/tileset-3d/common/tile-3d-contracts.js +51 -0
- package/dist/tileset-3d/common/tile-3d-contracts.js.map +1 -0
- package/dist/tileset-3d/common/tile-3d.d.ts +176 -5
- package/dist/tileset-3d/common/tile-3d.d.ts.map +1 -1
- package/dist/tileset-3d/common/tile-3d.js +523 -89
- package/dist/tileset-3d/common/tile-3d.js.map +1 -1
- package/dist/tileset-3d/common/tileset-3d.d.ts +192 -9
- package/dist/tileset-3d/common/tileset-3d.d.ts.map +1 -1
- package/dist/tileset-3d/common/tileset-3d.js +303 -23
- package/dist/tileset-3d/common/tileset-3d.js.map +1 -1
- package/dist/tileset-3d/common/tileset-cache.d.ts +11 -1
- package/dist/tileset-3d/common/tileset-cache.d.ts.map +1 -1
- package/dist/tileset-3d/common/tileset-cache.js +11 -3
- package/dist/tileset-3d/common/tileset-cache.js.map +1 -1
- package/dist/tileset-3d/common/tileset-content-traversal.d.ts +37 -0
- package/dist/tileset-3d/common/tileset-content-traversal.d.ts.map +1 -0
- package/dist/tileset-3d/common/tileset-content-traversal.js +80 -0
- package/dist/tileset-3d/common/tileset-content-traversal.js.map +1 -0
- package/dist/tileset-3d/common/tileset-observability.d.ts +60 -0
- package/dist/tileset-3d/common/tileset-observability.d.ts.map +1 -0
- package/dist/tileset-3d/common/tileset-observability.js +39 -0
- package/dist/tileset-3d/common/tileset-observability.js.map +1 -0
- package/dist/tileset-3d/common/tileset-source.d.ts +51 -9
- package/dist/tileset-3d/common/tileset-source.d.ts.map +1 -1
- package/dist/tileset-3d/common/tileset-source.js.map +1 -1
- package/dist/tileset-3d/common/tileset-traverser.d.ts +33 -1
- package/dist/tileset-3d/common/tileset-traverser.d.ts.map +1 -1
- package/dist/tileset-3d/common/tileset-traverser.js +59 -11
- package/dist/tileset-3d/common/tileset-traverser.js.map +1 -1
- package/dist/tileset-3d/format-3d-tiles/implicit-tiling.d.ts +182 -0
- package/dist/tileset-3d/format-3d-tiles/implicit-tiling.d.ts.map +1 -0
- package/dist/tileset-3d/format-3d-tiles/implicit-tiling.js +681 -0
- package/dist/tileset-3d/format-3d-tiles/implicit-tiling.js.map +1 -0
- package/dist/tileset-3d/format-3d-tiles/tiles-3d-source.d.ts +127 -6
- package/dist/tileset-3d/format-3d-tiles/tiles-3d-source.d.ts.map +1 -1
- package/dist/tileset-3d/format-3d-tiles/tiles-3d-source.js +485 -27
- package/dist/tileset-3d/format-3d-tiles/tiles-3d-source.js.map +1 -1
- package/dist/tileset-3d/format-3d-tiles/tileset-3d-traverser.d.ts +103 -0
- package/dist/tileset-3d/format-3d-tiles/tileset-3d-traverser.d.ts.map +1 -1
- package/dist/tileset-3d/format-3d-tiles/tileset-3d-traverser.js +278 -0
- package/dist/tileset-3d/format-3d-tiles/tileset-3d-traverser.js.map +1 -1
- package/dist/tileset-3d/format-i3s/i3s-pending-tiles-register.d.ts.map +1 -1
- package/dist/tileset-3d/format-i3s/i3s-pending-tiles-register.js +3 -0
- package/dist/tileset-3d/format-i3s/i3s-pending-tiles-register.js.map +1 -1
- package/dist/tileset-3d/format-i3s/i3s-source.d.ts +23 -6
- package/dist/tileset-3d/format-i3s/i3s-source.d.ts.map +1 -1
- package/dist/tileset-3d/format-i3s/i3s-source.js +176 -25
- package/dist/tileset-3d/format-i3s/i3s-source.js.map +1 -1
- package/dist/tileset-3d/format-i3s/i3s-tile-manager.d.ts.map +1 -1
- package/dist/tileset-3d/format-i3s/i3s-tile-manager.js +3 -0
- package/dist/tileset-3d/format-i3s/i3s-tile-manager.js.map +1 -1
- package/dist/tileset-3d/format-i3s/i3s-tileset-traverser.d.ts.map +1 -1
- package/dist/tileset-3d/format-i3s/i3s-tileset-traverser.js +4 -1
- package/dist/tileset-3d/format-i3s/i3s-tileset-traverser.js.map +1 -1
- package/dist/tileset-3d/helpers/3d-tiles-options.d.ts.map +1 -1
- package/dist/tileset-3d/helpers/3d-tiles-options.js +3 -0
- package/dist/tileset-3d/helpers/3d-tiles-options.js.map +1 -1
- package/dist/tileset-3d/helpers/bounding-volume.d.ts +7 -3
- package/dist/tileset-3d/helpers/bounding-volume.d.ts.map +1 -1
- package/dist/tileset-3d/helpers/bounding-volume.js +20 -91
- package/dist/tileset-3d/helpers/bounding-volume.js.map +1 -1
- package/dist/tileset-3d/helpers/frame-state.d.ts +67 -2
- package/dist/tileset-3d/helpers/frame-state.d.ts.map +1 -1
- package/dist/tileset-3d/helpers/frame-state.js +92 -10
- package/dist/tileset-3d/helpers/frame-state.js.map +1 -1
- package/dist/tileset-3d/helpers/i3s-lod.d.ts.map +1 -1
- package/dist/tileset-3d/helpers/i3s-lod.js +20 -8
- package/dist/tileset-3d/helpers/i3s-lod.js.map +1 -1
- package/dist/tileset-3d/helpers/s2-bounding-volume.d.ts +17 -0
- package/dist/tileset-3d/helpers/s2-bounding-volume.d.ts.map +1 -0
- package/dist/tileset-3d/helpers/s2-bounding-volume.js +20 -0
- package/dist/tileset-3d/helpers/s2-bounding-volume.js.map +1 -0
- package/dist/tileset-3d/helpers/tiles-3d-lod.d.ts +61 -9
- package/dist/tileset-3d/helpers/tiles-3d-lod.d.ts.map +1 -1
- package/dist/tileset-3d/helpers/tiles-3d-lod.js +198 -93
- package/dist/tileset-3d/helpers/tiles-3d-lod.js.map +1 -1
- package/dist/tileset-3d/helpers/tiles-3d-request-priority.d.ts +134 -0
- package/dist/tileset-3d/helpers/tiles-3d-request-priority.d.ts.map +1 -0
- package/dist/tileset-3d/helpers/tiles-3d-request-priority.js +179 -0
- package/dist/tileset-3d/helpers/tiles-3d-request-priority.js.map +1 -0
- package/dist/types.d.ts +7 -0
- package/dist/types.d.ts.map +1 -1
- package/dist/types.js +3 -0
- package/dist/types.js.map +1 -1
- package/dist/utils/doubly-linked-list.d.ts.map +1 -1
- package/dist/utils/doubly-linked-list.js +1 -0
- package/dist/utils/doubly-linked-list.js.map +1 -1
- package/dist/utils/managed-array.d.ts.map +1 -1
- package/dist/utils/managed-array.js +1 -0
- package/dist/utils/managed-array.js.map +1 -1
- package/package.json +12 -10
- package/src/index.ts +78 -1
- package/src/point-cloud/point-cloud-tile.ts +4 -0
- package/src/point-cloud/point-cloud-tileset.ts +70 -12
- package/src/point-cloud/types.ts +21 -0
- package/src/raster-set.ts +197 -67
- package/src/spatial/format-spatial-reference.ts +385 -0
- package/src/spatial/get-spatial-coordinate-frame.ts +169 -0
- package/src/spatial/i3s-elevation.ts +96 -0
- package/src/spatial/i3s-spatial-transformer.ts +957 -0
- package/src/spatial/normalize-crs-identifier.ts +26 -0
- package/src/spatial/spatial-coordinate-transformer.ts +376 -0
- package/src/spatial/spatial-resource-registry.ts +79 -0
- package/src/spatial/spatial-types.ts +422 -0
- package/src/spatial/tiles-3d-spatial-transformer.ts +206 -0
- package/src/tileset-2d/adapter.ts +2 -3
- package/src/tileset-2d/tileset-2d.ts +2 -3
- package/src/tileset-3d/common/indexed-archive-tileset-source.ts +13 -13
- package/src/tileset-3d/common/tile-3d-contracts.ts +115 -0
- package/src/tileset-3d/common/tile-3d.ts +629 -98
- package/src/tileset-3d/common/tileset-3d.ts +459 -29
- package/src/tileset-3d/common/tileset-cache.ts +15 -7
- package/src/tileset-3d/common/tileset-content-traversal.ts +114 -0
- package/src/tileset-3d/common/tileset-observability.ts +100 -0
- package/src/tileset-3d/common/tileset-source.ts +63 -13
- package/src/tileset-3d/common/tileset-traverser.ts +71 -11
- package/src/tileset-3d/format-3d-tiles/implicit-tiling.ts +1059 -0
- package/src/tileset-3d/format-3d-tiles/tiles-3d-source.ts +674 -28
- package/src/tileset-3d/format-3d-tiles/tileset-3d-traverser.ts +316 -0
- package/src/tileset-3d/format-i3s/i3s-pending-tiles-register.ts +4 -0
- package/src/tileset-3d/format-i3s/i3s-source.ts +220 -29
- package/src/tileset-3d/format-i3s/i3s-tile-manager.ts +4 -0
- package/src/tileset-3d/format-i3s/i3s-tileset-traverser.ts +6 -1
- package/src/tileset-3d/helpers/3d-tiles-options.ts +4 -0
- package/src/tileset-3d/helpers/bounding-volume.ts +31 -114
- package/src/tileset-3d/helpers/frame-state.ts +152 -13
- package/src/tileset-3d/helpers/i3s-lod.ts +22 -8
- package/src/tileset-3d/helpers/s2-bounding-volume.ts +35 -0
- package/src/tileset-3d/helpers/tiles-3d-lod.ts +291 -112
- package/src/tileset-3d/helpers/tiles-3d-request-priority.ts +301 -0
- package/src/types.ts +11 -0
- package/src/utils/doubly-linked-list.ts +2 -0
- package/src/utils/managed-array.ts +2 -0
|
@@ -1,11 +1,30 @@
|
|
|
1
1
|
import { Matrix4 } from '@math.gl/core';
|
|
2
|
+
import { CullingVolume } from '@math.gl/culling';
|
|
3
|
+
import type { CullingResult } from '@math.gl/culling';
|
|
4
|
+
import type { Tile3DContent, Tile3DFeatureIdSet, Tile3DMetadataContext } from "./tile-3d-contracts.js";
|
|
2
5
|
import type { Tileset3D } from "./tileset-3d.js";
|
|
3
6
|
import type { DoublyLinkedListNode } from "../../utils/doubly-linked-list-node.js";
|
|
4
7
|
import { TILE_REFINEMENT } from "../../constants.js";
|
|
5
|
-
import type { TileContentLoadResult } from "./tileset-source.js";
|
|
8
|
+
import type { TileChildrenLoadResult, TileContentLoadResult } from "./tileset-source.js";
|
|
6
9
|
import { FrameState } from "../helpers/frame-state.js";
|
|
7
10
|
import { CartographicBounds } from "../helpers/bounding-volume.js";
|
|
8
11
|
import { TilesetTraverser } from "./tileset-traverser.js";
|
|
12
|
+
/**
|
|
13
|
+
* Classifies render-content visibility across all content volumes owned by a tile.
|
|
14
|
+
*
|
|
15
|
+
* Content volumes form a union: one visible content entry keeps the tile renderable even when
|
|
16
|
+
* another entry is outside the frustum or clipping planes. The traversal volume is intentionally
|
|
17
|
+
* not used here except as a fallback when a tile has no content-specific volume. This separation
|
|
18
|
+
* keeps clipping render-only and prevents a tight content volume from pruning descendants.
|
|
19
|
+
*
|
|
20
|
+
* @param contentVolumes - Transformed content volumes in source order.
|
|
21
|
+
* @param fallbackVolume - Tile volume used when content does not declare its own volume.
|
|
22
|
+
* @param cullingVolume - Current view frustum.
|
|
23
|
+
* @param visibilityPlaneMask - Parent visibility mask optimization.
|
|
24
|
+
* @param clippingPlanes - Optional world-space planes applied to render content only.
|
|
25
|
+
* @returns Union visibility classification for the renderable content.
|
|
26
|
+
*/
|
|
27
|
+
export declare function getContentVisibility(contentVolumes: any[], fallbackVolume: any, cullingVolume: CullingVolume, visibilityPlaneMask: number | undefined, clippingPlanes?: any[]): CullingResult;
|
|
9
28
|
/**
|
|
10
29
|
* @param tileset - Tileset3D instance
|
|
11
30
|
* @param header - tile header - JSON loaded from a dataset
|
|
@@ -19,6 +38,8 @@ export type Tile3DProps = {
|
|
|
19
38
|
parentHeader: Tile3D;
|
|
20
39
|
extendedId: string;
|
|
21
40
|
};
|
|
41
|
+
/** Lifecycle of a source-managed lazy child-header group. */
|
|
42
|
+
export type TileChildrenState = 'unloaded' | 'loading' | 'ready' | 'failed';
|
|
22
43
|
/**
|
|
23
44
|
* A Tile3DHeader represents a tile as Tileset3D. When a tile is first created, its content is not loaded;
|
|
24
45
|
* the content is loaded on-demand when needed based on the view.
|
|
@@ -33,6 +54,8 @@ export declare class Tile3D {
|
|
|
33
54
|
refine: TILE_REFINEMENT;
|
|
34
55
|
type: string;
|
|
35
56
|
contentUrl: string;
|
|
57
|
+
/** Resolved render-content URLs in source order; empty for contentless tiles. */
|
|
58
|
+
contentUrls: string[];
|
|
36
59
|
/** Different refinement algorithms used by I3S and 3D tiles */
|
|
37
60
|
lodMetricType: string;
|
|
38
61
|
/**
|
|
@@ -45,6 +68,8 @@ export declare class Tile3D {
|
|
|
45
68
|
* separate ensures transform updates never compound an already-scaled geometric error.
|
|
46
69
|
*/
|
|
47
70
|
private _unscaledLodMetricValue;
|
|
71
|
+
/** Whether the source format defines geometric error in transform-local units. */
|
|
72
|
+
private _scaleGeometricError;
|
|
48
73
|
/** @todo math.gl is not exporting BoundingVolume base type? */
|
|
49
74
|
boundingVolume: any;
|
|
50
75
|
/**
|
|
@@ -52,10 +77,31 @@ export declare class Tile3D {
|
|
|
52
77
|
* not the content's metadata in the tileset JSON file.
|
|
53
78
|
*/
|
|
54
79
|
content: any;
|
|
80
|
+
/** Loaded payloads in the same order as {@link contentUrls}; `content` remains the primary payload. */
|
|
81
|
+
contents: any[];
|
|
82
|
+
/** Ordered renderer-neutral descriptors for each source content entry. */
|
|
83
|
+
contentEntries: Tile3DContent[];
|
|
84
|
+
/** Raw metadata references inherited by this tile and its content. */
|
|
85
|
+
metadataContext: Tile3DMetadataContext;
|
|
86
|
+
/** Feature-id declarations normalized from supported content extensions. */
|
|
87
|
+
featureIdSets: Tile3DFeatureIdSet[];
|
|
88
|
+
/** Decoded 3D Tiles vector topology for the primary loaded content, when present. */
|
|
89
|
+
vectorContent: unknown;
|
|
90
|
+
/**
|
|
91
|
+
* Metadata entity attached to this tile in the source tileset, if present.
|
|
92
|
+
*
|
|
93
|
+
* This is the raw 3D Tiles metadata reference. The generic tiles runtime preserves it without
|
|
94
|
+
* decoding schema classes or binary property tables.
|
|
95
|
+
*/
|
|
96
|
+
metadata: Record<string, any> | null;
|
|
97
|
+
/** Raw metadata entities attached to tile contents, in content source order. */
|
|
98
|
+
contentMetadata: Array<Record<string, any> | null>;
|
|
55
99
|
contentState: number;
|
|
56
100
|
gpuMemoryUsageInBytes: number;
|
|
57
101
|
/** The tile's children - an array of Tile3D objects. */
|
|
58
102
|
children: Tile3D[];
|
|
103
|
+
/** Current lifecycle state for a lazy implicit subtree rooted at this tile. */
|
|
104
|
+
childrenState: TileChildrenState;
|
|
59
105
|
depth: number;
|
|
60
106
|
viewportIds: any[];
|
|
61
107
|
transform: Matrix4;
|
|
@@ -73,14 +119,34 @@ export declare class Tile3D {
|
|
|
73
119
|
private _frameNumber;
|
|
74
120
|
private _expireDate;
|
|
75
121
|
private _expiredContent;
|
|
122
|
+
/** In-flight source request shared by repeated traversal frames. */
|
|
123
|
+
private _childrenPromise;
|
|
76
124
|
private _boundingBox?;
|
|
77
125
|
/** updated every frame for tree traversal and rendering optimizations: */
|
|
78
126
|
_distanceToCamera: number;
|
|
79
127
|
_screenSpaceError: number;
|
|
128
|
+
/** SSE calculated at the reduced viewport height used to prioritize coarse coverage. */
|
|
129
|
+
_screenSpaceErrorProgressiveResolution: number;
|
|
130
|
+
/** Whether this tile should be promoted into the progressive-resolution request pass. */
|
|
131
|
+
_priorityProgressiveResolution: boolean;
|
|
132
|
+
/** Angular distance from the camera view axis used to prioritize center tiles. */
|
|
133
|
+
_foveatedFactor: number;
|
|
134
|
+
/** Whether this peripheral request is currently inside the camera-motion deferral window. */
|
|
135
|
+
priorityDeferred: boolean;
|
|
80
136
|
private _visibilityPlaneMask;
|
|
81
137
|
private _visible;
|
|
82
138
|
private _contentBoundingVolume;
|
|
139
|
+
private _contentBoundingVolumes;
|
|
140
|
+
/** Source content-volume headers retained after render content is unloaded. */
|
|
141
|
+
private _contentBoundingVolumeHeaders;
|
|
83
142
|
private _viewerRequestVolume;
|
|
143
|
+
/** Bounding volume used to cull the tile's first renderable content entry. */
|
|
144
|
+
get contentBoundingVolume(): any;
|
|
145
|
+
/** All transformed render-content bounding volumes, including tile-volume fallbacks. */
|
|
146
|
+
get contentBoundingVolumes(): any[];
|
|
147
|
+
/** Bounding volume that limits when this tile may be requested, when declared. */
|
|
148
|
+
get viewerRequestVolume(): any;
|
|
149
|
+
/** Accumulated tile transforms from the source JSON, excluding the tileset model matrix. */
|
|
84
150
|
_initialTransform: Matrix4;
|
|
85
151
|
_priority: number;
|
|
86
152
|
_selectedFrame: number;
|
|
@@ -121,6 +187,10 @@ export declare class Tile3D {
|
|
|
121
187
|
get hasRenderContent(): boolean;
|
|
122
188
|
/** Returns true if tile has children */
|
|
123
189
|
get hasChildren(): any;
|
|
190
|
+
/** Returns whether traversal may request an unresolved lazy child-header group. */
|
|
191
|
+
get hasUnloadedChildren(): boolean;
|
|
192
|
+
/** Returns whether a lazy child-header request is currently in flight. */
|
|
193
|
+
get childrenLoading(): boolean;
|
|
124
194
|
/**
|
|
125
195
|
* Determines if the tile's content is ready. This is automatically `true` for
|
|
126
196
|
* tiles with empty content.
|
|
@@ -153,12 +223,22 @@ export declare class Tile3D {
|
|
|
153
223
|
*/
|
|
154
224
|
get screenSpaceError(): number;
|
|
155
225
|
/**
|
|
156
|
-
* Get bounding
|
|
226
|
+
* Get the current world-space bounding volume in cartographic coordinates.
|
|
157
227
|
* @returns [min, max] each in [longitude, latitude, altitude]
|
|
158
228
|
*/
|
|
159
229
|
get boundingBox(): CartographicBounds;
|
|
160
|
-
/**
|
|
161
|
-
|
|
230
|
+
/**
|
|
231
|
+
* Gets the tile's screen-space error for normal refinement or a reduced-height priority pass.
|
|
232
|
+
*
|
|
233
|
+
* I3S already supplies a screen-oriented LOD metric and intentionally ignores the optional 3D
|
|
234
|
+
* Tiles progressive-resolution height fraction.
|
|
235
|
+
*
|
|
236
|
+
* @param frameState - Current camera and viewport measurements.
|
|
237
|
+
* @param useParentLodMetric - Whether to substitute the parent LOD metric.
|
|
238
|
+
* @param viewportHeightFraction - Fraction of viewport height represented by the priority pass.
|
|
239
|
+
* @returns Screen-space LOD error for the current tileset format.
|
|
240
|
+
*/
|
|
241
|
+
getScreenSpaceError(frameState: any, useParentLodMetric: any, viewportHeightFraction?: number): number;
|
|
162
242
|
/**
|
|
163
243
|
* Make tile unselected than means it won't be shown
|
|
164
244
|
* but it can be still loaded in memory
|
|
@@ -168,12 +248,78 @@ export declare class Tile3D {
|
|
|
168
248
|
* Memory usage of tile on GPU
|
|
169
249
|
*/
|
|
170
250
|
_getGpuMemoryUsageInBytes(): number;
|
|
251
|
+
/**
|
|
252
|
+
* Returns scheduler priority for render-content requests.
|
|
253
|
+
*
|
|
254
|
+
* @returns Numeric priority, or a negative value when the queued request should be cancelled.
|
|
255
|
+
*/
|
|
171
256
|
_getPriority(): number;
|
|
257
|
+
/**
|
|
258
|
+
* Returns scheduler priority for lazy child-header requests.
|
|
259
|
+
*
|
|
260
|
+
* Contentless implicit placeholders intentionally retain `UNLOADED` content state, so metadata
|
|
261
|
+
* scheduling skips only that render-content cancellation check and preserves every visibility,
|
|
262
|
+
* recency, progressive, foveated, and motion-deferral rule.
|
|
263
|
+
*
|
|
264
|
+
* @returns Numeric priority, or a negative value when the queued request should be cancelled.
|
|
265
|
+
*/
|
|
266
|
+
private _getChildrenPriority;
|
|
267
|
+
/**
|
|
268
|
+
* Calculates the common scheduler priority for content or hierarchy metadata.
|
|
269
|
+
*
|
|
270
|
+
* @param allowUnloadedContent - Whether an empty placeholder may request child metadata.
|
|
271
|
+
* @returns Numeric priority, or a negative value when the queued request should be cancelled.
|
|
272
|
+
*/
|
|
273
|
+
private _calculateRequestPriority;
|
|
172
274
|
/**
|
|
173
275
|
* Requests the tile's content.
|
|
174
276
|
* The request may not be made if the Request Scheduler can't prioritize it.
|
|
175
277
|
*/
|
|
176
278
|
loadContent(): Promise<TileContentLoadResult>;
|
|
279
|
+
/** Loads content for complete dataset operations without viewport-based request priority. */
|
|
280
|
+
loadContentForTraversal(): Promise<TileContentLoadResult>;
|
|
281
|
+
/** Loads source content and updates the tile's renderer-neutral payload state. */
|
|
282
|
+
private _loadContentFromSource;
|
|
283
|
+
/**
|
|
284
|
+
* Requests and installs this tile's lazy child-header group through its source.
|
|
285
|
+
*
|
|
286
|
+
* The same request scheduler and SSE/foveated priority value used for render content are reused
|
|
287
|
+
* for subtree metadata. Repeated traversal frames share one promise, and scheduler cancellation
|
|
288
|
+
* restores the unloaded state so a later frame can retry.
|
|
289
|
+
*
|
|
290
|
+
* @param frameState - View state that made the subtree eligible for refinement.
|
|
291
|
+
* @returns Source load result, or an unloaded result if scheduling was cancelled.
|
|
292
|
+
*/
|
|
293
|
+
loadChildren(frameState: FrameState): Promise<TileChildrenLoadResult>;
|
|
294
|
+
/**
|
|
295
|
+
* Runs one lazy child-header load after obtaining a scheduler token.
|
|
296
|
+
*
|
|
297
|
+
* @param frameState - View state forwarded to the source implementation.
|
|
298
|
+
* @returns Source load result.
|
|
299
|
+
*/
|
|
300
|
+
private _loadChildrenWithScheduler;
|
|
301
|
+
/**
|
|
302
|
+
* Replaces a contentless implicit placeholder with its materialized subtree-root header.
|
|
303
|
+
*
|
|
304
|
+
* The placeholder transform is preserved when the subtree omits a root transform. An explicit
|
|
305
|
+
* subtree-root transform replaces it and is recomposed against the runtime parent. Content,
|
|
306
|
+
* metadata, bounds, and raw geometric error are reinitialized from the available header.
|
|
307
|
+
*
|
|
308
|
+
* @param materializedHeader - Available root header produced from one subtree resource.
|
|
309
|
+
*/
|
|
310
|
+
applyImplicitSubtreeHeader(materializedHeader: Record<string, any>): void;
|
|
311
|
+
/** Refreshes tile and content metadata from a source or materialized tile header. */
|
|
312
|
+
private _initializeMetadata;
|
|
313
|
+
/** Updates payload and renderability while retaining immutable metadata descriptors. */
|
|
314
|
+
private _updateContentEntriesAfterLoad;
|
|
315
|
+
/** Returns one ordered content descriptor, or null when the index is out of range. */
|
|
316
|
+
getContentEntry(index: number): Tile3DContent | null;
|
|
317
|
+
/** Returns whether an ordered content entry currently has renderable payload. */
|
|
318
|
+
isContentRenderable(index: number): boolean;
|
|
319
|
+
/** Initializes additive renderer-neutral descriptors from a normalized tile header. */
|
|
320
|
+
private _initializeContentEntries;
|
|
321
|
+
/** Extracts renderer-neutral feature-id declarations without decoding property values. */
|
|
322
|
+
private _getFeatureIdSets;
|
|
177
323
|
unloadContent(): boolean;
|
|
178
324
|
/**
|
|
179
325
|
* Update the tile's visibility
|
|
@@ -182,8 +328,26 @@ export declare class Tile3D {
|
|
|
182
328
|
* @return {void}
|
|
183
329
|
*/
|
|
184
330
|
updateVisibility(frameState: any, viewportIds: any): void;
|
|
331
|
+
/**
|
|
332
|
+
* Updates progressive-resolution and foveated request metrics for a 3D Tiles traversal frame.
|
|
333
|
+
*
|
|
334
|
+
* I3S retains its format-specific screen-threshold ordering and is explicitly isolated from
|
|
335
|
+
* geometric-error scheduling. Orthographic viewports still receive progressive coverage, but
|
|
336
|
+
* angular foveation is disabled because an orthographic frustum has no perspective field of view.
|
|
337
|
+
*
|
|
338
|
+
* @param frameState - Current camera and viewport measurements.
|
|
339
|
+
*/
|
|
340
|
+
_updateRequestPriorityMetrics(frameState: FrameState): void;
|
|
185
341
|
visibility(frameState: any, parentVisibilityPlaneMask: any): any;
|
|
186
|
-
|
|
342
|
+
/**
|
|
343
|
+
* Determines whether renderable content intersects the view and configured clipping planes.
|
|
344
|
+
*
|
|
345
|
+
* Clipping planes are render-only constraints; traversal continues to use the tile volume.
|
|
346
|
+
*
|
|
347
|
+
* @param frameState Current camera, culling, and optional clipping-plane state.
|
|
348
|
+
* @returns The content visibility classification.
|
|
349
|
+
*/
|
|
350
|
+
contentVisibility(frameState: FrameState, contentIndex?: number): CullingResult;
|
|
187
351
|
/**
|
|
188
352
|
* Computes the (potentially approximate) distance from the closest point of the tile's bounding volume to the camera.
|
|
189
353
|
* @param frameState The frame state.
|
|
@@ -227,6 +391,13 @@ export declare class Tile3D {
|
|
|
227
391
|
_initializeContent(tileHeader: any): void;
|
|
228
392
|
_initializeRenderingState(header: any): void;
|
|
229
393
|
_getRefine(refine: any): any;
|
|
394
|
+
/**
|
|
395
|
+
* Returns whether loaded content is an external tileset.
|
|
396
|
+
*
|
|
397
|
+
* Parsed shape is authoritative because valid external resources may be extensionless, signed,
|
|
398
|
+
* or use a misleading filename. This method is called only after source loading has populated
|
|
399
|
+
* `content`.
|
|
400
|
+
*/
|
|
230
401
|
_isTileset(): boolean;
|
|
231
402
|
_onContentLoaded(): void;
|
|
232
403
|
_updateBoundingVolume(header: any): void;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"tile-3d.d.ts","sourceRoot":"","sources":["../../../src/tileset-3d/common/tile-3d.ts"],"names":[],"mappings":"AAOA,OAAO,EAAU,OAAO,EAAC,MAAM,eAAe,CAAC;
|
|
1
|
+
{"version":3,"file":"tile-3d.d.ts","sourceRoot":"","sources":["../../../src/tileset-3d/common/tile-3d.ts"],"names":[],"mappings":"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"}
|