@loaders.gl/tiles 3.1.3 → 4.0.0-alpha.5

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 (122) hide show
  1. package/dist/bundle.js +2 -2
  2. package/dist/bundle.js.map +1 -0
  3. package/dist/constants.js +26 -29
  4. package/dist/constants.js.map +1 -0
  5. package/dist/dist.min.js +45 -264
  6. package/dist/index.js +10 -28
  7. package/dist/index.js.map +1 -0
  8. package/dist/tileset/helpers/3d-tiles-options.js +5 -8
  9. package/dist/tileset/helpers/3d-tiles-options.js.map +1 -0
  10. package/dist/tileset/helpers/bounding-volume.js +70 -159
  11. package/dist/tileset/helpers/bounding-volume.js.map +1 -0
  12. package/dist/tileset/helpers/frame-state.js +48 -67
  13. package/dist/tileset/helpers/frame-state.js.map +1 -0
  14. package/dist/tileset/helpers/i3s-lod.js +64 -80
  15. package/dist/tileset/helpers/i3s-lod.js.map +1 -0
  16. package/dist/tileset/helpers/tiles-3d-lod.js +100 -111
  17. package/dist/tileset/helpers/tiles-3d-lod.js.map +1 -0
  18. package/dist/tileset/helpers/transform-utils.js +56 -50
  19. package/dist/tileset/helpers/transform-utils.js.map +1 -0
  20. package/dist/tileset/helpers/zoom.js +30 -36
  21. package/dist/tileset/helpers/zoom.js.map +1 -0
  22. package/dist/tileset/tile-3d.js +533 -551
  23. package/dist/tileset/tile-3d.js.map +1 -0
  24. package/dist/tileset/tileset-3d.js +649 -576
  25. package/dist/tileset/tileset-3d.js.map +1 -0
  26. package/dist/tileset/tileset-cache.js +71 -71
  27. package/dist/tileset/tileset-cache.js.map +1 -0
  28. package/dist/tileset/traversers/i3s-tile-manager.js +40 -31
  29. package/dist/tileset/traversers/i3s-tile-manager.js.map +1 -0
  30. package/dist/tileset/traversers/i3s-tileset-traverser.js +76 -81
  31. package/dist/tileset/traversers/i3s-tileset-traverser.js.map +1 -0
  32. package/dist/tileset/traversers/tileset-3d-traverser.js +49 -51
  33. package/dist/tileset/traversers/tileset-3d-traverser.js.map +1 -0
  34. package/dist/tileset/traversers/tileset-traverser.js +276 -274
  35. package/dist/tileset/traversers/tileset-traverser.js.map +1 -0
  36. package/dist/utils/doubly-linked-list-node.js +15 -16
  37. package/dist/utils/doubly-linked-list-node.js.map +1 -0
  38. package/dist/utils/doubly-linked-list.js +75 -94
  39. package/dist/utils/doubly-linked-list.js.map +1 -0
  40. package/dist/utils/managed-array.js +109 -143
  41. package/dist/utils/managed-array.js.map +1 -0
  42. package/package.json +7 -7
  43. package/dist/es5/bundle.js +0 -7
  44. package/dist/es5/bundle.js.map +0 -1
  45. package/dist/es5/constants.js +0 -44
  46. package/dist/es5/constants.js.map +0 -1
  47. package/dist/es5/index.js +0 -104
  48. package/dist/es5/index.js.map +0 -1
  49. package/dist/es5/tileset/helpers/3d-tiles-options.js +0 -13
  50. package/dist/es5/tileset/helpers/3d-tiles-options.js.map +0 -1
  51. package/dist/es5/tileset/helpers/bounding-volume.js +0 -114
  52. package/dist/es5/tileset/helpers/bounding-volume.js.map +0 -1
  53. package/dist/es5/tileset/helpers/frame-state.js +0 -65
  54. package/dist/es5/tileset/helpers/frame-state.js.map +0 -1
  55. package/dist/es5/tileset/helpers/i3s-lod.js +0 -86
  56. package/dist/es5/tileset/helpers/i3s-lod.js.map +0 -1
  57. package/dist/es5/tileset/helpers/tiles-3d-lod.js +0 -119
  58. package/dist/es5/tileset/helpers/tiles-3d-lod.js.map +0 -1
  59. package/dist/es5/tileset/helpers/transform-utils.js +0 -65
  60. package/dist/es5/tileset/helpers/transform-utils.js.map +0 -1
  61. package/dist/es5/tileset/helpers/zoom.js +0 -43
  62. package/dist/es5/tileset/helpers/zoom.js.map +0 -1
  63. package/dist/es5/tileset/tile-3d.js +0 -605
  64. package/dist/es5/tileset/tile-3d.js.map +0 -1
  65. package/dist/es5/tileset/tileset-3d.js +0 -838
  66. package/dist/es5/tileset/tileset-3d.js.map +0 -1
  67. package/dist/es5/tileset/tileset-cache.js +0 -101
  68. package/dist/es5/tileset/tileset-cache.js.map +0 -1
  69. package/dist/es5/tileset/traversers/i3s-tile-manager.js +0 -69
  70. package/dist/es5/tileset/traversers/i3s-tile-manager.js.map +0 -1
  71. package/dist/es5/tileset/traversers/i3s-tileset-traverser.js +0 -185
  72. package/dist/es5/tileset/traversers/i3s-tileset-traverser.js.map +0 -1
  73. package/dist/es5/tileset/traversers/tileset-3d-traverser.js +0 -94
  74. package/dist/es5/tileset/traversers/tileset-3d-traverser.js.map +0 -1
  75. package/dist/es5/tileset/traversers/tileset-traverser.js +0 -377
  76. package/dist/es5/tileset/traversers/tileset-traverser.js.map +0 -1
  77. package/dist/es5/utils/doubly-linked-list-node.js +0 -25
  78. package/dist/es5/utils/doubly-linked-list-node.js.map +0 -1
  79. package/dist/es5/utils/doubly-linked-list.js +0 -104
  80. package/dist/es5/utils/doubly-linked-list.js.map +0 -1
  81. package/dist/es5/utils/managed-array.js +0 -147
  82. package/dist/es5/utils/managed-array.js.map +0 -1
  83. package/dist/esm/bundle.js +0 -5
  84. package/dist/esm/bundle.js.map +0 -1
  85. package/dist/esm/constants.js +0 -32
  86. package/dist/esm/constants.js.map +0 -1
  87. package/dist/esm/index.js +0 -10
  88. package/dist/esm/index.js.map +0 -1
  89. package/dist/esm/tileset/helpers/3d-tiles-options.js +0 -6
  90. package/dist/esm/tileset/helpers/3d-tiles-options.js.map +0 -1
  91. package/dist/esm/tileset/helpers/bounding-volume.js +0 -88
  92. package/dist/esm/tileset/helpers/bounding-volume.js.map +0 -1
  93. package/dist/esm/tileset/helpers/frame-state.js +0 -51
  94. package/dist/esm/tileset/helpers/frame-state.js.map +0 -1
  95. package/dist/esm/tileset/helpers/i3s-lod.js +0 -67
  96. package/dist/esm/tileset/helpers/i3s-lod.js.map +0 -1
  97. package/dist/esm/tileset/helpers/tiles-3d-lod.js +0 -105
  98. package/dist/esm/tileset/helpers/tiles-3d-lod.js.map +0 -1
  99. package/dist/esm/tileset/helpers/transform-utils.js +0 -58
  100. package/dist/esm/tileset/helpers/transform-utils.js.map +0 -1
  101. package/dist/esm/tileset/helpers/zoom.js +0 -36
  102. package/dist/esm/tileset/helpers/zoom.js.map +0 -1
  103. package/dist/esm/tileset/tile-3d.js +0 -537
  104. package/dist/esm/tileset/tile-3d.js.map +0 -1
  105. package/dist/esm/tileset/tileset-3d.js +0 -674
  106. package/dist/esm/tileset/tileset-3d.js.map +0 -1
  107. package/dist/esm/tileset/tileset-cache.js +0 -79
  108. package/dist/esm/tileset/tileset-cache.js.map +0 -1
  109. package/dist/esm/tileset/traversers/i3s-tile-manager.js +0 -45
  110. package/dist/esm/tileset/traversers/i3s-tile-manager.js.map +0 -1
  111. package/dist/esm/tileset/traversers/i3s-tileset-traverser.js +0 -80
  112. package/dist/esm/tileset/traversers/i3s-tileset-traverser.js.map +0 -1
  113. package/dist/esm/tileset/traversers/tileset-3d-traverser.js +0 -53
  114. package/dist/esm/tileset/traversers/tileset-3d-traverser.js.map +0 -1
  115. package/dist/esm/tileset/traversers/tileset-traverser.js +0 -296
  116. package/dist/esm/tileset/traversers/tileset-traverser.js.map +0 -1
  117. package/dist/esm/utils/doubly-linked-list-node.js +0 -16
  118. package/dist/esm/utils/doubly-linked-list-node.js.map +0 -1
  119. package/dist/esm/utils/doubly-linked-list.js +0 -81
  120. package/dist/esm/utils/doubly-linked-list.js.map +0 -1
  121. package/dist/esm/utils/managed-array.js +0 -117
  122. package/dist/esm/utils/managed-array.js.map +0 -1
