@loaders.gl/tiles 3.1.0-alpha.2 → 3.1.0-beta.1

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 (173) hide show
  1. package/dist/bundle.d.ts +2 -0
  2. package/dist/bundle.d.ts.map +1 -0
  3. package/dist/bundle.js +8134 -5
  4. package/dist/constants.d.ts +32 -0
  5. package/dist/constants.d.ts.map +1 -0
  6. package/dist/constants.js +29 -26
  7. package/dist/es5/bundle.js +7 -0
  8. package/dist/es5/bundle.js.map +1 -0
  9. package/dist/es5/constants.js +44 -0
  10. package/dist/es5/constants.js.map +1 -0
  11. package/dist/es5/index.js +104 -0
  12. package/dist/es5/index.js.map +1 -0
  13. package/dist/es5/tileset/helpers/3d-tiles-options.js +13 -0
  14. package/dist/es5/tileset/helpers/3d-tiles-options.js.map +1 -0
  15. package/dist/es5/tileset/helpers/bounding-volume.js +102 -0
  16. package/dist/es5/tileset/helpers/bounding-volume.js.map +1 -0
  17. package/dist/es5/tileset/helpers/frame-state.js +69 -0
  18. package/dist/es5/tileset/helpers/frame-state.js.map +1 -0
  19. package/dist/es5/tileset/helpers/i3s-lod.js +84 -0
  20. package/dist/es5/tileset/helpers/i3s-lod.js.map +1 -0
  21. package/dist/es5/tileset/helpers/tiles-3d-lod.js +123 -0
  22. package/dist/es5/tileset/helpers/tiles-3d-lod.js.map +1 -0
  23. package/dist/es5/tileset/helpers/transform-utils.js +71 -0
  24. package/dist/es5/tileset/helpers/transform-utils.js.map +1 -0
  25. package/dist/es5/tileset/helpers/zoom.js +45 -0
  26. package/dist/es5/tileset/helpers/zoom.js.map +1 -0
  27. package/dist/es5/tileset/tile-3d.js +510 -0
  28. package/dist/es5/tileset/tile-3d.js.map +1 -0
  29. package/dist/es5/tileset/tileset-3d.js +656 -0
  30. package/dist/es5/tileset/tileset-3d.js.map +1 -0
  31. package/dist/es5/tileset/tileset-cache.js +88 -0
  32. package/dist/es5/tileset/tileset-cache.js.map +1 -0
  33. package/dist/es5/tileset/traversers/i3s-tile-manager.js +57 -0
  34. package/dist/es5/tileset/traversers/i3s-tile-manager.js.map +1 -0
  35. package/dist/es5/tileset/traversers/i3s-tileset-traverser.js +95 -0
  36. package/dist/es5/tileset/traversers/i3s-tileset-traverser.js.map +1 -0
  37. package/dist/es5/tileset/traversers/tileset-3d-traverser.js +66 -0
  38. package/dist/es5/tileset/traversers/tileset-3d-traverser.js.map +1 -0
  39. package/dist/es5/tileset/traversers/tileset-traverser.js +304 -0
  40. package/dist/es5/tileset/traversers/tileset-traverser.js.map +1 -0
  41. package/dist/es5/utils/doubly-linked-list-node.js +25 -0
  42. package/dist/es5/utils/doubly-linked-list-node.js.map +1 -0
  43. package/dist/es5/utils/doubly-linked-list.js +92 -0
  44. package/dist/es5/utils/doubly-linked-list.js.map +1 -0
  45. package/dist/es5/utils/managed-array.js +127 -0
  46. package/dist/es5/utils/managed-array.js.map +1 -0
  47. package/dist/esm/bundle.js +5 -0
  48. package/dist/esm/bundle.js.map +1 -0
  49. package/dist/esm/constants.js +32 -0
  50. package/dist/esm/constants.js.map +1 -0
  51. package/dist/esm/index.js +10 -0
  52. package/dist/esm/index.js.map +1 -0
  53. package/dist/esm/tileset/helpers/3d-tiles-options.js +6 -0
  54. package/dist/esm/tileset/helpers/3d-tiles-options.js.map +1 -0
  55. package/dist/esm/tileset/helpers/bounding-volume.js +88 -0
  56. package/dist/esm/tileset/helpers/bounding-volume.js.map +1 -0
  57. package/dist/esm/tileset/helpers/frame-state.js +51 -0
  58. package/dist/esm/tileset/helpers/frame-state.js.map +1 -0
  59. package/dist/esm/tileset/helpers/i3s-lod.js +67 -0
  60. package/dist/esm/tileset/helpers/i3s-lod.js.map +1 -0
  61. package/dist/esm/tileset/helpers/tiles-3d-lod.js +105 -0
  62. package/dist/esm/tileset/helpers/tiles-3d-lod.js.map +1 -0
  63. package/dist/esm/tileset/helpers/transform-utils.js +58 -0
  64. package/dist/esm/tileset/helpers/transform-utils.js.map +1 -0
  65. package/dist/esm/tileset/helpers/zoom.js +36 -0
  66. package/dist/esm/tileset/helpers/zoom.js.map +1 -0
  67. package/dist/esm/tileset/tile-3d.js +534 -0
  68. package/dist/esm/tileset/tile-3d.js.map +1 -0
  69. package/dist/esm/tileset/tileset-3d.js +674 -0
  70. package/dist/esm/tileset/tileset-3d.js.map +1 -0
  71. package/dist/esm/tileset/tileset-cache.js +79 -0
  72. package/dist/esm/tileset/tileset-cache.js.map +1 -0
  73. package/dist/esm/tileset/traversers/i3s-tile-manager.js +45 -0
  74. package/dist/esm/tileset/traversers/i3s-tile-manager.js.map +1 -0
  75. package/dist/esm/tileset/traversers/i3s-tileset-traverser.js +80 -0
  76. package/dist/esm/tileset/traversers/i3s-tileset-traverser.js.map +1 -0
  77. package/dist/esm/tileset/traversers/tileset-3d-traverser.js +53 -0
  78. package/dist/esm/tileset/traversers/tileset-3d-traverser.js.map +1 -0
  79. package/dist/esm/tileset/traversers/tileset-traverser.js +296 -0
  80. package/dist/esm/tileset/traversers/tileset-traverser.js.map +1 -0
  81. package/dist/esm/utils/doubly-linked-list-node.js +16 -0
  82. package/dist/esm/utils/doubly-linked-list-node.js.map +1 -0
  83. package/dist/esm/utils/doubly-linked-list.js +81 -0
  84. package/dist/esm/utils/doubly-linked-list.js.map +1 -0
  85. package/dist/esm/utils/managed-array.js +117 -0
  86. package/dist/esm/utils/managed-array.js.map +1 -0
  87. package/dist/index.d.ts +11 -0
  88. package/dist/index.d.ts.map +1 -0
  89. package/dist/index.js +28 -9
  90. package/dist/tileset/helpers/3d-tiles-options.d.ts +4 -0
  91. package/dist/tileset/helpers/3d-tiles-options.d.ts.map +1 -0
  92. package/dist/tileset/helpers/3d-tiles-options.js +8 -5
  93. package/dist/tileset/helpers/bounding-volume.d.ts +9 -0
  94. package/dist/tileset/helpers/bounding-volume.d.ts.map +1 -0
  95. package/dist/tileset/helpers/bounding-volume.js +159 -70
  96. package/dist/tileset/helpers/frame-state.d.ts +17 -0
  97. package/dist/tileset/helpers/frame-state.d.ts.map +1 -0
  98. package/dist/tileset/helpers/frame-state.js +67 -48
  99. package/dist/tileset/helpers/i3s-lod.d.ts +20 -0
  100. package/dist/tileset/helpers/i3s-lod.d.ts.map +1 -0
  101. package/dist/tileset/helpers/i3s-lod.js +80 -105
  102. package/dist/tileset/helpers/tiles-3d-lod.d.ts +8 -0
  103. package/dist/tileset/helpers/tiles-3d-lod.d.ts.map +1 -0
  104. package/dist/tileset/helpers/tiles-3d-lod.js +111 -100
  105. package/dist/tileset/helpers/transform-utils.d.ts +2 -0
  106. package/dist/tileset/helpers/transform-utils.d.ts.map +1 -0
  107. package/dist/tileset/helpers/transform-utils.js +50 -53
  108. package/dist/tileset/helpers/zoom.d.ts +7 -0
  109. package/dist/tileset/helpers/zoom.d.ts.map +1 -0
  110. package/dist/tileset/helpers/zoom.js +36 -30
  111. package/dist/tileset/tile-3d.d.ts +174 -0
  112. package/dist/tileset/tile-3d.d.ts.map +1 -0
  113. package/dist/tileset/tile-3d.js +550 -530
  114. package/dist/tileset/tileset-3d.d.ts +172 -0
  115. package/dist/tileset/tileset-3d.d.ts.map +1 -0
  116. package/dist/tileset/tileset-3d.js +576 -649
  117. package/dist/tileset/tileset-cache.d.ts +18 -0
  118. package/dist/tileset/tileset-cache.d.ts.map +1 -0
  119. package/dist/tileset/tileset-cache.js +71 -71
  120. package/dist/tileset/traversers/i3s-tile-manager.d.ts +8 -0
  121. package/dist/tileset/traversers/i3s-tile-manager.d.ts.map +1 -0
  122. package/dist/tileset/traversers/i3s-tile-manager.js +31 -40
  123. package/dist/tileset/traversers/i3s-tileset-traverser.d.ts +18 -0
  124. package/dist/tileset/traversers/i3s-tileset-traverser.d.ts.map +1 -0
  125. package/dist/tileset/traversers/i3s-tileset-traverser.js +81 -76
  126. package/dist/tileset/traversers/tileset-3d-traverser.d.ts +7 -0
  127. package/dist/tileset/traversers/tileset-3d-traverser.d.ts.map +1 -0
  128. package/dist/tileset/traversers/tileset-3d-traverser.js +51 -49
  129. package/dist/tileset/traversers/tileset-traverser.d.ts +52 -0
  130. package/dist/tileset/traversers/tileset-traverser.d.ts.map +1 -0
  131. package/dist/tileset/traversers/tileset-traverser.js +274 -276
  132. package/dist/utils/doubly-linked-list-node.d.ts +12 -0
  133. package/dist/utils/doubly-linked-list-node.d.ts.map +1 -0
  134. package/dist/utils/doubly-linked-list-node.js +16 -8
  135. package/dist/utils/doubly-linked-list.d.ts +31 -0
  136. package/dist/utils/doubly-linked-list.d.ts.map +1 -0
  137. package/dist/utils/doubly-linked-list.js +94 -72
  138. package/dist/utils/managed-array.d.ts +85 -0
  139. package/dist/utils/managed-array.d.ts.map +1 -0
  140. package/dist/utils/managed-array.js +143 -103
  141. package/package.json +11 -9
  142. package/src/bundle.ts +2 -3
  143. package/src/index.ts +1 -0
  144. package/src/tileset/helpers/i3s-lod.ts +72 -96
  145. package/src/tileset/helpers/transform-utils.ts +3 -1
  146. package/src/tileset/tile-3d.ts +2 -2
  147. package/src/tileset/tileset-cache.ts +2 -0
  148. package/src/tileset/traversers/i3s-tileset-traverser.ts +2 -3
  149. package/src/utils/{doubly-linked-list-node.js → doubly-linked-list-node.ts} +4 -0
  150. package/src/utils/{doubly-linked-list.js → doubly-linked-list.ts} +3 -5
  151. package/src/utils/{managed-array.js → managed-array.ts} +4 -1
  152. package/dist/bundle.js.map +0 -1
  153. package/dist/constants.js.map +0 -1
  154. package/dist/dist.min.js +0 -2
  155. package/dist/dist.min.js.map +0 -1
  156. package/dist/index.js.map +0 -1
  157. package/dist/tileset/helpers/3d-tiles-options.js.map +0 -1
  158. package/dist/tileset/helpers/bounding-volume.js.map +0 -1
  159. package/dist/tileset/helpers/frame-state.js.map +0 -1
  160. package/dist/tileset/helpers/i3s-lod.js.map +0 -1
  161. package/dist/tileset/helpers/tiles-3d-lod.js.map +0 -1
  162. package/dist/tileset/helpers/transform-utils.js.map +0 -1
  163. package/dist/tileset/helpers/zoom.js.map +0 -1
  164. package/dist/tileset/tile-3d.js.map +0 -1
  165. package/dist/tileset/tileset-3d.js.map +0 -1
  166. package/dist/tileset/tileset-cache.js.map +0 -1
  167. package/dist/tileset/traversers/i3s-tile-manager.js.map +0 -1
  168. package/dist/tileset/traversers/i3s-tileset-traverser.js.map +0 -1
  169. package/dist/tileset/traversers/tileset-3d-traverser.js.map +0 -1
  170. package/dist/tileset/traversers/tileset-traverser.js.map +0 -1
  171. package/dist/utils/doubly-linked-list-node.js.map +0 -1
  172. package/dist/utils/doubly-linked-list.js.map +0 -1
  173. package/dist/utils/managed-array.js.map +0 -1
