@cesium/engine 3.0.1 → 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 (234) 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 -2011
  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 +3353 -1464
  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/FeatureDetection.js +9 -0
  107. package/Source/Core/GoogleMaps.js +1 -1
  108. package/Source/Core/GroundPolylineGeometry.js +3 -2
  109. package/Source/Core/Ion.js +1 -1
  110. package/Source/Core/KTX2Transcoder.js +7 -3
  111. package/Source/Core/RequestScheduler.js +1 -0
  112. package/Source/Core/TaskProcessor.js +150 -146
  113. package/Source/Core/Transforms.js +2 -2
  114. package/Source/Core/buildModuleUrl.js +6 -5
  115. package/Source/DataSources/CzmlDataSource.js +6 -4
  116. package/Source/Scene/ArcGisMapService.js +1 -1
  117. package/Source/Scene/DracoLoader.js +26 -3
  118. package/Source/Scene/GltfLoaderUtil.js +1 -7
  119. package/Source/Scene/I3SDataProvider.js +0 -27
  120. package/Source/Scene/I3SDecoder.js +127 -0
  121. package/Source/Scene/I3SNode.js +32 -110
  122. package/Source/Scene/ImageryLayer.js +2 -2
  123. package/Source/Scene/Implicit3DTileContent.js +13 -0
  124. package/Source/Scene/ImplicitTileset.js +5 -0
  125. package/Source/Scene/Model/I3dmLoader.js +5 -1
  126. package/Source/Scene/Model/Model.js +4 -1
  127. package/Source/Scene/OpenStreetMapImageryProvider.js +7 -4
  128. package/Source/Scene/SingleTileImageryProvider.js +4 -2
  129. package/Source/ThirdParty/Workers/basis_transcoder.js +1 -1
  130. package/Source/{WorkersES6 → Workers}/createGeometry.js +11 -12
  131. package/Source/{WorkersES6 → Workers}/createTaskProcessorWorker.js +43 -59
  132. package/Source/{WorkersES6 → Workers}/decodeDraco.js +19 -25
  133. package/Source/{WorkersES6 → Workers}/decodeI3S.js +18 -32
  134. package/Source/{WorkersES6 → Workers}/transcodeKTX2.js +19 -26
  135. package/Source/Workers/transferTypedArrayTest.js +0 -6
  136. package/index.d.ts +20 -11
  137. package/index.js +170 -169
  138. package/package.json +3 -2
  139. package/Build/Workers/ArcType-2d9abbbc.js +0 -37
  140. package/Build/Workers/AttributeCompression-f9f6c717.js +0 -716
  141. package/Build/Workers/AxisAlignedBoundingBox-4bfd84f3.js +0 -258
  142. package/Build/Workers/BoundingRectangle-5fd6403a.js +0 -369
  143. package/Build/Workers/BoxGeometry-7aa4ce7f.js +0 -884
  144. package/Build/Workers/Check-6ede7e26.js +0 -290
  145. package/Build/Workers/Color-8e135f71.js +0 -2262
  146. package/Build/Workers/ComponentDatatype-cf1fa08e.js +0 -341
  147. package/Build/Workers/CoplanarPolygonGeometryLibrary-59c69b0a.js +0 -132
  148. package/Build/Workers/CorridorGeometryLibrary-63907365.js +0 -498
  149. package/Build/Workers/CylinderGeometry-8fc7c44b.js +0 -467
  150. package/Build/Workers/CylinderGeometryLibrary-7bf291b4.js +0 -63
  151. package/Build/Workers/EllipseGeometry-16b3736a.js +0 -1304
  152. package/Build/Workers/EllipseGeometryLibrary-21262a28.js +0 -366
  153. package/Build/Workers/EllipseOutlineGeometry-05d35d18.js +0 -443
  154. package/Build/Workers/EllipsoidGeodesic-5b3623dc.js +0 -520
  155. package/Build/Workers/EllipsoidGeometry-a503d1d6.js +0 -637
  156. package/Build/Workers/EllipsoidOutlineGeometry-7b09f24d.js +0 -454
  157. package/Build/Workers/EllipsoidRhumbLine-ef872433.js +0 -741
  158. package/Build/Workers/EllipsoidTangentPlane-546c0d5e.js +0 -373
  159. package/Build/Workers/EncodedCartesian3-57415c8a.js +0 -171
  160. package/Build/Workers/FrustumGeometry-87ce8622.js +0 -2540
  161. package/Build/Workers/GeometryAttribute-8fcff0d5.js +0 -619
  162. package/Build/Workers/GeometryAttributes-ad136444.js +0 -91
  163. package/Build/Workers/GeometryInstance-34d9e21e.js +0 -121
  164. package/Build/Workers/GeometryOffsetAttribute-9ad0019c.js +0 -16
  165. package/Build/Workers/GeometryPipeline-70d69a43.js +0 -3690
  166. package/Build/Workers/IndexDatatype-2643aa47.js +0 -200
  167. package/Build/Workers/IntersectionTests-85350792.js +0 -1836
  168. package/Build/Workers/Math-0a2ac845.js +0 -1340
  169. package/Build/Workers/Matrix2-e1298525.js +0 -7086
  170. package/Build/Workers/Matrix3-41c58dde.js +0 -4283
  171. package/Build/Workers/OrientedBoundingBox-29fb0fcd.js +0 -1259
  172. package/Build/Workers/Plane-4c3d403b.js +0 -309
  173. package/Build/Workers/PolygonGeometryLibrary-bad6329a.js +0 -1074
  174. package/Build/Workers/PolygonPipeline-dd13ee78.js +0 -1344
  175. package/Build/Workers/PolylinePipeline-7119eb3f.js +0 -573
  176. package/Build/Workers/PolylineVolumeGeometryLibrary-d25f0050.js +0 -781
  177. package/Build/Workers/PrimitivePipeline-111ee29f.js +0 -966
  178. package/Build/Workers/RectangleGeometryLibrary-bb378fb6.js +0 -280
  179. package/Build/Workers/RuntimeError-ef395448.js +0 -68
  180. package/Build/Workers/TerrainEncoding-c8e029a2.js +0 -1227
  181. package/Build/Workers/Transforms-e2d4a55a.js +0 -14713
  182. package/Build/Workers/VertexFormat-030f11ff.js +0 -312
  183. package/Build/Workers/WallGeometryLibrary-3e0819ec.js +0 -211
  184. package/Build/Workers/WebGLConstants-0b1ce7ba.js +0 -620
  185. package/Build/Workers/WebMercatorProjection-13ed1a6e.js +0 -151
  186. package/Build/Workers/arrayRemoveDuplicates-d2061e85.js +0 -129
  187. package/Build/Workers/cesiumWorkerBootstrapper.js +0 -1363
  188. package/Build/Workers/combine-d9581036.js +0 -82
  189. package/Build/Workers/defaultValue-fe22d8c0.js +0 -51
  190. package/Source/ThirdParty/Workers/draco_decoder_nodejs.js +0 -117
  191. package/Source/Workers/cesiumWorkerBootstrapper.js +0 -2290
  192. package/Source/Workers/package.json +0 -1
  193. /package/Source/{WorkersES6 → Workers}/combineGeometry.js +0 -0
  194. /package/Source/{WorkersES6 → Workers}/createBoxGeometry.js +0 -0
  195. /package/Source/{WorkersES6 → Workers}/createBoxOutlineGeometry.js +0 -0
  196. /package/Source/{WorkersES6 → Workers}/createCircleGeometry.js +0 -0
  197. /package/Source/{WorkersES6 → Workers}/createCircleOutlineGeometry.js +0 -0
  198. /package/Source/{WorkersES6 → Workers}/createCoplanarPolygonGeometry.js +0 -0
  199. /package/Source/{WorkersES6 → Workers}/createCoplanarPolygonOutlineGeometry.js +0 -0
  200. /package/Source/{WorkersES6 → Workers}/createCorridorGeometry.js +0 -0
  201. /package/Source/{WorkersES6 → Workers}/createCorridorOutlineGeometry.js +0 -0
  202. /package/Source/{WorkersES6 → Workers}/createCylinderGeometry.js +0 -0
  203. /package/Source/{WorkersES6 → Workers}/createCylinderOutlineGeometry.js +0 -0
  204. /package/Source/{WorkersES6 → Workers}/createEllipseGeometry.js +0 -0
  205. /package/Source/{WorkersES6 → Workers}/createEllipseOutlineGeometry.js +0 -0
  206. /package/Source/{WorkersES6 → Workers}/createEllipsoidGeometry.js +0 -0
  207. /package/Source/{WorkersES6 → Workers}/createEllipsoidOutlineGeometry.js +0 -0
  208. /package/Source/{WorkersES6 → Workers}/createFrustumGeometry.js +0 -0
  209. /package/Source/{WorkersES6 → Workers}/createFrustumOutlineGeometry.js +0 -0
  210. /package/Source/{WorkersES6 → Workers}/createGroundPolylineGeometry.js +0 -0
  211. /package/Source/{WorkersES6 → Workers}/createPlaneGeometry.js +0 -0
  212. /package/Source/{WorkersES6 → Workers}/createPlaneOutlineGeometry.js +0 -0
  213. /package/Source/{WorkersES6 → Workers}/createPolygonGeometry.js +0 -0
  214. /package/Source/{WorkersES6 → Workers}/createPolygonOutlineGeometry.js +0 -0
  215. /package/Source/{WorkersES6 → Workers}/createPolylineGeometry.js +0 -0
  216. /package/Source/{WorkersES6 → Workers}/createPolylineVolumeGeometry.js +0 -0
  217. /package/Source/{WorkersES6 → Workers}/createPolylineVolumeOutlineGeometry.js +0 -0
  218. /package/Source/{WorkersES6 → Workers}/createRectangleGeometry.js +0 -0
  219. /package/Source/{WorkersES6 → Workers}/createRectangleOutlineGeometry.js +0 -0
  220. /package/Source/{WorkersES6 → Workers}/createSimplePolylineGeometry.js +0 -0
  221. /package/Source/{WorkersES6 → Workers}/createSphereGeometry.js +0 -0
  222. /package/Source/{WorkersES6 → Workers}/createSphereOutlineGeometry.js +0 -0
  223. /package/Source/{WorkersES6 → Workers}/createVectorTileClampedPolylines.js +0 -0
  224. /package/Source/{WorkersES6 → Workers}/createVectorTileGeometries.js +0 -0
  225. /package/Source/{WorkersES6 → Workers}/createVectorTilePoints.js +0 -0
  226. /package/Source/{WorkersES6 → Workers}/createVectorTilePolygons.js +0 -0
  227. /package/Source/{WorkersES6 → Workers}/createVectorTilePolylines.js +0 -0
  228. /package/Source/{WorkersES6 → Workers}/createVerticesFromGoogleEarthEnterpriseBuffer.js +0 -0
  229. /package/Source/{WorkersES6 → Workers}/createVerticesFromHeightmap.js +0 -0
  230. /package/Source/{WorkersES6 → Workers}/createVerticesFromQuantizedTerrainMesh.js +0 -0
  231. /package/Source/{WorkersES6 → Workers}/createWallGeometry.js +0 -0
  232. /package/Source/{WorkersES6 → Workers}/createWallOutlineGeometry.js +0 -0
  233. /package/Source/{WorkersES6 → Workers}/decodeGoogleEarthEnterprisePacket.js +0 -0
  234. /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
- }));