@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.
Files changed (240) hide show
  1. package/Build/Workers/{AttributeCompression-8a5a065e.js → AttributeCompression-f9f6c717.js} +1 -1
  2. package/Build/Workers/{AxisAlignedBoundingBox-a6f9f0e5.js → AxisAlignedBoundingBox-31fadcf0.js} +1 -1
  3. package/Build/Workers/{BoundingRectangle-b0a68595.js → BoundingRectangle-995f0079.js} +1 -1
  4. package/Build/Workers/{BoxGeometry-baedd794.js → BoxGeometry-7eb1af60.js} +1 -1
  5. package/Build/Workers/{Color-f85df1be.js → Color-2dc49658.js} +1 -1
  6. package/Build/Workers/{CoplanarPolygonGeometryLibrary-30516950.js → CoplanarPolygonGeometryLibrary-d7d972d6.js} +1 -1
  7. package/Build/Workers/{CorridorGeometryLibrary-5d5d3b3a.js → CorridorGeometryLibrary-1f5ef7b3.js} +1 -1
  8. package/Build/Workers/{CylinderGeometry-d899ae26.js → CylinderGeometry-23c67a6c.js} +1 -1
  9. package/Build/Workers/{CylinderGeometryLibrary-135b0858.js → CylinderGeometryLibrary-7bf291b4.js} +1 -1
  10. package/Build/Workers/{EllipseGeometry-a49f8449.js → EllipseGeometry-37014da4.js} +1 -1
  11. package/Build/Workers/{EllipseGeometryLibrary-cba7edde.js → EllipseGeometryLibrary-92ab6b1e.js} +1 -1
  12. package/Build/Workers/{EllipseOutlineGeometry-8095c8cb.js → EllipseOutlineGeometry-12b6fef5.js} +1 -1
  13. package/Build/Workers/{EllipsoidGeodesic-dcff5cbd.js → EllipsoidGeodesic-5b3623dc.js} +1 -1
  14. package/Build/Workers/{EllipsoidGeometry-ed93f571.js → EllipsoidGeometry-508da15c.js} +1 -1
  15. package/Build/Workers/{EllipsoidOutlineGeometry-e4854854.js → EllipsoidOutlineGeometry-40d97455.js} +1 -1
  16. package/Build/Workers/{EllipsoidRhumbLine-b672d507.js → EllipsoidRhumbLine-ef872433.js} +1 -1
  17. package/Build/Workers/{EllipsoidTangentPlane-7ae1aa9a.js → EllipsoidTangentPlane-46d4d9c2.js} +1 -1
  18. package/Build/Workers/{EncodedCartesian3-e8bbca36.js → EncodedCartesian3-57415c8a.js} +1 -1
  19. package/Build/Workers/{FrustumGeometry-b62db3e3.js → FrustumGeometry-38605e69.js} +32 -4
  20. package/Build/Workers/{GeometryAttribute-780af4fa.js → GeometryAttribute-a466e9c7.js} +1 -1
  21. package/Build/Workers/{GeometryInstance-3fb607b7.js → GeometryInstance-34d9e21e.js} +1 -1
  22. package/Build/Workers/{GeometryPipeline-36b61c99.js → GeometryPipeline-dcf79306.js} +1 -1
  23. package/Build/Workers/{IndexDatatype-b8f3e09d.js → IndexDatatype-2643aa47.js} +1 -1
  24. package/Build/Workers/{IntersectionTests-e889fcf0.js → IntersectionTests-88c49b2e.js} +1 -1
  25. package/Build/Workers/{Math-dad82b4d.js → Math-0a2ac845.js} +12 -2
  26. package/Build/Workers/{Matrix2-1e403d0e.js → Matrix2-e1298525.js} +1 -1
  27. package/Build/Workers/{Matrix3-fa806b97.js → Matrix3-41c58dde.js} +1 -1
  28. package/Build/Workers/{OrientedBoundingBox-43478ac8.js → OrientedBoundingBox-2dd47921.js} +5 -3
  29. package/Build/Workers/{Plane-c27e1ac6.js → Plane-4c3d403b.js} +1 -1
  30. package/Build/Workers/{PolygonGeometryLibrary-38a98276.js → PolygonGeometryLibrary-59126025.js} +1 -1
  31. package/Build/Workers/PolygonPipeline-1fe328c0.js +1344 -0
  32. package/Build/Workers/{PolylinePipeline-30e4cec9.js → PolylinePipeline-896735cc.js} +1 -1
  33. package/Build/Workers/{PolylineVolumeGeometryLibrary-90551d26.js → PolylineVolumeGeometryLibrary-9c0639f7.js} +1 -1
  34. package/Build/Workers/{PrimitivePipeline-558d9cb0.js → PrimitivePipeline-fc1a47ff.js} +1 -1
  35. package/Build/Workers/{RectangleGeometryLibrary-815c68df.js → RectangleGeometryLibrary-a23c9ebe.js} +1 -1
  36. package/Build/Workers/{TerrainEncoding-341ead52.js → TerrainEncoding-51b8b33b.js} +1 -1
  37. package/Build/Workers/Transforms-bc45e707.js +14699 -0
  38. package/Build/Workers/{WallGeometryLibrary-ccf90976.js → WallGeometryLibrary-007e9883.js} +1 -1
  39. package/Build/Workers/{WebMercatorProjection-76a3fcc0.js → WebMercatorProjection-13ed1a6e.js} +1 -1
  40. package/Build/Workers/{arrayRemoveDuplicates-fac118a8.js → arrayRemoveDuplicates-d2061e85.js} +1 -1
  41. package/Build/Workers/cesiumWorkerBootstrapper.js +1 -1
  42. package/Build/Workers/combineGeometry.js +1 -1
  43. package/Build/Workers/createBoxGeometry.js +1 -1
  44. package/Build/Workers/createBoxOutlineGeometry.js +1 -1
  45. package/Build/Workers/createCircleGeometry.js +1 -1
  46. package/Build/Workers/createCircleOutlineGeometry.js +1 -1
  47. package/Build/Workers/createCoplanarPolygonGeometry.js +1 -1
  48. package/Build/Workers/createCoplanarPolygonOutlineGeometry.js +1 -1
  49. package/Build/Workers/createCorridorGeometry.js +1 -1
  50. package/Build/Workers/createCorridorOutlineGeometry.js +1 -1
  51. package/Build/Workers/createCylinderGeometry.js +1 -1
  52. package/Build/Workers/createCylinderOutlineGeometry.js +1 -1
  53. package/Build/Workers/createEllipseGeometry.js +1 -1
  54. package/Build/Workers/createEllipseOutlineGeometry.js +1 -1
  55. package/Build/Workers/createEllipsoidGeometry.js +1 -1
  56. package/Build/Workers/createEllipsoidOutlineGeometry.js +1 -1
  57. package/Build/Workers/createFrustumGeometry.js +1 -1
  58. package/Build/Workers/createFrustumOutlineGeometry.js +1 -1
  59. package/Build/Workers/createGeometry.js +1 -1
  60. package/Build/Workers/createGroundPolylineGeometry.js +1 -1
  61. package/Build/Workers/createPlaneGeometry.js +1 -1
  62. package/Build/Workers/createPlaneOutlineGeometry.js +1 -1
  63. package/Build/Workers/createPolygonGeometry.js +1 -1
  64. package/Build/Workers/createPolygonOutlineGeometry.js +1 -1
  65. package/Build/Workers/createPolylineGeometry.js +1 -1
  66. package/Build/Workers/createPolylineVolumeGeometry.js +1 -1
  67. package/Build/Workers/createPolylineVolumeOutlineGeometry.js +1 -1
  68. package/Build/Workers/createRectangleGeometry.js +1 -1
  69. package/Build/Workers/createRectangleOutlineGeometry.js +1 -1
  70. package/Build/Workers/createSimplePolylineGeometry.js +1 -1
  71. package/Build/Workers/createSphereGeometry.js +1 -1
  72. package/Build/Workers/createSphereOutlineGeometry.js +1 -1
  73. package/Build/Workers/createVectorTileClampedPolylines.js +1 -1
  74. package/Build/Workers/createVectorTileGeometries.js +1 -1
  75. package/Build/Workers/createVectorTilePoints.js +1 -1
  76. package/Build/Workers/createVectorTilePolygons.js +1 -1
  77. package/Build/Workers/createVectorTilePolylines.js +1 -1
  78. package/Build/Workers/createVerticesFromGoogleEarthEnterpriseBuffer.js +1 -1
  79. package/Build/Workers/createVerticesFromHeightmap.js +5 -8
  80. package/Build/Workers/createVerticesFromQuantizedTerrainMesh.js +10 -15
  81. package/Build/Workers/createWallGeometry.js +1 -1
  82. package/Build/Workers/createWallOutlineGeometry.js +1 -1
  83. package/Build/Workers/decodeDraco.js +1 -1
  84. package/Build/Workers/decodeI3S.js +1 -1
  85. package/Build/Workers/package.js +1 -1
  86. package/Build/Workers/transferTypedArrayTest.js +1 -1
  87. package/Build/Workers/upsampleQuantizedTerrainMesh.js +1 -1
  88. package/Source/Core/ArcGISTiledElevationTerrainProvider.js +291 -191
  89. package/Source/Core/BingMapsGeocoderService.js +19 -1
  90. package/Source/Core/CartographicGeocoderService.js +15 -0
  91. package/Source/Core/CesiumTerrainProvider.js +571 -434
  92. package/Source/Core/Credit.js +1 -1
  93. package/Source/Core/CustomHeightmapTerrainProvider.js +12 -0
  94. package/Source/Core/EllipsoidTerrainProvider.js +17 -10
  95. package/Source/Core/FrustumGeometry.js +4 -3
  96. package/Source/Core/GeocoderService.js +32 -1
  97. package/Source/Core/GoogleEarthEnterpriseMetadata.js +86 -34
  98. package/Source/Core/GoogleEarthEnterpriseTerrainProvider.js +119 -82
  99. package/Source/Core/Ion.js +1 -1
  100. package/Source/Core/IonGeocoderService.js +17 -2
  101. package/Source/Core/IonResource.js +14 -3
  102. package/Source/Core/OpenCageGeocoderService.js +18 -1
  103. package/Source/Core/OrientedBoundingBox.js +4 -2
  104. package/Source/Core/OrthographicFrustum.js +13 -0
  105. package/Source/Core/PeliasGeocoderService.js +14 -1
  106. package/Source/Core/PerspectiveFrustum.js +14 -0
  107. package/Source/Core/Request.js +3 -2
  108. package/Source/Core/RequestScheduler.js +10 -5
  109. package/Source/Core/Resource.js +230 -236
  110. package/Source/Core/TerrainProvider.js +9 -14
  111. package/Source/Core/TileProviderError.js +8 -8
  112. package/Source/Core/VRTheWorldTerrainProvider.js +193 -124
  113. package/Source/Core/buildModuleUrl.js +4 -3
  114. package/Source/Core/createWorldTerrain.js +20 -2
  115. package/Source/Core/createWorldTerrainAsync.js +48 -0
  116. package/Source/Core/sampleTerrain.js +9 -10
  117. package/Source/Core/sampleTerrainMostDetailed.js +66 -72
  118. package/Source/DataSources/Cesium3DTilesetVisualizer.js +37 -26
  119. package/Source/DataSources/DataSourceDisplay.js +2 -2
  120. package/Source/DataSources/Entity.js +6 -1
  121. package/Source/DataSources/EntityCluster.js +126 -128
  122. package/Source/DataSources/ModelVisualizer.js +104 -34
  123. package/Source/DataSources/PolygonGraphics.js +1 -1
  124. package/Source/Renderer/UniformState.js +3 -2
  125. package/Source/Renderer/demodernizeShader.js +5 -5
  126. package/Source/Scene/ArcGisBaseMapType.js +12 -0
  127. package/Source/Scene/ArcGisMapServerImageryProvider.js +694 -376
  128. package/Source/Scene/ArcGisMapService.js +83 -0
  129. package/Source/Scene/BingMapsImageryProvider.js +511 -305
  130. package/Source/Scene/BufferLoader.js +29 -34
  131. package/Source/Scene/Camera.js +8 -7
  132. package/Source/Scene/Cesium3DTile.js +392 -254
  133. package/Source/Scene/Cesium3DTileBatchTable.js +2 -2
  134. package/Source/Scene/Cesium3DTileContent.js +16 -0
  135. package/Source/Scene/Cesium3DTileContentFactory.js +4 -4
  136. package/Source/Scene/Cesium3DTilePass.js +8 -11
  137. package/Source/Scene/Cesium3DTileStyleEngine.js +1 -1
  138. package/Source/Scene/Cesium3DTilesVoxelProvider.js +225 -117
  139. package/Source/Scene/Cesium3DTileset.js +756 -482
  140. package/Source/Scene/Cesium3DTilesetBaseTraversal.js +301 -0
  141. package/Source/Scene/Cesium3DTilesetMostDetailedTraversal.js +33 -46
  142. package/Source/Scene/Cesium3DTilesetSkipTraversal.js +421 -0
  143. package/Source/Scene/Cesium3DTilesetTraversal.js +219 -671
  144. package/Source/Scene/ClassificationPrimitive.js +7 -0
  145. package/Source/Scene/Composite3DTileContent.js +69 -26
  146. package/Source/Scene/CreditDisplay.js +132 -20
  147. package/Source/Scene/DepthPlane.js +1 -1
  148. package/Source/Scene/Empty3DTileContent.js +31 -1
  149. package/Source/Scene/Geometry3DTileContent.js +47 -7
  150. package/Source/Scene/Globe.js +5 -1
  151. package/Source/Scene/GlobeSurfaceTile.js +2 -1
  152. package/Source/Scene/GlobeSurfaceTileProvider.js +53 -30
  153. package/Source/Scene/GltfBufferViewLoader.js +47 -91
  154. package/Source/Scene/GltfDracoLoader.js +110 -112
  155. package/Source/Scene/GltfImageLoader.js +71 -78
  156. package/Source/Scene/GltfIndexBufferLoader.js +108 -121
  157. package/Source/Scene/GltfJsonLoader.js +87 -74
  158. package/Source/Scene/GltfLoader.js +381 -300
  159. package/Source/Scene/GltfStructuralMetadataLoader.js +109 -110
  160. package/Source/Scene/GltfTextureLoader.js +97 -96
  161. package/Source/Scene/GltfVertexBufferLoader.js +128 -133
  162. package/Source/Scene/GoogleEarthEnterpriseImageryProvider.js +353 -225
  163. package/Source/Scene/GoogleEarthEnterpriseMapsProvider.js +491 -331
  164. package/Source/Scene/GridImageryProvider.js +267 -104
  165. package/Source/Scene/GroundPolylinePrimitive.js +12 -1
  166. package/Source/Scene/GroundPrimitive.js +8 -1
  167. package/Source/Scene/I3SDataProvider.js +214 -113
  168. package/Source/Scene/I3SFeature.js +7 -6
  169. package/Source/Scene/I3SLayer.js +26 -37
  170. package/Source/Scene/I3SNode.js +59 -66
  171. package/Source/Scene/Imagery.js +6 -1
  172. package/Source/Scene/ImageryLayer.js +299 -48
  173. package/Source/Scene/ImageryLayerCollection.js +26 -0
  174. package/Source/Scene/ImageryProvider.js +129 -111
  175. package/Source/Scene/Implicit3DTileContent.js +72 -23
  176. package/Source/Scene/ImplicitSubtree.js +66 -45
  177. package/Source/Scene/IonImageryProvider.js +482 -275
  178. package/Source/Scene/MapboxImageryProvider.js +272 -112
  179. package/Source/Scene/MapboxStyleImageryProvider.js +270 -111
  180. package/Source/Scene/MetadataSchemaLoader.js +26 -36
  181. package/Source/Scene/Model/B3dmLoader.js +42 -46
  182. package/Source/Scene/Model/GeoJsonLoader.js +8 -32
  183. package/Source/Scene/Model/I3dmLoader.js +48 -74
  184. package/Source/Scene/Model/MaterialPipelineStage.js +12 -12
  185. package/Source/Scene/Model/Model.js +514 -135
  186. package/Source/Scene/Model/Model3DTileContent.js +83 -31
  187. package/Source/Scene/Model/ModelAnimationCollection.js +3 -3
  188. package/Source/Scene/Model/ModelDrawCommand.js +15 -26
  189. package/Source/Scene/Model/ModelUtility.js +16 -16
  190. package/Source/Scene/Model/PntsLoader.js +27 -32
  191. package/Source/Scene/Model/UniformType.js +1 -1
  192. package/Source/Scene/Multiple3DTileContent.js +134 -115
  193. package/Source/Scene/Picking.js +3 -2
  194. package/Source/Scene/PointCloud.js +11 -19
  195. package/Source/Scene/Primitive.js +20 -0
  196. package/Source/Scene/QuadtreePrimitive.js +5 -2
  197. package/Source/Scene/QuadtreeTileProvider.js +4 -8
  198. package/Source/Scene/ResourceCache.js +47 -105
  199. package/Source/Scene/ResourceCacheStatistics.js +24 -58
  200. package/Source/Scene/ResourceLoader.js +5 -17
  201. package/Source/Scene/ResourceLoaderState.js +12 -4
  202. package/Source/Scene/Scene.js +65 -0
  203. package/Source/Scene/SceneTransforms.js +3 -2
  204. package/Source/Scene/ScreenSpaceCameraController.js +2 -2
  205. package/Source/Scene/SingleTileImageryProvider.js +382 -209
  206. package/Source/Scene/Terrain.js +196 -0
  207. package/Source/Scene/TileCoordinatesImageryProvider.js +267 -104
  208. package/Source/Scene/TileMapServiceImageryProvider.js +177 -85
  209. package/Source/Scene/Tileset3DTileContent.js +47 -5
  210. package/Source/Scene/TimeDynamicPointCloud.js +15 -2
  211. package/Source/Scene/UrlTemplateImageryProvider.js +343 -215
  212. package/Source/Scene/Vector3DTileClampedPolylines.js +96 -84
  213. package/Source/Scene/Vector3DTileContent.js +47 -22
  214. package/Source/Scene/Vector3DTileGeometry.js +57 -52
  215. package/Source/Scene/Vector3DTilePoints.js +97 -81
  216. package/Source/Scene/Vector3DTilePolygons.js +118 -117
  217. package/Source/Scene/Vector3DTilePolylines.js +86 -82
  218. package/Source/Scene/Vector3DTilePrimitive.js +0 -1
  219. package/Source/Scene/VoxelContent.js +61 -63
  220. package/Source/Scene/VoxelPrimitive.js +39 -91
  221. package/Source/Scene/VoxelProvider.js +2 -2
  222. package/Source/Scene/WebMapServiceImageryProvider.js +272 -111
  223. package/Source/Scene/WebMapTileServiceImageryProvider.js +270 -107
  224. package/Source/Scene/computeFlyToLocationForRectangle.js +33 -37
  225. package/Source/Scene/createOsmBuildings.js +6 -0
  226. package/Source/Scene/createOsmBuildingsAsync.js +82 -0
  227. package/Source/Scene/createWorldImagery.js +14 -5
  228. package/Source/Scene/createWorldImageryAsync.js +39 -0
  229. package/Source/Shaders/AtmosphereCommon.glsl +51 -8
  230. package/Source/Shaders/AtmosphereCommon.js +51 -8
  231. package/Source/Shaders/PostProcessStages/AmbientOcclusionGenerate.glsl +1 -1
  232. package/Source/Shaders/PostProcessStages/AmbientOcclusionGenerate.js +1 -1
  233. package/Source/Shaders/PostProcessStages/AmbientOcclusionModulate.glsl +3 -3
  234. package/Source/Shaders/PostProcessStages/AmbientOcclusionModulate.js +3 -3
  235. package/Source/Widget/CesiumWidget.js +67 -27
  236. package/index.d.ts +2429 -1475
  237. package/index.js +324 -315
  238. package/package.json +4 -4
  239. package/Build/Workers/PolygonPipeline-d31ff61c.js +0 -1345
  240. 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