@@ -1,6 +1,9 @@
1
- export function get3dTilesOptions(tileset) {
2
- return {
3
- assetGltfUpAxis: tileset.asset && tileset.asset.gltfUpAxis || 'Y'
4
- };
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.get3dTilesOptions = void 0;
4
+ function get3dTilesOptions(tileset) {
5
+ return {
6
+ assetGltfUpAxis: (tileset.asset && tileset.asset.gltfUpAxis) || 'Y'
7
+ };
5
8
  }
6
- //# sourceMappingURL=3d-tiles-options.js.map
9
+ exports.get3dTilesOptions = get3dTilesOptions;
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Create a bounding volume from the tile's bounding volume header.
3
+ * @param {Object} boundingVolumeHeader The tile's bounding volume header.
4
+ * @param {Matrix4} transform The transform to apply to the bounding volume.
5
+ * @param [result] The object onto which to store the result.
6
+ * @returns The modified result parameter or a new TileBoundingVolume instance if none was provided.
7
+ */
8
+ export declare function createBoundingVolume(boundingVolumeHeader: any, transform: any, result: any): any;
9
+ //# sourceMappingURL=bounding-volume.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bounding-volume.d.ts","sourceRoot":"","sources":["../../../src/tileset/helpers/bounding-volume.ts"],"names":[],"mappings":"AAuBA;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,oBAAoB,KAAA,EAAE,SAAS,KAAA,EAAE,MAAM,KAAA,OAsC3E"}
@@ -1,88 +1,177 @@
1
- import { Quaternion, Vector3, Matrix3, Matrix4, degrees } from '@math.gl/core';
2
- import { BoundingSphere, OrientedBoundingBox } from '@math.gl/culling';
3
- import { Ellipsoid } from '@math.gl/geospatial';
4
- import { assert } from '@loaders.gl/loader-utils';
5
-
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
+ exports.createBoundingVolume = void 0;
6
+ /* eslint-disable */
7
+ const core_1 = require("@math.gl/core");
8
+ const culling_1 = require("@math.gl/culling");
9
+ const geospatial_1 = require("@math.gl/geospatial");
10
+ const loader_utils_1 = require("@loaders.gl/loader-utils");
11
+ // const scratchProjectedBoundingSphere = new BoundingSphere();
6
12
  function defined(x) {
7
- return x !== undefined && x !== null;
13
+ return x !== undefined && x !== null;
8
14
  }
9
-
10
- const scratchScale = new Vector3();
11
- const scratchNorthWest = new Vector3();
12
- const scratchSouthEast = new Vector3();
13
- export function createBoundingVolume(boundingVolumeHeader, transform, result) {
14
- assert(boundingVolumeHeader, '3D Tile: boundingVolume must be defined');
15
-
16
- if (boundingVolumeHeader.box) {
17
- return createBox(boundingVolumeHeader.box, transform, result);
18
- }
19
-
20
- if (boundingVolumeHeader.region) {
21
- const [west, south, east, north, minHeight, maxHeight] = boundingVolumeHeader.region;
22
- const northWest = Ellipsoid.WGS84.cartographicToCartesian([degrees(west), degrees(north), minHeight], scratchNorthWest);
23
- const southEast = Ellipsoid.WGS84.cartographicToCartesian([degrees(east), degrees(south), maxHeight], scratchSouthEast);
24
- const centerInCartesian = new Vector3().addVectors(northWest, southEast).multiplyScalar(0.5);
25
- const radius = new Vector3().subVectors(northWest, southEast).len() / 2.0;
26
- return createSphere([centerInCartesian[0], centerInCartesian[1], centerInCartesian[2], radius], new Matrix4());
27
- }
28
-
29
- if (boundingVolumeHeader.sphere) {
30
- return createSphere(boundingVolumeHeader.sphere, transform, result);
31
- }
32
-
33
- throw new Error('3D Tile: boundingVolume must contain a sphere, region, or box');
15
+ // const scratchMatrix = new Matrix3();
16
+ const scratchScale = new core_1.Vector3();
17
+ const scratchNorthWest = new core_1.Vector3();
18
+ const scratchSouthEast = new core_1.Vector3();
19
+ // const scratchRectangle = new Rectangle();
20
+ // const scratchOrientedBoundingBox = new OrientedBoundingBox();
21
+ // const scratchTransform = new Matrix4();
22
+ /**
23
+ * Create a bounding volume from the tile's bounding volume header.
24
+ * @param {Object} boundingVolumeHeader The tile's bounding volume header.
25
+ * @param {Matrix4} transform The transform to apply to the bounding volume.
26
+ * @param [result] The object onto which to store the result.
27
+ * @returns The modified result parameter or a new TileBoundingVolume instance if none was provided.
28
+ */
29
+ function createBoundingVolume(boundingVolumeHeader, transform, result) {
30
+ (0, loader_utils_1.assert)(boundingVolumeHeader, '3D Tile: boundingVolume must be defined');
31
+ // boundingVolume schema:
32
+ // https://github.com/AnalyticalGraphicsInc/3d-tiles/blob/master/specification/schema/boundingVolume.schema.json
33
+ if (boundingVolumeHeader.box) {
34
+ return createBox(boundingVolumeHeader.box, transform, result);
35
+ }
36
+ if (boundingVolumeHeader.region) {
37
+ // [west, south, east, north, minimum height, maximum height]
38
+ // Latitudes and longitudes are in the WGS 84 datum as defined in EPSG 4979 and are in radians.
39
+ // Heights are in meters above (or below) the WGS 84 ellipsoid.
40
+ const [west, south, east, north, minHeight, maxHeight] = boundingVolumeHeader.region;
41
+ const northWest = geospatial_1.Ellipsoid.WGS84.cartographicToCartesian([(0, core_1.degrees)(west), (0, core_1.degrees)(north), minHeight], scratchNorthWest);
42
+ const southEast = geospatial_1.Ellipsoid.WGS84.cartographicToCartesian([(0, core_1.degrees)(east), (0, core_1.degrees)(south), maxHeight], scratchSouthEast);
43
+ const centerInCartesian = new core_1.Vector3().addVectors(northWest, southEast).multiplyScalar(0.5);
44
+ const radius = new core_1.Vector3().subVectors(northWest, southEast).len() / 2.0;
45
+ // TODO improve region boundingVolume
46
+ // for now, create a sphere as the boundingVolume instead of box
47
+ return createSphere([centerInCartesian[0], centerInCartesian[1], centerInCartesian[2], radius], new core_1.Matrix4());
48
+ }
49
+ if (boundingVolumeHeader.sphere) {
50
+ return createSphere(boundingVolumeHeader.sphere, transform, result);
51
+ }
52
+ throw new Error('3D Tile: boundingVolume must contain a sphere, region, or box');
34
53
  }
35
-
54
+ exports.createBoundingVolume = createBoundingVolume;
36
55
  function createBox(box, transform, result) {
37
- const center = new Vector3(box[0], box[1], box[2]);
38
- transform.transform(center, center);
39
- let origin = [];
56
+ // https://math.gl/modules/culling/docs/api-reference/oriented-bounding-box
57
+ // 1. A half-axes based representation.
58
+ // box: An array of 12 numbers that define an oriented bounding box.
59
+ // The first three elements define the x, y, and z values for the center of the box.
60
+ // The next three elements (with indices 3, 4, and 5) define the x axis direction and half-length.
61
+ // The next three elements (indices 6, 7, and 8) define the y axis direction and half-length.
62
+ // The last three elements (indices 9, 10, and 11) define the z axis direction and half-length.
63
+ // 2. A half-size-quaternion based representation.
64
+ // box: An array of 10 numbers that define an oriented bounding box.
65
+ // The first three elements define the x, y, and z values for the center of the box in a right-handed 3-axis (x, y, z) Cartesian coordinate system where the z-axis is up.
66
+ // The next three elements (with indices 3, 4, and 5) define the halfSize.
67
+ // The last four elements (indices 6, 7, 8 and 10) define the quaternion.
68
+ const center = new core_1.Vector3(box[0], box[1], box[2]);
69
+ transform.transform(center, center);
70
+ let origin = [];
71
+ if (box.length === 10) {
72
+ const halfSize = box.slice(3, 6);
73
+ const quaternion = new core_1.Quaternion();
74
+ quaternion.fromArray(box, 6);
75
+ const x = new core_1.Vector3([1, 0, 0]);
76
+ const y = new core_1.Vector3([0, 1, 0]);
77
+ const z = new core_1.Vector3([0, 0, 1]);
78
+ x.transformByQuaternion(quaternion);
79
+ x.scale(halfSize[0]);
80
+ y.transformByQuaternion(quaternion);
81
+ y.scale(halfSize[1]);
82
+ z.transformByQuaternion(quaternion);
83
+ z.scale(halfSize[2]);
84
+ origin = [...x.toArray(), ...y.toArray(), ...z.toArray()];
85
+ }
86
+ else {
87
+ origin = [...box.slice(3, 6), ...box.slice(6, 9), ...box.slice(9, 12)];
88
+ }
89
+ const xAxis = transform.transformAsVector(origin.slice(0, 3));
90
+ const yAxis = transform.transformAsVector(origin.slice(3, 6));
91
+ const zAxis = transform.transformAsVector(origin.slice(6, 9));
92
+ const halfAxes = new core_1.Matrix3([
93
+ xAxis[0],
94
+ xAxis[1],
95
+ xAxis[2],
96
+ yAxis[0],
97
+ yAxis[1],
98
+ yAxis[2],
99
+ zAxis[0],
100
+ zAxis[1],
101
+ zAxis[2]
102
+ ]);
103
+ if (defined(result)) {
104
+ result.center = center;
105
+ result.halfAxes = halfAxes;
106
+ return result;
107
+ }
108
+ return new culling_1.OrientedBoundingBox(center, halfAxes);
109
+ }
110
+ /*
111
+ function createBoxFromTransformedRegion(region, transform, initialTransform, result) {
112
+ const rectangle = Rectangle.unpack(region, 0, scratchRectangle);
113
+ const minimumHeight = region[4];
114
+ const maximumHeight = region[5];
40
115
 
41
- if (box.length === 10) {
42
- const halfSize = box.slice(3, 6);
43
- const quaternion = new Quaternion();
44
- quaternion.fromArray(box, 6);
45
- const x = new Vector3([1, 0, 0]);
46
- const y = new Vector3([0, 1, 0]);
47
- const z = new Vector3([0, 0, 1]);
48
- x.transformByQuaternion(quaternion);
49
- x.scale(halfSize[0]);
50
- y.transformByQuaternion(quaternion);
51
- y.scale(halfSize[1]);
52
- z.transformByQuaternion(quaternion);
53
- z.scale(halfSize[2]);
54
- origin = [...x.toArray(), ...y.toArray(), ...z.toArray()];
55
- } else {
56
- origin = [...box.slice(3, 6), ...box.slice(6, 9), ...box.slice(9, 12)];
57
- }
116
+ const orientedBoundingBox = OrientedBoundingBox.fromRectangle(
117
+ rectangle,
118
+ minimumHeight,
119
+ maximumHeight,
120
+ Ellipsoid.WGS84,
121
+ scratchOrientedBoundingBox
122
+ );
123
+ const center = orientedBoundingBox.center;
124
+ const halfAxes = orientedBoundingBox.halfAxes;
58
125
 
59
- const xAxis = transform.transformAsVector(origin.slice(0, 3));
60
- const yAxis = transform.transformAsVector(origin.slice(3, 6));
61
- const zAxis = transform.transformAsVector(origin.slice(6, 9));
62
- const halfAxes = new Matrix3([xAxis[0], xAxis[1], xAxis[2], yAxis[0], yAxis[1], yAxis[2], zAxis[0], zAxis[1], zAxis[2]]);
126
+ // A region bounding volume is not transformed by the transform in the tileset JSON,
127
+ // but may be transformed by additional transforms applied in Cesium.
128
+ // This is why the transform is calculated as the difference between the initial transform and the current transform.
129
+ transform = Matrix4.multiplyTransformation(
130
+ transform,
131
+ Matrix4.inverseTransformation(initialTransform, scratchTransform),
132
+ scratchTransform
133
+ );
134
+ center = Matrix4.multiplyByPoint(transform, center, center);
135
+ const rotationScale = Matrix4.getRotation(transform, scratchMatrix);
136
+ halfAxes = Matrix3.multiply(rotationScale, halfAxes, halfAxes);
63
137
 
64
- if (defined(result)) {
65
- result.center = center;
66
- result.halfAxes = halfAxes;
138
+ if (defined(result) && result instanceof TileOrientedBoundingBox) {
139
+ result.update(center, halfAxes);
67
140
  return result;
68
141
  }
69
142
 
70
- return new OrientedBoundingBox(center, halfAxes);
143
+ return new TileOrientedBoundingBox(center, halfAxes);
71
144
  }
72
145
 
73
- function createSphere(sphere, transform, result) {
74
- const center = new Vector3(sphere[0], sphere[1], sphere[2]);
75
- transform.transform(center, center);
76
- const scale = transform.getScale(scratchScale);
77
- const uniformScale = Math.max(Math.max(scale[0], scale[1]), scale[2]);
78
- const radius = sphere[3] * uniformScale;
146
+ function createRegion(region, transform, initialTransform, result) {
147
+ if (!Matrix4.equalsEpsilon(transform, initialTransform, CesiumMath.EPSILON8)) {
148
+ return createBoxFromTransformedRegion(region, transform, initialTransform, result);
149
+ }
79
150
 
80
151
  if (defined(result)) {
81
- result.center = center;
82
- result.radius = radius;
83
152
  return result;
84
153
  }
85
154
 
86
- return new BoundingSphere(center, radius);
155
+ const rectangleRegion = Rectangle.unpack(region, 0, scratchRectangle);
156
+
157
+ return new TileBoundingRegion({
158
+ rectangle: rectangleRegion,
159
+ minimumHeight: region[4],
160
+ maximumHeight: region[5]
161
+ });
162
+ }
163
+ */
164
+ function createSphere(sphere, transform, result) {
165
+ // Find the transformed center
166
+ const center = new core_1.Vector3(sphere[0], sphere[1], sphere[2]);
167
+ transform.transform(center, center);
168
+ const scale = transform.getScale(scratchScale);
169
+ const uniformScale = Math.max(Math.max(scale[0], scale[1]), scale[2]);
170
+ const radius = sphere[3] * uniformScale;
171
+ if (defined(result)) {
172
+ result.center = center;
173
+ result.radius = radius;
174
+ return result;
175
+ }
176
+ return new culling_1.BoundingSphere(center, radius);
87
177
  }
88
- //# sourceMappingURL=bounding-volume.js.map
@@ -0,0 +1,17 @@
1
+ import { CullingVolume } from '@math.gl/culling';
2
+ export declare type FrameState = {
3
+ camera: {
4
+ position: number[];
5
+ direction: number[];
6
+ up: number[];
7
+ };
8
+ viewport: {
9
+ [key: string]: any;
10
+ };
11
+ height: number;
12
+ cullingVolume: CullingVolume;
13
+ frameNumber: number;
14
+ sseDenominator: number;
15
+ };
16
+ export declare function getFrameState(viewport: any, frameNumber: number): FrameState;
17
+ //# sourceMappingURL=frame-state.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"frame-state.d.ts","sourceRoot":"","sources":["../../../src/tileset/helpers/frame-state.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,aAAa,EAAQ,MAAM,kBAAkB,CAAC;AAGtD,oBAAY,UAAU,GAAG;IACvB,MAAM,EAAE;QACN,QAAQ,EAAE,MAAM,EAAE,CAAC;QACnB,SAAS,EAAE,MAAM,EAAE,CAAC;QACpB,EAAE,EAAE,MAAM,EAAE,CAAC;KACd,CAAC;IACF,QAAQ,EAAE;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;KAAC,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,aAAa,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAeF,wBAAgB,aAAa,CAAC,QAAQ,KAAA,EAAE,WAAW,EAAE,MAAM,GAAG,UAAU,CA6CvE"}
@@ -1,51 +1,70 @@
1
- import { Vector3 } from '@math.gl/core';
2
- import { CullingVolume, Plane } from '@math.gl/culling';
3
- import { Ellipsoid } from '@math.gl/geospatial';
4
- const scratchVector = new Vector3();
5
- const scratchPosition = new Vector3();
6
- const cullingVolume = new CullingVolume([new Plane(), new Plane(), new Plane(), new Plane(), new Plane(), new Plane()]);
7
- export function getFrameState(viewport, frameNumber) {
8
- const {
9
- cameraDirection,
10
- cameraUp,
11
- height
12
- } = viewport;
13
- const {
14
- metersPerUnit
15
- } = viewport.distanceScales;
16
- const viewportCenterCartographic = [viewport.longitude, viewport.latitude, 0];
17
- const viewportCenterCartesian = Ellipsoid.WGS84.cartographicToCartesian(viewportCenterCartographic, new Vector3());
18
- const enuToFixedTransform = Ellipsoid.WGS84.eastNorthUpToFixedFrame(viewportCenterCartesian);
19
- const cameraPositionCartographic = viewport.unprojectPosition(viewport.cameraPosition);
20
- const cameraPositionCartesian = Ellipsoid.WGS84.cartographicToCartesian(cameraPositionCartographic, new Vector3());
21
- const cameraDirectionCartesian = new Vector3(enuToFixedTransform.transformAsVector(new Vector3(cameraDirection).scale(metersPerUnit))).normalize();
22
- const cameraUpCartesian = new Vector3(enuToFixedTransform.transformAsVector(new Vector3(cameraUp).scale(metersPerUnit))).normalize();
23
- commonSpacePlanesToWGS84(viewport, viewportCenterCartesian);
24
- return {
25
- camera: {
26
- position: cameraPositionCartesian,
27
- direction: cameraDirectionCartesian,
28
- up: cameraUpCartesian
29
- },
30
- viewport,
31
- height,
32
- cullingVolume,
33
- frameNumber,
34
- sseDenominator: 1.15
35
- };
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.getFrameState = void 0;
4
+ const core_1 = require("@math.gl/core");
5
+ const culling_1 = require("@math.gl/culling");
6
+ const geospatial_1 = require("@math.gl/geospatial");
7
+ const scratchVector = new core_1.Vector3();
8
+ const scratchPosition = new core_1.Vector3();
9
+ const cullingVolume = new culling_1.CullingVolume([
10
+ new culling_1.Plane(),
11
+ new culling_1.Plane(),
12
+ new culling_1.Plane(),
13
+ new culling_1.Plane(),
14
+ new culling_1.Plane(),
15
+ new culling_1.Plane()
16
+ ]);
17
+ // Extracts a frame state appropriate for tile culling from a deck.gl viewport
18
+ // TODO - this could likely be generalized and merged back into deck.gl for other culling scenarios
19
+ function getFrameState(viewport, frameNumber) {
20
+ // Traverse and and request. Update _selectedTiles so that we know what to render.
21
+ const { cameraDirection, cameraUp, height } = viewport;
22
+ const { metersPerUnit } = viewport.distanceScales;
23
+ const viewportCenterCartographic = [viewport.longitude, viewport.latitude, 0];
24
+ // TODO - Ellipsoid.eastNorthUpToFixedFrame() breaks on raw array, create a Vector.
25
+ // TODO - Ellipsoid.eastNorthUpToFixedFrame() takes a cartesian, is that intuitive?
26
+ const viewportCenterCartesian = geospatial_1.Ellipsoid.WGS84.cartographicToCartesian(viewportCenterCartographic, new core_1.Vector3());
27
+ const enuToFixedTransform = geospatial_1.Ellipsoid.WGS84.eastNorthUpToFixedFrame(viewportCenterCartesian);
28
+ const cameraPositionCartographic = viewport.unprojectPosition(viewport.cameraPosition);
29
+ const cameraPositionCartesian = geospatial_1.Ellipsoid.WGS84.cartographicToCartesian(cameraPositionCartographic, new core_1.Vector3());
30
+ // These should still be normalized as the transform has scale 1 (goes from meters to meters)
31
+ const cameraDirectionCartesian = new core_1.Vector3(
32
+ // @ts-ignore
33
+ enuToFixedTransform.transformAsVector(new core_1.Vector3(cameraDirection).scale(metersPerUnit))).normalize();
34
+ const cameraUpCartesian = new core_1.Vector3(
35
+ // @ts-ignore
36
+ enuToFixedTransform.transformAsVector(new core_1.Vector3(cameraUp).scale(metersPerUnit))).normalize();
37
+ commonSpacePlanesToWGS84(viewport, viewportCenterCartesian);
38
+ // TODO: make a file/class for frameState and document what needs to be attached to this so that traversal can function
39
+ return {
40
+ camera: {
41
+ position: cameraPositionCartesian,
42
+ direction: cameraDirectionCartesian,
43
+ up: cameraUpCartesian
44
+ },
45
+ viewport,
46
+ height,
47
+ cullingVolume,
48
+ frameNumber,
49
+ sseDenominator: 1.15 // Assumes fovy = 60 degrees
50
+ };
36
51
  }
37
-
52
+ exports.getFrameState = getFrameState;
38
53
  function commonSpacePlanesToWGS84(viewport, viewportCenterCartesian) {
39
- const frustumPlanes = viewport.getFrustumPlanes();
40
- let i = 0;
41
-
42
- for (const dir in frustumPlanes) {
43
- const plane = frustumPlanes[dir];
44
- const distanceToCenter = plane.normal.dot(viewport.center);
45
- scratchPosition.copy(plane.normal).scale(plane.distance - distanceToCenter).add(viewport.center);
46
- const cartographicPos = viewport.unprojectPosition(scratchPosition);
47
- const cartesianPos = Ellipsoid.WGS84.cartographicToCartesian(cartographicPos, new Vector3());
48
- cullingVolume.planes[i++].fromPointNormal(cartesianPos, scratchVector.copy(viewportCenterCartesian).subtract(cartesianPos));
49
- }
54
+ // Extract frustum planes based on current view.
55
+ const frustumPlanes = viewport.getFrustumPlanes();
56
+ let i = 0;
57
+ for (const dir in frustumPlanes) {
58
+ const plane = frustumPlanes[dir];
59
+ const distanceToCenter = plane.normal.dot(viewport.center);
60
+ scratchPosition
61
+ .copy(plane.normal)
62
+ .scale(plane.distance - distanceToCenter)
63
+ .add(viewport.center);
64
+ const cartographicPos = viewport.unprojectPosition(scratchPosition);
65
+ const cartesianPos = geospatial_1.Ellipsoid.WGS84.cartographicToCartesian(cartographicPos, new core_1.Vector3());
66
+ cullingVolume.planes[i++].fromPointNormal(cartesianPos,
67
+ // Want the normal to point into the frustum since that's what culling expects
68
+ scratchVector.copy(viewportCenterCartesian).subtract(cartesianPos));
69
+ }
50
70
  }
51
- //# sourceMappingURL=frame-state.js.map
@@ -0,0 +1,20 @@
1
+ import Tile3D from '../tile-3d';
2
+ import { FrameState } from './frame-state';
3
+ /**
4
+ * For the maxScreenThreshold error metric, maxError means that you should replace the node with it's children
5
+ as soon as the nodes bounding sphere has a screen radius larger than maxError pixels.
6
+ In this sense a value of 0 means you should always load it's children,
7
+ or if it's a leaf node, you should always display it.
8
+ * @param tile
9
+ * @param frameState
10
+ * @returns
11
+ */
12
+ export declare function getLodStatus(tile: Tile3D, frameState: FrameState): 'DIG' | 'OUT' | 'DRAW';
13
+ /**
14
+ * Calculate size of MBS radius projected on the screen plane
15
+ * @param tile
16
+ * @param frameState
17
+ * @returns
18
+ */
19
+ export declare function getProjectedRadius(tile: Tile3D, frameState: FrameState): number;
20
+ //# sourceMappingURL=i3s-lod.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"i3s-lod.d.ts","sourceRoot":"","sources":["../../../src/tileset/helpers/i3s-lod.ts"],"names":[],"mappings":"AAEA,OAAO,MAAM,MAAM,YAAY,CAAC;AAChC,OAAO,EAAC,UAAU,EAAC,MAAM,eAAe,CAAC;AAEzC;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAczF;AAED;;;;;GAKG;AAEH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,GAAG,MAAM,CAoD/E"}
@@ -1,108 +1,83 @@
1
- import { toRadians } from '@math.gl/core';
2
- const WGS84_RADIUS_X = 6378137.0;
3
- const qualityFactor = Math.PI / 2;
4
- export function lodJudge(tile, frameState) {
5
- const viewport = frameState.viewport;
6
- const metersPerPixel = viewport.metersPerPixel;
7
- const mbsLat = tile.header.mbs[1];
8
- const mbsLon = tile.header.mbs[0];
9
- const mbsZ = tile.header.mbs[2];
10
- const mbsR = tile.header.mbs[3];
11
- const {
12
- height,
13
- width,
14
- latitude,
15
- longitude
16
- } = viewport;
17
- const viewportCenter = [longitude, latitude];
18
- const mbsCenter = [mbsLon, mbsLat, mbsZ];
19
- const mbsLatProjected = [longitude, mbsLat];
20
- const mbsLonProjected = [mbsLon, latitude];
21
- const diagonalInMeters = Math.sqrt(height * height + width * width) * metersPerPixel[0];
22
- const distanceInMeters = getDistanceFromLatLon(viewportCenter, mbsCenter);
23
- const visibleHeight = height * 0.5 + mbsR / WGS84_RADIUS_X;
24
- const visibleWidth = width * 0.5 + mbsR / WGS84_RADIUS_X;
25
-
26
- if (distanceInMeters > diagonalInMeters + mbsR / WGS84_RADIUS_X) {
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.getProjectedRadius = exports.getLodStatus = void 0;
4
+ const core_1 = require("@math.gl/core");
5
+ const geospatial_1 = require("@math.gl/geospatial");
6
+ /**
7
+ * For the maxScreenThreshold error metric, maxError means that you should replace the node with it's children
8
+ as soon as the nodes bounding sphere has a screen radius larger than maxError pixels.
9
+ In this sense a value of 0 means you should always load it's children,
10
+ or if it's a leaf node, you should always display it.
11
+ * @param tile
12
+ * @param frameState
13
+ * @returns
14
+ */
15
+ function getLodStatus(tile, frameState) {
16
+ if (tile.lodMetricValue === 0 || isNaN(tile.lodMetricValue)) {
17
+ return 'DIG';
18
+ }
19
+ const screenSize = 2 * getProjectedRadius(tile, frameState);
20
+ if (screenSize < 2) {
21
+ return 'OUT';
22
+ }
23
+ if (!tile.header.children || screenSize <= tile.lodMetricValue) {
24
+ return 'DRAW';
25
+ }
26
+ else if (tile.header.children) {
27
+ return 'DIG';
28
+ }
27
29
  return 'OUT';
28
- }
29
-
30
- if (getDistanceFromLatLon(viewportCenter, mbsLatProjected) > visibleHeight) {
31
- return 'OUT';
32
- }
33
-
34
- if (getDistanceFromLatLon(viewportCenter, mbsLonProjected) > visibleWidth) {
35
- return 'OUT';
36
- }
37
-
38
- if (tile.lodMetricValue === 0) {
39
- return 'DIG';
40
- }
41
-
42
- let screenSize = getI3ScreenSize(tile, frameState);
43
- screenSize *= qualityFactor;
44
-
45
- if (screenSize < 0.5) {
46
- return 'OUT';
47
- }
48
-
49
- if (!tile.header.children || screenSize <= tile.lodMetricValue) {
50
- return 'DRAW';
51
- } else if (tile.header.children) {
52
- return 'DIG';
53
- }
54
-
55
- return 'OUT';
56
- }
57
-
58
- function projectVertexToSphere([x, y, z]) {
59
- const azim = toRadians(x);
60
- const incl = toRadians(y);
61
- const radius = 1.0 + z / WGS84_RADIUS_X;
62
- const radCosInc = radius * Math.cos(incl);
63
- x = radCosInc * Math.cos(azim);
64
- y = radCosInc * Math.sin(azim);
65
- z = radius * Math.sin(incl);
66
- return [x, y, z];
67
- }
68
-
69
- function getDistanceFromLatLon(observer, center) {
70
- const [observerLon, observerLat, observerZ = 0.0] = observer;
71
- const [centerLon, centerLat, centerZ = 0.0] = center;
72
- const projectedCenter = projectVertexToSphere([centerLon, centerLat, centerZ]);
73
- const projectedObserver = projectVertexToSphere([observerLon, observerLat, observerZ]);
74
- const dx = projectedObserver[0] - projectedCenter[0];
75
- const dy = projectedObserver[1] - projectedCenter[1];
76
- const dz = projectedObserver[2] - projectedCenter[2];
77
- return dx * dx + dy * dy + dz * dz;
78
- }
79
-
80
- export function getI3ScreenSize(tile, frameState) {
81
- const viewport = frameState.viewport;
82
- const mbsLat = tile.header.mbs[1];
83
- const mbsLon = tile.header.mbs[0];
84
- const mbsZ = tile.header.mbs[2];
85
- const mbsR = tile.header.mbs[3];
86
- const mbsCenter = [mbsLon, mbsLat, mbsZ];
87
- const cameraPositionCartographic = viewport.unprojectPosition(viewport.cameraPosition);
88
- const dSquared = getDistanceFromLatLon(cameraPositionCartographic, mbsCenter);
89
- const mbsRNormalized = mbsR / WGS84_RADIUS_X;
90
- const d = dSquared - mbsRNormalized * mbsRNormalized;
91
- const fltMax = 3.4028235e38;
92
-
93
- if (d <= 0.0) {
94
- return 0.5 * fltMax;
95
- }
96
-
97
- const screenSizeFactor = getTanOfHalfVFAngle(frameState) * mbsRNormalized / Math.sqrt(d) * 300;
98
- return screenSizeFactor;
99
30
  }
100
-
101
- function getTanOfHalfVFAngle(frameState) {
102
- const {
103
- projectionMatrix
104
- } = frameState.viewport;
105
- const t = projectionMatrix[5];
106
- return t;
31
+ exports.getLodStatus = getLodStatus;
32
+ /**
33
+ * Calculate size of MBS radius projected on the screen plane
34
+ * @param tile
35
+ * @param frameState
36
+ * @returns
37
+ */
38
+ // eslint-disable-next-line max-statements
39
+ function getProjectedRadius(tile, frameState) {
40
+ const originalViewport = frameState.viewport;
41
+ const ViewportClass = originalViewport.constructor;
42
+ const { longitude, latitude, height, width, bearing, zoom } = originalViewport;
43
+ // @ts-ignore
44
+ const viewport = new ViewportClass({ longitude, latitude, height, width, bearing, zoom, pitch: 0 });
45
+ const mbsLat = tile.header.mbs[1];
46
+ const mbsLon = tile.header.mbs[0];
47
+ const mbsZ = tile.header.mbs[2];
48
+ const mbsR = tile.header.mbs[3];
49
+ const mbsCenterCartesian = [...tile.boundingVolume.center];
50
+ const cameraPositionCartographic = viewport.unprojectPosition(viewport.cameraPosition);
51
+ const cameraPositionCartesian = geospatial_1.Ellipsoid.WGS84.cartographicToCartesian(cameraPositionCartographic, new core_1.Vector3());
52
+ // ---------------------------
53
+ // Calculate mbs border vertex
54
+ // ---------------------------
55
+ const toEye = new core_1.Vector3(cameraPositionCartesian).subtract(mbsCenterCartesian).normalize();
56
+ // Add extra vector to form plane
57
+ const enuToCartesianMatrix = new core_1.Matrix4();
58
+ geospatial_1.Ellipsoid.WGS84.eastNorthUpToFixedFrame(mbsCenterCartesian, enuToCartesianMatrix);
59
+ const cartesianToEnuMatrix = new core_1.Matrix4(enuToCartesianMatrix).invert();
60
+ const cameraPositionEnu = new core_1.Vector3(cameraPositionCartesian).transform(cartesianToEnuMatrix);
61
+ // Mean Proportionals in Right Triangles - Altitude rule
62
+ // https://mathbitsnotebook.com/Geometry/RightTriangles/RTmeanRight.html
63
+ const projection = Math.sqrt(cameraPositionEnu[0] * cameraPositionEnu[0] + cameraPositionEnu[1] * cameraPositionEnu[1]);
64
+ const extraZ = (projection * projection) / cameraPositionEnu[2];
65
+ const extraVertexEnu = new core_1.Vector3([cameraPositionEnu[0], cameraPositionEnu[1], extraZ]);
66
+ const extraVertexCartesian = extraVertexEnu.transform(enuToCartesianMatrix);
67
+ const extraVectorCartesian = new core_1.Vector3(extraVertexCartesian)
68
+ .subtract(mbsCenterCartesian)
69
+ .normalize();
70
+ // We need radius vector orthogonal to toEye vector
71
+ const radiusVector = toEye.cross(extraVectorCartesian).normalize().scale(mbsR);
72
+ const sphereMbsBorderVertexCartesian = new core_1.Vector3(mbsCenterCartesian).add(radiusVector);
73
+ const sphereMbsBorderVertexCartographic = geospatial_1.Ellipsoid.WGS84.cartesianToCartographic(sphereMbsBorderVertexCartesian);
74
+ // ---------------------------
75
+ // Project center vertex and border vertex and calculate projected radius of MBS
76
+ const projectedOrigin = viewport.project([mbsLon, mbsLat, mbsZ]);
77
+ const projectedMbsBorderVertex = viewport.project(sphereMbsBorderVertexCartographic);
78
+ const projectedRadius = new core_1.Vector3(projectedOrigin)
79
+ .subtract(projectedMbsBorderVertex)
80
+ .magnitude();
81
+ return projectedRadius;
107
82
  }
108
- //# sourceMappingURL=i3s-lod.js.map
83
+ exports.getProjectedRadius = getProjectedRadius;
@@ -0,0 +1,8 @@
1
+ export declare function calculateDynamicScreenSpaceError(root: any, { camera, mapProjection }: {
2
+ camera: any;
3
+ mapProjection: any;
4
+ }, options?: {}): number;
5
+ export declare function fog(distanceToCamera: any, density: any): number;
6
+ export declare function getDynamicScreenSpaceError(tileset: any, distanceToCamera: any): number;
7
+ export declare function getTiles3DScreenSpaceError(tile: any, frameState: any, useParentLodMetric: any): number;
8
+ //# sourceMappingURL=tiles-3d-lod.d.ts.map