@cesium/engine 2.1.0 → 2.3.0
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/Build/Workers/{AttributeCompression-8a5a065e.js → AttributeCompression-f9f6c717.js} +1 -1
- package/Build/Workers/{AxisAlignedBoundingBox-a6f9f0e5.js → AxisAlignedBoundingBox-31fadcf0.js} +1 -1
- package/Build/Workers/{BoundingRectangle-b0a68595.js → BoundingRectangle-995f0079.js} +1 -1
- package/Build/Workers/{BoxGeometry-baedd794.js → BoxGeometry-7eb1af60.js} +1 -1
- package/Build/Workers/{Color-f85df1be.js → Color-2dc49658.js} +1 -1
- package/Build/Workers/{CoplanarPolygonGeometryLibrary-30516950.js → CoplanarPolygonGeometryLibrary-d7d972d6.js} +1 -1
- package/Build/Workers/{CorridorGeometryLibrary-5d5d3b3a.js → CorridorGeometryLibrary-1f5ef7b3.js} +1 -1
- package/Build/Workers/{CylinderGeometry-d899ae26.js → CylinderGeometry-23c67a6c.js} +1 -1
- package/Build/Workers/{CylinderGeometryLibrary-135b0858.js → CylinderGeometryLibrary-7bf291b4.js} +1 -1
- package/Build/Workers/{EllipseGeometry-a49f8449.js → EllipseGeometry-37014da4.js} +1 -1
- package/Build/Workers/{EllipseGeometryLibrary-cba7edde.js → EllipseGeometryLibrary-92ab6b1e.js} +1 -1
- package/Build/Workers/{EllipseOutlineGeometry-8095c8cb.js → EllipseOutlineGeometry-12b6fef5.js} +1 -1
- package/Build/Workers/{EllipsoidGeodesic-dcff5cbd.js → EllipsoidGeodesic-5b3623dc.js} +1 -1
- package/Build/Workers/{EllipsoidGeometry-ed93f571.js → EllipsoidGeometry-508da15c.js} +1 -1
- package/Build/Workers/{EllipsoidOutlineGeometry-e4854854.js → EllipsoidOutlineGeometry-40d97455.js} +1 -1
- package/Build/Workers/{EllipsoidRhumbLine-b672d507.js → EllipsoidRhumbLine-ef872433.js} +1 -1
- package/Build/Workers/{EllipsoidTangentPlane-7ae1aa9a.js → EllipsoidTangentPlane-46d4d9c2.js} +1 -1
- package/Build/Workers/{EncodedCartesian3-e8bbca36.js → EncodedCartesian3-57415c8a.js} +1 -1
- package/Build/Workers/{FrustumGeometry-b62db3e3.js → FrustumGeometry-38605e69.js} +32 -4
- package/Build/Workers/{GeometryAttribute-780af4fa.js → GeometryAttribute-a466e9c7.js} +1 -1
- package/Build/Workers/{GeometryInstance-3fb607b7.js → GeometryInstance-34d9e21e.js} +1 -1
- package/Build/Workers/{GeometryPipeline-36b61c99.js → GeometryPipeline-dcf79306.js} +1 -1
- package/Build/Workers/{IndexDatatype-b8f3e09d.js → IndexDatatype-2643aa47.js} +1 -1
- package/Build/Workers/{IntersectionTests-e889fcf0.js → IntersectionTests-88c49b2e.js} +1 -1
- package/Build/Workers/{Math-dad82b4d.js → Math-0a2ac845.js} +12 -2
- package/Build/Workers/{Matrix2-1e403d0e.js → Matrix2-e1298525.js} +1 -1
- package/Build/Workers/{Matrix3-fa806b97.js → Matrix3-41c58dde.js} +1 -1
- package/Build/Workers/{OrientedBoundingBox-43478ac8.js → OrientedBoundingBox-2dd47921.js} +5 -3
- package/Build/Workers/{Plane-c27e1ac6.js → Plane-4c3d403b.js} +1 -1
- package/Build/Workers/{PolygonGeometryLibrary-38a98276.js → PolygonGeometryLibrary-59126025.js} +1 -1
- package/Build/Workers/PolygonPipeline-1fe328c0.js +1344 -0
- package/Build/Workers/{PolylinePipeline-30e4cec9.js → PolylinePipeline-896735cc.js} +1 -1
- package/Build/Workers/{PolylineVolumeGeometryLibrary-90551d26.js → PolylineVolumeGeometryLibrary-9c0639f7.js} +1 -1
- package/Build/Workers/{PrimitivePipeline-558d9cb0.js → PrimitivePipeline-fc1a47ff.js} +1 -1
- package/Build/Workers/{RectangleGeometryLibrary-815c68df.js → RectangleGeometryLibrary-a23c9ebe.js} +1 -1
- package/Build/Workers/{TerrainEncoding-341ead52.js → TerrainEncoding-51b8b33b.js} +1 -1
- package/Build/Workers/Transforms-bc45e707.js +14699 -0
- package/Build/Workers/{WallGeometryLibrary-ccf90976.js → WallGeometryLibrary-007e9883.js} +1 -1
- package/Build/Workers/{WebMercatorProjection-76a3fcc0.js → WebMercatorProjection-13ed1a6e.js} +1 -1
- package/Build/Workers/{arrayRemoveDuplicates-fac118a8.js → arrayRemoveDuplicates-d2061e85.js} +1 -1
- package/Build/Workers/cesiumWorkerBootstrapper.js +1 -1
- package/Build/Workers/combineGeometry.js +1 -1
- package/Build/Workers/createBoxGeometry.js +1 -1
- package/Build/Workers/createBoxOutlineGeometry.js +1 -1
- package/Build/Workers/createCircleGeometry.js +1 -1
- package/Build/Workers/createCircleOutlineGeometry.js +1 -1
- package/Build/Workers/createCoplanarPolygonGeometry.js +1 -1
- package/Build/Workers/createCoplanarPolygonOutlineGeometry.js +1 -1
- package/Build/Workers/createCorridorGeometry.js +1 -1
- package/Build/Workers/createCorridorOutlineGeometry.js +1 -1
- package/Build/Workers/createCylinderGeometry.js +1 -1
- package/Build/Workers/createCylinderOutlineGeometry.js +1 -1
- package/Build/Workers/createEllipseGeometry.js +1 -1
- package/Build/Workers/createEllipseOutlineGeometry.js +1 -1
- package/Build/Workers/createEllipsoidGeometry.js +1 -1
- package/Build/Workers/createEllipsoidOutlineGeometry.js +1 -1
- package/Build/Workers/createFrustumGeometry.js +1 -1
- package/Build/Workers/createFrustumOutlineGeometry.js +1 -1
- package/Build/Workers/createGeometry.js +1 -1
- package/Build/Workers/createGroundPolylineGeometry.js +1 -1
- package/Build/Workers/createPlaneGeometry.js +1 -1
- package/Build/Workers/createPlaneOutlineGeometry.js +1 -1
- package/Build/Workers/createPolygonGeometry.js +1 -1
- package/Build/Workers/createPolygonOutlineGeometry.js +1 -1
- package/Build/Workers/createPolylineGeometry.js +1 -1
- package/Build/Workers/createPolylineVolumeGeometry.js +1 -1
- package/Build/Workers/createPolylineVolumeOutlineGeometry.js +1 -1
- package/Build/Workers/createRectangleGeometry.js +1 -1
- package/Build/Workers/createRectangleOutlineGeometry.js +1 -1
- package/Build/Workers/createSimplePolylineGeometry.js +1 -1
- package/Build/Workers/createSphereGeometry.js +1 -1
- package/Build/Workers/createSphereOutlineGeometry.js +1 -1
- package/Build/Workers/createVectorTileClampedPolylines.js +1 -1
- package/Build/Workers/createVectorTileGeometries.js +1 -1
- package/Build/Workers/createVectorTilePoints.js +1 -1
- package/Build/Workers/createVectorTilePolygons.js +1 -1
- package/Build/Workers/createVectorTilePolylines.js +1 -1
- package/Build/Workers/createVerticesFromGoogleEarthEnterpriseBuffer.js +1 -1
- package/Build/Workers/createVerticesFromHeightmap.js +5 -8
- package/Build/Workers/createVerticesFromQuantizedTerrainMesh.js +10 -15
- package/Build/Workers/createWallGeometry.js +1 -1
- package/Build/Workers/createWallOutlineGeometry.js +1 -1
- package/Build/Workers/decodeDraco.js +1 -1
- package/Build/Workers/decodeI3S.js +1 -1
- package/Build/Workers/package.js +1 -1
- package/Build/Workers/transferTypedArrayTest.js +1 -1
- package/Build/Workers/upsampleQuantizedTerrainMesh.js +1 -1
- package/Source/Core/ArcGISTiledElevationTerrainProvider.js +291 -191
- package/Source/Core/BingMapsGeocoderService.js +19 -1
- package/Source/Core/CartographicGeocoderService.js +15 -0
- package/Source/Core/CesiumTerrainProvider.js +571 -434
- package/Source/Core/Credit.js +1 -1
- package/Source/Core/CustomHeightmapTerrainProvider.js +12 -0
- package/Source/Core/EllipsoidTerrainProvider.js +17 -10
- package/Source/Core/FrustumGeometry.js +4 -3
- package/Source/Core/GeocoderService.js +32 -1
- package/Source/Core/GoogleEarthEnterpriseMetadata.js +86 -34
- package/Source/Core/GoogleEarthEnterpriseTerrainProvider.js +119 -82
- package/Source/Core/Ion.js +1 -1
- package/Source/Core/IonGeocoderService.js +17 -2
- package/Source/Core/IonResource.js +14 -3
- package/Source/Core/OpenCageGeocoderService.js +18 -1
- package/Source/Core/OrientedBoundingBox.js +4 -2
- package/Source/Core/OrthographicFrustum.js +13 -0
- package/Source/Core/PeliasGeocoderService.js +14 -1
- package/Source/Core/PerspectiveFrustum.js +14 -0
- package/Source/Core/Request.js +3 -2
- package/Source/Core/RequestScheduler.js +10 -5
- package/Source/Core/Resource.js +230 -236
- package/Source/Core/TerrainProvider.js +9 -14
- package/Source/Core/TileProviderError.js +8 -8
- package/Source/Core/VRTheWorldTerrainProvider.js +193 -124
- package/Source/Core/buildModuleUrl.js +4 -3
- package/Source/Core/createWorldTerrain.js +20 -2
- package/Source/Core/createWorldTerrainAsync.js +48 -0
- package/Source/Core/sampleTerrain.js +9 -10
- package/Source/Core/sampleTerrainMostDetailed.js +66 -72
- package/Source/DataSources/Cesium3DTilesetVisualizer.js +37 -26
- package/Source/DataSources/DataSourceDisplay.js +2 -2
- package/Source/DataSources/Entity.js +6 -1
- package/Source/DataSources/EntityCluster.js +126 -128
- package/Source/DataSources/ModelVisualizer.js +104 -34
- package/Source/DataSources/PolygonGraphics.js +1 -1
- package/Source/Renderer/UniformState.js +3 -2
- package/Source/Renderer/demodernizeShader.js +5 -5
- package/Source/Scene/ArcGisBaseMapType.js +12 -0
- package/Source/Scene/ArcGisMapServerImageryProvider.js +694 -376
- package/Source/Scene/ArcGisMapService.js +83 -0
- package/Source/Scene/BingMapsImageryProvider.js +511 -305
- package/Source/Scene/BufferLoader.js +29 -34
- package/Source/Scene/Camera.js +8 -7
- package/Source/Scene/Cesium3DTile.js +392 -254
- package/Source/Scene/Cesium3DTileBatchTable.js +2 -2
- package/Source/Scene/Cesium3DTileContent.js +16 -0
- package/Source/Scene/Cesium3DTileContentFactory.js +4 -4
- package/Source/Scene/Cesium3DTilePass.js +8 -11
- package/Source/Scene/Cesium3DTileStyleEngine.js +1 -1
- package/Source/Scene/Cesium3DTilesVoxelProvider.js +225 -117
- package/Source/Scene/Cesium3DTileset.js +756 -482
- package/Source/Scene/Cesium3DTilesetBaseTraversal.js +301 -0
- package/Source/Scene/Cesium3DTilesetMostDetailedTraversal.js +33 -46
- package/Source/Scene/Cesium3DTilesetSkipTraversal.js +421 -0
- package/Source/Scene/Cesium3DTilesetTraversal.js +219 -671
- package/Source/Scene/ClassificationPrimitive.js +7 -0
- package/Source/Scene/Composite3DTileContent.js +69 -26
- package/Source/Scene/CreditDisplay.js +132 -20
- package/Source/Scene/DepthPlane.js +1 -1
- package/Source/Scene/Empty3DTileContent.js +31 -1
- package/Source/Scene/Geometry3DTileContent.js +47 -7
- package/Source/Scene/Globe.js +5 -1
- package/Source/Scene/GlobeSurfaceTile.js +2 -1
- package/Source/Scene/GlobeSurfaceTileProvider.js +53 -30
- package/Source/Scene/GltfBufferViewLoader.js +47 -91
- package/Source/Scene/GltfDracoLoader.js +110 -112
- package/Source/Scene/GltfImageLoader.js +71 -78
- package/Source/Scene/GltfIndexBufferLoader.js +108 -121
- package/Source/Scene/GltfJsonLoader.js +87 -74
- package/Source/Scene/GltfLoader.js +381 -300
- package/Source/Scene/GltfStructuralMetadataLoader.js +109 -110
- package/Source/Scene/GltfTextureLoader.js +97 -96
- package/Source/Scene/GltfVertexBufferLoader.js +128 -133
- package/Source/Scene/GoogleEarthEnterpriseImageryProvider.js +353 -225
- package/Source/Scene/GoogleEarthEnterpriseMapsProvider.js +491 -331
- package/Source/Scene/GridImageryProvider.js +267 -104
- package/Source/Scene/GroundPolylinePrimitive.js +12 -1
- package/Source/Scene/GroundPrimitive.js +8 -1
- package/Source/Scene/I3SDataProvider.js +214 -113
- package/Source/Scene/I3SFeature.js +7 -6
- package/Source/Scene/I3SLayer.js +26 -37
- package/Source/Scene/I3SNode.js +59 -66
- package/Source/Scene/Imagery.js +6 -1
- package/Source/Scene/ImageryLayer.js +299 -48
- package/Source/Scene/ImageryLayerCollection.js +26 -0
- package/Source/Scene/ImageryProvider.js +129 -111
- package/Source/Scene/Implicit3DTileContent.js +72 -23
- package/Source/Scene/ImplicitSubtree.js +66 -45
- package/Source/Scene/IonImageryProvider.js +482 -275
- package/Source/Scene/MapboxImageryProvider.js +272 -112
- package/Source/Scene/MapboxStyleImageryProvider.js +270 -111
- package/Source/Scene/MetadataSchemaLoader.js +26 -36
- package/Source/Scene/Model/B3dmLoader.js +42 -46
- package/Source/Scene/Model/GeoJsonLoader.js +8 -32
- package/Source/Scene/Model/I3dmLoader.js +48 -74
- package/Source/Scene/Model/MaterialPipelineStage.js +12 -12
- package/Source/Scene/Model/Model.js +514 -135
- package/Source/Scene/Model/Model3DTileContent.js +83 -31
- package/Source/Scene/Model/ModelAnimationCollection.js +3 -3
- package/Source/Scene/Model/ModelDrawCommand.js +15 -26
- package/Source/Scene/Model/ModelUtility.js +16 -16
- package/Source/Scene/Model/PntsLoader.js +27 -32
- package/Source/Scene/Model/UniformType.js +1 -1
- package/Source/Scene/Multiple3DTileContent.js +134 -115
- package/Source/Scene/Picking.js +3 -2
- package/Source/Scene/PointCloud.js +11 -19
- package/Source/Scene/Primitive.js +20 -0
- package/Source/Scene/QuadtreePrimitive.js +5 -2
- package/Source/Scene/QuadtreeTileProvider.js +4 -8
- package/Source/Scene/ResourceCache.js +47 -105
- package/Source/Scene/ResourceCacheStatistics.js +24 -58
- package/Source/Scene/ResourceLoader.js +5 -17
- package/Source/Scene/ResourceLoaderState.js +12 -4
- package/Source/Scene/Scene.js +65 -0
- package/Source/Scene/SceneTransforms.js +3 -2
- package/Source/Scene/ScreenSpaceCameraController.js +2 -2
- package/Source/Scene/SingleTileImageryProvider.js +382 -209
- package/Source/Scene/Terrain.js +196 -0
- package/Source/Scene/TileCoordinatesImageryProvider.js +267 -104
- package/Source/Scene/TileMapServiceImageryProvider.js +177 -85
- package/Source/Scene/Tileset3DTileContent.js +47 -5
- package/Source/Scene/TimeDynamicPointCloud.js +15 -2
- package/Source/Scene/UrlTemplateImageryProvider.js +343 -215
- package/Source/Scene/Vector3DTileClampedPolylines.js +96 -84
- package/Source/Scene/Vector3DTileContent.js +47 -22
- package/Source/Scene/Vector3DTileGeometry.js +57 -52
- package/Source/Scene/Vector3DTilePoints.js +97 -81
- package/Source/Scene/Vector3DTilePolygons.js +118 -117
- package/Source/Scene/Vector3DTilePolylines.js +86 -82
- package/Source/Scene/Vector3DTilePrimitive.js +0 -1
- package/Source/Scene/VoxelContent.js +61 -63
- package/Source/Scene/VoxelPrimitive.js +39 -91
- package/Source/Scene/VoxelProvider.js +2 -2
- package/Source/Scene/WebMapServiceImageryProvider.js +272 -111
- package/Source/Scene/WebMapTileServiceImageryProvider.js +270 -107
- package/Source/Scene/computeFlyToLocationForRectangle.js +33 -37
- package/Source/Scene/createOsmBuildings.js +6 -0
- package/Source/Scene/createOsmBuildingsAsync.js +82 -0
- package/Source/Scene/createWorldImagery.js +14 -5
- package/Source/Scene/createWorldImageryAsync.js +39 -0
- package/Source/Shaders/AtmosphereCommon.glsl +51 -8
- package/Source/Shaders/AtmosphereCommon.js +51 -8
- package/Source/Shaders/PostProcessStages/AmbientOcclusionGenerate.glsl +1 -1
- package/Source/Shaders/PostProcessStages/AmbientOcclusionGenerate.js +1 -1
- package/Source/Shaders/PostProcessStages/AmbientOcclusionModulate.glsl +3 -3
- package/Source/Shaders/PostProcessStages/AmbientOcclusionModulate.js +3 -3
- package/Source/Widget/CesiumWidget.js +67 -27
- package/index.d.ts +2429 -1475
- package/index.js +324 -315
- package/package.json +4 -4
- package/Build/Workers/PolygonPipeline-d31ff61c.js +0 -1345
- package/Build/Workers/Transforms-9e9df299.js +0 -14714
|
@@ -1,288 +1,139 @@
|
|
|
1
1
|
import defined from "../Core/defined.js";
|
|
2
|
+
import DeveloperError from "../Core/DeveloperError.js";
|
|
2
3
|
import Intersect from "../Core/Intersect.js";
|
|
3
|
-
import ManagedArray from "../Core/ManagedArray.js";
|
|
4
4
|
import Cesium3DTileOptimizationHint from "./Cesium3DTileOptimizationHint.js";
|
|
5
5
|
import Cesium3DTileRefine from "./Cesium3DTileRefine.js";
|
|
6
6
|
|
|
7
7
|
/**
|
|
8
|
+
* Traverses a {@link Cesium3DTileset} to determine which tiles to load and render.
|
|
9
|
+
* This type describes an interface and is not intended to be instantiated directly.
|
|
10
|
+
*
|
|
11
|
+
* @alias Cesium3DTilesetTraversal
|
|
12
|
+
* @constructor
|
|
13
|
+
* @abstract
|
|
14
|
+
*
|
|
15
|
+
* @see Cesium3DTilesetBaseTraversal
|
|
16
|
+
* @see Cesium3DTilesetSkipTraversal
|
|
17
|
+
* @see Cesium3DTilesetMostDetailedTraversal
|
|
18
|
+
*
|
|
8
19
|
* @private
|
|
9
20
|
*/
|
|
10
21
|
function Cesium3DTilesetTraversal() {}
|
|
11
22
|
|
|
12
|
-
|
|
13
|
-
|
|
14
|
-
|
|
15
|
-
|
|
16
|
-
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
};
|
|
20
|
-
|
|
21
|
-
const emptyTraversal = {
|
|
22
|
-
stack: new ManagedArray(),
|
|
23
|
-
stackMaximumLength: 0,
|
|
24
|
-
};
|
|
25
|
-
|
|
26
|
-
const descendantTraversal = {
|
|
27
|
-
stack: new ManagedArray(),
|
|
28
|
-
stackMaximumLength: 0,
|
|
29
|
-
};
|
|
30
|
-
|
|
31
|
-
const selectionTraversal = {
|
|
32
|
-
stack: new ManagedArray(),
|
|
33
|
-
stackMaximumLength: 0,
|
|
34
|
-
ancestorStack: new ManagedArray(),
|
|
35
|
-
ancestorStackMaximumLength: 0,
|
|
36
|
-
};
|
|
37
|
-
|
|
38
|
-
const descendantSelectionDepth = 2;
|
|
39
|
-
|
|
23
|
+
/**
|
|
24
|
+
* Traverses a {@link Cesium3DTileset} to determine which tiles to load and render.
|
|
25
|
+
*
|
|
26
|
+
* @private
|
|
27
|
+
* @param {Cesium3DTileset} tileset
|
|
28
|
+
* @param {FrameState} frameState
|
|
29
|
+
*/
|
|
40
30
|
Cesium3DTilesetTraversal.selectTiles = function (tileset, frameState) {
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
if (tileset.debugFreezeFrame) {
|
|
44
|
-
return;
|
|
45
|
-
}
|
|
46
|
-
|
|
47
|
-
tileset._selectedTiles.length = 0;
|
|
48
|
-
tileset._selectedTilesToStyle.length = 0;
|
|
49
|
-
tileset._emptyTiles.length = 0;
|
|
50
|
-
tileset._hasMixedContent = false;
|
|
51
|
-
|
|
52
|
-
const root = tileset.root;
|
|
53
|
-
updateTile(tileset, root, frameState);
|
|
54
|
-
|
|
55
|
-
// The root tile is not visible
|
|
56
|
-
if (!isVisible(root)) {
|
|
57
|
-
return;
|
|
58
|
-
}
|
|
59
|
-
|
|
60
|
-
// The tileset doesn't meet the SSE requirement, therefore the tree does not need to be rendered
|
|
61
|
-
if (
|
|
62
|
-
root.getScreenSpaceError(frameState, true) <=
|
|
63
|
-
tileset._maximumScreenSpaceError
|
|
64
|
-
) {
|
|
65
|
-
return;
|
|
66
|
-
}
|
|
31
|
+
DeveloperError.throwInstantiationError();
|
|
32
|
+
};
|
|
67
33
|
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
34
|
+
/**
|
|
35
|
+
* Sort by farthest child first since this is going on a stack
|
|
36
|
+
*
|
|
37
|
+
* @private
|
|
38
|
+
* @param {Cesium3DTile} a
|
|
39
|
+
* @param {Cesium3DTile} b
|
|
40
|
+
* @returns {number}
|
|
41
|
+
*/
|
|
42
|
+
Cesium3DTilesetTraversal.sortChildrenByDistanceToCamera = function (a, b) {
|
|
43
|
+
if (b._distanceToCamera === 0 && a._distanceToCamera === 0) {
|
|
44
|
+
return b._centerZDepth - a._centerZDepth;
|
|
74
45
|
}
|
|
75
46
|
|
|
76
|
-
|
|
77
|
-
emptyTraversal.stack.trim(emptyTraversal.stackMaximumLength);
|
|
78
|
-
descendantTraversal.stack.trim(descendantTraversal.stackMaximumLength);
|
|
79
|
-
selectionTraversal.stack.trim(selectionTraversal.stackMaximumLength);
|
|
80
|
-
selectionTraversal.ancestorStack.trim(
|
|
81
|
-
selectionTraversal.ancestorStackMaximumLength
|
|
82
|
-
);
|
|
83
|
-
|
|
84
|
-
// Update the priority for any requests found during traversal
|
|
85
|
-
// Update after traversal so that min and max values can be used to normalize priority values
|
|
86
|
-
const requestedTiles = tileset._requestedTiles;
|
|
87
|
-
const length = requestedTiles.length;
|
|
88
|
-
for (let i = 0; i < length; ++i) {
|
|
89
|
-
requestedTiles[i].updatePriority();
|
|
90
|
-
}
|
|
47
|
+
return b._distanceToCamera - a._distanceToCamera;
|
|
91
48
|
};
|
|
92
49
|
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
|
|
96
|
-
|
|
97
|
-
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
)
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
function executeSkipTraversal(tileset, root, frameState) {
|
|
106
|
-
const baseScreenSpaceError = Number.MAX_VALUE;
|
|
107
|
-
const maximumScreenSpaceError = tileset._maximumScreenSpaceError;
|
|
108
|
-
executeTraversal(
|
|
109
|
-
tileset,
|
|
110
|
-
root,
|
|
111
|
-
baseScreenSpaceError,
|
|
112
|
-
maximumScreenSpaceError,
|
|
113
|
-
frameState
|
|
114
|
-
);
|
|
115
|
-
traverseAndSelect(tileset, root, frameState);
|
|
116
|
-
}
|
|
117
|
-
|
|
118
|
-
function executeBaseAndSkipTraversal(tileset, root, frameState) {
|
|
119
|
-
const baseScreenSpaceError = Math.max(
|
|
120
|
-
tileset.baseScreenSpaceError,
|
|
121
|
-
tileset.maximumScreenSpaceError
|
|
122
|
-
);
|
|
123
|
-
const maximumScreenSpaceError = tileset.maximumScreenSpaceError;
|
|
124
|
-
executeTraversal(
|
|
125
|
-
tileset,
|
|
126
|
-
root,
|
|
127
|
-
baseScreenSpaceError,
|
|
128
|
-
maximumScreenSpaceError,
|
|
129
|
-
frameState
|
|
130
|
-
);
|
|
131
|
-
traverseAndSelect(tileset, root, frameState);
|
|
132
|
-
}
|
|
133
|
-
|
|
134
|
-
function skipLevelOfDetail(tileset) {
|
|
135
|
-
return tileset._skipLevelOfDetail;
|
|
136
|
-
}
|
|
137
|
-
|
|
138
|
-
function addEmptyTile(tileset, tile) {
|
|
139
|
-
tileset._emptyTiles.push(tile);
|
|
140
|
-
}
|
|
141
|
-
|
|
142
|
-
function selectTile(tileset, tile, frameState) {
|
|
143
|
-
if (tile.contentVisibility(frameState) !== Intersect.OUTSIDE) {
|
|
144
|
-
const tileContent = tile.content;
|
|
145
|
-
if (tileContent.featurePropertiesDirty) {
|
|
146
|
-
// A feature's property in this tile changed, the tile needs to be re-styled.
|
|
147
|
-
tileContent.featurePropertiesDirty = false;
|
|
148
|
-
tile.lastStyleTime = 0; // Force applying the style to this tile
|
|
149
|
-
tileset._selectedTilesToStyle.push(tile);
|
|
150
|
-
} else if (tile._selectedFrame < frameState.frameNumber - 1) {
|
|
151
|
-
// Tile is newly selected; it is selected this frame, but was not selected last frame.
|
|
152
|
-
tileset._selectedTilesToStyle.push(tile);
|
|
153
|
-
}
|
|
154
|
-
tile._selectedFrame = frameState.frameNumber;
|
|
155
|
-
tileset._selectedTiles.push(tile);
|
|
50
|
+
/**
|
|
51
|
+
* Determine if a tile can and should be traversed for children tiles that
|
|
52
|
+
* would contribute to rendering the current view
|
|
53
|
+
*
|
|
54
|
+
* @private
|
|
55
|
+
* @param {Cesium3DTile} tile
|
|
56
|
+
* @returns {boolean}
|
|
57
|
+
*/
|
|
58
|
+
Cesium3DTilesetTraversal.canTraverse = function (tile) {
|
|
59
|
+
if (tile.children.length === 0) {
|
|
60
|
+
return false;
|
|
156
61
|
}
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
stack.push(root);
|
|
162
|
-
while (stack.length > 0) {
|
|
163
|
-
descendantTraversal.stackMaximumLength = Math.max(
|
|
164
|
-
descendantTraversal.stackMaximumLength,
|
|
165
|
-
stack.length
|
|
166
|
-
);
|
|
167
|
-
const tile = stack.pop();
|
|
168
|
-
const children = tile.children;
|
|
169
|
-
const childrenLength = children.length;
|
|
170
|
-
for (let i = 0; i < childrenLength; ++i) {
|
|
171
|
-
const child = children[i];
|
|
172
|
-
if (isVisible(child)) {
|
|
173
|
-
if (child.contentAvailable) {
|
|
174
|
-
updateTile(tileset, child, frameState);
|
|
175
|
-
touchTile(tileset, child, frameState);
|
|
176
|
-
selectTile(tileset, child, frameState);
|
|
177
|
-
} else if (child._depth - root._depth < descendantSelectionDepth) {
|
|
178
|
-
// Continue traversing, but not too far
|
|
179
|
-
stack.push(child);
|
|
180
|
-
}
|
|
181
|
-
}
|
|
182
|
-
}
|
|
62
|
+
if (tile.hasTilesetContent || tile.hasImplicitContent) {
|
|
63
|
+
// Traverse external tileset to visit its root tile
|
|
64
|
+
// Don't traverse if the subtree is expired because it will be destroyed
|
|
65
|
+
return !tile.contentExpired;
|
|
183
66
|
}
|
|
184
|
-
|
|
67
|
+
return tile._screenSpaceError > tile.tileset._maximumScreenSpaceError;
|
|
68
|
+
};
|
|
185
69
|
|
|
186
|
-
|
|
187
|
-
|
|
188
|
-
|
|
189
|
-
|
|
190
|
-
|
|
191
|
-
|
|
70
|
+
/**
|
|
71
|
+
* Mark a tile as selected, and add it to the tileset's list of selected tiles
|
|
72
|
+
*
|
|
73
|
+
* @private
|
|
74
|
+
* @param {Cesium3DTile} tile
|
|
75
|
+
* @param {FrameState} frameState
|
|
76
|
+
*/
|
|
77
|
+
Cesium3DTilesetTraversal.selectTile = function (tile, frameState) {
|
|
78
|
+
if (tile.contentVisibility(frameState) === Intersect.OUTSIDE) {
|
|
192
79
|
return;
|
|
193
80
|
}
|
|
194
81
|
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
199
|
-
|
|
200
|
-
|
|
201
|
-
|
|
202
|
-
|
|
203
|
-
|
|
204
|
-
// This happens often for immediatelyLoadDesiredLevelOfDetail where parent tiles are not necessarily loaded before zooming out.
|
|
205
|
-
selectDescendants(tileset, tile, frameState);
|
|
82
|
+
const { content, tileset } = tile;
|
|
83
|
+
if (content.featurePropertiesDirty) {
|
|
84
|
+
// A feature's property in this tile changed, the tile needs to be re-styled.
|
|
85
|
+
content.featurePropertiesDirty = false;
|
|
86
|
+
tile.lastStyleTime = 0; // Force applying the style to this tile
|
|
87
|
+
tileset._selectedTilesToStyle.push(tile);
|
|
88
|
+
} else if (tile._selectedFrame < frameState.frameNumber - 1) {
|
|
89
|
+
// Tile is newly selected; it is selected this frame, but was not selected last frame.
|
|
90
|
+
tileset._selectedTilesToStyle.push(tile);
|
|
206
91
|
}
|
|
207
|
-
|
|
92
|
+
tile._selectedFrame = frameState.frameNumber;
|
|
93
|
+
tileset._selectedTiles.push(tile);
|
|
94
|
+
};
|
|
208
95
|
|
|
209
|
-
|
|
210
|
-
|
|
96
|
+
/**
|
|
97
|
+
* @private
|
|
98
|
+
* @param {Cesium3DTile} tile
|
|
99
|
+
* @param {FrameState} frameState
|
|
100
|
+
*/
|
|
101
|
+
Cesium3DTilesetTraversal.visitTile = function (tile, frameState) {
|
|
102
|
+
++tile.tileset._statistics.visited;
|
|
211
103
|
tile._visitedFrame = frameState.frameNumber;
|
|
212
|
-
}
|
|
104
|
+
};
|
|
213
105
|
|
|
214
|
-
|
|
106
|
+
/**
|
|
107
|
+
* @private
|
|
108
|
+
* @param {Cesium3DTile} tile
|
|
109
|
+
* @param {FrameState} frameState
|
|
110
|
+
*/
|
|
111
|
+
Cesium3DTilesetTraversal.touchTile = function (tile, frameState) {
|
|
215
112
|
if (tile._touchedFrame === frameState.frameNumber) {
|
|
216
113
|
// Prevents another pass from touching the frame again
|
|
217
114
|
return;
|
|
218
115
|
}
|
|
219
|
-
tileset._cache.touch(tile);
|
|
116
|
+
tile.tileset._cache.touch(tile);
|
|
220
117
|
tile._touchedFrame = frameState.frameNumber;
|
|
221
|
-
}
|
|
222
|
-
|
|
223
|
-
function updateMinimumMaximumPriority(tileset, tile) {
|
|
224
|
-
tileset._maximumPriority.distance = Math.max(
|
|
225
|
-
tile._priorityHolder._distanceToCamera,
|
|
226
|
-
tileset._maximumPriority.distance
|
|
227
|
-
);
|
|
228
|
-
tileset._minimumPriority.distance = Math.min(
|
|
229
|
-
tile._priorityHolder._distanceToCamera,
|
|
230
|
-
tileset._minimumPriority.distance
|
|
231
|
-
);
|
|
232
|
-
tileset._maximumPriority.depth = Math.max(
|
|
233
|
-
tile._depth,
|
|
234
|
-
tileset._maximumPriority.depth
|
|
235
|
-
);
|
|
236
|
-
tileset._minimumPriority.depth = Math.min(
|
|
237
|
-
tile._depth,
|
|
238
|
-
tileset._minimumPriority.depth
|
|
239
|
-
);
|
|
240
|
-
tileset._maximumPriority.foveatedFactor = Math.max(
|
|
241
|
-
tile._priorityHolder._foveatedFactor,
|
|
242
|
-
tileset._maximumPriority.foveatedFactor
|
|
243
|
-
);
|
|
244
|
-
tileset._minimumPriority.foveatedFactor = Math.min(
|
|
245
|
-
tile._priorityHolder._foveatedFactor,
|
|
246
|
-
tileset._minimumPriority.foveatedFactor
|
|
247
|
-
);
|
|
248
|
-
tileset._maximumPriority.reverseScreenSpaceError = Math.max(
|
|
249
|
-
tile._priorityReverseScreenSpaceError,
|
|
250
|
-
tileset._maximumPriority.reverseScreenSpaceError
|
|
251
|
-
);
|
|
252
|
-
tileset._minimumPriority.reverseScreenSpaceError = Math.min(
|
|
253
|
-
tile._priorityReverseScreenSpaceError,
|
|
254
|
-
tileset._minimumPriority.reverseScreenSpaceError
|
|
255
|
-
);
|
|
256
|
-
}
|
|
257
|
-
|
|
258
|
-
function isOnScreenLongEnough(tileset, tile, frameState) {
|
|
259
|
-
// Prevent unnecessary loads while camera is moving by getting the ratio of travel distance to tile size.
|
|
260
|
-
if (!tileset._cullRequestsWhileMoving) {
|
|
261
|
-
return true;
|
|
262
|
-
}
|
|
263
|
-
|
|
264
|
-
const sphere = tile.boundingSphere;
|
|
265
|
-
const diameter = Math.max(sphere.radius * 2.0, 1.0);
|
|
266
|
-
|
|
267
|
-
const camera = frameState.camera;
|
|
268
|
-
const deltaMagnitude =
|
|
269
|
-
camera.positionWCDeltaMagnitude !== 0.0
|
|
270
|
-
? camera.positionWCDeltaMagnitude
|
|
271
|
-
: camera.positionWCDeltaMagnitudeLastFrame;
|
|
272
|
-
const movementRatio =
|
|
273
|
-
(tileset.cullRequestsWhileMovingMultiplier * deltaMagnitude) / diameter; // How do n frames of this movement compare to the tile's physical size.
|
|
274
|
-
return movementRatio < 1.0;
|
|
275
|
-
}
|
|
118
|
+
};
|
|
276
119
|
|
|
277
|
-
|
|
120
|
+
/**
|
|
121
|
+
* Add a tile to the list of requested tiles, if appropriate
|
|
122
|
+
*
|
|
123
|
+
* @private
|
|
124
|
+
* @param {Cesium3DTile} tile
|
|
125
|
+
* @param {FrameState} frameState
|
|
126
|
+
*/
|
|
127
|
+
Cesium3DTilesetTraversal.loadTile = function (tile, frameState) {
|
|
128
|
+
const { tileset } = tile;
|
|
278
129
|
if (
|
|
279
130
|
tile._requestedFrame === frameState.frameNumber ||
|
|
280
|
-
(!
|
|
131
|
+
(!tile.hasUnloadedRenderableContent && !tile.contentExpired)
|
|
281
132
|
) {
|
|
282
133
|
return;
|
|
283
134
|
}
|
|
284
135
|
|
|
285
|
-
if (!isOnScreenLongEnough(
|
|
136
|
+
if (!isOnScreenLongEnough(tile, frameState)) {
|
|
286
137
|
return;
|
|
287
138
|
}
|
|
288
139
|
|
|
@@ -294,53 +145,68 @@ function loadTile(tileset, tile, frameState) {
|
|
|
294
145
|
|
|
295
146
|
tile._requestedFrame = frameState.frameNumber;
|
|
296
147
|
tileset._requestedTiles.push(tile);
|
|
297
|
-
}
|
|
148
|
+
};
|
|
298
149
|
|
|
299
|
-
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
|
|
303
|
-
|
|
150
|
+
/**
|
|
151
|
+
* Prevent unnecessary loads while camera is moving by getting the ratio of travel distance to tile size.
|
|
152
|
+
*
|
|
153
|
+
* @private
|
|
154
|
+
* @param {Cesium3DTile} tile
|
|
155
|
+
* @param {FrameState} frameState
|
|
156
|
+
* @returns {boolean}
|
|
157
|
+
*/
|
|
158
|
+
function isOnScreenLongEnough(tile, frameState) {
|
|
159
|
+
const { tileset } = tile;
|
|
160
|
+
if (!tileset._cullRequestsWhileMoving) {
|
|
161
|
+
return true;
|
|
304
162
|
}
|
|
305
163
|
|
|
306
|
-
|
|
307
|
-
|
|
308
|
-
|
|
164
|
+
const {
|
|
165
|
+
positionWCDeltaMagnitude,
|
|
166
|
+
positionWCDeltaMagnitudeLastFrame,
|
|
167
|
+
} = frameState.camera;
|
|
168
|
+
const deltaMagnitude =
|
|
169
|
+
positionWCDeltaMagnitude !== 0.0
|
|
170
|
+
? positionWCDeltaMagnitude
|
|
171
|
+
: positionWCDeltaMagnitudeLastFrame;
|
|
309
172
|
|
|
310
|
-
|
|
311
|
-
|
|
312
|
-
const
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
|
|
316
|
-
updateVisibility(tileset, child, frameState);
|
|
317
|
-
anyVisible = anyVisible || isVisible(child);
|
|
318
|
-
}
|
|
319
|
-
return anyVisible;
|
|
173
|
+
// How do n frames of this movement compare to the tile's physical size.
|
|
174
|
+
const diameter = Math.max(tile.boundingSphere.radius * 2.0, 1.0);
|
|
175
|
+
const movementRatio =
|
|
176
|
+
(tileset.cullRequestsWhileMovingMultiplier * deltaMagnitude) / diameter;
|
|
177
|
+
|
|
178
|
+
return movementRatio < 1.0;
|
|
320
179
|
}
|
|
321
180
|
|
|
322
|
-
|
|
323
|
-
|
|
324
|
-
|
|
325
|
-
|
|
326
|
-
|
|
327
|
-
|
|
328
|
-
|
|
329
|
-
|
|
330
|
-
|
|
331
|
-
|
|
181
|
+
/**
|
|
182
|
+
* Reset some of the tile's flags and re-evaluate visibility and priority
|
|
183
|
+
*
|
|
184
|
+
* @private
|
|
185
|
+
* @param {Cesium3DTile} tile
|
|
186
|
+
* @param {FrameState} frameState
|
|
187
|
+
*/
|
|
188
|
+
Cesium3DTilesetTraversal.updateTile = function (tile, frameState) {
|
|
189
|
+
updateTileVisibility(tile, frameState);
|
|
190
|
+
tile.updateExpiration();
|
|
332
191
|
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
|
|
336
|
-
tileset._maximumScreenSpaceError
|
|
337
|
-
);
|
|
338
|
-
}
|
|
192
|
+
tile._wasMinPriorityChild = false;
|
|
193
|
+
tile._priorityHolder = tile;
|
|
194
|
+
updateMinimumMaximumPriority(tile);
|
|
339
195
|
|
|
340
|
-
|
|
341
|
-
|
|
196
|
+
// SkipLOD
|
|
197
|
+
tile._shouldSelect = false;
|
|
198
|
+
tile._finalResolution = true;
|
|
199
|
+
};
|
|
342
200
|
|
|
343
|
-
|
|
201
|
+
/**
|
|
202
|
+
* @private
|
|
203
|
+
* @param {Cesium3DTile} tile
|
|
204
|
+
* @param {FrameState} frameState
|
|
205
|
+
*/
|
|
206
|
+
function updateTileVisibility(tile, frameState) {
|
|
207
|
+
tile.updateVisibility(frameState);
|
|
208
|
+
|
|
209
|
+
if (!tile.isVisible) {
|
|
344
210
|
return;
|
|
345
211
|
}
|
|
346
212
|
|
|
@@ -350,12 +216,12 @@ function updateTileVisibility(tileset, tile, frameState) {
|
|
|
350
216
|
// The root tile may be culled by the children bounds optimization in which
|
|
351
217
|
// case this tile should also be culled.
|
|
352
218
|
const child = tile.children[0];
|
|
353
|
-
updateTileVisibility(
|
|
219
|
+
updateTileVisibility(child, frameState);
|
|
354
220
|
tile._visible = child._visible;
|
|
355
221
|
return;
|
|
356
222
|
}
|
|
357
223
|
|
|
358
|
-
if (meetsScreenSpaceErrorEarly(
|
|
224
|
+
if (meetsScreenSpaceErrorEarly(tile, frameState)) {
|
|
359
225
|
tile._visible = false;
|
|
360
226
|
return;
|
|
361
227
|
}
|
|
@@ -366,408 +232,90 @@ function updateTileVisibility(tileset, tile, frameState) {
|
|
|
366
232
|
tile._optimChildrenWithinParent ===
|
|
367
233
|
Cesium3DTileOptimizationHint.USE_OPTIMIZATION;
|
|
368
234
|
if (replace && useOptimization && hasChildren) {
|
|
369
|
-
if (!anyChildrenVisible(
|
|
370
|
-
++tileset._statistics.numberOfTilesCulledWithChildrenUnion;
|
|
235
|
+
if (!anyChildrenVisible(tile, frameState)) {
|
|
236
|
+
++tile.tileset._statistics.numberOfTilesCulledWithChildrenUnion;
|
|
371
237
|
tile._visible = false;
|
|
372
238
|
return;
|
|
373
239
|
}
|
|
374
240
|
}
|
|
375
241
|
}
|
|
376
242
|
|
|
377
|
-
|
|
378
|
-
|
|
379
|
-
|
|
380
|
-
|
|
381
|
-
|
|
382
|
-
|
|
383
|
-
|
|
384
|
-
|
|
385
|
-
|
|
386
|
-
|
|
387
|
-
|
|
388
|
-
|
|
389
|
-
|
|
390
|
-
|
|
391
|
-
|
|
392
|
-
function updateTileAncestorContentLinks(tile, frameState) {
|
|
393
|
-
tile._ancestorWithContent = undefined;
|
|
394
|
-
tile._ancestorWithContentAvailable = undefined;
|
|
395
|
-
|
|
396
|
-
const parent = tile.parent;
|
|
397
|
-
if (defined(parent)) {
|
|
398
|
-
// ancestorWithContent is an ancestor that has content or has the potential to have
|
|
399
|
-
// content. Used in conjunction with tileset.skipLevels to know when to skip a tile.
|
|
400
|
-
// ancestorWithContentAvailable is an ancestor that is rendered if a desired tile is not loaded.
|
|
401
|
-
const hasContent =
|
|
402
|
-
!hasUnloadedContent(parent) ||
|
|
403
|
-
parent._requestedFrame === frameState.frameNumber;
|
|
404
|
-
tile._ancestorWithContent = hasContent
|
|
405
|
-
? parent
|
|
406
|
-
: parent._ancestorWithContent;
|
|
407
|
-
tile._ancestorWithContentAvailable = parent.contentAvailable
|
|
408
|
-
? parent
|
|
409
|
-
: parent._ancestorWithContentAvailable; // Links a descendant up to its contentAvailable ancestor as the traversal progresses.
|
|
243
|
+
/**
|
|
244
|
+
* @private
|
|
245
|
+
* @param {Cesium3DTile} tile
|
|
246
|
+
* @param {FrameState} frameState
|
|
247
|
+
* @returns {boolean}
|
|
248
|
+
*/
|
|
249
|
+
function meetsScreenSpaceErrorEarly(tile, frameState) {
|
|
250
|
+
const { parent, tileset } = tile;
|
|
251
|
+
if (
|
|
252
|
+
!defined(parent) ||
|
|
253
|
+
parent.hasTilesetContent ||
|
|
254
|
+
parent.hasImplicitContent ||
|
|
255
|
+
parent.refine !== Cesium3DTileRefine.ADD
|
|
256
|
+
) {
|
|
257
|
+
return false;
|
|
410
258
|
}
|
|
411
|
-
}
|
|
412
|
-
|
|
413
|
-
function hasEmptyContent(tile) {
|
|
414
|
-
return (
|
|
415
|
-
tile.hasEmptyContent || tile.hasTilesetContent || tile.hasImplicitContent
|
|
416
|
-
);
|
|
417
|
-
}
|
|
418
259
|
|
|
419
|
-
|
|
420
|
-
return !hasEmptyContent(tile) && tile.contentUnloaded;
|
|
421
|
-
}
|
|
422
|
-
|
|
423
|
-
function reachedSkippingThreshold(tileset, tile) {
|
|
424
|
-
const ancestor = tile._ancestorWithContent;
|
|
260
|
+
// Use parent's geometric error with child's box to see if the tile already meet the SSE
|
|
425
261
|
return (
|
|
426
|
-
|
|
427
|
-
|
|
428
|
-
(defined(ancestor) &&
|
|
429
|
-
tile._screenSpaceError <
|
|
430
|
-
ancestor._screenSpaceError / tileset.skipScreenSpaceErrorFactor &&
|
|
431
|
-
tile._depth > ancestor._depth + tileset.skipLevels))
|
|
262
|
+
tile.getScreenSpaceError(frameState, true) <=
|
|
263
|
+
tileset._maximumScreenSpaceError
|
|
432
264
|
);
|
|
433
265
|
}
|
|
434
266
|
|
|
435
|
-
|
|
436
|
-
|
|
437
|
-
|
|
438
|
-
|
|
439
|
-
|
|
440
|
-
|
|
441
|
-
|
|
442
|
-
|
|
443
|
-
|
|
444
|
-
function updateAndPushChildren(tileset, tile, stack, frameState) {
|
|
445
|
-
let i;
|
|
446
|
-
const replace = tile.refine === Cesium3DTileRefine.REPLACE;
|
|
267
|
+
/**
|
|
268
|
+
* @private
|
|
269
|
+
* @param {Cesium3DTile} tile
|
|
270
|
+
* @param {FrameState} frameState
|
|
271
|
+
* @returns {boolean}
|
|
272
|
+
*/
|
|
273
|
+
function anyChildrenVisible(tile, frameState) {
|
|
274
|
+
let anyVisible = false;
|
|
447
275
|
const children = tile.children;
|
|
448
|
-
|
|
449
|
-
|
|
450
|
-
|
|
451
|
-
|
|
452
|
-
}
|
|
453
|
-
|
|
454
|
-
// Sort by distance to take advantage of early Z and reduce artifacts for skipLevelOfDetail
|
|
455
|
-
children.sort(sortChildrenByDistanceToCamera);
|
|
456
|
-
|
|
457
|
-
// For traditional replacement refinement only refine if all children are loaded.
|
|
458
|
-
// Empty tiles are exempt since it looks better if children stream in as they are loaded to fill the empty space.
|
|
459
|
-
const checkRefines =
|
|
460
|
-
!skipLevelOfDetail(tileset) && replace && !hasEmptyContent(tile);
|
|
461
|
-
let refines = true;
|
|
462
|
-
|
|
463
|
-
let anyChildrenVisible = false;
|
|
464
|
-
|
|
465
|
-
// Determining min child
|
|
466
|
-
let minIndex = -1;
|
|
467
|
-
let minimumPriority = Number.MAX_VALUE;
|
|
468
|
-
|
|
469
|
-
let child;
|
|
470
|
-
for (i = 0; i < length; ++i) {
|
|
471
|
-
child = children[i];
|
|
472
|
-
if (isVisible(child)) {
|
|
473
|
-
stack.push(child);
|
|
474
|
-
if (child._foveatedFactor < minimumPriority) {
|
|
475
|
-
minIndex = i;
|
|
476
|
-
minimumPriority = child._foveatedFactor;
|
|
477
|
-
}
|
|
478
|
-
anyChildrenVisible = true;
|
|
479
|
-
} else if (checkRefines || tileset.loadSiblings) {
|
|
480
|
-
// Keep non-visible children loaded since they are still needed before the parent can refine.
|
|
481
|
-
// Or loadSiblings is true so always load tiles regardless of visibility.
|
|
482
|
-
if (child._foveatedFactor < minimumPriority) {
|
|
483
|
-
minIndex = i;
|
|
484
|
-
minimumPriority = child._foveatedFactor;
|
|
485
|
-
}
|
|
486
|
-
loadTile(tileset, child, frameState);
|
|
487
|
-
touchTile(tileset, child, frameState);
|
|
488
|
-
}
|
|
489
|
-
if (checkRefines) {
|
|
490
|
-
let childRefines;
|
|
491
|
-
if (!child._inRequestVolume) {
|
|
492
|
-
childRefines = false;
|
|
493
|
-
} else if (hasEmptyContent(child)) {
|
|
494
|
-
childRefines = executeEmptyTraversal(tileset, child, frameState);
|
|
495
|
-
} else {
|
|
496
|
-
childRefines = child.contentAvailable;
|
|
497
|
-
}
|
|
498
|
-
refines = refines && childRefines;
|
|
499
|
-
}
|
|
500
|
-
}
|
|
501
|
-
|
|
502
|
-
if (!anyChildrenVisible) {
|
|
503
|
-
refines = false;
|
|
504
|
-
}
|
|
505
|
-
|
|
506
|
-
if (minIndex !== -1 && !skipLevelOfDetail(tileset) && replace) {
|
|
507
|
-
// An ancestor will hold the _foveatedFactor and _distanceToCamera for descendants between itself and its highest priority descendant. Siblings of a min children along the way use this ancestor as their priority holder as well.
|
|
508
|
-
// Priority of all tiles that refer to the _foveatedFactor and _distanceToCamera stored in the common ancestor will be differentiated based on their _depth.
|
|
509
|
-
const minPriorityChild = children[minIndex];
|
|
510
|
-
minPriorityChild._wasMinPriorityChild = true;
|
|
511
|
-
const priorityHolder =
|
|
512
|
-
(tile._wasMinPriorityChild || tile === tileset.root) &&
|
|
513
|
-
minimumPriority <= tile._priorityHolder._foveatedFactor
|
|
514
|
-
? tile._priorityHolder
|
|
515
|
-
: tile; // This is where priority dependency chains are wired up or started anew.
|
|
516
|
-
priorityHolder._foveatedFactor = Math.min(
|
|
517
|
-
minPriorityChild._foveatedFactor,
|
|
518
|
-
priorityHolder._foveatedFactor
|
|
519
|
-
);
|
|
520
|
-
priorityHolder._distanceToCamera = Math.min(
|
|
521
|
-
minPriorityChild._distanceToCamera,
|
|
522
|
-
priorityHolder._distanceToCamera
|
|
523
|
-
);
|
|
524
|
-
|
|
525
|
-
for (i = 0; i < length; ++i) {
|
|
526
|
-
child = children[i];
|
|
527
|
-
child._priorityHolder = priorityHolder;
|
|
528
|
-
}
|
|
529
|
-
}
|
|
530
|
-
|
|
531
|
-
return refines;
|
|
532
|
-
}
|
|
533
|
-
|
|
534
|
-
function inBaseTraversal(tileset, tile, baseScreenSpaceError) {
|
|
535
|
-
if (!skipLevelOfDetail(tileset)) {
|
|
536
|
-
return true;
|
|
537
|
-
}
|
|
538
|
-
if (tileset.immediatelyLoadDesiredLevelOfDetail) {
|
|
539
|
-
return false;
|
|
540
|
-
}
|
|
541
|
-
if (!defined(tile._ancestorWithContent)) {
|
|
542
|
-
// Include root or near-root tiles in the base traversal so there is something to select up to
|
|
543
|
-
return true;
|
|
544
|
-
}
|
|
545
|
-
if (tile._screenSpaceError === 0.0) {
|
|
546
|
-
// If a leaf, use parent's SSE
|
|
547
|
-
return tile.parent._screenSpaceError > baseScreenSpaceError;
|
|
548
|
-
}
|
|
549
|
-
return tile._screenSpaceError > baseScreenSpaceError;
|
|
550
|
-
}
|
|
551
|
-
|
|
552
|
-
function canTraverse(tileset, tile) {
|
|
553
|
-
if (tile.children.length === 0) {
|
|
554
|
-
return false;
|
|
555
|
-
}
|
|
556
|
-
if (tile.hasTilesetContent || tile.hasImplicitContent) {
|
|
557
|
-
// Traverse external tileset to visit its root tile
|
|
558
|
-
// Don't traverse if the subtree is expired because it will be destroyed
|
|
559
|
-
return !tile.contentExpired;
|
|
560
|
-
}
|
|
561
|
-
return tile._screenSpaceError > tileset._maximumScreenSpaceError;
|
|
562
|
-
}
|
|
563
|
-
|
|
564
|
-
function executeTraversal(
|
|
565
|
-
tileset,
|
|
566
|
-
root,
|
|
567
|
-
baseScreenSpaceError,
|
|
568
|
-
maximumScreenSpaceError,
|
|
569
|
-
frameState
|
|
570
|
-
) {
|
|
571
|
-
// Depth-first traversal that traverses all visible tiles and marks tiles for selection.
|
|
572
|
-
// If skipLevelOfDetail is off then a tile does not refine until all children are loaded.
|
|
573
|
-
// This is the traditional replacement refinement approach and is called the base traversal.
|
|
574
|
-
// Tiles that have a greater screen space error than the base screen space error are part of the base traversal,
|
|
575
|
-
// all other tiles are part of the skip traversal. The skip traversal allows for skipping levels of the tree
|
|
576
|
-
// and rendering children and parent tiles simultaneously.
|
|
577
|
-
const stack = traversal.stack;
|
|
578
|
-
stack.push(root);
|
|
579
|
-
|
|
580
|
-
while (stack.length > 0) {
|
|
581
|
-
traversal.stackMaximumLength = Math.max(
|
|
582
|
-
traversal.stackMaximumLength,
|
|
583
|
-
stack.length
|
|
584
|
-
);
|
|
585
|
-
|
|
586
|
-
const tile = stack.pop();
|
|
587
|
-
|
|
588
|
-
updateTileAncestorContentLinks(tile, frameState);
|
|
589
|
-
const baseTraversal = inBaseTraversal(tileset, tile, baseScreenSpaceError);
|
|
590
|
-
const add = tile.refine === Cesium3DTileRefine.ADD;
|
|
591
|
-
const replace = tile.refine === Cesium3DTileRefine.REPLACE;
|
|
592
|
-
const parent = tile.parent;
|
|
593
|
-
const parentRefines = !defined(parent) || parent._refines;
|
|
594
|
-
let refines = false;
|
|
595
|
-
|
|
596
|
-
if (canTraverse(tileset, tile)) {
|
|
597
|
-
refines =
|
|
598
|
-
updateAndPushChildren(tileset, tile, stack, frameState) &&
|
|
599
|
-
parentRefines;
|
|
600
|
-
}
|
|
601
|
-
|
|
602
|
-
const stoppedRefining = !refines && parentRefines;
|
|
603
|
-
|
|
604
|
-
if (hasEmptyContent(tile)) {
|
|
605
|
-
// Add empty tile just to show its debug bounding volume
|
|
606
|
-
// If the tile has tileset content load the external tileset
|
|
607
|
-
// If the tile cannot refine further select its nearest loaded ancestor
|
|
608
|
-
addEmptyTile(tileset, tile, frameState);
|
|
609
|
-
loadTile(tileset, tile, frameState);
|
|
610
|
-
if (stoppedRefining) {
|
|
611
|
-
selectDesiredTile(tileset, tile, frameState);
|
|
612
|
-
}
|
|
613
|
-
} else if (add) {
|
|
614
|
-
// Additive tiles are always loaded and selected
|
|
615
|
-
selectDesiredTile(tileset, tile, frameState);
|
|
616
|
-
loadTile(tileset, tile, frameState);
|
|
617
|
-
} else if (replace) {
|
|
618
|
-
if (baseTraversal) {
|
|
619
|
-
// Always load tiles in the base traversal
|
|
620
|
-
// Select tiles that can't refine further
|
|
621
|
-
loadTile(tileset, tile, frameState);
|
|
622
|
-
if (stoppedRefining) {
|
|
623
|
-
selectDesiredTile(tileset, tile, frameState);
|
|
624
|
-
}
|
|
625
|
-
} else if (stoppedRefining) {
|
|
626
|
-
// In skip traversal, load and select tiles that can't refine further
|
|
627
|
-
selectDesiredTile(tileset, tile, frameState);
|
|
628
|
-
loadTile(tileset, tile, frameState);
|
|
629
|
-
} else if (reachedSkippingThreshold(tileset, tile)) {
|
|
630
|
-
// In skip traversal, load tiles that aren't skipped. In practice roughly half the tiles stay unloaded.
|
|
631
|
-
loadTile(tileset, tile, frameState);
|
|
632
|
-
}
|
|
633
|
-
}
|
|
634
|
-
|
|
635
|
-
visitTile(tileset, tile, frameState);
|
|
636
|
-
touchTile(tileset, tile, frameState);
|
|
637
|
-
tile._refines = refines;
|
|
638
|
-
}
|
|
639
|
-
}
|
|
640
|
-
|
|
641
|
-
function executeEmptyTraversal(tileset, root, frameState) {
|
|
642
|
-
// Depth-first traversal that checks if all nearest descendants with content are loaded. Ignores visibility.
|
|
643
|
-
let allDescendantsLoaded = true;
|
|
644
|
-
const stack = emptyTraversal.stack;
|
|
645
|
-
stack.push(root);
|
|
646
|
-
|
|
647
|
-
while (stack.length > 0) {
|
|
648
|
-
emptyTraversal.stackMaximumLength = Math.max(
|
|
649
|
-
emptyTraversal.stackMaximumLength,
|
|
650
|
-
stack.length
|
|
651
|
-
);
|
|
652
|
-
|
|
653
|
-
const tile = stack.pop();
|
|
654
|
-
const children = tile.children;
|
|
655
|
-
const childrenLength = children.length;
|
|
656
|
-
|
|
657
|
-
// Only traverse if the tile is empty - traversal stop at descendants with content
|
|
658
|
-
const emptyContent = hasEmptyContent(tile);
|
|
659
|
-
const traverse = emptyContent && canTraverse(tileset, tile);
|
|
660
|
-
const emptyLeaf = emptyContent && tile.children.length === 0;
|
|
661
|
-
|
|
662
|
-
// Traversal stops but the tile does not have content yet
|
|
663
|
-
// There will be holes if the parent tries to refine to its children, so don't refine
|
|
664
|
-
// One exception: a parent may refine even if one of its descendants is an empty leaf
|
|
665
|
-
if (!traverse && !tile.contentAvailable && !emptyLeaf) {
|
|
666
|
-
allDescendantsLoaded = false;
|
|
667
|
-
}
|
|
668
|
-
|
|
669
|
-
updateTile(tileset, tile, frameState);
|
|
670
|
-
if (!isVisible(tile)) {
|
|
671
|
-
// Load tiles that aren't visible since they are still needed for the parent to refine
|
|
672
|
-
loadTile(tileset, tile, frameState);
|
|
673
|
-
touchTile(tileset, tile, frameState);
|
|
674
|
-
}
|
|
675
|
-
|
|
676
|
-
if (traverse) {
|
|
677
|
-
for (let i = 0; i < childrenLength; ++i) {
|
|
678
|
-
const child = children[i];
|
|
679
|
-
stack.push(child);
|
|
680
|
-
}
|
|
681
|
-
}
|
|
276
|
+
for (let i = 0; i < children.length; ++i) {
|
|
277
|
+
const child = children[i];
|
|
278
|
+
child.updateVisibility(frameState);
|
|
279
|
+
anyVisible = anyVisible || child.isVisible;
|
|
682
280
|
}
|
|
683
|
-
|
|
684
|
-
return allDescendantsLoaded;
|
|
281
|
+
return anyVisible;
|
|
685
282
|
}
|
|
686
283
|
|
|
687
284
|
/**
|
|
688
|
-
* Traverse the tree and check if their selected frame is the current frame. If so, add it to a selection queue.
|
|
689
|
-
* This is a preorder traversal so children tiles are selected before ancestor tiles.
|
|
690
|
-
*
|
|
691
|
-
* The reason for the preorder traversal is so that tiles can easily be marked with their
|
|
692
|
-
* selection depth. A tile's _selectionDepth is its depth in the tree where all non-selected tiles are removed.
|
|
693
|
-
* This property is important for use in the stencil test because we want to render deeper tiles on top of their
|
|
694
|
-
* ancestors. If a tileset is very deep, the depth is unlikely to fit into the stencil buffer.
|
|
695
|
-
*
|
|
696
|
-
* We want to select children before their ancestors because there is no guarantee on the relationship between
|
|
697
|
-
* the children's z-depth and the ancestor's z-depth. We cannot rely on Z because we want the child to appear on top
|
|
698
|
-
* of ancestor regardless of true depth. The stencil tests used require children to be drawn first.
|
|
699
|
-
*
|
|
700
|
-
* NOTE: 3D Tiles uses 3 bits from the stencil buffer meaning this will not work when there is a chain of
|
|
701
|
-
* selected tiles that is deeper than 7. This is not very likely.
|
|
702
285
|
* @private
|
|
286
|
+
* @param {Cesium3DTile} tile
|
|
703
287
|
*/
|
|
704
|
-
function
|
|
705
|
-
const
|
|
706
|
-
const
|
|
707
|
-
|
|
708
|
-
|
|
709
|
-
|
|
710
|
-
|
|
711
|
-
|
|
712
|
-
|
|
713
|
-
|
|
714
|
-
|
|
715
|
-
|
|
716
|
-
|
|
717
|
-
|
|
718
|
-
|
|
719
|
-
|
|
720
|
-
|
|
721
|
-
|
|
722
|
-
|
|
723
|
-
|
|
724
|
-
|
|
725
|
-
|
|
726
|
-
|
|
727
|
-
|
|
728
|
-
|
|
729
|
-
|
|
730
|
-
|
|
731
|
-
|
|
732
|
-
|
|
733
|
-
|
|
734
|
-
|
|
735
|
-
// stack is empty but ancestorStack isn't
|
|
736
|
-
continue;
|
|
737
|
-
}
|
|
738
|
-
|
|
739
|
-
const add = tile.refine === Cesium3DTileRefine.ADD;
|
|
740
|
-
const shouldSelect = tile._shouldSelect;
|
|
741
|
-
const children = tile.children;
|
|
742
|
-
const childrenLength = children.length;
|
|
743
|
-
const traverse = canTraverse(tileset, tile);
|
|
744
|
-
|
|
745
|
-
if (shouldSelect) {
|
|
746
|
-
if (add) {
|
|
747
|
-
selectTile(tileset, tile, frameState);
|
|
748
|
-
} else {
|
|
749
|
-
tile._selectionDepth = ancestorStack.length;
|
|
750
|
-
if (tile._selectionDepth > 0) {
|
|
751
|
-
tileset._hasMixedContent = true;
|
|
752
|
-
}
|
|
753
|
-
lastAncestor = tile;
|
|
754
|
-
if (!traverse) {
|
|
755
|
-
selectTile(tileset, tile, frameState);
|
|
756
|
-
continue;
|
|
757
|
-
}
|
|
758
|
-
ancestorStack.push(tile);
|
|
759
|
-
tile._stackLength = stack.length;
|
|
760
|
-
}
|
|
761
|
-
}
|
|
762
|
-
|
|
763
|
-
if (traverse) {
|
|
764
|
-
for (let i = 0; i < childrenLength; ++i) {
|
|
765
|
-
const child = children[i];
|
|
766
|
-
if (isVisible(child)) {
|
|
767
|
-
stack.push(child);
|
|
768
|
-
}
|
|
769
|
-
}
|
|
770
|
-
}
|
|
771
|
-
}
|
|
288
|
+
function updateMinimumMaximumPriority(tile) {
|
|
289
|
+
const minimumPriority = tile.tileset._minimumPriority;
|
|
290
|
+
const maximumPriority = tile.tileset._maximumPriority;
|
|
291
|
+
const priorityHolder = tile._priorityHolder;
|
|
292
|
+
|
|
293
|
+
maximumPriority.distance = Math.max(
|
|
294
|
+
priorityHolder._distanceToCamera,
|
|
295
|
+
maximumPriority.distance
|
|
296
|
+
);
|
|
297
|
+
minimumPriority.distance = Math.min(
|
|
298
|
+
priorityHolder._distanceToCamera,
|
|
299
|
+
minimumPriority.distance
|
|
300
|
+
);
|
|
301
|
+
maximumPriority.depth = Math.max(tile._depth, maximumPriority.depth);
|
|
302
|
+
minimumPriority.depth = Math.min(tile._depth, minimumPriority.depth);
|
|
303
|
+
maximumPriority.foveatedFactor = Math.max(
|
|
304
|
+
priorityHolder._foveatedFactor,
|
|
305
|
+
maximumPriority.foveatedFactor
|
|
306
|
+
);
|
|
307
|
+
minimumPriority.foveatedFactor = Math.min(
|
|
308
|
+
priorityHolder._foveatedFactor,
|
|
309
|
+
minimumPriority.foveatedFactor
|
|
310
|
+
);
|
|
311
|
+
maximumPriority.reverseScreenSpaceError = Math.max(
|
|
312
|
+
tile._priorityReverseScreenSpaceError,
|
|
313
|
+
maximumPriority.reverseScreenSpaceError
|
|
314
|
+
);
|
|
315
|
+
minimumPriority.reverseScreenSpaceError = Math.min(
|
|
316
|
+
tile._priorityReverseScreenSpaceError,
|
|
317
|
+
minimumPriority.reverseScreenSpaceError
|
|
318
|
+
);
|
|
772
319
|
}
|
|
320
|
+
|
|
773
321
|
export default Cesium3DTilesetTraversal;
|