@math.gl/geometry 5.0.0-alpha.8 → 5.0.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 (368) hide show
  1. package/LICENSE +97 -49
  2. package/README.md +16 -1
  3. package/THIRD-PARTY-NOTICES.md +18 -0
  4. package/dist/culling/constants.d.ts +3 -0
  5. package/dist/culling/constants.d.ts.map +1 -0
  6. package/dist/culling/constants.js +5 -0
  7. package/dist/culling/constants.js.map +1 -0
  8. package/dist/culling/index.cjs +2124 -0
  9. package/dist/culling/index.cjs.map +6 -0
  10. package/dist/culling/index.d.ts +31 -0
  11. package/dist/culling/index.d.ts.map +1 -0
  12. package/dist/culling/index.js +25 -0
  13. package/dist/culling/index.js.map +1 -0
  14. package/dist/culling/lib/algorithms/bounding-box-from-points.d.ts +15 -0
  15. package/dist/culling/lib/algorithms/bounding-box-from-points.d.ts.map +1 -0
  16. package/dist/culling/lib/algorithms/bounding-box-from-points.js +137 -0
  17. package/dist/culling/lib/algorithms/bounding-box-from-points.js.map +1 -0
  18. package/dist/culling/lib/algorithms/bounding-sphere-from-points.d.ts +14 -0
  19. package/dist/culling/lib/algorithms/bounding-sphere-from-points.d.ts.map +1 -0
  20. package/dist/culling/lib/algorithms/bounding-sphere-from-points.js +146 -0
  21. package/dist/culling/lib/algorithms/bounding-sphere-from-points.js.map +1 -0
  22. package/dist/culling/lib/algorithms/compute-eigen-decomposition.d.ts +37 -0
  23. package/dist/culling/lib/algorithms/compute-eigen-decomposition.d.ts.map +1 -0
  24. package/dist/culling/lib/algorithms/compute-eigen-decomposition.js +137 -0
  25. package/dist/culling/lib/algorithms/compute-eigen-decomposition.js.map +1 -0
  26. package/dist/culling/lib/algorithms/oriented-bounding-box-quaternion.d.ts +7 -0
  27. package/dist/culling/lib/algorithms/oriented-bounding-box-quaternion.d.ts.map +1 -0
  28. package/dist/culling/lib/algorithms/oriented-bounding-box-quaternion.js +26 -0
  29. package/dist/culling/lib/algorithms/oriented-bounding-box-quaternion.js.map +1 -0
  30. package/dist/culling/lib/bounding-volumes/axis-aligned-bounding-box.d.ts +56 -0
  31. package/dist/culling/lib/bounding-volumes/axis-aligned-bounding-box.d.ts.map +1 -0
  32. package/dist/culling/lib/bounding-volumes/axis-aligned-bounding-box.js +116 -0
  33. package/dist/culling/lib/bounding-volumes/axis-aligned-bounding-box.js.map +1 -0
  34. package/dist/culling/lib/bounding-volumes/bounding-sphere.d.ts +40 -0
  35. package/dist/culling/lib/bounding-volumes/bounding-sphere.d.ts.map +1 -0
  36. package/dist/culling/lib/bounding-volumes/bounding-sphere.js +123 -0
  37. package/dist/culling/lib/bounding-volumes/bounding-sphere.js.map +1 -0
  38. package/dist/culling/lib/bounding-volumes/bounding-volume.d.ts +30 -0
  39. package/dist/culling/lib/bounding-volumes/bounding-volume.d.ts.map +1 -0
  40. package/dist/culling/lib/bounding-volumes/bounding-volume.js +7 -0
  41. package/dist/culling/lib/bounding-volumes/bounding-volume.js.map +1 -0
  42. package/dist/culling/lib/bounding-volumes/oriented-bounding-box.d.ts +62 -0
  43. package/dist/culling/lib/bounding-volumes/oriented-bounding-box.d.ts.map +1 -0
  44. package/dist/culling/lib/bounding-volumes/oriented-bounding-box.js +230 -0
  45. package/dist/culling/lib/bounding-volumes/oriented-bounding-box.js.map +1 -0
  46. package/dist/culling/lib/culling-volume.d.ts +46 -0
  47. package/dist/culling/lib/culling-volume.d.ts.map +1 -0
  48. package/dist/culling/lib/culling-volume.js +126 -0
  49. package/dist/culling/lib/culling-volume.js.map +1 -0
  50. package/dist/culling/lib/perspective-frustum.d.ts +153 -0
  51. package/dist/culling/lib/perspective-frustum.d.ts.map +1 -0
  52. package/dist/culling/lib/perspective-frustum.js +191 -0
  53. package/dist/culling/lib/perspective-frustum.js.map +1 -0
  54. package/dist/culling/lib/perspective-off-center-frustum.d.ts +158 -0
  55. package/dist/culling/lib/perspective-off-center-frustum.d.ts.map +1 -0
  56. package/dist/culling/lib/perspective-off-center-frustum.js +276 -0
  57. package/dist/culling/lib/perspective-off-center-frustum.js.map +1 -0
  58. package/dist/culling/lib/plane.d.ts +35 -0
  59. package/dist/culling/lib/plane.d.ts.map +1 -0
  60. package/dist/culling/lib/plane.js +90 -0
  61. package/dist/culling/lib/plane.js.map +1 -0
  62. package/dist/culling/lib/ray.d.ts +13 -0
  63. package/dist/culling/lib/ray.d.ts.map +1 -0
  64. package/dist/culling/lib/ray.js +30 -0
  65. package/dist/culling/lib/ray.js.map +1 -0
  66. package/dist/culling/lib/shapes/box-shape.d.ts +19 -0
  67. package/dist/culling/lib/shapes/box-shape.d.ts.map +1 -0
  68. package/dist/culling/lib/shapes/box-shape.js +69 -0
  69. package/dist/culling/lib/shapes/box-shape.js.map +1 -0
  70. package/dist/culling/lib/shapes/capsule-shape.d.ts +23 -0
  71. package/dist/culling/lib/shapes/capsule-shape.d.ts.map +1 -0
  72. package/dist/culling/lib/shapes/capsule-shape.js +151 -0
  73. package/dist/culling/lib/shapes/capsule-shape.js.map +1 -0
  74. package/dist/culling/lib/shapes/cylinder-shape.d.ts +22 -0
  75. package/dist/culling/lib/shapes/cylinder-shape.d.ts.map +1 -0
  76. package/dist/culling/lib/shapes/cylinder-shape.js +99 -0
  77. package/dist/culling/lib/shapes/cylinder-shape.js.map +1 -0
  78. package/dist/culling/lib/shapes/implicit-shape.d.ts +56 -0
  79. package/dist/culling/lib/shapes/implicit-shape.d.ts.map +1 -0
  80. package/dist/culling/lib/shapes/implicit-shape.js +142 -0
  81. package/dist/culling/lib/shapes/implicit-shape.js.map +1 -0
  82. package/dist/culling/lib/shapes/plane-shape.d.ts +27 -0
  83. package/dist/culling/lib/shapes/plane-shape.d.ts.map +1 -0
  84. package/dist/culling/lib/shapes/plane-shape.js +71 -0
  85. package/dist/culling/lib/shapes/plane-shape.js.map +1 -0
  86. package/dist/culling/lib/shapes/sphere-shape.d.ts +18 -0
  87. package/dist/culling/lib/shapes/sphere-shape.d.ts.map +1 -0
  88. package/dist/culling/lib/shapes/sphere-shape.js +43 -0
  89. package/dist/culling/lib/shapes/sphere-shape.js.map +1 -0
  90. package/dist/culling/oriented-box-2d.d.ts +22 -0
  91. package/dist/culling/oriented-box-2d.d.ts.map +1 -0
  92. package/dist/culling/oriented-box-2d.js +86 -0
  93. package/dist/culling/oriented-box-2d.js.map +1 -0
  94. package/dist/culling/queries.d.ts +44 -0
  95. package/dist/culling/queries.d.ts.map +1 -0
  96. package/dist/culling/queries.js +259 -0
  97. package/dist/culling/queries.js.map +1 -0
  98. package/dist/curves/bezier-curves.d.ts +18 -0
  99. package/dist/curves/bezier-curves.d.ts.map +1 -0
  100. package/dist/curves/bezier-curves.js +54 -0
  101. package/dist/curves/bezier-curves.js.map +1 -0
  102. package/dist/curves/catmull-rom-curve.d.ts +15 -0
  103. package/dist/curves/catmull-rom-curve.d.ts.map +1 -0
  104. package/dist/curves/catmull-rom-curve.js +77 -0
  105. package/dist/curves/catmull-rom-curve.js.map +1 -0
  106. package/dist/curves/curve-arc-length.d.ts +17 -0
  107. package/dist/curves/curve-arc-length.d.ts.map +1 -0
  108. package/dist/curves/curve-arc-length.js +58 -0
  109. package/dist/curves/curve-arc-length.js.map +1 -0
  110. package/dist/curves/curve.d.ts +23 -0
  111. package/dist/curves/curve.d.ts.map +1 -0
  112. package/dist/curves/curve.js +77 -0
  113. package/dist/curves/curve.js.map +1 -0
  114. package/dist/curves/hermite-curve.d.ts +9 -0
  115. package/dist/curves/hermite-curve.d.ts.map +1 -0
  116. package/dist/curves/hermite-curve.js +24 -0
  117. package/dist/curves/hermite-curve.js.map +1 -0
  118. package/dist/curves/index.d.ts +8 -0
  119. package/dist/curves/index.d.ts.map +1 -0
  120. package/dist/curves/index.js +9 -0
  121. package/dist/curves/index.js.map +1 -0
  122. package/dist/geometries/box-geometry.js +1 -1
  123. package/dist/geometries/box-geometry.js.map +1 -1
  124. package/dist/geometries/capsule-geometry.js +1 -1
  125. package/dist/geometries/capsule-geometry.js.map +1 -1
  126. package/dist/geometries/cylinder-geometry.js +1 -1
  127. package/dist/geometries/cylinder-geometry.js.map +1 -1
  128. package/dist/geometries/geometry-helpers.js +1 -1
  129. package/dist/geometries/geometry-helpers.js.map +1 -1
  130. package/dist/geometries/ico-sphere-geometry.js +1 -1
  131. package/dist/geometries/ico-sphere-geometry.js.map +1 -1
  132. package/dist/geometries/plane-geometry.js +1 -1
  133. package/dist/geometries/plane-geometry.js.map +1 -1
  134. package/dist/geometries/primitive-mesh-builder.d.ts +24 -0
  135. package/dist/geometries/primitive-mesh-builder.d.ts.map +1 -0
  136. package/dist/geometries/primitive-mesh-builder.js +74 -0
  137. package/dist/geometries/primitive-mesh-builder.js.map +1 -0
  138. package/dist/geometries/prism-geometry.d.ts +13 -0
  139. package/dist/geometries/prism-geometry.d.ts.map +1 -0
  140. package/dist/geometries/prism-geometry.js +34 -0
  141. package/dist/geometries/prism-geometry.js.map +1 -0
  142. package/dist/geometries/ring-geometry.d.ts +15 -0
  143. package/dist/geometries/ring-geometry.d.ts.map +1 -0
  144. package/dist/geometries/ring-geometry.js +64 -0
  145. package/dist/geometries/ring-geometry.js.map +1 -0
  146. package/dist/geometries/sphere-geometry.js +1 -1
  147. package/dist/geometries/sphere-geometry.js.map +1 -1
  148. package/dist/geometries/surface-of-revolution.js +1 -1
  149. package/dist/geometries/surface-of-revolution.js.map +1 -1
  150. package/dist/geometries/truncated-cone-geometry.js +1 -1
  151. package/dist/geometries/truncated-cone-geometry.js.map +1 -1
  152. package/dist/index.cjs +5867 -16
  153. package/dist/index.cjs.map +3 -3
  154. package/dist/index.d.ts +23 -0
  155. package/dist/index.d.ts.map +1 -1
  156. package/dist/index.js +13 -1
  157. package/dist/index.js.map +1 -1
  158. package/dist/lib/geometry-utils.js +1 -1
  159. package/dist/lib/geometry-utils.js.map +1 -1
  160. package/dist/lib/geometry.d.ts +1 -1
  161. package/dist/lib/geometry.d.ts.map +1 -1
  162. package/dist/lib/geometry.js +1 -1
  163. package/dist/lib/geometry.js.map +1 -1
  164. package/dist/lib/hinge-tree.d.ts +33 -0
  165. package/dist/lib/hinge-tree.d.ts.map +1 -0
  166. package/dist/lib/hinge-tree.js +144 -0
  167. package/dist/lib/hinge-tree.js.map +1 -0
  168. package/dist/parametric/lathe-geometry.d.ts +14 -0
  169. package/dist/parametric/lathe-geometry.d.ts.map +1 -0
  170. package/dist/parametric/lathe-geometry.js +48 -0
  171. package/dist/parametric/lathe-geometry.js.map +1 -0
  172. package/dist/parametric/parametric-geometry.d.ts +20 -0
  173. package/dist/parametric/parametric-geometry.d.ts.map +1 -0
  174. package/dist/parametric/parametric-geometry.js +88 -0
  175. package/dist/parametric/parametric-geometry.js.map +1 -0
  176. package/dist/parametric/torus-geometry.d.ts +19 -0
  177. package/dist/parametric/torus-geometry.d.ts.map +1 -0
  178. package/dist/parametric/torus-geometry.js +89 -0
  179. package/dist/parametric/torus-geometry.js.map +1 -0
  180. package/dist/parametric.d.ts +7 -0
  181. package/dist/parametric.d.ts.map +1 -0
  182. package/dist/parametric.js +7 -0
  183. package/dist/parametric.js.map +1 -0
  184. package/dist/polygon/clip-triangle-mesh.d.ts +41 -0
  185. package/dist/polygon/clip-triangle-mesh.d.ts.map +1 -0
  186. package/dist/polygon/clip-triangle-mesh.js +155 -0
  187. package/dist/polygon/clip-triangle-mesh.js.map +1 -0
  188. package/dist/polygon/cut-by-grid.d.ts +24 -0
  189. package/dist/polygon/cut-by-grid.d.ts.map +1 -0
  190. package/dist/polygon/cut-by-grid.js +221 -0
  191. package/dist/polygon/cut-by-grid.js.map +1 -0
  192. package/dist/polygon/cut-by-mercator-bounds.d.ts +17 -0
  193. package/dist/polygon/cut-by-mercator-bounds.d.ts.map +1 -0
  194. package/dist/polygon/cut-by-mercator-bounds.js +149 -0
  195. package/dist/polygon/cut-by-mercator-bounds.js.map +1 -0
  196. package/dist/polygon/earcut.d.ts +13 -0
  197. package/dist/polygon/earcut.d.ts.map +1 -0
  198. package/dist/polygon/earcut.js +627 -0
  199. package/dist/polygon/earcut.js.map +1 -0
  200. package/dist/polygon/index.d.ts +14 -0
  201. package/dist/polygon/index.d.ts.map +1 -0
  202. package/dist/polygon/index.js +13 -0
  203. package/dist/polygon/index.js.map +1 -0
  204. package/dist/polygon/lineclip.d.ts +31 -0
  205. package/dist/polygon/lineclip.d.ts.map +1 -0
  206. package/dist/polygon/lineclip.js +184 -0
  207. package/dist/polygon/lineclip.js.map +1 -0
  208. package/dist/polygon/polygon-utils.d.ts +103 -0
  209. package/dist/polygon/polygon-utils.d.ts.map +1 -0
  210. package/dist/polygon/polygon-utils.js +155 -0
  211. package/dist/polygon/polygon-utils.js.map +1 -0
  212. package/dist/polygon/polygon.d.ts +41 -0
  213. package/dist/polygon/polygon.d.ts.map +1 -0
  214. package/dist/polygon/polygon.js +76 -0
  215. package/dist/polygon/polygon.js.map +1 -0
  216. package/dist/polygon/subdivide-polyline.d.ts +56 -0
  217. package/dist/polygon/subdivide-polyline.d.ts.map +1 -0
  218. package/dist/polygon/subdivide-polyline.js +141 -0
  219. package/dist/polygon/subdivide-polyline.js.map +1 -0
  220. package/dist/polygon/subdivide-triangle-mesh.d.ts +68 -0
  221. package/dist/polygon/subdivide-triangle-mesh.d.ts.map +1 -0
  222. package/dist/polygon/subdivide-triangle-mesh.js +228 -0
  223. package/dist/polygon/subdivide-triangle-mesh.js.map +1 -0
  224. package/dist/polygon/utils.d.ts +5 -0
  225. package/dist/polygon/utils.d.ts.map +1 -0
  226. package/dist/polygon/utils.js +38 -0
  227. package/dist/polygon/utils.js.map +1 -0
  228. package/dist/spatial-index/box-index.d.ts +86 -0
  229. package/dist/spatial-index/box-index.d.ts.map +1 -0
  230. package/dist/spatial-index/box-index.js +335 -0
  231. package/dist/spatial-index/box-index.js.map +1 -0
  232. package/dist/spatial-index/index.d.ts +7 -0
  233. package/dist/spatial-index/index.d.ts.map +1 -0
  234. package/dist/spatial-index/index.js +6 -0
  235. package/dist/spatial-index/index.js.map +1 -0
  236. package/dist/spatial-index/triangle-bvh.d.ts +74 -0
  237. package/dist/spatial-index/triangle-bvh.d.ts.map +1 -0
  238. package/dist/spatial-index/triangle-bvh.js +221 -0
  239. package/dist/spatial-index/triangle-bvh.js.map +1 -0
  240. package/dist/utils/attribute-compression.d.ts +50 -0
  241. package/dist/utils/attribute-compression.d.ts.map +1 -0
  242. package/dist/utils/attribute-compression.js +186 -0
  243. package/dist/utils/attribute-compression.js.map +1 -0
  244. package/dist/utils/attribute-iterator.d.ts +8 -0
  245. package/dist/utils/attribute-iterator.d.ts.map +1 -0
  246. package/dist/utils/attribute-iterator.js +25 -0
  247. package/dist/utils/attribute-iterator.js.map +1 -0
  248. package/dist/utils/compute-vertex-normals.d.ts +4 -0
  249. package/dist/utils/compute-vertex-normals.d.ts.map +1 -0
  250. package/dist/utils/compute-vertex-normals.js +54 -0
  251. package/dist/utils/compute-vertex-normals.js.map +1 -0
  252. package/dist/utils/constants.d.ts +52 -0
  253. package/dist/utils/constants.d.ts.map +1 -0
  254. package/dist/utils/constants.js +39 -0
  255. package/dist/utils/constants.js.map +1 -0
  256. package/dist/utils/coordinates.d.ts +3 -0
  257. package/dist/utils/coordinates.d.ts.map +1 -0
  258. package/dist/utils/coordinates.js +8 -0
  259. package/dist/utils/coordinates.js.map +1 -0
  260. package/dist/utils/geometry.d.ts +20 -0
  261. package/dist/utils/geometry.d.ts.map +1 -0
  262. package/dist/utils/geometry.js +31 -0
  263. package/dist/utils/geometry.js.map +1 -0
  264. package/dist/utils/gl-type.d.ts +17 -0
  265. package/dist/utils/gl-type.d.ts.map +1 -0
  266. package/dist/utils/gl-type.js +69 -0
  267. package/dist/utils/gl-type.js.map +1 -0
  268. package/dist/utils/index.d.ts +18 -0
  269. package/dist/utils/index.d.ts.map +1 -0
  270. package/dist/utils/index.js +16 -0
  271. package/dist/utils/index.js.map +1 -0
  272. package/dist/utils/interpolate-packed-attributes.d.ts +43 -0
  273. package/dist/utils/interpolate-packed-attributes.d.ts.map +1 -0
  274. package/dist/utils/interpolate-packed-attributes.js +192 -0
  275. package/dist/utils/interpolate-packed-attributes.js.map +1 -0
  276. package/dist/utils/mesh-processing.d.ts +18 -0
  277. package/dist/utils/mesh-processing.d.ts.map +1 -0
  278. package/dist/utils/mesh-processing.js +300 -0
  279. package/dist/utils/mesh-processing.js.map +1 -0
  280. package/dist/utils/primitive-iterator.d.ts +21 -0
  281. package/dist/utils/primitive-iterator.d.ts.map +1 -0
  282. package/dist/utils/primitive-iterator.js +117 -0
  283. package/dist/utils/primitive-iterator.js.map +1 -0
  284. package/dist/utils/rgb565.d.ts +5 -0
  285. package/dist/utils/rgb565.d.ts.map +1 -0
  286. package/dist/utils/rgb565.js +24 -0
  287. package/dist/utils/rgb565.js.map +1 -0
  288. package/dist/utils/typed-array-utils.d.ts +3 -0
  289. package/dist/utils/typed-array-utils.d.ts.map +1 -0
  290. package/dist/utils/typed-array-utils.js +16 -0
  291. package/dist/utils/typed-array-utils.js.map +1 -0
  292. package/package.json +12 -4
  293. package/src/culling/constants.ts +6 -0
  294. package/src/culling/index.ts +55 -0
  295. package/src/culling/lib/algorithms/bounding-box-from-points.ts +174 -0
  296. package/src/culling/lib/algorithms/bounding-sphere-from-points.ts +175 -0
  297. package/src/culling/lib/algorithms/compute-eigen-decomposition.ts +171 -0
  298. package/src/culling/lib/algorithms/oriented-bounding-box-quaternion.ts +32 -0
  299. package/src/culling/lib/bounding-volumes/axis-aligned-bounding-box.ts +153 -0
  300. package/src/culling/lib/bounding-volumes/bounding-sphere.ts +154 -0
  301. package/src/culling/lib/bounding-volumes/bounding-volume.ts +38 -0
  302. package/src/culling/lib/bounding-volumes/oriented-bounding-box.ts +320 -0
  303. package/src/culling/lib/culling-volume.ts +163 -0
  304. package/src/culling/lib/perspective-frustum.ts +288 -0
  305. package/src/culling/lib/perspective-off-center-frustum.ts +381 -0
  306. package/src/culling/lib/plane.ts +118 -0
  307. package/src/culling/lib/ray.ts +33 -0
  308. package/src/culling/lib/shapes/box-shape.ts +78 -0
  309. package/src/culling/lib/shapes/capsule-shape.ts +232 -0
  310. package/src/culling/lib/shapes/cylinder-shape.ts +133 -0
  311. package/src/culling/lib/shapes/implicit-shape.ts +209 -0
  312. package/src/culling/lib/shapes/plane-shape.ts +78 -0
  313. package/src/culling/lib/shapes/sphere-shape.ts +60 -0
  314. package/src/culling/oriented-box-2d.ts +165 -0
  315. package/src/culling/queries.ts +332 -0
  316. package/src/curves/bezier-curves.ts +62 -0
  317. package/src/curves/catmull-rom-curve.ts +89 -0
  318. package/src/curves/curve-arc-length.ts +70 -0
  319. package/src/curves/curve.ts +96 -0
  320. package/src/curves/hermite-curve.ts +34 -0
  321. package/src/curves/index.ts +15 -0
  322. package/src/geometries/box-geometry.ts +1 -1
  323. package/src/geometries/capsule-geometry.ts +1 -1
  324. package/src/geometries/cylinder-geometry.ts +1 -1
  325. package/src/geometries/geometry-helpers.ts +1 -1
  326. package/src/geometries/ico-sphere-geometry.ts +1 -1
  327. package/src/geometries/plane-geometry.ts +1 -1
  328. package/src/geometries/primitive-mesh-builder.ts +84 -0
  329. package/src/geometries/prism-geometry.ts +57 -0
  330. package/src/geometries/ring-geometry.ts +102 -0
  331. package/src/geometries/sphere-geometry.ts +1 -1
  332. package/src/geometries/surface-of-revolution.ts +1 -1
  333. package/src/geometries/truncated-cone-geometry.ts +1 -1
  334. package/src/index.ts +175 -1
  335. package/src/lib/geometry-utils.ts +2 -2
  336. package/src/lib/geometry.ts +2 -2
  337. package/src/lib/hinge-tree.ts +170 -0
  338. package/src/parametric/lathe-geometry.ts +70 -0
  339. package/src/parametric/parametric-geometry.ts +118 -0
  340. package/src/parametric/torus-geometry.ts +118 -0
  341. package/src/parametric.ts +9 -0
  342. package/src/polygon/clip-triangle-mesh.ts +218 -0
  343. package/src/polygon/cut-by-grid.ts +313 -0
  344. package/src/polygon/cut-by-mercator-bounds.ts +204 -0
  345. package/src/polygon/earcut.ts +798 -0
  346. package/src/polygon/index.ts +42 -0
  347. package/src/polygon/lineclip.ts +218 -0
  348. package/src/polygon/polygon-utils.ts +273 -0
  349. package/src/polygon/polygon.ts +105 -0
  350. package/src/polygon/subdivide-polyline.ts +223 -0
  351. package/src/polygon/subdivide-triangle-mesh.ts +322 -0
  352. package/src/polygon/utils.ts +50 -0
  353. package/src/spatial-index/box-index.ts +452 -0
  354. package/src/spatial-index/index.ts +20 -0
  355. package/src/spatial-index/triangle-bvh.ts +345 -0
  356. package/src/utils/attribute-compression.ts +234 -0
  357. package/src/utils/attribute-iterator.ts +28 -0
  358. package/src/utils/compute-vertex-normals.ts +63 -0
  359. package/src/utils/constants.ts +42 -0
  360. package/src/utils/coordinates.ts +8 -0
  361. package/src/utils/geometry.ts +49 -0
  362. package/src/utils/gl-type.ts +87 -0
  363. package/src/utils/index.ts +55 -0
  364. package/src/utils/interpolate-packed-attributes.ts +284 -0
  365. package/src/utils/mesh-processing.ts +377 -0
  366. package/src/utils/primitive-iterator.ts +145 -0
  367. package/src/utils/rgb565.ts +26 -0
  368. package/src/utils/typed-array-utils.ts +16 -0
