@loaders.gl/tiles 3.1.0-alpha.5 → 3.1.0-beta.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 (84) hide show
  1. package/dist/bundle.d.ts +1 -0
  2. package/dist/bundle.d.ts.map +1 -0
  3. package/dist/bundle.js +8136 -0
  4. package/dist/constants.d.ts +1 -0
  5. package/dist/constants.d.ts.map +1 -0
  6. package/dist/constants.js +35 -0
  7. package/dist/es5/tileset/helpers/i3s-lod.js.map +1 -1
  8. package/dist/es5/tileset/tileset-cache.js.map +1 -1
  9. package/dist/es5/utils/doubly-linked-list-node.js +7 -0
  10. package/dist/es5/utils/doubly-linked-list-node.js.map +1 -1
  11. package/dist/es5/utils/doubly-linked-list.js +5 -3
  12. package/dist/es5/utils/doubly-linked-list.js.map +1 -1
  13. package/dist/es5/utils/managed-array.js +7 -1
  14. package/dist/es5/utils/managed-array.js.map +1 -1
  15. package/dist/esm/tileset/helpers/i3s-lod.js.map +1 -1
  16. package/dist/esm/tileset/tileset-cache.js.map +1 -1
  17. package/dist/esm/utils/doubly-linked-list-node.js +7 -0
  18. package/dist/esm/utils/doubly-linked-list-node.js.map +1 -1
  19. package/dist/esm/utils/doubly-linked-list.js +6 -3
  20. package/dist/esm/utils/doubly-linked-list.js.map +1 -1
  21. package/dist/esm/utils/managed-array.js +7 -1
  22. package/dist/esm/utils/managed-array.js.map +1 -1
  23. package/dist/index.d.ts +1 -0
  24. package/dist/index.d.ts.map +1 -0
  25. package/dist/index.js +28 -0
  26. package/dist/tileset/helpers/3d-tiles-options.d.ts +1 -0
  27. package/dist/tileset/helpers/3d-tiles-options.d.ts.map +1 -0
  28. package/dist/tileset/helpers/3d-tiles-options.js +9 -0
  29. package/dist/tileset/helpers/bounding-volume.d.ts +1 -0
  30. package/dist/tileset/helpers/bounding-volume.d.ts.map +1 -0
  31. package/dist/tileset/helpers/bounding-volume.js +177 -0
  32. package/dist/tileset/helpers/frame-state.d.ts +1 -0
  33. package/dist/tileset/helpers/frame-state.d.ts.map +1 -0
  34. package/dist/tileset/helpers/frame-state.js +70 -0
  35. package/dist/tileset/helpers/i3s-lod.d.ts +2 -1
  36. package/dist/tileset/helpers/i3s-lod.d.ts.map +1 -0
  37. package/dist/tileset/helpers/i3s-lod.js +83 -0
  38. package/dist/tileset/helpers/tiles-3d-lod.d.ts +1 -0
  39. package/dist/tileset/helpers/tiles-3d-lod.d.ts.map +1 -0
  40. package/dist/tileset/helpers/tiles-3d-lod.js +116 -0
  41. package/dist/tileset/helpers/transform-utils.d.ts +1 -0
  42. package/dist/tileset/helpers/transform-utils.d.ts.map +1 -0
  43. package/dist/tileset/helpers/transform-utils.js +52 -0
  44. package/dist/tileset/helpers/zoom.d.ts +1 -0
  45. package/dist/tileset/helpers/zoom.d.ts.map +1 -0
  46. package/dist/tileset/helpers/zoom.js +42 -0
  47. package/dist/tileset/tile-3d.d.ts +1 -0
  48. package/dist/tileset/tile-3d.d.ts.map +1 -0
  49. package/dist/tileset/tile-3d.js +554 -0
  50. package/dist/tileset/tileset-3d.d.ts +1 -0
  51. package/dist/tileset/tileset-3d.d.ts.map +1 -0
  52. package/dist/tileset/tileset-3d.js +601 -0
  53. package/dist/tileset/tileset-cache.d.ts +1 -0
  54. package/dist/tileset/tileset-cache.d.ts.map +1 -0
  55. package/dist/tileset/tileset-cache.js +79 -0
  56. package/dist/tileset/traversers/i3s-tile-manager.d.ts +1 -0
  57. package/dist/tileset/traversers/i3s-tile-manager.d.ts.map +1 -0
  58. package/dist/tileset/traversers/i3s-tile-manager.js +36 -0
  59. package/dist/tileset/traversers/i3s-tileset-traverser.d.ts +1 -0
  60. package/dist/tileset/traversers/i3s-tileset-traverser.d.ts.map +1 -0
  61. package/dist/tileset/traversers/i3s-tileset-traverser.js +85 -0
  62. package/dist/tileset/traversers/tileset-3d-traverser.d.ts +1 -0
  63. package/dist/tileset/traversers/tileset-3d-traverser.d.ts.map +1 -0
  64. package/dist/tileset/traversers/tileset-3d-traverser.js +55 -0
  65. package/dist/tileset/traversers/tileset-traverser.d.ts +1 -0
  66. package/dist/tileset/traversers/tileset-traverser.d.ts.map +1 -0
  67. package/dist/tileset/traversers/tileset-traverser.js +294 -0
  68. package/dist/utils/doubly-linked-list-node.d.ts +2 -1
  69. package/dist/utils/doubly-linked-list-node.d.ts.map +1 -0
  70. package/dist/utils/doubly-linked-list-node.js +17 -0
  71. package/dist/utils/doubly-linked-list.d.ts +7 -6
  72. package/dist/utils/doubly-linked-list.d.ts.map +1 -0
  73. package/dist/utils/doubly-linked-list.js +100 -0
  74. package/dist/utils/managed-array.d.ts +10 -9
  75. package/dist/utils/managed-array.d.ts.map +1 -0
  76. package/dist/utils/managed-array.js +151 -0
  77. package/package.json +6 -7
  78. package/src/tileset/helpers/i3s-lod.ts +1 -1
  79. package/src/tileset/tileset-cache.ts +2 -0
  80. package/src/utils/{doubly-linked-list-node.js → doubly-linked-list-node.ts} +4 -0
  81. package/src/utils/{doubly-linked-list.js → doubly-linked-list.ts} +3 -5
  82. package/src/utils/{managed-array.js → managed-array.ts} +4 -1
  83. package/dist/dist.min.js +0 -2
  84. package/dist/dist.min.js.map +0 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"i3s-tile-manager.d.ts","sourceRoot":"","sources":["../../../src/tileset/traversers/i3s-tile-manager.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,OAAO,OAAO,cAAc;IACjC,OAAO,CAAC,UAAU,CAAS;;IAM3B,GAAG,CAAC,OAAO,KAAA,EAAE,GAAG,KAAA,EAAE,QAAQ,KAAA,EAAE,UAAU,KAAA;IAetC,MAAM,CAAC,GAAG,KAAA,EAAE,UAAU,KAAA;IAMtB,IAAI,CAAC,GAAG,KAAA;CAGT"}
