@cesium/engine 3.0.2 → 4.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (230) hide show
  1. package/Build/ThirdParty/Workers/pako_deflate.min.js +605 -0
  2. package/Build/ThirdParty/Workers/pako_inflate.min.js +800 -0
  3. package/Build/ThirdParty/Workers/z-worker-pako.js +502 -0
  4. package/Build/Workers/chunk-27R2KRIK.js +634 -0
  5. package/Build/Workers/chunk-2C65EKYA.js +55 -0
  6. package/Build/Workers/chunk-2NLMZNJI.js +138 -0
  7. package/Build/Workers/chunk-4V6RCTVH.js +289 -0
  8. package/Build/Workers/chunk-4VWUFKYW.js +368 -0
  9. package/Build/Workers/chunk-527JG4D7.js +629 -0
  10. package/Build/Workers/chunk-5U4UHRZ2.js +8644 -0
  11. package/Build/Workers/chunk-7CZEWQWE.js +353 -0
  12. package/Build/Workers/chunk-7IMAWM6A.js +842 -0
  13. package/Build/Workers/{package.js → chunk-A6EA6KIE.js} +13 -2
  14. package/Build/Workers/chunk-AXGQUPXA.js +1075 -0
  15. package/Build/Workers/chunk-BT6YIL2N.js +39 -0
  16. package/Build/Workers/chunk-C6MRR5YL.js +476 -0
  17. package/Build/Workers/chunk-DJUTBX6A.js +1860 -0
  18. package/Build/Workers/chunk-EQ6ZAP37.js +218 -0
  19. package/Build/Workers/chunk-F7P2HCYZ.js +73 -0
  20. package/Build/Workers/chunk-FE2XG3SS.js +73 -0
  21. package/Build/Workers/chunk-FKHRSGKP.js +781 -0
  22. package/Build/Workers/chunk-FVDTKX3F.js +58 -0
  23. package/Build/Workers/chunk-FYHCAKU6.js +684 -0
  24. package/Build/Workers/chunk-G3MOT7BZ.js +157 -0
  25. package/Build/Workers/chunk-H52L6U76.js +421 -0
  26. package/Build/Workers/chunk-H6MBQ4W4.js +305 -0
  27. package/Build/Workers/chunk-HCZR75II.js +2716 -0
  28. package/Build/Workers/chunk-I5MQWHBR.js +102 -0
  29. package/Build/Workers/chunk-KAFF2QX3.js +258 -0
  30. package/Build/Workers/chunk-LGSGX2RH.js +757 -0
  31. package/Build/Workers/chunk-LQRFWCNX.js +124 -0
  32. package/Build/Workers/chunk-N5MMDSD2.js +44 -0
  33. package/Build/Workers/chunk-NRETMGYL.js +390 -0
  34. package/Build/Workers/chunk-P4M4QUNQ.js +196 -0
  35. package/Build/Workers/chunk-P7PWX5HR.js +430 -0
  36. package/Build/Workers/chunk-PGB3EFR7.js +171 -0
  37. package/Build/Workers/chunk-PW5CA4MJ.js +3273 -0
  38. package/Build/Workers/chunk-PWDYKCNC.js +501 -0
  39. package/Build/Workers/chunk-QIS3NB7U.js +1258 -0
  40. package/Build/Workers/chunk-QVJ6IRKV.js +77 -0
  41. package/Build/Workers/chunk-RDCDRNJ7.js +117 -0
  42. package/Build/Workers/chunk-RDM3BKNC.js +1009 -0
  43. package/Build/Workers/chunk-RRUPTJ6P.js +452 -0
  44. package/Build/Workers/chunk-SGRWJKNO.js +400 -0
  45. package/Build/Workers/chunk-TF5D2H7B.js +138 -0
  46. package/Build/Workers/chunk-TVYIHH4V.js +513 -0
  47. package/Build/Workers/chunk-U5LKG6LX.js +101 -0
  48. package/Build/Workers/chunk-UGZGTV5K.js +302 -0
  49. package/Build/Workers/chunk-UN7AK64D.js +163 -0
  50. package/Build/Workers/chunk-V2LKNJGT.js +59 -0
  51. package/Build/Workers/chunk-VSCXSFHE.js +1477 -0
  52. package/Build/Workers/chunk-XJCTFTBM.js +2041 -0
  53. package/Build/Workers/chunk-XZVQMPWG.js +100 -0
  54. package/Build/Workers/chunk-YLAFWVOW.js +834 -0
  55. package/Build/Workers/chunk-YLS3FX3U.js +236 -0
  56. package/Build/Workers/chunk-YMJPANZZ.js +693 -0
  57. package/Build/Workers/combineGeometry.js +65 -15
  58. package/Build/Workers/createBoxGeometry.js +55 -10
  59. package/Build/Workers/createBoxOutlineGeometry.js +231 -310
  60. package/Build/Workers/createCircleGeometry.js +185 -202
  61. package/Build/Workers/createCircleOutlineGeometry.js +141 -155
  62. package/Build/Workers/createCoplanarPolygonGeometry.js +477 -557
  63. package/Build/Workers/createCoplanarPolygonOutlineGeometry.js +218 -230
  64. package/Build/Workers/createCorridorGeometry.js +1162 -1307
  65. package/Build/Workers/createCorridorOutlineGeometry.js +533 -569
  66. package/Build/Workers/createCylinderGeometry.js +57 -10
  67. package/Build/Workers/createCylinderOutlineGeometry.js +224 -258
  68. package/Build/Workers/createEllipseGeometry.js +68 -12
  69. package/Build/Workers/createEllipseOutlineGeometry.js +61 -12
  70. package/Build/Workers/createEllipsoidGeometry.js +56 -10
  71. package/Build/Workers/createEllipsoidOutlineGeometry.js +58 -13
  72. package/Build/Workers/createFrustumGeometry.js +55 -10
  73. package/Build/Workers/createFrustumOutlineGeometry.js +226 -243
  74. package/Build/Workers/createGeometry.js +143 -48
  75. package/Build/Workers/createGroundPolylineGeometry.js +1484 -2012
  76. package/Build/Workers/createPlaneGeometry.js +216 -243
  77. package/Build/Workers/createPlaneOutlineGeometry.js +121 -113
  78. package/Build/Workers/createPolygonGeometry.js +1041 -1327
  79. package/Build/Workers/createPolygonOutlineGeometry.js +516 -657
  80. package/Build/Workers/createPolylineGeometry.js +471 -547
  81. package/Build/Workers/createPolylineVolumeGeometry.js +352 -384
  82. package/Build/Workers/createPolylineVolumeOutlineGeometry.js +271 -295
  83. package/Build/Workers/createRectangleGeometry.js +1128 -1331
  84. package/Build/Workers/createRectangleOutlineGeometry.js +445 -500
  85. package/Build/Workers/createSimplePolylineGeometry.js +381 -440
  86. package/Build/Workers/createSphereGeometry.js +112 -118
  87. package/Build/Workers/createSphereOutlineGeometry.js +112 -121
  88. package/Build/Workers/createTaskProcessorWorker.js +32 -127
  89. package/Build/Workers/createVectorTileClampedPolylines.js +462 -505
  90. package/Build/Workers/createVectorTileGeometries.js +377 -436
  91. package/Build/Workers/createVectorTilePoints.js +110 -77
  92. package/Build/Workers/createVectorTilePolygons.js +369 -391
  93. package/Build/Workers/createVectorTilePolylines.js +252 -244
  94. package/Build/Workers/createVerticesFromGoogleEarthEnterpriseBuffer.js +543 -615
  95. package/Build/Workers/createVerticesFromHeightmap.js +2244 -2677
  96. package/Build/Workers/createVerticesFromQuantizedTerrainMesh.js +682 -904
  97. package/Build/Workers/createWallGeometry.js +459 -593
  98. package/Build/Workers/createWallOutlineGeometry.js +324 -419
  99. package/Build/Workers/decodeDraco.js +327 -347
  100. package/Build/Workers/decodeGoogleEarthEnterprisePacket.js +2530 -3567
  101. package/Build/Workers/decodeI3S.js +765 -970
  102. package/Build/Workers/transcodeKTX2.js +3351 -1473
  103. package/Build/Workers/transferTypedArrayTest.js +3 -4
  104. package/Build/Workers/upsampleQuantizedTerrainMesh.js +748 -953
  105. package/LICENSE.md +0 -12
  106. package/Source/Core/CesiumTerrainProvider.js +1 -2
  107. package/Source/Core/FeatureDetection.js +9 -0
  108. package/Source/Core/GoogleMaps.js +1 -1
  109. package/Source/Core/Ion.js +1 -1
  110. package/Source/Core/KTX2Transcoder.js +7 -3
  111. package/Source/Core/TaskProcessor.js +150 -146
  112. package/Source/Core/Transforms.js +2 -2
  113. package/Source/Core/buildModuleUrl.js +6 -5
  114. package/Source/Scene/ArcGisMapService.js +1 -1
  115. package/Source/Scene/DracoLoader.js +26 -3
  116. package/Source/Scene/I3SDataProvider.js +0 -27
  117. package/Source/Scene/I3SDecoder.js +127 -0
  118. package/Source/Scene/I3SNode.js +32 -110
  119. package/Source/Scene/Implicit3DTileContent.js +13 -0
  120. package/Source/Scene/ImplicitTileset.js +5 -0
  121. package/Source/Scene/Model/I3dmLoader.js +5 -1
  122. package/Source/Scene/Model/Model.js +4 -1
  123. package/Source/Scene/OpenStreetMapImageryProvider.js +4 -1
  124. package/Source/Scene/SingleTileImageryProvider.js +4 -2
  125. package/Source/ThirdParty/Workers/basis_transcoder.js +1 -1
  126. package/Source/{WorkersES6 → Workers}/createGeometry.js +11 -12
  127. package/Source/{WorkersES6 → Workers}/createTaskProcessorWorker.js +43 -59
  128. package/Source/{WorkersES6 → Workers}/decodeDraco.js +19 -25
  129. package/Source/{WorkersES6 → Workers}/decodeI3S.js +18 -32
  130. package/Source/{WorkersES6 → Workers}/transcodeKTX2.js +19 -26
  131. package/Source/Workers/transferTypedArrayTest.js +0 -6
  132. package/index.d.ts +16 -7
  133. package/index.js +252 -251
  134. package/package.json +2 -1
  135. package/Build/Workers/ArcType-2d9abbbc.js +0 -37
  136. package/Build/Workers/AttributeCompression-f9f6c717.js +0 -716
  137. package/Build/Workers/AxisAlignedBoundingBox-a03420b1.js +0 -258
  138. package/Build/Workers/BoundingRectangle-32fa8a4a.js +0 -369
  139. package/Build/Workers/BoxGeometry-cd550612.js +0 -884
  140. package/Build/Workers/Check-6ede7e26.js +0 -290
  141. package/Build/Workers/Color-571a6085.js +0 -2262
  142. package/Build/Workers/ComponentDatatype-cf1fa08e.js +0 -341
  143. package/Build/Workers/CoplanarPolygonGeometryLibrary-488b1a9f.js +0 -132
  144. package/Build/Workers/CorridorGeometryLibrary-fc4ff147.js +0 -498
  145. package/Build/Workers/CylinderGeometry-bc26926d.js +0 -467
  146. package/Build/Workers/CylinderGeometryLibrary-7bf291b4.js +0 -63
  147. package/Build/Workers/EllipseGeometry-89533a10.js +0 -1304
  148. package/Build/Workers/EllipseGeometryLibrary-b0d7df17.js +0 -366
  149. package/Build/Workers/EllipseOutlineGeometry-63ff7a87.js +0 -443
  150. package/Build/Workers/EllipsoidGeodesic-5b3623dc.js +0 -520
  151. package/Build/Workers/EllipsoidGeometry-07e99d2d.js +0 -637
  152. package/Build/Workers/EllipsoidOutlineGeometry-ba5c7ee2.js +0 -454
  153. package/Build/Workers/EllipsoidRhumbLine-ef872433.js +0 -741
  154. package/Build/Workers/EllipsoidTangentPlane-65d41b3e.js +0 -373
  155. package/Build/Workers/EncodedCartesian3-57415c8a.js +0 -171
  156. package/Build/Workers/FrustumGeometry-4a7589ed.js +0 -2540
  157. package/Build/Workers/GeometryAttribute-a5b6275b.js +0 -619
  158. package/Build/Workers/GeometryAttributes-ad136444.js +0 -91
  159. package/Build/Workers/GeometryInstance-34d9e21e.js +0 -121
  160. package/Build/Workers/GeometryOffsetAttribute-9ad0019c.js +0 -16
  161. package/Build/Workers/GeometryPipeline-fa9e6ffc.js +0 -3690
  162. package/Build/Workers/IndexDatatype-2643aa47.js +0 -200
  163. package/Build/Workers/IntersectionTests-feace3da.js +0 -1836
  164. package/Build/Workers/Math-0a2ac845.js +0 -1340
  165. package/Build/Workers/Matrix2-e1298525.js +0 -7086
  166. package/Build/Workers/Matrix3-41c58dde.js +0 -4283
  167. package/Build/Workers/OrientedBoundingBox-6b94d955.js +0 -1259
  168. package/Build/Workers/Plane-4c3d403b.js +0 -309
  169. package/Build/Workers/PolygonGeometryLibrary-4ffc457d.js +0 -1074
  170. package/Build/Workers/PolygonPipeline-d5e66350.js +0 -1344
  171. package/Build/Workers/PolylinePipeline-83410f0c.js +0 -573
  172. package/Build/Workers/PolylineVolumeGeometryLibrary-290e7aec.js +0 -781
  173. package/Build/Workers/PrimitivePipeline-6081d138.js +0 -966
  174. package/Build/Workers/RectangleGeometryLibrary-986710d8.js +0 -280
  175. package/Build/Workers/RuntimeError-ef395448.js +0 -68
  176. package/Build/Workers/TerrainEncoding-528e1d68.js +0 -1227
  177. package/Build/Workers/Transforms-b527bb09.js +0 -14714
  178. package/Build/Workers/VertexFormat-030f11ff.js +0 -312
  179. package/Build/Workers/WallGeometryLibrary-faf583f8.js +0 -211
  180. package/Build/Workers/WebGLConstants-0b1ce7ba.js +0 -620
  181. package/Build/Workers/WebMercatorProjection-13ed1a6e.js +0 -151
  182. package/Build/Workers/arrayRemoveDuplicates-d2061e85.js +0 -129
  183. package/Build/Workers/cesiumWorkerBootstrapper.js +0 -1363
  184. package/Build/Workers/combine-d9581036.js +0 -82
  185. package/Build/Workers/defaultValue-fe22d8c0.js +0 -51
  186. package/Source/ThirdParty/Workers/draco_decoder_nodejs.js +0 -117
  187. package/Source/Workers/cesiumWorkerBootstrapper.js +0 -2290
  188. package/Source/Workers/package.json +0 -1
  189. /package/Source/{WorkersES6 → Workers}/combineGeometry.js +0 -0
  190. /package/Source/{WorkersES6 → Workers}/createBoxGeometry.js +0 -0
  191. /package/Source/{WorkersES6 → Workers}/createBoxOutlineGeometry.js +0 -0
  192. /package/Source/{WorkersES6 → Workers}/createCircleGeometry.js +0 -0
  193. /package/Source/{WorkersES6 → Workers}/createCircleOutlineGeometry.js +0 -0
  194. /package/Source/{WorkersES6 → Workers}/createCoplanarPolygonGeometry.js +0 -0
  195. /package/Source/{WorkersES6 → Workers}/createCoplanarPolygonOutlineGeometry.js +0 -0
  196. /package/Source/{WorkersES6 → Workers}/createCorridorGeometry.js +0 -0
  197. /package/Source/{WorkersES6 → Workers}/createCorridorOutlineGeometry.js +0 -0
  198. /package/Source/{WorkersES6 → Workers}/createCylinderGeometry.js +0 -0
  199. /package/Source/{WorkersES6 → Workers}/createCylinderOutlineGeometry.js +0 -0
  200. /package/Source/{WorkersES6 → Workers}/createEllipseGeometry.js +0 -0
  201. /package/Source/{WorkersES6 → Workers}/createEllipseOutlineGeometry.js +0 -0
  202. /package/Source/{WorkersES6 → Workers}/createEllipsoidGeometry.js +0 -0
  203. /package/Source/{WorkersES6 → Workers}/createEllipsoidOutlineGeometry.js +0 -0
  204. /package/Source/{WorkersES6 → Workers}/createFrustumGeometry.js +0 -0
  205. /package/Source/{WorkersES6 → Workers}/createFrustumOutlineGeometry.js +0 -0
  206. /package/Source/{WorkersES6 → Workers}/createGroundPolylineGeometry.js +0 -0
  207. /package/Source/{WorkersES6 → Workers}/createPlaneGeometry.js +0 -0
  208. /package/Source/{WorkersES6 → Workers}/createPlaneOutlineGeometry.js +0 -0
  209. /package/Source/{WorkersES6 → Workers}/createPolygonGeometry.js +0 -0
  210. /package/Source/{WorkersES6 → Workers}/createPolygonOutlineGeometry.js +0 -0
  211. /package/Source/{WorkersES6 → Workers}/createPolylineGeometry.js +0 -0
  212. /package/Source/{WorkersES6 → Workers}/createPolylineVolumeGeometry.js +0 -0
  213. /package/Source/{WorkersES6 → Workers}/createPolylineVolumeOutlineGeometry.js +0 -0
  214. /package/Source/{WorkersES6 → Workers}/createRectangleGeometry.js +0 -0
  215. /package/Source/{WorkersES6 → Workers}/createRectangleOutlineGeometry.js +0 -0
  216. /package/Source/{WorkersES6 → Workers}/createSimplePolylineGeometry.js +0 -0
  217. /package/Source/{WorkersES6 → Workers}/createSphereGeometry.js +0 -0
  218. /package/Source/{WorkersES6 → Workers}/createSphereOutlineGeometry.js +0 -0
  219. /package/Source/{WorkersES6 → Workers}/createVectorTileClampedPolylines.js +0 -0
  220. /package/Source/{WorkersES6 → Workers}/createVectorTileGeometries.js +0 -0
  221. /package/Source/{WorkersES6 → Workers}/createVectorTilePoints.js +0 -0
  222. /package/Source/{WorkersES6 → Workers}/createVectorTilePolygons.js +0 -0
  223. /package/Source/{WorkersES6 → Workers}/createVectorTilePolylines.js +0 -0
  224. /package/Source/{WorkersES6 → Workers}/createVerticesFromGoogleEarthEnterpriseBuffer.js +0 -0
  225. /package/Source/{WorkersES6 → Workers}/createVerticesFromHeightmap.js +0 -0
  226. /package/Source/{WorkersES6 → Workers}/createVerticesFromQuantizedTerrainMesh.js +0 -0
  227. /package/Source/{WorkersES6 → Workers}/createWallGeometry.js +0 -0
  228. /package/Source/{WorkersES6 → Workers}/createWallOutlineGeometry.js +0 -0
  229. /package/Source/{WorkersES6 → Workers}/decodeGoogleEarthEnterprisePacket.js +0 -0
  230. /package/Source/{WorkersES6 → Workers}/upsampleQuantizedTerrainMesh.js +0 -0