@@ -0,0 +1,204 @@
1
+ // math.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
4
+
5
+ import {cutPolylineByGrid, cutPolygonByGrid} from './cut-by-grid';
6
+ import {getPointAtIndex, push} from './utils';
7
+ import type {Polygon} from './cut-by-grid';
8
+ import type {NumericArray} from '@math.gl/core';
9
+
10
+ // https://en.wikipedia.org/wiki/Web_Mercator_projection
11
+ const DEFAULT_MAX_LATITUDE = 85.051129;
12
+
13
+ /** https://user-images.githubusercontent.com/2059298/78465769-938b7a00-76ae-11ea-9b95-1f4c26425ab9.png */
14
+ export function cutPolylineByMercatorBounds(
15
+ positions: Readonly<NumericArray>,
16
+ options?: {
17
+ size?: number;
18
+ startIndex?: number;
19
+ endIndex?: number;
20
+ normalize?: boolean;
21
+ }
22
+ ): number[][] {
23
+ const {size = 2, startIndex = 0, endIndex = positions.length, normalize = true} = options || {};
24
+
25
+ // Remap longitudes so that each segment takes the shorter path
26
+ const newPositions = positions.slice(startIndex, endIndex);
27
+ wrapLongitudesForShortestPath(newPositions, size, 0, endIndex - startIndex);
28
+
29
+ const parts = cutPolylineByGrid(newPositions, {
30
+ size,
31
+ broken: true,
32
+ gridResolution: 360,
33
+ gridOffset: [-180, -180]
34
+ }) as number[][];
35
+
36
+ if (normalize) {
37
+ // Each part is guaranteed to be in a single copy of the world
38
+ // Map longitudes back to [-180, 180]
39
+ for (const part of parts) {
40
+ shiftLongitudesIntoRange(part, size);
41
+ }
42
+ }
43
+ return parts;
44
+ }
45
+
46
+ /** https://user-images.githubusercontent.com/2059298/78465770-94241080-76ae-11ea-809a-6a8534dac1d9.png */
47
+ export function cutPolygonByMercatorBounds(
48
+ positions: Readonly<NumericArray>,
49
+ holeIndices: Readonly<NumericArray> | null = null,
50
+ options?: {
51
+ size?: number;
52
+ normalize?: boolean;
53
+ maxLatitude?: number;
54
+ edgeTypes?: boolean;
55
+ }
56
+ ): Polygon[] {
57
+ const {size = 2, normalize = true, edgeTypes = false} = options || {};
58
+ holeIndices = holeIndices || [];
59
+ const newPositions: number[] = [];
60
+ const newHoleIndices: number[] = [];
61
+ let srcStartIndex = 0;
62
+ let targetIndex = 0;
63
+
64
+ for (let ringIndex = 0; ringIndex <= holeIndices.length; ringIndex++) {
65
+ // srcStartIndex/srcEndIndex define the ring in the original positions
66
+ const srcEndIndex = holeIndices[ringIndex] || positions.length;
67
+ // targetStartIndex/targetIndex define the ring in newPositions
68
+ const targetStartIndex = targetIndex;
69
+
70
+ // In case the ring contains a pole (e.g. Antarctica), we'll have to insert vertices
71
+ // The insertion point is defined by the vertex closest to the pole
72
+ // Split the the ring by the insertion point when copying to newPositions
73
+ const splitIndex = findSplitIndex(positions, size, srcStartIndex, srcEndIndex);
74
+ for (let i = splitIndex; i < srcEndIndex; i++) {
75
+ newPositions[targetIndex++] = positions[i];
76
+ }
77
+ for (let i = srcStartIndex; i < splitIndex; i++) {
78
+ newPositions[targetIndex++] = positions[i];
79
+ }
80
+
81
+ // Remap longitudes so that each segment takes the shorter path
82
+ wrapLongitudesForShortestPath(newPositions, size, targetStartIndex, targetIndex);
83
+
84
+ // Handle the case when the ring contains a pole
85
+ insertPoleVertices(newPositions, size, targetStartIndex, targetIndex, options?.maxLatitude);
86
+
87
+ srcStartIndex = srcEndIndex;
88
+ newHoleIndices[ringIndex] = targetIndex;
89
+ }
90
+ newHoleIndices.pop();
91
+
92
+ const parts = cutPolygonByGrid(newPositions, newHoleIndices, {
93
+ size,
94
+ gridResolution: 360,
95
+ gridOffset: [-180, -180],
96
+ edgeTypes
97
+ });
98
+
99
+ if (normalize) {
100
+ // Each part is guaranteed to be in a single copy of the world
101
+ // Map longitudes back to [-180, 180]
102
+ for (const part of parts) {
103
+ // May mutate newPositions, which is created by us.
104
+ shiftLongitudesIntoRange(part.positions as NumericArray, size);
105
+ }
106
+ }
107
+ return parts;
108
+ }
109
+
110
+ /* Helpers */
111
+
112
+ // See comments for insertPoleVertices
113
+ function findSplitIndex(
114
+ positions: Readonly<NumericArray>,
115
+ size: number,
116
+ startIndex: number,
117
+ endIndex: number
118
+ ): number {
119
+ let maxLat = -1;
120
+ let pointIndex = -1;
121
+ for (let i = startIndex + 1; i < endIndex; i += size) {
122
+ const lat = Math.abs(positions[i]);
123
+ if (lat > maxLat) {
124
+ maxLat = lat;
125
+ pointIndex = i - 1;
126
+ }
127
+ }
128
+ return pointIndex;
129
+ }
130
+
131
+ // https://user-images.githubusercontent.com/2059298/78857483-5987e400-79de-11ea-98fc-0631287a8431.png
132
+ //
133
+ // If the polygon contains a pole, to tesselate it correctly, we need to insert the edge
134
+ // of map into the polygon. This requires adding two vertices that represent the pole, by
135
+ // drawing a perpendicular line to the Mercator map edge from a selected vertex on the ring.
136
+ //
137
+ // We select the insertion position carefully so that the inserted line segments do not
138
+ // intersect with the ring itself. This is ensured by findSplitIndex, which returns the
139
+ // vertex closest to the pole.
140
+ function insertPoleVertices(
141
+ positions: number[],
142
+ size: number,
143
+ startIndex: number,
144
+ endIndex: number,
145
+ maxLatitude: number = DEFAULT_MAX_LATITUDE
146
+ ): void {
147
+ // Check if the ring contains a pole
148
+ const firstLng = positions[startIndex];
149
+ const lastLng = positions[endIndex - size];
150
+ if (Math.abs(firstLng - lastLng) > 180) {
151
+ // The ring does not make a round trip
152
+ // Add the nearest pole to the vertices so that the polygon tesselates correctly
153
+ const p = getPointAtIndex(positions, 0, size, startIndex);
154
+ // Copy the first vertex to the world of the last vertex
155
+ p[0] += Math.round((lastLng - firstLng) / 360) * 360;
156
+ push(positions, p);
157
+ // Project the copied vertex to the edge of the map
158
+ p[1] = Math.sign(p[1]) * maxLatitude;
159
+ push(positions, p);
160
+ // Project the first vertex to the edge of the map
161
+ p[0] = firstLng;
162
+ push(positions, p);
163
+ }
164
+ }
165
+
166
+ function wrapLongitudesForShortestPath(
167
+ positions: NumericArray,
168
+ size: number,
169
+ startIndex: number,
170
+ endIndex: number
171
+ ): void {
172
+ let prevLng: number = positions[0];
173
+ let lng: number;
174
+ for (let i = startIndex; i < endIndex; i += size) {
175
+ lng = positions[i];
176
+ const delta = lng - prevLng;
177
+ if (delta > 180 || delta < -180) {
178
+ lng -= Math.round(delta / 360) * 360;
179
+ }
180
+ positions[i] = prevLng = lng;
181
+ }
182
+ }
183
+
184
+ function shiftLongitudesIntoRange(positions: NumericArray, size: number): void {
185
+ let refLng: number;
186
+ const pointCount = positions.length / size;
187
+
188
+ // Find a longitude that is not on the edge of a world
189
+ // Which we will use to determine which world copy it is
190
+ for (let i = 0; i < pointCount; i++) {
191
+ refLng = positions[i * size];
192
+ if ((refLng + 180) % 360 !== 0) {
193
+ break;
194
+ }
195
+ }
196
+
197
+ const delta = -Math.round(refLng / 360) * 360;
198
+ if (delta === 0) {
199
+ return;
200
+ }
201
+ for (let i = 0; i < pointCount; i++) {
202
+ positions[i * size] += delta;
203
+ }
204
+ }