@@ -0,0 +1,36 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ const STATUS = {
4
+ REQUESTED: 'REQUESTED',
5
+ COMPLETED: 'COMPLETED',
6
+ ERROR: 'ERROR'
7
+ };
8
+ // A helper class to manage tile metadata fetching
9
+ class I3STileManager {
10
+ constructor() {
11
+ this._statusMap = {};
12
+ }
13
+ add(request, key, callback, frameState) {
14
+ if (!this._statusMap[key]) {
15
+ this._statusMap[key] = { request, callback, key, frameState, status: STATUS.REQUESTED };
16
+ request()
17
+ .then((data) => {
18
+ this._statusMap[key].status = STATUS.COMPLETED;
19
+ this._statusMap[key].callback(data, frameState);
20
+ })
21
+ .catch((error) => {
22
+ this._statusMap[key].status = STATUS.ERROR;
23
+ callback(error);
24
+ });
25
+ }
26
+ }
27
+ update(key, frameState) {
28
+ if (this._statusMap[key]) {
29
+ this._statusMap[key].frameState = frameState;
30
+ }
31
+ }
32
+ find(key) {
33
+ return this._statusMap[key];
34
+ }
35
+ }
36
+ exports.default = I3STileManager;
@@ -15,3 +15,4 @@ export default class I3STilesetTraverser extends TilesetTraverser {
15
15
  */
16
16
  _onTileLoad(header: any, tile: any, extendedId: any): void;
17
17
  }