@@ -1,309 +0,0 @@
1
- define(['exports', './Matrix3-41c58dde', './Matrix2-e1298525', './Check-6ede7e26', './defaultValue-fe22d8c0', './Math-0a2ac845'], (function (exports, Matrix3, Matrix2, Check, defaultValue, Math) { 'use strict';
2
-
3
- /**
4
- * A plane in Hessian Normal Form defined by
5
- * <pre>
6
- * ax + by + cz + d = 0
7
- * </pre>
8
- * where (a, b, c) is the plane's <code>normal</code>, d is the signed
9
- * <code>distance</code> to the plane, and (x, y, z) is any point on
10
- * the plane.
11
- *
12
- * @alias Plane
13
- * @constructor
14
- *
15
- * @param {Cartesian3} normal The plane's normal (normalized).
16
- * @param {number} distance The shortest distance from the origin to the plane. The sign of
17
- * <code>distance</code> determines which side of the plane the origin
18
- * is on. If <code>distance</code> is positive, the origin is in the half-space
19
- * in the direction of the normal; if negative, the origin is in the half-space
20
- * opposite to the normal; if zero, the plane passes through the origin.
21
- *
22
- * @example
23
- * // The plane x=0
24
- * const plane = new Cesium.Plane(Cesium.Cartesian3.UNIT_X, 0.0);
25
- *
26
- * @exception {DeveloperError} Normal must be normalized
27
- */
28
- function Plane(normal, distance) {
29
- //>>includeStart('debug', pragmas.debug);
30
- Check.Check.typeOf.object("normal", normal);
31
- if (
32
- !Math.CesiumMath.equalsEpsilon(
33
- Matrix3.Cartesian3.magnitude(normal),
34
- 1.0,
35
- Math.CesiumMath.EPSILON6
36
- )
37
- ) {
38
- throw new Check.DeveloperError("normal must be normalized.");
39
- }
40
- Check.Check.typeOf.number("distance", distance);
41
- //>>includeEnd('debug');
42
-
43
- /**
44
- * The plane's normal.
45
- *
46
- * @type {Cartesian3}
47
- */
48
- this.normal = Matrix3.Cartesian3.clone(normal);
49
-
50
- /**
51
- * The shortest distance from the origin to the plane. The sign of
52
- * <code>distance</code> determines which side of the plane the origin
53
- * is on. If <code>distance</code> is positive, the origin is in the half-space
54
- * in the direction of the normal; if negative, the origin is in the half-space
55
- * opposite to the normal; if zero, the plane passes through the origin.
56
- *
57
- * @type {number}
58
- */
59
- this.distance = distance;
60
- }
61
-
62
- /**
63
- * Creates a plane from a normal and a point on the plane.
64
- *
65
- * @param {Cartesian3} point The point on the plane.
66
- * @param {Cartesian3} normal The plane's normal (normalized).
67
- * @param {Plane} [result] The object onto which to store the result.
68
- * @returns {Plane} A new plane instance or the modified result parameter.
69
- *
70
- * @example
71
- * const point = Cesium.Cartesian3.fromDegrees(-72.0, 40.0);
72
- * const normal = ellipsoid.geodeticSurfaceNormal(point);
73
- * const tangentPlane = Cesium.Plane.fromPointNormal(point, normal);
74
- *
75
- * @exception {DeveloperError} Normal must be normalized
76
- */
77
- Plane.fromPointNormal = function (point, normal, result) {
78
- //>>includeStart('debug', pragmas.debug);
79
- Check.Check.typeOf.object("point", point);
80
- Check.Check.typeOf.object("normal", normal);
81
- if (
82
- !Math.CesiumMath.equalsEpsilon(
83
- Matrix3.Cartesian3.magnitude(normal),
84
- 1.0,
85
- Math.CesiumMath.EPSILON6
86
- )
87
- ) {
88
- throw new Check.DeveloperError("normal must be normalized.");
89
- }
90
- //>>includeEnd('debug');
91
-
92
- const distance = -Matrix3.Cartesian3.dot(normal, point);
93
-
94
- if (!defaultValue.defined(result)) {
95
- return new Plane(normal, distance);
96
- }
97
-
98
- Matrix3.Cartesian3.clone(normal, result.normal);
99
- result.distance = distance;
100
- return result;
101
- };
102
-
103
- const scratchNormal = new Matrix3.Cartesian3();
104
- /**
105
- * Creates a plane from the general equation
106
- *
107
- * @param {Cartesian4} coefficients The plane's normal (normalized).
108
- * @param {Plane} [result] The object onto which to store the result.
109
- * @returns {Plane} A new plane instance or the modified result parameter.
110
- *
111
- * @exception {DeveloperError} Normal must be normalized
112
- */
113
- Plane.fromCartesian4 = function (coefficients, result) {
114
- //>>includeStart('debug', pragmas.debug);
115
- Check.Check.typeOf.object("coefficients", coefficients);
116
- //>>includeEnd('debug');
117
-
118
- const normal = Matrix3.Cartesian3.fromCartesian4(coefficients, scratchNormal);
119
- const distance = coefficients.w;
120
-
121
- //>>includeStart('debug', pragmas.debug);
122
- if (
123
- !Math.CesiumMath.equalsEpsilon(
124
- Matrix3.Cartesian3.magnitude(normal),
125
- 1.0,
126
- Math.CesiumMath.EPSILON6
127
- )
128
- ) {
129
- throw new Check.DeveloperError("normal must be normalized.");
130
- }
131
- //>>includeEnd('debug');
132
-
133
- if (!defaultValue.defined(result)) {
134
- return new Plane(normal, distance);
135
- }
136
- Matrix3.Cartesian3.clone(normal, result.normal);
137
- result.distance = distance;
138
- return result;
139
- };
140
-
141
- /**
142
- * Computes the signed shortest distance of a point to a plane.
143
- * The sign of the distance determines which side of the plane the point
144
- * is on. If the distance is positive, the point is in the half-space
145
- * in the direction of the normal; if negative, the point is in the half-space
146
- * opposite to the normal; if zero, the plane passes through the point.
147
- *
148
- * @param {Plane} plane The plane.
149
- * @param {Cartesian3} point The point.
150
- * @returns {number} The signed shortest distance of the point to the plane.
151
- */
152
- Plane.getPointDistance = function (plane, point) {
153
- //>>includeStart('debug', pragmas.debug);
154
- Check.Check.typeOf.object("plane", plane);
155
- Check.Check.typeOf.object("point", point);
156
- //>>includeEnd('debug');
157
-
158
- return Matrix3.Cartesian3.dot(plane.normal, point) + plane.distance;
159
- };
160
-
161
- const scratchCartesian = new Matrix3.Cartesian3();
162
- /**
163
- * Projects a point onto the plane.
164
- * @param {Plane} plane The plane to project the point onto
165
- * @param {Cartesian3} point The point to project onto the plane
166
- * @param {Cartesian3} [result] The result point. If undefined, a new Cartesian3 will be created.
167
- * @returns {Cartesian3} The modified result parameter or a new Cartesian3 instance if one was not provided.
168
- */
169
- Plane.projectPointOntoPlane = function (plane, point, result) {
170
- //>>includeStart('debug', pragmas.debug);
171
- Check.Check.typeOf.object("plane", plane);
172
- Check.Check.typeOf.object("point", point);
173
- //>>includeEnd('debug');
174
-
175
- if (!defaultValue.defined(result)) {
176
- result = new Matrix3.Cartesian3();
177
- }
178
-
179
- // projectedPoint = point - (normal.point + scale) * normal
180
- const pointDistance = Plane.getPointDistance(plane, point);
181
- const scaledNormal = Matrix3.Cartesian3.multiplyByScalar(
182
- plane.normal,
183
- pointDistance,
184
- scratchCartesian
185
- );
186
-
187
- return Matrix3.Cartesian3.subtract(point, scaledNormal, result);
188
- };
189
-
190
- const scratchInverseTranspose = new Matrix2.Matrix4();
191
- const scratchPlaneCartesian4 = new Matrix2.Cartesian4();
192
- const scratchTransformNormal = new Matrix3.Cartesian3();
193
- /**
194
- * Transforms the plane by the given transformation matrix.
195
- *
196
- * @param {Plane} plane The plane.
197
- * @param {Matrix4} transform The transformation matrix.
198
- * @param {Plane} [result] The object into which to store the result.
199
- * @returns {Plane} The plane transformed by the given transformation matrix.
200
- */
201
- Plane.transform = function (plane, transform, result) {
202
- //>>includeStart('debug', pragmas.debug);
203
- Check.Check.typeOf.object("plane", plane);
204
- Check.Check.typeOf.object("transform", transform);
205
- //>>includeEnd('debug');
206
-
207
- const normal = plane.normal;
208
- const distance = plane.distance;
209
- const inverseTranspose = Matrix2.Matrix4.inverseTranspose(
210
- transform,
211
- scratchInverseTranspose
212
- );
213
- let planeAsCartesian4 = Matrix2.Cartesian4.fromElements(
214
- normal.x,
215
- normal.y,
216
- normal.z,
217
- distance,
218
- scratchPlaneCartesian4
219
- );
220
- planeAsCartesian4 = Matrix2.Matrix4.multiplyByVector(
221
- inverseTranspose,
222
- planeAsCartesian4,
223
- planeAsCartesian4
224
- );
225
-
226
- // Convert the transformed plane to Hessian Normal Form
227
- const transformedNormal = Matrix3.Cartesian3.fromCartesian4(
228
- planeAsCartesian4,
229
- scratchTransformNormal
230
- );
231
-
232
- planeAsCartesian4 = Matrix2.Cartesian4.divideByScalar(
233
- planeAsCartesian4,
234
- Matrix3.Cartesian3.magnitude(transformedNormal),
235
- planeAsCartesian4
236
- );
237
-
238
- return Plane.fromCartesian4(planeAsCartesian4, result);
239
- };
240
-
241
- /**
242
- * Duplicates a Plane instance.
243
- *
244
- * @param {Plane} plane The plane to duplicate.
245
- * @param {Plane} [result] The object onto which to store the result.
246
- * @returns {Plane} The modified result parameter or a new Plane instance if one was not provided.
247
- */
248
- Plane.clone = function (plane, result) {
249
- //>>includeStart('debug', pragmas.debug);
250
- Check.Check.typeOf.object("plane", plane);
251
- //>>includeEnd('debug');
252
-
253
- if (!defaultValue.defined(result)) {
254
- return new Plane(plane.normal, plane.distance);
255
- }
256
-
257
- Matrix3.Cartesian3.clone(plane.normal, result.normal);
258
- result.distance = plane.distance;
259
-
260
- return result;
261
- };
262
-
263
- /**
264
- * Compares the provided Planes by normal and distance and returns
265
- * <code>true</code> if they are equal, <code>false</code> otherwise.
266
- *
267
- * @param {Plane} left The first plane.
268
- * @param {Plane} right The second plane.
269
- * @returns {boolean} <code>true</code> if left and right are equal, <code>false</code> otherwise.
270
- */
271
- Plane.equals = function (left, right) {
272
- //>>includeStart('debug', pragmas.debug);
273
- Check.Check.typeOf.object("left", left);
274
- Check.Check.typeOf.object("right", right);
275
- //>>includeEnd('debug');
276
-
277
- return (
278
- left.distance === right.distance &&
279
- Matrix3.Cartesian3.equals(left.normal, right.normal)
280
- );
281
- };
282
-
283
- /**
284
- * A constant initialized to the XY plane passing through the origin, with normal in positive Z.
285
- *
286
- * @type {Plane}
287
- * @constant
288
- */
289
- Plane.ORIGIN_XY_PLANE = Object.freeze(new Plane(Matrix3.Cartesian3.UNIT_Z, 0.0));
290
-
291
- /**
292
- * A constant initialized to the YZ plane passing through the origin, with normal in positive X.
293
- *
294
- * @type {Plane}
295
- * @constant
296
- */
297
- Plane.ORIGIN_YZ_PLANE = Object.freeze(new Plane(Matrix3.Cartesian3.UNIT_X, 0.0));
298
-
299
- /**
300
- * A constant initialized to the ZX plane passing through the origin, with normal in positive Y.
301
- *
302
- * @type {Plane}
303
- * @constant
304
- */
305
- Plane.ORIGIN_ZX_PLANE = Object.freeze(new Plane(Matrix3.Cartesian3.UNIT_Y, 0.0));
306
-
307
- exports.Plane = Plane;
308
-
309
- }));