@@ -1,294 +1,296 @@
1
- "use strict";
2
- var __importDefault = (this && this.__importDefault) || function (mod) {
3
- return (mod && mod.__esModule) ? mod : { "default": mod };
1
+ import _defineProperty from "@babel/runtime/helpers/esm/defineProperty";
2
+ import ManagedArray from '../../utils/managed-array';
3
+ import { TILE_REFINEMENT } from '../../constants';
4
+ export const DEFAULT_PROPS = {
5
+ loadSiblings: false,
6
+ skipLevelOfDetail: false,
7
+ maximumScreenSpaceError: 2,
8
+ updateTransforms: true,
9
+ onTraversalEnd: () => {},
10
+ viewportTraversersMap: {},
11
+ basePath: ''
4
12
  };
5
- Object.defineProperty(exports, "__esModule", { value: true });
6
- exports.DEFAULT_PROPS = void 0;
7
- const managed_array_1 = __importDefault(require("../../utils/managed-array"));
8
- const constants_1 = require("../../constants");
9
- exports.DEFAULT_PROPS = {
10
- loadSiblings: false,
11
- skipLevelOfDetail: false,
12
- maximumScreenSpaceError: 2,
13
- updateTransforms: true,
14
- onTraversalEnd: () => { },
15
- viewportTraversersMap: {},
16
- basePath: ''
17
- };
18
- class TilesetTraverser {
19
- // TODO nested props
20
- constructor(options) {
21
- this.options = { ...exports.DEFAULT_PROPS, ...options };
22
- // TRAVERSAL
23
- // temporary storage to hold the traversed tiles during a traversal
24
- this._traversalStack = new managed_array_1.default();
25
- this._emptyTraversalStack = new managed_array_1.default();
26
- // set in every traverse cycle
27
- this._frameNumber = null;
28
- // fulfill in traverse call
29
- this.root = null;
30
- // RESULT
31
- // tiles should be rendered
32
- this.selectedTiles = {};
33
- // tiles should be loaded from server
34
- this.requestedTiles = {};
35
- // tiles does not have render content
36
- this.emptyTiles = {};
37
- }
38
- // tiles should be visible
39
- traverse(root, frameState, options) {
40
- this.root = root; // for root screen space error
41
- this.options = { ...this.options, ...options };
42
- // reset result
43
- this.reset();
44
- // update tile (visibility and expiration)
45
- this.updateTile(root, frameState);
46
- this._frameNumber = frameState.frameNumber;
47
- this.executeTraversal(root, frameState);
48
- }
49
- reset() {
50
- this.requestedTiles = {};
51
- this.selectedTiles = {};
52
- this.emptyTiles = {};
53
- this._traversalStack.reset();
54
- this._emptyTraversalStack.reset();
55
- }
56
- // execute traverse
57
- // Depth-first traversal that traverses all visible tiles and marks tiles for selection.
58
- // If skipLevelOfDetail is off then a tile does not refine until all children are loaded.
59
- // This is the traditional replacement refinement approach and is called the base traversal.
60
- // Tiles that have a greater screen space error than the base screen space error are part of the base traversal,
61
- // all other tiles are part of the skip traversal. The skip traversal allows for skipping levels of the tree
62
- // and rendering children and parent tiles simultaneously.
63
- /* eslint-disable-next-line complexity, max-statements */
64
- executeTraversal(root, frameState) {
65
- // stack to store traversed tiles, only visible tiles should be added to stack
66
- // visible: visible in the current view frustum
67
- const stack = this._traversalStack;
68
- root._selectionDepth = 1;
69
- stack.push(root);
70
- while (stack.length > 0) {
71
- // 1. pop tile
72
- const tile = stack.pop();
73
- // 2. check if tile needs to be refine, needs refine if a tile's LoD is not sufficient and tile has available children (available content)
74
- let shouldRefine = false;
75
- if (this.canTraverse(tile, frameState)) {
76
- this.updateChildTiles(tile, frameState);
77
- shouldRefine = this.updateAndPushChildren(tile, frameState, stack, tile.hasRenderContent ? tile._selectionDepth + 1 : tile._selectionDepth);
78
- }
79
- // 3. decide if should render (select) this tile
80
- // - tile does not have render content
81
- // - tile has render content and tile is `add` type (pointcloud)
82
- // - tile has render content and tile is `replace` type (photogrammetry) and can't refine any further
83
- const parent = tile.parent;
84
- const parentRefines = Boolean(!parent || parent._shouldRefine);
85
- const stoppedRefining = !shouldRefine;
86
- if (!tile.hasRenderContent) {
87
- this.emptyTiles[tile.id] = tile;
88
- this.loadTile(tile, frameState);
89
- if (stoppedRefining) {
90
- this.selectTile(tile, frameState);
91
- }
92
- // additive tiles
93
- }
94
- else if (tile.refine === constants_1.TILE_REFINEMENT.ADD) {
95
- // Additive tiles are always loaded and selected
96
- this.loadTile(tile, frameState);
97
- this.selectTile(tile, frameState);
98
- // replace tiles
99
- }
100
- else if (tile.refine === constants_1.TILE_REFINEMENT.REPLACE) {
101
- // Always load tiles in the base traversal
102
- // Select tiles that can't refine further
103
- this.loadTile(tile, frameState);
104
- if (stoppedRefining) {
105
- this.selectTile(tile, frameState);
106
- }
107
- }
108
- // 3. update cache, most recent touched tiles have higher priority to be fetched from server
109
- this.touchTile(tile, frameState);
110
- // 4. update tile refine prop and parent refinement status to trickle down to the descendants
111
- tile._shouldRefine = shouldRefine && parentRefines;
112
- }
113
- this.options.onTraversalEnd(frameState);
114
- }
115
- updateChildTiles(tile, frameState) {
116
- const children = tile.children;
117
- for (const child of children) {
118
- this.updateTile(child, frameState);
119
- }
120
- return true;
121
- }
122
- /* eslint-disable complexity, max-statements */
123
- updateAndPushChildren(tile, frameState, stack, depth) {
124
- const { loadSiblings, skipLevelOfDetail } = this.options;
125
- const children = tile.children;
126
- // sort children tiles
127
- children.sort(this.compareDistanceToCamera.bind(this));
128
- // For traditional replacement refinement only refine if all children are loaded.
129
- // Empty tiles are exempt since it looks better if children stream in as they are loaded to fill the empty space.
130
- const checkRefines = tile.refine === constants_1.TILE_REFINEMENT.REPLACE && tile.hasRenderContent && !skipLevelOfDetail;
131
- let hasVisibleChild = false;
132
- let refines = true;
133
- for (const child of children) {
134
- child._selectionDepth = depth;
135
- if (child.isVisibleAndInRequestVolume) {
136
- if (stack.find(child)) {
137
- stack.delete(child);
138
- }
139
- stack.push(child);
140
- hasVisibleChild = true;
141
- }
142
- else if (checkRefines || loadSiblings) {
143
- // Keep non-visible children loaded since they are still needed before the parent can refine.
144
- // Or loadSiblings is true so always load tiles regardless of visibility.
145
- this.loadTile(child, frameState);
146
- this.touchTile(child, frameState);
147
- }
148
- if (checkRefines) {
149
- let childRefines;
150
- if (!child._inRequestVolume) {
151
- childRefines = false;
152
- }
153
- else if (!child.hasRenderContent) {
154
- childRefines = this.executeEmptyTraversal(child, frameState);
155
- }
156
- else {
157
- childRefines = child.contentAvailable;
158
- }
159
- refines = refines && childRefines;
160
- if (!refines) {
161
- return false;
162
- }
163
- }
13
+ export default class TilesetTraverser {
14
+ constructor(options) {
15
+ _defineProperty(this, "options", void 0);
16
+
17
+ _defineProperty(this, "root", void 0);
18
+
19
+ _defineProperty(this, "requestedTiles", void 0);
20
+
21
+ _defineProperty(this, "selectedTiles", void 0);
22
+
23
+ _defineProperty(this, "emptyTiles", void 0);
24
+
25
+ _defineProperty(this, "_traversalStack", void 0);
26
+
27
+ _defineProperty(this, "_emptyTraversalStack", void 0);
28
+
29
+ _defineProperty(this, "_frameNumber", void 0);
30
+
31
+ this.options = { ...DEFAULT_PROPS,
32
+ ...options
33
+ };
34
+ this._traversalStack = new ManagedArray();
35
+ this._emptyTraversalStack = new ManagedArray();
36
+ this._frameNumber = null;
37
+ this.root = null;
38
+ this.selectedTiles = {};
39
+ this.requestedTiles = {};
40
+ this.emptyTiles = {};
41
+ }
42
+
43
+ traverse(root, frameState, options) {
44
+ this.root = root;
45
+ this.options = { ...this.options,
46
+ ...options
47
+ };
48
+ this.reset();
49
+ this.updateTile(root, frameState);
50
+ this._frameNumber = frameState.frameNumber;
51
+ this.executeTraversal(root, frameState);
52
+ }
53
+
54
+ reset() {
55
+ this.requestedTiles = {};
56
+ this.selectedTiles = {};
57
+ this.emptyTiles = {};
58
+
59
+ this._traversalStack.reset();
60
+
61
+ this._emptyTraversalStack.reset();
62
+ }
63
+
64
+ executeTraversal(root, frameState) {
65
+ const stack = this._traversalStack;
66
+ root._selectionDepth = 1;
67
+ stack.push(root);
68
+
69
+ while (stack.length > 0) {
70
+ const tile = stack.pop();
71
+ let shouldRefine = false;
72
+
73
+ if (this.canTraverse(tile, frameState)) {
74
+ this.updateChildTiles(tile, frameState);
75
+ shouldRefine = this.updateAndPushChildren(tile, frameState, stack, tile.hasRenderContent ? tile._selectionDepth + 1 : tile._selectionDepth);
76
+ }
77
+
78
+ const parent = tile.parent;
79
+ const parentRefines = Boolean(!parent || parent._shouldRefine);
80
+ const stoppedRefining = !shouldRefine;
81
+
82
+ if (!tile.hasRenderContent) {
83
+ this.emptyTiles[tile.id] = tile;
84
+ this.loadTile(tile, frameState);
85
+
86
+ if (stoppedRefining) {
87
+ this.selectTile(tile, frameState);
164
88
  }
165
- if (!hasVisibleChild) {
166
- refines = false;
89
+ } else if (tile.refine === TILE_REFINEMENT.ADD) {
90
+ this.loadTile(tile, frameState);
91
+ this.selectTile(tile, frameState);
92
+ } else if (tile.refine === TILE_REFINEMENT.REPLACE) {
93
+ this.loadTile(tile, frameState);
94
+
95
+ if (stoppedRefining) {
96
+ this.selectTile(tile, frameState);
167
97
  }
168
- return refines;
98
+ }
99
+
100
+ this.touchTile(tile, frameState);
101
+ tile._shouldRefine = shouldRefine && parentRefines;
169
102
  }
170
- /* eslint-enable complexity, max-statements */
171
- updateTile(tile, frameState) {
172
- this.updateTileVisibility(tile, frameState);
103
+
104
+ this.options.onTraversalEnd(frameState);
105
+ }
106
+
107
+ updateChildTiles(tile, frameState) {
108
+ const children = tile.children;
109
+
110
+ for (const child of children) {
111
+ this.updateTile(child, frameState);
173
112
  }
174
- // tile to render in the browser
175
- selectTile(tile, frameState) {
176
- if (this.shouldSelectTile(tile)) {
177
- // The tile can be selected right away and does not require traverseAndSelect
178
- tile._selectedFrame = frameState.frameNumber;
179
- this.selectedTiles[tile.id] = tile;
113
+
114
+ return true;
115
+ }
116
+
117
+ updateAndPushChildren(tile, frameState, stack, depth) {
118
+ const {
119
+ loadSiblings,
120
+ skipLevelOfDetail
121
+ } = this.options;
122
+ const children = tile.children;
123
+ children.sort(this.compareDistanceToCamera.bind(this));
124
+ const checkRefines = tile.refine === TILE_REFINEMENT.REPLACE && tile.hasRenderContent && !skipLevelOfDetail;
125
+ let hasVisibleChild = false;
126
+ let refines = true;
127
+
128
+ for (const child of children) {
129
+ child._selectionDepth = depth;
130
+
131
+ if (child.isVisibleAndInRequestVolume) {
132
+ if (stack.find(child)) {
133
+ stack.delete(child);
180
134
  }
181
- }
182
- // tile to load from server
183
- loadTile(tile, frameState) {
184
- if (this.shouldLoadTile(tile)) {
185
- tile._requestedFrame = frameState.frameNumber;
186
- tile._priority = tile._getPriority();
187
- this.requestedTiles[tile.id] = tile;
135
+
136
+ stack.push(child);
137
+ hasVisibleChild = true;
138
+ } else if (checkRefines || loadSiblings) {
139
+ this.loadTile(child, frameState);
140
+ this.touchTile(child, frameState);
141
+ }
142
+
143
+ if (checkRefines) {
144
+ let childRefines;
145
+
146
+ if (!child._inRequestVolume) {
147
+ childRefines = false;
148
+ } else if (!child.hasRenderContent) {
149
+ childRefines = this.executeEmptyTraversal(child, frameState);
150
+ } else {
151
+ childRefines = child.contentAvailable;
152
+ }
153
+
154
+ refines = refines && childRefines;
155
+
156
+ if (!refines) {
157
+ return false;
188
158
  }
159
+ }
189
160
  }
190
- // cache tile
191
- touchTile(tile, frameState) {
192
- tile.tileset._cache.touch(tile);
193
- tile._touchedFrame = frameState.frameNumber;
161
+
162
+ if (!hasVisibleChild) {
163
+ refines = false;
194
164
  }
195
- // tile should be visible
196
- // tile should have children
197
- // tile LoD (level of detail) is not sufficient under current viewport
198
- canTraverse(tile, frameState, useParentMetric = false, ignoreVisibility = false) {
199
- if (!tile.hasChildren) {
200
- return false;
201
- }
202
- // cesium specific
203
- if (tile.hasTilesetContent) {
204
- // Traverse external this to visit its root tile
205
- // Don't traverse if the subtree is expired because it will be destroyed
206
- return !tile.contentExpired;
207
- }
208
- if (!ignoreVisibility && !tile.isVisibleAndInRequestVolume) {
209
- return false;
210
- }
211
- return this.shouldRefine(tile, frameState, useParentMetric);
165
+
166
+ return refines;
167
+ }
168
+
169
+ updateTile(tile, frameState) {
170
+ this.updateTileVisibility(tile, frameState);
171
+ }
172
+
173
+ selectTile(tile, frameState) {
174
+ if (this.shouldSelectTile(tile)) {
175
+ tile._selectedFrame = frameState.frameNumber;
176
+ this.selectedTiles[tile.id] = tile;
212
177
  }
213
- shouldLoadTile(tile) {
214
- // if request tile is in current frame
215
- // and has unexpired render content
216
- return tile.hasUnloadedContent || tile.contentExpired;
178
+ }
179
+
180
+ loadTile(tile, frameState) {
181
+ if (this.shouldLoadTile(tile)) {
182
+ tile._requestedFrame = frameState.frameNumber;
183
+ tile._priority = tile._getPriority();
184
+ this.requestedTiles[tile.id] = tile;
217
185
  }
218
- shouldSelectTile(tile) {
219
- // if select tile is in current frame
220
- // and content available
221
- return tile.contentAvailable && !this.options.skipLevelOfDetail;
186
+ }
187
+
188
+ touchTile(tile, frameState) {
189
+ tile.tileset._cache.touch(tile);
190
+
191
+ tile._touchedFrame = frameState.frameNumber;
192
+ }
193
+
194
+ canTraverse(tile, frameState, useParentMetric = false, ignoreVisibility = false) {
195
+ if (!tile.hasChildren) {
196
+ return false;
222
197
  }
223
- // Decide if tile LoD (level of detail) is not sufficient under current viewport
224
- shouldRefine(tile, frameState, useParentMetric) {
225
- let screenSpaceError = tile._screenSpaceError;
226
- if (useParentMetric) {
227
- screenSpaceError = tile.getScreenSpaceError(frameState, true);
228
- }
229
- return screenSpaceError > this.options.maximumScreenSpaceError;
198
+
199
+ if (tile.hasTilesetContent) {
200
+ return !tile.contentExpired;
230
201
  }
231
- updateTileVisibility(tile, frameState) {
232
- const viewportIds = [];
233
- if (this.options.viewportTraversersMap) {
234
- for (const key in this.options.viewportTraversersMap) {
235
- const value = this.options.viewportTraversersMap[key];
236
- if (value === frameState.viewport.id) {
237
- viewportIds.push(key);
238
- }
239
- }
240
- }
241
- else {
242
- viewportIds.push(frameState.viewport.id);
243
- }
244
- tile.updateVisibility(frameState, viewportIds);
202
+
203
+ if (!ignoreVisibility && !tile.isVisibleAndInRequestVolume) {
204
+ return false;
245
205
  }
246
- // UTILITIES
247
- compareDistanceToCamera(b, a) {
248
- return b._distanceToCamera - a._distanceToCamera;
206
+
207
+ return this.shouldRefine(tile, frameState, useParentMetric);
208
+ }
209
+
210
+ shouldLoadTile(tile) {
211
+ return tile.hasUnloadedContent || tile.contentExpired;
212
+ }
213
+
214
+ shouldSelectTile(tile) {
215
+ return tile.contentAvailable && !this.options.skipLevelOfDetail;
216
+ }
217
+
218
+ shouldRefine(tile, frameState, useParentMetric) {
219
+ let screenSpaceError = tile._screenSpaceError;
220
+
221
+ if (useParentMetric) {
222
+ screenSpaceError = tile.getScreenSpaceError(frameState, true);
249
223
  }
250
- anyChildrenVisible(tile, frameState) {
251
- let anyVisible = false;
252
- for (const child of tile.children) {
253
- child.updateVisibility(frameState);
254
- anyVisible = anyVisible || child.isVisibleAndInRequestVolume;
224
+
225
+ return screenSpaceError > this.options.maximumScreenSpaceError;
226
+ }
227
+
228
+ updateTileVisibility(tile, frameState) {
229
+ const viewportIds = [];
230
+
231
+ if (this.options.viewportTraversersMap) {
232
+ for (const key in this.options.viewportTraversersMap) {
233
+ const value = this.options.viewportTraversersMap[key];
234
+
235
+ if (value === frameState.viewport.id) {
236
+ viewportIds.push(key);
255
237
  }
256
- return anyVisible;
238
+ }
239
+ } else {
240
+ viewportIds.push(frameState.viewport.id);
241
+ }
242
+
243
+ tile.updateVisibility(frameState, viewportIds);
244
+ }
245
+
246
+ compareDistanceToCamera(b, a) {
247
+ return b._distanceToCamera - a._distanceToCamera;
248
+ }
249
+
250
+ anyChildrenVisible(tile, frameState) {
251
+ let anyVisible = false;
252
+
253
+ for (const child of tile.children) {
254
+ child.updateVisibility(frameState);
255
+ anyVisible = anyVisible || child.isVisibleAndInRequestVolume;
257
256
  }
258
- // Depth-first traversal that checks if all nearest descendants with content are loaded.
259
- // Ignores visibility.
260
- executeEmptyTraversal(root, frameState) {
261
- let allDescendantsLoaded = true;
262
- const stack = this._emptyTraversalStack;
263
- stack.push(root);
264
- while (stack.length > 0 && allDescendantsLoaded) {
265
- const tile = stack.pop();
266
- this.updateTile(tile, frameState);
267
- if (!tile.isVisibleAndInRequestVolume) {
268
- // Load tiles that aren't visible since they are still needed for the parent to refine
269
- this.loadTile(tile, frameState);
270
- }
271
- this.touchTile(tile, frameState);
272
- // Only traverse if the tile is empty - traversal stop at descendants with content
273
- const traverse = !tile.hasRenderContent && this.canTraverse(tile, frameState, false, true);
274
- if (traverse) {
275
- const children = tile.children;
276
- for (const child of children) {
277
- // eslint-disable-next-line max-depth
278
- if (stack.find(child)) {
279
- stack.delete(child);
280
- }
281
- stack.push(child);
282
- }
283
- }
284
- else if (!tile.contentAvailable) {
285
- allDescendantsLoaded = false;
286
- }
257
+
258
+ return anyVisible;
259
+ }
260
+
261
+ executeEmptyTraversal(root, frameState) {
262
+ let allDescendantsLoaded = true;
263
+ const stack = this._emptyTraversalStack;
264
+ stack.push(root);
265
+
266
+ while (stack.length > 0 && allDescendantsLoaded) {
267
+ const tile = stack.pop();
268
+ this.updateTile(tile, frameState);
269
+
270
+ if (!tile.isVisibleAndInRequestVolume) {
271
+ this.loadTile(tile, frameState);
272
+ }
273
+
274
+ this.touchTile(tile, frameState);
275
+ const traverse = !tile.hasRenderContent && this.canTraverse(tile, frameState, false, true);
276
+
277
+ if (traverse) {
278
+ const children = tile.children;
279
+
280
+ for (const child of children) {
281
+ if (stack.find(child)) {
282
+ stack.delete(child);
283
+ }
284
+
285
+ stack.push(child);
287
286
  }
288
- return allDescendantsLoaded;
287
+ } else if (!tile.contentAvailable) {
288
+ allDescendantsLoaded = false;
289
+ }
289
290
  }
291
+
292
+ return allDescendantsLoaded;
293
+ }
294
+
290
295
  }
291
- exports.default = TilesetTraverser;
292
- // TODO
293
- // enable expiration
294
- // enable optimization hint
296
+ //# sourceMappingURL=tileset-traverser.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../../src/tileset/traversers/tileset-traverser.ts"],"names":["ManagedArray","TILE_REFINEMENT","DEFAULT_PROPS","loadSiblings","skipLevelOfDetail","maximumScreenSpaceError","updateTransforms","onTraversalEnd","viewportTraversersMap","basePath","TilesetTraverser","constructor","options","_traversalStack","_emptyTraversalStack","_frameNumber","root","selectedTiles","requestedTiles","emptyTiles","traverse","frameState","reset","updateTile","frameNumber","executeTraversal","stack","_selectionDepth","push","length","tile","pop","shouldRefine","canTraverse","updateChildTiles","updateAndPushChildren","hasRenderContent","parent","parentRefines","Boolean","_shouldRefine","stoppedRefining","id","loadTile","selectTile","refine","ADD","REPLACE","touchTile","children","child","depth","sort","compareDistanceToCamera","bind","checkRefines","hasVisibleChild","refines","isVisibleAndInRequestVolume","find","delete","childRefines","_inRequestVolume","executeEmptyTraversal","contentAvailable","updateTileVisibility","shouldSelectTile","_selectedFrame","shouldLoadTile","_requestedFrame","_priority","_getPriority","tileset","_cache","touch","_touchedFrame","useParentMetric","ignoreVisibility","hasChildren","hasTilesetContent","contentExpired","hasUnloadedContent","screenSpaceError","_screenSpaceError","getScreenSpaceError","viewportIds","key","value","viewport","updateVisibility","b","a","_distanceToCamera","anyChildrenVisible","anyVisible","allDescendantsLoaded"],"mappings":"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","sourcesContent":["import ManagedArray from '../../utils/managed-array';\nimport {TILE_REFINEMENT} from '../../constants';\n\nexport type TilesetTraverserProps = {\n loadSiblings?: boolean;\n skipLevelOfDetail?: boolean;\n maximumScreenSpaceError?: number;\n onTraversalEnd?: (frameState) => any;\n viewportTraversersMap?: {[key: string]: any};\n basePath?: string;\n};\n\nexport type Props = {\n loadSiblings: boolean;\n skipLevelOfDetail: boolean;\n updateTransforms: boolean;\n maximumScreenSpaceError: number;\n onTraversalEnd: (frameState) => any;\n viewportTraversersMap: {[key: string]: any};\n basePath: string;\n};\n\nexport const DEFAULT_PROPS: Props = {\n loadSiblings: false,\n skipLevelOfDetail: false,\n maximumScreenSpaceError: 2,\n updateTransforms: true,\n onTraversalEnd: () => {},\n viewportTraversersMap: {},\n basePath: ''\n};\n\nexport default class TilesetTraverser {\n options: Props;\n\n root: any;\n requestedTiles: object;\n selectedTiles: object;\n emptyTiles: object;\n\n protected _traversalStack: ManagedArray;\n protected _emptyTraversalStack: ManagedArray;\n protected _frameNumber: number | null;\n\n // TODO nested props\n constructor(options: TilesetTraverserProps) {\n this.options = {...DEFAULT_PROPS, ...options};\n // TRAVERSAL\n // temporary storage to hold the traversed tiles during a traversal\n this._traversalStack = new ManagedArray();\n this._emptyTraversalStack = new ManagedArray();\n\n // set in every traverse cycle\n this._frameNumber = null;\n\n // fulfill in traverse call\n this.root = null;\n\n // RESULT\n // tiles should be rendered\n this.selectedTiles = {};\n // tiles should be loaded from server\n this.requestedTiles = {};\n // tiles does not have render content\n this.emptyTiles = {};\n }\n\n // tiles should be visible\n traverse(root, frameState, options) {\n this.root = root; // for root screen space error\n this.options = {...this.options, ...options};\n\n // reset result\n this.reset();\n\n // update tile (visibility and expiration)\n this.updateTile(root, frameState);\n\n this._frameNumber = frameState.frameNumber;\n this.executeTraversal(root, frameState);\n }\n\n reset() {\n this.requestedTiles = {};\n this.selectedTiles = {};\n this.emptyTiles = {};\n this._traversalStack.reset();\n this._emptyTraversalStack.reset();\n }\n\n // execute traverse\n // Depth-first traversal that traverses all visible tiles and marks tiles for selection.\n // If skipLevelOfDetail is off then a tile does not refine until all children are loaded.\n // This is the traditional replacement refinement approach and is called the base traversal.\n // Tiles that have a greater screen space error than the base screen space error are part of the base traversal,\n // all other tiles are part of the skip traversal. The skip traversal allows for skipping levels of the tree\n // and rendering children and parent tiles simultaneously.\n /* eslint-disable-next-line complexity, max-statements */\n executeTraversal(root, frameState) {\n // stack to store traversed tiles, only visible tiles should be added to stack\n // visible: visible in the current view frustum\n const stack = this._traversalStack;\n root._selectionDepth = 1;\n\n stack.push(root);\n while (stack.length > 0) {\n // 1. pop tile\n const tile = stack.pop();\n\n // 2. check if tile needs to be refine, needs refine if a tile's LoD is not sufficient and tile has available children (available content)\n let shouldRefine = false;\n if (this.canTraverse(tile, frameState)) {\n this.updateChildTiles(tile, frameState);\n shouldRefine = this.updateAndPushChildren(\n tile,\n frameState,\n stack,\n tile.hasRenderContent ? tile._selectionDepth + 1 : tile._selectionDepth\n );\n }\n\n // 3. decide if should render (select) this tile\n // - tile does not have render content\n // - tile has render content and tile is `add` type (pointcloud)\n // - tile has render content and tile is `replace` type (photogrammetry) and can't refine any further\n const parent = tile.parent;\n const parentRefines = Boolean(!parent || parent._shouldRefine);\n const stoppedRefining = !shouldRefine;\n\n if (!tile.hasRenderContent) {\n this.emptyTiles[tile.id] = tile;\n this.loadTile(tile, frameState);\n if (stoppedRefining) {\n this.selectTile(tile, frameState);\n }\n // additive tiles\n } else if (tile.refine === TILE_REFINEMENT.ADD) {\n // Additive tiles are always loaded and selected\n this.loadTile(tile, frameState);\n this.selectTile(tile, frameState);\n\n // replace tiles\n } else if (tile.refine === TILE_REFINEMENT.REPLACE) {\n // Always load tiles in the base traversal\n // Select tiles that can't refine further\n this.loadTile(tile, frameState);\n if (stoppedRefining) {\n this.selectTile(tile, frameState);\n }\n }\n\n // 3. update cache, most recent touched tiles have higher priority to be fetched from server\n this.touchTile(tile, frameState);\n\n // 4. update tile refine prop and parent refinement status to trickle down to the descendants\n tile._shouldRefine = shouldRefine && parentRefines;\n }\n\n this.options.onTraversalEnd(frameState);\n }\n\n updateChildTiles(tile, frameState) {\n const children = tile.children;\n for (const child of children) {\n this.updateTile(child, frameState);\n }\n return true;\n }\n\n /* eslint-disable complexity, max-statements */\n updateAndPushChildren(tile, frameState, stack, depth) {\n const {loadSiblings, skipLevelOfDetail} = this.options;\n\n const children = tile.children;\n\n // sort children tiles\n children.sort(this.compareDistanceToCamera.bind(this));\n\n // For traditional replacement refinement only refine if all children are loaded.\n // Empty tiles are exempt since it looks better if children stream in as they are loaded to fill the empty space.\n const checkRefines =\n tile.refine === TILE_REFINEMENT.REPLACE && tile.hasRenderContent && !skipLevelOfDetail;\n\n let hasVisibleChild = false;\n let refines = true;\n\n for (const child of children) {\n child._selectionDepth = depth;\n if (child.isVisibleAndInRequestVolume) {\n if (stack.find(child)) {\n stack.delete(child);\n }\n stack.push(child);\n hasVisibleChild = true;\n } else if (checkRefines || loadSiblings) {\n // Keep non-visible children loaded since they are still needed before the parent can refine.\n // Or loadSiblings is true so always load tiles regardless of visibility.\n this.loadTile(child, frameState);\n this.touchTile(child, frameState);\n }\n\n if (checkRefines) {\n let childRefines;\n if (!child._inRequestVolume) {\n childRefines = false;\n } else if (!child.hasRenderContent) {\n childRefines = this.executeEmptyTraversal(child, frameState);\n } else {\n childRefines = child.contentAvailable;\n }\n refines = refines && childRefines;\n\n if (!refines) {\n return false;\n }\n }\n }\n\n if (!hasVisibleChild) {\n refines = false;\n }\n return refines;\n }\n /* eslint-enable complexity, max-statements */\n\n updateTile(tile, frameState) {\n this.updateTileVisibility(tile, frameState);\n }\n\n // tile to render in the browser\n selectTile(tile, frameState) {\n if (this.shouldSelectTile(tile)) {\n // The tile can be selected right away and does not require traverseAndSelect\n tile._selectedFrame = frameState.frameNumber;\n this.selectedTiles[tile.id] = tile;\n }\n }\n\n // tile to load from server\n loadTile(tile, frameState) {\n if (this.shouldLoadTile(tile)) {\n tile._requestedFrame = frameState.frameNumber;\n tile._priority = tile._getPriority();\n this.requestedTiles[tile.id] = tile;\n }\n }\n\n // cache tile\n touchTile(tile, frameState) {\n tile.tileset._cache.touch(tile);\n tile._touchedFrame = frameState.frameNumber;\n }\n\n // tile should be visible\n // tile should have children\n // tile LoD (level of detail) is not sufficient under current viewport\n canTraverse(tile, frameState, useParentMetric = false, ignoreVisibility = false) {\n if (!tile.hasChildren) {\n return false;\n }\n\n // cesium specific\n if (tile.hasTilesetContent) {\n // Traverse external this to visit its root tile\n // Don't traverse if the subtree is expired because it will be destroyed\n return !tile.contentExpired;\n }\n\n if (!ignoreVisibility && !tile.isVisibleAndInRequestVolume) {\n return false;\n }\n\n return this.shouldRefine(tile, frameState, useParentMetric);\n }\n\n shouldLoadTile(tile) {\n // if request tile is in current frame\n // and has unexpired render content\n return tile.hasUnloadedContent || tile.contentExpired;\n }\n\n shouldSelectTile(tile) {\n // if select tile is in current frame\n // and content available\n return tile.contentAvailable && !this.options.skipLevelOfDetail;\n }\n\n // Decide if tile LoD (level of detail) is not sufficient under current viewport\n shouldRefine(tile, frameState, useParentMetric) {\n let screenSpaceError = tile._screenSpaceError;\n if (useParentMetric) {\n screenSpaceError = tile.getScreenSpaceError(frameState, true);\n }\n\n return screenSpaceError > this.options.maximumScreenSpaceError;\n }\n\n updateTileVisibility(tile, frameState) {\n const viewportIds: string[] = [];\n if (this.options.viewportTraversersMap) {\n for (const key in this.options.viewportTraversersMap) {\n const value = this.options.viewportTraversersMap[key];\n if (value === frameState.viewport.id) {\n viewportIds.push(key);\n }\n }\n } else {\n viewportIds.push(frameState.viewport.id);\n }\n tile.updateVisibility(frameState, viewportIds);\n }\n\n // UTILITIES\n\n compareDistanceToCamera(b, a) {\n return b._distanceToCamera - a._distanceToCamera;\n }\n\n anyChildrenVisible(tile, frameState) {\n let anyVisible = false;\n for (const child of tile.children) {\n child.updateVisibility(frameState);\n anyVisible = anyVisible || child.isVisibleAndInRequestVolume;\n }\n return anyVisible;\n }\n\n // Depth-first traversal that checks if all nearest descendants with content are loaded.\n // Ignores visibility.\n executeEmptyTraversal(root, frameState) {\n let allDescendantsLoaded = true;\n const stack = this._emptyTraversalStack;\n\n stack.push(root);\n\n while (stack.length > 0 && allDescendantsLoaded) {\n const tile = stack.pop();\n\n this.updateTile(tile, frameState);\n\n if (!tile.isVisibleAndInRequestVolume) {\n // Load tiles that aren't visible since they are still needed for the parent to refine\n this.loadTile(tile, frameState);\n }\n\n this.touchTile(tile, frameState);\n\n // Only traverse if the tile is empty - traversal stop at descendants with content\n const traverse = !tile.hasRenderContent && this.canTraverse(tile, frameState, false, true);\n\n if (traverse) {\n const children = tile.children;\n for (const child of children) {\n // eslint-disable-next-line max-depth\n if (stack.find(child)) {\n stack.delete(child);\n }\n stack.push(child);\n }\n } else if (!tile.contentAvailable) {\n allDescendantsLoaded = false;\n }\n }\n\n return allDescendantsLoaded;\n }\n}\n\n// TODO\n// enable expiration\n// enable optimization hint\n"],"file":"tileset-traverser.js"}