18
+ //# sourceMappingURL=i3s-tileset-traverser.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"i3s-tileset-traverser.d.ts","sourceRoot":"","sources":["../../../src/tileset/traversers/i3s-tileset-traverser.ts"],"names":[],"mappings":"AACA,OAAO,gBAAgB,MAAM,qBAAqB,CAAC;AAMnD,MAAM,CAAC,OAAO,OAAO,mBAAoB,SAAQ,gBAAgB;IAC/D,OAAO,CAAC,YAAY,CAAiB;gBAEzB,OAAO,KAAA;IAKnB,YAAY,CAAC,IAAI,KAAA,EAAE,UAAU,KAAA;IAK7B,gBAAgB,CAAC,IAAI,KAAA,EAAE,UAAU,KAAA,GAAG,OAAO;IAoCrC,SAAS,CAAC,MAAM,KAAA,EAAE,OAAO,KAAA;IAgB/B;;;;;;;OAOG;IACH,WAAW,CAAC,MAAM,KAAA,EAAE,IAAI,KAAA,EAAE,UAAU,KAAA;CAYrC"}
@@ -0,0 +1,85 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
5
+ Object.defineProperty(exports, "__esModule", { value: true });
6
+ const core_1 = require("@loaders.gl/core");
7
+ const tileset_traverser_1 = __importDefault(require("./tileset-traverser"));
8
+ const i3s_lod_1 = require("../helpers/i3s-lod");
9
+ const tile_3d_1 = __importDefault(require("../tile-3d"));
10
+ const i3s_tile_manager_1 = __importDefault(require("./i3s-tile-manager"));
11
+ class I3STilesetTraverser extends tileset_traverser_1.default {
12
+ constructor(options) {
13
+ super(options);
14
+ this._tileManager = new i3s_tile_manager_1.default();
15
+ }
16
+ shouldRefine(tile, frameState) {
17
+ tile._lodJudge = (0, i3s_lod_1.getLodStatus)(tile, frameState);
18
+ return tile._lodJudge === 'DIG';
19
+ }
20
+ updateChildTiles(tile, frameState) {
21
+ const children = tile.header.children || [];
22
+ // children which are already fetched and constructed as Tile3D instances
23
+ const childTiles = tile.children;
24
+ const tileset = tile.tileset;
25
+ for (const child of children) {
26
+ const extendedId = `${child.id}-${frameState.viewport.id}`;
27
+ // if child tile is not fetched
28
+ const childTile = childTiles && childTiles.find((t) => t.id === extendedId);
29
+ if (!childTile) {
30
+ let request = () => this._loadTile(child.id, tileset);
31
+ const cachedRequest = this._tileManager.find(extendedId);
32
+ if (!cachedRequest) {
33
+ // eslint-disable-next-line max-depth
34
+ if (tileset.tileset.nodePages) {
35
+ request = () => tileset.tileset.nodePagesTile.formTileFromNodePages(child.id);
36
+ }
37
+ this._tileManager.add(request, extendedId, (header) => this._onTileLoad(header, tile, extendedId), frameState);
38
+ }
39
+ else {
40
+ // update frameNumber since it is still needed in current frame
41
+ this._tileManager.update(extendedId, frameState);
42
+ }
43
+ }
44
+ else if (childTile) {
45
+ // if child tile is fetched and available
46
+ this.updateTile(childTile, frameState);
47
+ }
48
+ }
49
+ return false;
50
+ }
51
+ async _loadTile(nodeId, tileset) {
52
+ const { loader } = tileset;
53
+ const nodeUrl = tileset.getTileUrl(`${tileset.url}/nodes/${nodeId}`);
54
+ // load metadata
55
+ const options = {
56
+ ...tileset.loadOptions,
57
+ i3s: {
58
+ ...tileset.loadOptions.i3s,
59
+ isTileHeader: true,
60
+ loadContent: false
61
+ }
62
+ };
63
+ return await (0, core_1.load)(nodeUrl, loader, options);
64
+ }
65
+ /**
66
+ * The callback to init TileHeader instance after loading the tile JSON
67
+ * @param {Object} header - the tile JSON from a dataset
68
+ * @param {TileHeader} tile - the parent TileHeader instance
69
+ * @param {string} extendedId - optional ID to separate copies of a tile for different viewports.
70
+ * const extendedId = `${tile.id}-${frameState.viewport.id}`;
71
+ * @return {void}
72
+ */
73
+ _onTileLoad(header, tile, extendedId) {
74
+ // after child tile is fetched
75
+ const childTile = new tile_3d_1.default(tile.tileset, header, tile, extendedId);
76
+ tile.children.push(childTile);
77
+ const frameState = this._tileManager.find(childTile.id).frameState;
78
+ this.updateTile(childTile, frameState);
79
+ // after tile fetched, resume traversal if still in current update/traversal frame
80
+ if (this._frameNumber === frameState.frameNumber) {
81
+ this.executeTraversal(childTile, frameState);
82
+ }
83
+ }
84
+ }
85
+ exports.default = I3STilesetTraverser;
@@ -4,3 +4,4 @@ export default class Tileset3DTraverser extends TilesetTraverser {
4
4
  updateTileVisibility(tile: any, frameState: any): void;
5
5
  meetsScreenSpaceErrorEarly(tile: any, frameState: any): boolean;
6
6
  }