- function isVisible(tile) {
13
- return tile._visible && tile._inRequestVolume;
14
- }
15
-
16
- const traversal = {
17
- stack: new ManagedArray(),
18
- stackMaximumLength: 0,
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
- tileset._requestedTiles.length = 0;
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
- if (!skipLevelOfDetail(tileset)) {
69
- executeBaseTraversal(tileset, root, frameState);
70
- } else if (tileset.immediatelyLoadDesiredLevelOfDetail) {
71
- executeSkipTraversal(tileset, root, frameState);
72
- } else {
73
- executeBaseAndSkipTraversal(tileset, root, frameState);
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
- traversal.stack.trim(traversal.stackMaximumLength);
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
- function executeBaseTraversal(tileset, root, frameState) {
94
- const baseScreenSpaceError = tileset._maximumScreenSpaceError;
95
- const maximumScreenSpaceError = tileset._maximumScreenSpaceError;
96
- executeTraversal(
97
- tileset,
98
- root,
99
- baseScreenSpaceError,
100
- maximumScreenSpaceError,
101
- frameState
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
- function selectDescendants(tileset, root, frameState) {
160
- const stack = descendantTraversal.stack;
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
- function selectDesiredTile(tileset, tile, frameState) {
187
- if (!skipLevelOfDetail(tileset)) {
188
- if (tile.contentAvailable) {
189
- // The tile can be selected right away and does not require traverseAndSelect
190
- selectTile(tileset, tile, frameState);
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
- // If this tile is not loaded attempt to select its ancestor instead
196
- const loadedTile = tile.contentAvailable
197
- ? tile
198
- : tile._ancestorWithContentAvailable;
199
- if (defined(loadedTile)) {
200
- // Tiles will actually be selected in traverseAndSelect
201
- loadedTile._shouldSelect = true;
202
- } else {
203
- // If no ancestors are ready traverse down and select tiles to minimize empty regions.
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
- function visitTile(tileset, tile, frameState) {
210
- ++tileset._statistics.visited;
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
- function touchTile(tileset, tile, frameState) {
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
- function loadTile(tileset, tile, frameState) {
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
- (!hasUnloadedContent(tile) && !tile.contentExpired)
131
+ (!tile.hasUnloadedRenderableContent && !tile.contentExpired)
281
132
  ) {
282
133
  return;
283
134
  }
284
135
 
285
- if (!isOnScreenLongEnough(tileset, tile, frameState)) {
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
- function updateVisibility(tileset, tile, frameState) {
300
- if (tile._updatedVisibilityFrame === tileset._updatedVisibilityFrame) {
301
- // Return early if visibility has already been checked during the traversal.
302
- // The visibility may have already been checked if the cullWithChildrenBounds optimization is used.
303
- return;
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
- tile.updateVisibility(frameState);
307
- tile._updatedVisibilityFrame = tileset._updatedVisibilityFrame;
308
- }
164
+ const {
165
+ positionWCDeltaMagnitude,
166
+ positionWCDeltaMagnitudeLastFrame,
167
+ } = frameState.camera;
168
+ const deltaMagnitude =
169
+ positionWCDeltaMagnitude !== 0.0
170
+ ? positionWCDeltaMagnitude
171
+ : positionWCDeltaMagnitudeLastFrame;
309
172
 
310
- function anyChildrenVisible(tileset, tile, frameState) {
311
- let anyVisible = false;
312
- const children = tile.children;
313
- const length = children.length;
314
- for (let i = 0; i < length; ++i) {
315
- const child = children[i];
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
- function meetsScreenSpaceErrorEarly(tileset, tile, frameState) {
323
- const parent = tile.parent;
324
- if (
325
- !defined(parent) ||
326
- parent.hasTilesetContent ||
327
- parent.hasImplicitContent ||
328
- parent.refine !== Cesium3DTileRefine.ADD
329
- ) {
330
- return false;
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
- // Use parent's geometric error with child's box to see if the tile already meet the SSE
334
- return (
335
- tile.getScreenSpaceError(frameState, true) <=
336
- tileset._maximumScreenSpaceError
337
- );
338
- }
192
+ tile._wasMinPriorityChild = false;
193
+ tile._priorityHolder = tile;
194
+ updateMinimumMaximumPriority(tile);
339
195
 
340
- function updateTileVisibility(tileset, tile, frameState) {
341
- updateVisibility(tileset, tile, frameState);
196
+ // SkipLOD
197
+ tile._shouldSelect = false;
198
+ tile._finalResolution = true;
199
+ };
342
200
 
343
- if (!isVisible(tile)) {
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(tileset, child, frameState);
219
+ updateTileVisibility(child, frameState);
354
220
  tile._visible = child._visible;
355
221
  return;
356
222
  }
357
223
 
358
- if (meetsScreenSpaceErrorEarly(tileset, tile, frameState)) {
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(tileset, tile, frameState)) {
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
- function updateTile(tileset, tile, frameState) {
378
- // Reset some of the tile's flags and re-evaluate visibility
379
- updateTileVisibility(tileset, tile, frameState);
380
- tile.updateExpiration();
381
-
382
- // Request priority
383
- tile._wasMinPriorityChild = false;
384
- tile._priorityHolder = tile;
385
- updateMinimumMaximumPriority(tileset, tile);
386
-
387
- // SkipLOD
388
- tile._shouldSelect = false;
389
- tile._finalResolution = true;
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
- function hasUnloadedContent(tile) {
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
- !tileset.immediatelyLoadDesiredLevelOfDetail &&
427
- (tile._priorityProgressiveResolutionScreenSpaceErrorLeaf ||
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
- function sortChildrenByDistanceToCamera(a, b) {
436
- // Sort by farthest child first since this is going on a stack
437
- if (b._distanceToCamera === 0 && a._distanceToCamera === 0) {
438
- return b._centerZDepth - a._centerZDepth;
439
- }
440
-
441
- return b._distanceToCamera - a._distanceToCamera;
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
- const length = children.length;
449
-
450
- for (i = 0; i < length; ++i) {
451
- updateTile(tileset, children[i], frameState);
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 traverseAndSelect(tileset, root, frameState) {
705
- const stack = selectionTraversal.stack;
706
- const ancestorStack = selectionTraversal.ancestorStack;
707
- let lastAncestor;
708
-
709
- stack.push(root);
710
-
711
- while (stack.length > 0 || ancestorStack.length > 0) {
712
- selectionTraversal.stackMaximumLength = Math.max(
713
- selectionTraversal.stackMaximumLength,
714
- stack.length
715
- );
716
- selectionTraversal.ancestorStackMaximumLength = Math.max(
717
- selectionTraversal.ancestorStackMaximumLength,
718
- ancestorStack.length
719
- );
720
-
721
- if (ancestorStack.length > 0) {
722
- const waitingTile = ancestorStack.peek();
723
- if (waitingTile._stackLength === stack.length) {
724
- ancestorStack.pop();
725
- if (waitingTile !== lastAncestor) {
726
- waitingTile._finalResolution = false;
727
- }
728
- selectTile(tileset, waitingTile, frameState);
729
- continue;
730
- }
731
- }
732
-
733
- const tile = stack.pop();
734
- if (!defined(tile)) {
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;