7
+ //# sourceMappingURL=tileset-3d-traverser.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tileset-3d-traverser.d.ts","sourceRoot":"","sources":["../../../src/tileset/traversers/tileset-3d-traverser.ts"],"names":[],"mappings":"AAIA,OAAO,gBAAgB,MAAM,qBAAqB,CAAC;AAEnD,MAAM,CAAC,OAAO,OAAO,kBAAmB,SAAQ,gBAAgB;IAC9D,uBAAuB,CAAC,CAAC,KAAA,EAAE,CAAC,KAAA;IAO5B,oBAAoB,CAAC,IAAI,KAAA,EAAE,UAAU,KAAA;IAmCrC,0BAA0B,CAAC,IAAI,KAAA,EAAE,UAAU,KAAA;CAS5C"}
@@ -0,0 +1,55 @@
1
+ "use strict";
2
+ // This file is derived from the Cesium code base under Apache 2 license
3
+ // See LICENSE.md and https://github.com/AnalyticalGraphicsInc/cesium/blob/master/LICENSE.md
4
+ var __importDefault = (this && this.__importDefault) || function (mod) {
5
+ return (mod && mod.__esModule) ? mod : { "default": mod };
6
+ };
7
+ Object.defineProperty(exports, "__esModule", { value: true });
8
+ const constants_1 = require("../../constants");
9
+ const tileset_traverser_1 = __importDefault(require("./tileset-traverser"));
10
+ class Tileset3DTraverser extends tileset_traverser_1.default {
11
+ compareDistanceToCamera(a, b) {
12
+ // Sort by farthest child first since this is going on a stack
13
+ return b._distanceToCamera === 0 && a._distanceToCamera === 0
14
+ ? b._centerZDepth - a._centerZDepth
15
+ : b._distanceToCamera - a._distanceToCamera;
16
+ }
17
+ updateTileVisibility(tile, frameState) {
18
+ super.updateTileVisibility(tile, frameState);
19
+ // Optimization - if none of the tile's children are visible then this tile isn't visible
20
+ if (!tile.isVisibleAndInRequestVolume) {
21
+ return;
22
+ }
23
+ const hasChildren = tile.children.length > 0;
24
+ if (tile.hasTilesetContent && hasChildren) {
25
+ // Use the root tile's visibility instead of this tile's visibility.
26
+ // The root tile may be culled by the children bounds optimization in which
27
+ // case this tile should also be culled.
28
+ const firstChild = tile.children[0];
29
+ this.updateTileVisibility(firstChild, frameState);
30
+ tile._visible = firstChild._visible;
31
+ return;
32
+ }
33
+ if (this.meetsScreenSpaceErrorEarly(tile, frameState)) {
34
+ tile._visible = false;
35
+ return;
36
+ }
37
+ const replace = tile.refine === constants_1.TILE_REFINEMENT.REPLACE;
38
+ const useOptimization = tile._optimChildrenWithinParent === constants_1.TILE3D_OPTIMIZATION_HINT.USE_OPTIMIZATION;
39
+ if (replace && useOptimization && hasChildren) {
40
+ if (!this.anyChildrenVisible(tile, frameState)) {
41
+ tile._visible = false;
42
+ return;
43
+ }
44
+ }
45
+ }
46
+ meetsScreenSpaceErrorEarly(tile, frameState) {
47
+ const { parent } = tile;
48
+ if (!parent || parent.hasTilesetContent || parent.refine !== constants_1.TILE_REFINEMENT.ADD) {
49
+ return false;
50
+ }
51
+ // Use parent's geometric error with child's box to see if the tile already meet the SSE
52
+ return !this.shouldRefine(tile, frameState, true);
53
+ }
54
+ }
55
+ exports.default = Tileset3DTraverser;
@@ -49,3 +49,4 @@ export default class TilesetTraverser {
49
49
  anyChildrenVisible(tile: any, frameState: any): boolean;
50
50
  executeEmptyTraversal(root: any, frameState: any): boolean;
51
51
  }
52
+ //# sourceMappingURL=tileset-traverser.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tileset-traverser.d.ts","sourceRoot":"","sources":["../../../src/tileset/traversers/tileset-traverser.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,2BAA2B,CAAC;AAGrD,oBAAY,qBAAqB,GAAG;IAClC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,cAAc,CAAC,EAAE,CAAC,UAAU,KAAA,KAAK,GAAG,CAAC;IACrC,qBAAqB,CAAC,EAAE;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAC,CAAC;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,oBAAY,KAAK,GAAG;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,uBAAuB,EAAE,MAAM,CAAC;IAChC,cAAc,EAAE,CAAC,UAAU,KAAA,KAAK,GAAG,CAAC;IACpC,qBAAqB,EAAE;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAC,CAAC;IAC5C,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,KAQ3B,CAAC;AAEF,MAAM,CAAC,OAAO,OAAO,gBAAgB;IACnC,OAAO,EAAE,KAAK,CAAC;IAEf,IAAI,EAAE,GAAG,CAAC;IACV,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IAEnB,SAAS,CAAC,eAAe,EAAE,YAAY,CAAC;IACxC,SAAS,CAAC,oBAAoB,EAAE,YAAY,CAAC;IAC7C,SAAS,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;gBAG1B,OAAO,EAAE,qBAAqB;IAuB1C,QAAQ,CAAC,IAAI,KAAA,EAAE,UAAU,KAAA,EAAE,OAAO,KAAA;IAclC,KAAK;IAgBL,gBAAgB,CAAC,IAAI,KAAA,EAAE,UAAU,KAAA;IA+DjC,gBAAgB,CAAC,IAAI,KAAA,EAAE,UAAU,KAAA;IASjC,qBAAqB,CAAC,IAAI,KAAA,EAAE,UAAU,KAAA,EAAE,KAAK,KAAA,EAAE,KAAK,KAAA;IAuDpD,UAAU,CAAC,IAAI,KAAA,EAAE,UAAU,KAAA;IAK3B,UAAU,CAAC,IAAI,KAAA,EAAE,UAAU,KAAA;IAS3B,QAAQ,CAAC,IAAI,KAAA,EAAE,UAAU,KAAA;IASzB,SAAS,CAAC,IAAI,KAAA,EAAE,UAAU,KAAA;IAQ1B,WAAW,CAAC,IAAI,KAAA,EAAE,UAAU,KAAA,EAAE,eAAe,UAAQ,EAAE,gBAAgB,UAAQ;IAmB/E,cAAc,CAAC,IAAI,KAAA;IAMnB,gBAAgB,CAAC,IAAI,KAAA;IAOrB,YAAY,CAAC,IAAI,KAAA,EAAE,UAAU,KAAA,EAAE,eAAe,KAAA;IAS9C,oBAAoB,CAAC,IAAI,KAAA,EAAE,UAAU,KAAA;IAiBrC,uBAAuB,CAAC,CAAC,KAAA,EAAE,CAAC,KAAA;IAI5B,kBAAkB,CAAC,IAAI,KAAA,EAAE,UAAU,KAAA;IAWnC,qBAAqB,CAAC,IAAI,KAAA,EAAE,UAAU,KAAA;CAqCvC"}
@@ -0,0 +1,294 @@
1
+ "use strict";
2
+ var __importDefault = (this && this.__importDefault) || function (mod) {
3
+ return (mod && mod.__esModule) ? mod : { "default": mod };
4
+ };
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
+ }
164
+ }
165
+ if (!hasVisibleChild) {
166
+ refines = false;
167
+ }
168
+ return refines;
169
+ }
170
+ /* eslint-enable complexity, max-statements */
171
+ updateTile(tile, frameState) {
172
+ this.updateTileVisibility(tile, frameState);
173
+ }
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;
180
+ }
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;
188
+ }
189
+ }
190
+ // cache tile
191
+ touchTile(tile, frameState) {
192
+ tile.tileset._cache.touch(tile);
193
+ tile._touchedFrame = frameState.frameNumber;
194
+ }
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);
212
+ }
213
+ shouldLoadTile(tile) {
214
+ // if request tile is in current frame
215
+ // and has unexpired render content
216
+ return tile.hasUnloadedContent || tile.contentExpired;
217
+ }
218
+ shouldSelectTile(tile) {
219
+ // if select tile is in current frame
220
+ // and content available
221
+ return tile.contentAvailable && !this.options.skipLevelOfDetail;
222
+ }
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;
230
+ }
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);
245
+ }
246
+ // UTILITIES
247
+ compareDistanceToCamera(b, a) {
248
+ return b._distanceToCamera - a._distanceToCamera;
249
+ }
250
+ anyChildrenVisible(tile, frameState) {
251
+ let anyVisible = false;
252
+ for (const child of tile.children) {
253
+ child.updateVisibility(frameState);
254
+ anyVisible = anyVisible || child.isVisibleAndInRequestVolume;
255
+ }
256
+ return anyVisible;
257
+ }
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
+ }
287
+ }
288
+ return allDescendantsLoaded;
289
+ }
290
+ }
291
+ exports.default = TilesetTraverser;
292
+ // TODO
293
+ // enable expiration
294
+ // enable optimization hint
@@ -4,8 +4,9 @@
4
4
  * @private
5
5
  */
6
6
  export default class DoublyLinkedListNode {
7
- constructor(item: any, previous: any, next: any);
8
7
  item: any;
9
8
  previous: any;
10
9
  next: any;
10
+ constructor(item: any, previous: any, next: any);
11
11
  }
12
+ //# sourceMappingURL=doubly-linked-list-node.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"doubly-linked-list-node.d.ts","sourceRoot":"","sources":["../../src/utils/doubly-linked-list-node.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,oBAAoB;IACvC,IAAI,MAAC;IACL,QAAQ,MAAC;IACT,IAAI,MAAC;gBAEO,IAAI,KAAA,EAAE,QAAQ,KAAA,EAAE,IAAI,KAAA;CAKjC"}
@@ -0,0 +1,17 @@
1
+ "use strict";
2
+ // This file is derived from the Cesium code base under Apache 2 license
3
+ // See LICENSE.md and https://github.com/AnalyticalGraphicsInc/cesium/blob/master/LICENSE.md
4
+ Object.defineProperty(exports, "__esModule", { value: true });
5
+ /**
6
+ * Doubly linked list node
7
+ *
8
+ * @private
9
+ */
10
+ class DoublyLinkedListNode {
11
+ constructor(item, previous, next) {
12
+ this.item = item;
13
+ this.previous = previous;
14
+ this.next = next;
15
+ }
16
+ }
17
+ exports.default = DoublyLinkedListNode;
@@ -1,11 +1,12 @@
1
+ import DoublyLinkedListNode from '../utils/doubly-linked-list-node';
1
2
  /**
2
3
  * Doubly linked list
3
4
  *
4
5
  * @private
5
6
  */
6
7
  export default class DoublyLinkedList {
7
- head: any;
8
- tail: any;
8
+ head: DoublyLinkedListNode | null;
9
+ tail: DoublyLinkedListNode | null;
9
10
  _length: number;
10
11
  get length(): number;
11
12
  /**
@@ -13,18 +14,18 @@ export default class DoublyLinkedList {
13
14
  * @param {*} [item]
14
15
  * @return {DoublyLinkedListNode}
15
16
  */
16
- add(item?: any): DoublyLinkedListNode;
17
+ add(item: any): DoublyLinkedListNode;
17
18
  /**
18
19
  * Removes the given node from the list
19
20
  * @param {DoublyLinkedListNode} node
20
21
  */
21
- remove(node: DoublyLinkedListNode): void;
22
+ remove(node: any): void;
22
23
  /**
23
24
  * Moves nextNode after node
24
25
  * @param {DoublyLinkedListNode} node
25
26
  * @param {DoublyLinkedListNode} nextNode
26
27
  */
27
- splice(node: DoublyLinkedListNode, nextNode: DoublyLinkedListNode): void;
28
+ splice(node: any, nextNode: any): void;
28
29
  _insert(node: any, nextNode: any): void;
29
30
  }
30
- import DoublyLinkedListNode from "../utils/doubly-linked-list-node";
31
+ //# sourceMappingURL=doubly-linked-list.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"doubly-linked-list.d.ts","sourceRoot":"","sources":["../../src/utils/doubly-linked-list.ts"],"names":[],"mappings":"AAGA,OAAO,oBAAoB,MAAM,kCAAkC,CAAC;AAEpE;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,gBAAgB;IACnC,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAAQ;IACzC,IAAI,EAAE,oBAAoB,GAAG,IAAI,CAAQ;IACzC,OAAO,SAAK;IAEZ,IAAI,MAAM,WAET;IAED;;;;OAIG;IACH,GAAG,CAAC,IAAI,KAAA;IAgBR;;;OAGG;IACH,MAAM,CAAC,IAAI,KAAA;IA4BX;;;;OAIG;IACH,MAAM,CAAC,IAAI,KAAA,EAAE,QAAQ,KAAA;IAUrB,OAAO,CAAC,IAAI,KAAA,EAAE,QAAQ,KAAA;CAgBvB"}