@loaders.gl/raster 0.0.0-stage → 5.0.0-alpha.13

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 (379) hide show
  1. package/README.md +60 -2
  2. package/dist/geotiff/advanced.cjs +1955 -0
  3. package/dist/geotiff/advanced.cjs.map +7 -0
  4. package/dist/geotiff/advanced.d.ts +13 -0
  5. package/dist/geotiff/advanced.d.ts.map +1 -0
  6. package/dist/geotiff/advanced.js +12 -0
  7. package/dist/geotiff/advanced.js.map +1 -0
  8. package/dist/geotiff/bundled.d.ts +3 -0
  9. package/dist/geotiff/bundled.d.ts.map +1 -0
  10. package/dist/geotiff/bundled.js +5 -0
  11. package/dist/geotiff/bundled.js.map +1 -0
  12. package/dist/geotiff/discover-geotiff.d.ts +14 -0
  13. package/dist/geotiff/discover-geotiff.d.ts.map +1 -0
  14. package/dist/geotiff/discover-geotiff.js +63 -0
  15. package/dist/geotiff/discover-geotiff.js.map +1 -0
  16. package/dist/geotiff/geotiff-format.d.ts +21 -0
  17. package/dist/geotiff/geotiff-format.d.ts.map +1 -0
  18. package/dist/geotiff/geotiff-format.js +24 -0
  19. package/dist/geotiff/geotiff-format.js.map +1 -0
  20. package/dist/geotiff/geotiff-loader-types.d.ts +63 -0
  21. package/dist/geotiff/geotiff-loader-types.d.ts.map +1 -0
  22. package/dist/geotiff/geotiff-loader-types.js +26 -0
  23. package/dist/geotiff/geotiff-loader-types.js.map +1 -0
  24. package/dist/geotiff/geotiff-loader.d.ts +49 -0
  25. package/dist/geotiff/geotiff-loader.d.ts.map +1 -0
  26. package/dist/geotiff/geotiff-loader.js +70 -0
  27. package/dist/geotiff/geotiff-loader.js.map +1 -0
  28. package/dist/geotiff/geotiff-raster-loader-types.d.ts +37 -0
  29. package/dist/geotiff/geotiff-raster-loader-types.d.ts.map +1 -0
  30. package/dist/geotiff/geotiff-raster-loader-types.js +24 -0
  31. package/dist/geotiff/geotiff-raster-loader-types.js.map +1 -0
  32. package/dist/geotiff/geotiff-raster-loader.d.ts +22 -0
  33. package/dist/geotiff/geotiff-raster-loader.d.ts.map +1 -0
  34. package/dist/geotiff/geotiff-raster-loader.js +65 -0
  35. package/dist/geotiff/geotiff-raster-loader.js.map +1 -0
  36. package/dist/geotiff/geotiff-raster-types.d.ts +65 -0
  37. package/dist/geotiff/geotiff-raster-types.d.ts.map +1 -0
  38. package/dist/geotiff/geotiff-raster-types.js +5 -0
  39. package/dist/geotiff/geotiff-raster-types.js.map +1 -0
  40. package/dist/geotiff/geotiff-source-loader-types.d.ts +67 -0
  41. package/dist/geotiff/geotiff-source-loader-types.d.ts.map +1 -0
  42. package/dist/geotiff/geotiff-source-loader-types.js +43 -0
  43. package/dist/geotiff/geotiff-source-loader-types.js.map +1 -0
  44. package/dist/geotiff/geotiff-source-loader.d.ts +132 -0
  45. package/dist/geotiff/geotiff-source-loader.d.ts.map +1 -0
  46. package/dist/geotiff/geotiff-source-loader.js +1322 -0
  47. package/dist/geotiff/geotiff-source-loader.js.map +1 -0
  48. package/dist/geotiff/index.d.ts +3 -0
  49. package/dist/geotiff/index.d.ts.map +1 -0
  50. package/dist/geotiff/index.js +6 -0
  51. package/dist/geotiff/index.js.map +1 -0
  52. package/dist/geotiff/lib/load-geotiff.d.ts +28 -0
  53. package/dist/geotiff/lib/load-geotiff.d.ts.map +1 -0
  54. package/dist/geotiff/lib/load-geotiff.js +61 -0
  55. package/dist/geotiff/lib/load-geotiff.js.map +1 -0
  56. package/dist/geotiff/lib/ome/load-ome-tiff.d.ts +50 -0
  57. package/dist/geotiff/lib/ome/load-ome-tiff.d.ts.map +1 -0
  58. package/dist/geotiff/lib/ome/load-ome-tiff.js +42 -0
  59. package/dist/geotiff/lib/ome/load-ome-tiff.js.map +1 -0
  60. package/dist/geotiff/lib/ome/ome-indexers.d.ts +12 -0
  61. package/dist/geotiff/lib/ome/ome-indexers.d.ts.map +1 -0
  62. package/dist/geotiff/lib/ome/ome-indexers.js +109 -0
  63. package/dist/geotiff/lib/ome/ome-indexers.js.map +1 -0
  64. package/dist/geotiff/lib/ome/ome-utils.d.ts +32 -0
  65. package/dist/geotiff/lib/ome/ome-utils.d.ts.map +1 -0
  66. package/dist/geotiff/lib/ome/ome-utils.js +67 -0
  67. package/dist/geotiff/lib/ome/ome-utils.js.map +1 -0
  68. package/dist/geotiff/lib/ome/omexml.d.ts +49 -0
  69. package/dist/geotiff/lib/ome/omexml.d.ts.map +1 -0
  70. package/dist/geotiff/lib/ome/omexml.js +63 -0
  71. package/dist/geotiff/lib/ome/omexml.js.map +1 -0
  72. package/dist/geotiff/lib/ome/utils.d.ts +7 -0
  73. package/dist/geotiff/lib/ome/utils.d.ts.map +1 -0
  74. package/dist/geotiff/lib/ome/utils.js +29 -0
  75. package/dist/geotiff/lib/ome/utils.js.map +1 -0
  76. package/dist/geotiff/lib/tiff/decode-tiff-samples.d.ts +34 -0
  77. package/dist/geotiff/lib/tiff/decode-tiff-samples.d.ts.map +1 -0
  78. package/dist/geotiff/lib/tiff/decode-tiff-samples.js +150 -0
  79. package/dist/geotiff/lib/tiff/decode-tiff-samples.js.map +1 -0
  80. package/dist/geotiff/lib/tiff/geotiff-decoder-adapter.d.ts +4 -0
  81. package/dist/geotiff/lib/tiff/geotiff-decoder-adapter.d.ts.map +1 -0
  82. package/dist/geotiff/lib/tiff/geotiff-decoder-adapter.js +88 -0
  83. package/dist/geotiff/lib/tiff/geotiff-decoder-adapter.js.map +1 -0
  84. package/dist/geotiff/lib/tiff/geotiff-source-adapter.d.ts +4 -0
  85. package/dist/geotiff/lib/tiff/geotiff-source-adapter.d.ts.map +1 -0
  86. package/dist/geotiff/lib/tiff/geotiff-source-adapter.js +51 -0
  87. package/dist/geotiff/lib/tiff/geotiff-source-adapter.js.map +1 -0
  88. package/dist/geotiff/lib/tiff/plan-tiff-blocks.d.ts +10 -0
  89. package/dist/geotiff/lib/tiff/plan-tiff-blocks.d.ts.map +1 -0
  90. package/dist/geotiff/lib/tiff/plan-tiff-blocks.js +101 -0
  91. package/dist/geotiff/lib/tiff/plan-tiff-blocks.js.map +1 -0
  92. package/dist/geotiff/lib/tiff/read-tiff-directory.d.ts +8 -0
  93. package/dist/geotiff/lib/tiff/read-tiff-directory.d.ts.map +1 -0
  94. package/dist/geotiff/lib/tiff/read-tiff-directory.js +219 -0
  95. package/dist/geotiff/lib/tiff/read-tiff-directory.js.map +1 -0
  96. package/dist/geotiff/lib/tiff/tiff-gdal-metadata.d.ts +8 -0
  97. package/dist/geotiff/lib/tiff/tiff-gdal-metadata.d.ts.map +1 -0
  98. package/dist/geotiff/lib/tiff/tiff-gdal-metadata.js +50 -0
  99. package/dist/geotiff/lib/tiff/tiff-gdal-metadata.js.map +1 -0
  100. package/dist/geotiff/lib/tiff/tiff-metadata.d.ts +5 -0
  101. package/dist/geotiff/lib/tiff/tiff-metadata.d.ts.map +1 -0
  102. package/dist/geotiff/lib/tiff/tiff-metadata.js +188 -0
  103. package/dist/geotiff/lib/tiff/tiff-metadata.js.map +1 -0
  104. package/dist/geotiff/lib/tiff/tiff-numeric-decoder.d.ts +40 -0
  105. package/dist/geotiff/lib/tiff/tiff-numeric-decoder.d.ts.map +1 -0
  106. package/dist/geotiff/lib/tiff/tiff-numeric-decoder.js +40 -0
  107. package/dist/geotiff/lib/tiff/tiff-numeric-decoder.js.map +1 -0
  108. package/dist/geotiff/lib/tiff/tiff-source-decoder.d.ts +103 -0
  109. package/dist/geotiff/lib/tiff/tiff-source-decoder.d.ts.map +1 -0
  110. package/dist/geotiff/lib/tiff/tiff-source-decoder.js +5 -0
  111. package/dist/geotiff/lib/tiff/tiff-source-decoder.js.map +1 -0
  112. package/dist/geotiff/lib/tiff/tiff-types.d.ts +49 -0
  113. package/dist/geotiff/lib/tiff/tiff-types.d.ts.map +1 -0
  114. package/dist/geotiff/lib/tiff/tiff-types.js +5 -0
  115. package/dist/geotiff/lib/tiff/tiff-types.js.map +1 -0
  116. package/dist/geotiff/lib/tiff-pixel-source.d.ts +17 -0
  117. package/dist/geotiff/lib/tiff-pixel-source.d.ts.map +1 -0
  118. package/dist/geotiff/lib/tiff-pixel-source.js +71 -0
  119. package/dist/geotiff/lib/tiff-pixel-source.js.map +1 -0
  120. package/dist/geotiff/lib/utils/tiff-utils.d.ts +10 -0
  121. package/dist/geotiff/lib/utils/tiff-utils.d.ts.map +1 -0
  122. package/dist/geotiff/lib/utils/tiff-utils.js +41 -0
  123. package/dist/geotiff/lib/utils/tiff-utils.js.map +1 -0
  124. package/dist/geotiff/loaders.d.ts +30 -0
  125. package/dist/geotiff/loaders.d.ts.map +1 -0
  126. package/dist/geotiff/loaders.js +53 -0
  127. package/dist/geotiff/loaders.js.map +1 -0
  128. package/dist/geotiff/ometiff-source-loader-types.d.ts +67 -0
  129. package/dist/geotiff/ometiff-source-loader-types.d.ts.map +1 -0
  130. package/dist/geotiff/ometiff-source-loader-types.js +38 -0
  131. package/dist/geotiff/ometiff-source-loader-types.js.map +1 -0
  132. package/dist/geotiff/ometiff-source-loader.d.ts +152 -0
  133. package/dist/geotiff/ometiff-source-loader.d.ts.map +1 -0
  134. package/dist/geotiff/ometiff-source-loader.js +256 -0
  135. package/dist/geotiff/ometiff-source-loader.js.map +1 -0
  136. package/dist/geotiff/types.d.ts +75 -0
  137. package/dist/geotiff/types.d.ts.map +1 -0
  138. package/dist/geotiff/types.js +5 -0
  139. package/dist/geotiff/types.js.map +1 -0
  140. package/dist/geotiff/unbundled.d.ts +3 -0
  141. package/dist/geotiff/unbundled.d.ts.map +1 -0
  142. package/dist/geotiff/unbundled.js +5 -0
  143. package/dist/geotiff/unbundled.js.map +1 -0
  144. package/dist/index.cjs +523 -0
  145. package/dist/index.cjs.map +7 -0
  146. package/dist/index.d.ts +29 -0
  147. package/dist/index.d.ts.map +1 -0
  148. package/dist/index.js +19 -0
  149. package/dist/index.js.map +1 -0
  150. package/dist/lerc/bundled.d.ts +3 -0
  151. package/dist/lerc/bundled.d.ts.map +1 -0
  152. package/dist/lerc/bundled.js +5 -0
  153. package/dist/lerc/bundled.js.map +1 -0
  154. package/dist/lerc/index.d.ts +6 -0
  155. package/dist/lerc/index.d.ts.map +1 -0
  156. package/dist/lerc/index.js +9 -0
  157. package/dist/lerc/index.js.map +1 -0
  158. package/dist/lerc/lerc-format.d.ts +11 -0
  159. package/dist/lerc/lerc-format.d.ts.map +1 -0
  160. package/dist/lerc/lerc-format.js +14 -0
  161. package/dist/lerc/lerc-format.js.map +1 -0
  162. package/dist/lerc/lerc-loader-types.d.ts +54 -0
  163. package/dist/lerc/lerc-loader-types.d.ts.map +1 -0
  164. package/dist/lerc/lerc-loader-types.js +31 -0
  165. package/dist/lerc/lerc-loader-types.js.map +1 -0
  166. package/dist/lerc/lerc-loader.d.ts +36 -0
  167. package/dist/lerc/lerc-loader.d.ts.map +1 -0
  168. package/dist/lerc/lerc-loader.js +22 -0
  169. package/dist/lerc/lerc-loader.js.map +1 -0
  170. package/dist/lerc/lerc-wasm-url.d.ts +3 -0
  171. package/dist/lerc/lerc-wasm-url.d.ts.map +1 -0
  172. package/dist/lerc/lerc-wasm-url.js +8 -0
  173. package/dist/lerc/lerc-wasm-url.js.map +1 -0
  174. package/dist/lerc/lib/parsers/lerc/lerc-types.d.ts +30 -0
  175. package/dist/lerc/lib/parsers/lerc/lerc-types.d.ts.map +1 -0
  176. package/dist/lerc/lib/parsers/lerc/lerc-types.js +5 -0
  177. package/dist/lerc/lib/parsers/lerc/lerc-types.js.map +1 -0
  178. package/dist/lerc/libs/lerc/LICENSE +101 -0
  179. package/dist/lerc/libs/lerc/NOTICE +23 -0
  180. package/dist/lerc/libs/lerc/lerc-wasm.wasm +0 -0
  181. package/dist/lerc/unbundled.d.ts +3 -0
  182. package/dist/lerc/unbundled.d.ts.map +1 -0
  183. package/dist/lerc/unbundled.js +5 -0
  184. package/dist/lerc/unbundled.js.map +1 -0
  185. package/dist/lerc/workers/lerc-worker.d.ts +2 -0
  186. package/dist/lerc/workers/lerc-worker.d.ts.map +1 -0
  187. package/dist/lerc/workers/lerc-worker.js +7 -0
  188. package/dist/lerc/workers/lerc-worker.js.map +1 -0
  189. package/dist/quantized-mesh-worker.js +17271 -0
  190. package/dist/quantized-mesh.d.ts +2 -0
  191. package/dist/quantized-mesh.d.ts.map +1 -0
  192. package/dist/quantized-mesh.js +5 -0
  193. package/dist/quantized-mesh.js.map +1 -0
  194. package/dist/terrain/bundled.d.ts +5 -0
  195. package/dist/terrain/bundled.d.ts.map +1 -0
  196. package/dist/terrain/bundled.js +6 -0
  197. package/dist/terrain/bundled.js.map +1 -0
  198. package/dist/terrain/heightmap.cjs +397 -0
  199. package/dist/terrain/heightmap.cjs.map +7 -0
  200. package/dist/terrain/heightmap.d.ts +8 -0
  201. package/dist/terrain/heightmap.d.ts.map +1 -0
  202. package/dist/terrain/heightmap.js +8 -0
  203. package/dist/terrain/heightmap.js.map +1 -0
  204. package/dist/terrain/index.cjs +1406 -0
  205. package/dist/terrain/index.cjs.map +7 -0
  206. package/dist/terrain/index.d.ts +18 -0
  207. package/dist/terrain/index.d.ts.map +1 -0
  208. package/dist/terrain/index.js +16 -0
  209. package/dist/terrain/index.js.map +1 -0
  210. package/dist/terrain/lib/decode-quantized-mesh.d.ts +59 -0
  211. package/dist/terrain/lib/decode-quantized-mesh.d.ts.map +1 -0
  212. package/dist/terrain/lib/decode-quantized-mesh.js +227 -0
  213. package/dist/terrain/lib/decode-quantized-mesh.js.map +1 -0
  214. package/dist/terrain/lib/decode-terrain-heightmap.d.ts +16 -0
  215. package/dist/terrain/lib/decode-terrain-heightmap.d.ts.map +1 -0
  216. package/dist/terrain/lib/decode-terrain-heightmap.js +52 -0
  217. package/dist/terrain/lib/decode-terrain-heightmap.js.map +1 -0
  218. package/dist/terrain/lib/delatin/index.d.ts +24 -0
  219. package/dist/terrain/lib/delatin/index.d.ts.map +1 -0
  220. package/dist/terrain/lib/delatin/index.js +409 -0
  221. package/dist/terrain/lib/delatin/index.js.map +1 -0
  222. package/dist/terrain/lib/helpers/skirt.d.ts +19 -0
  223. package/dist/terrain/lib/helpers/skirt.d.ts.map +1 -0
  224. package/dist/terrain/lib/helpers/skirt.js +127 -0
  225. package/dist/terrain/lib/helpers/skirt.js.map +1 -0
  226. package/dist/terrain/lib/parse-quantized-mesh.d.ts +15 -0
  227. package/dist/terrain/lib/parse-quantized-mesh.d.ts.map +1 -0
  228. package/dist/terrain/lib/parse-quantized-mesh.js +86 -0
  229. package/dist/terrain/lib/parse-quantized-mesh.js.map +1 -0
  230. package/dist/terrain/lib/parse-terrain.d.ts +32 -0
  231. package/dist/terrain/lib/parse-terrain.d.ts.map +1 -0
  232. package/dist/terrain/lib/parse-terrain.js +150 -0
  233. package/dist/terrain/lib/parse-terrain.js.map +1 -0
  234. package/dist/terrain/lib/terrain-contracts.d.ts +58 -0
  235. package/dist/terrain/lib/terrain-contracts.d.ts.map +1 -0
  236. package/dist/terrain/lib/terrain-contracts.js +5 -0
  237. package/dist/terrain/lib/terrain-contracts.js.map +1 -0
  238. package/dist/terrain/lib/terrain-height-field.d.ts +51 -0
  239. package/dist/terrain/lib/terrain-height-field.d.ts.map +1 -0
  240. package/dist/terrain/lib/terrain-height-field.js +260 -0
  241. package/dist/terrain/lib/terrain-height-field.js.map +1 -0
  242. package/dist/terrain/lib/terrain-height-grid.d.ts +14 -0
  243. package/dist/terrain/lib/terrain-height-grid.d.ts.map +1 -0
  244. package/dist/terrain/lib/terrain-height-grid.js +104 -0
  245. package/dist/terrain/lib/terrain-height-grid.js.map +1 -0
  246. package/dist/terrain/lib/terrain-heightmap-types.d.ts +30 -0
  247. package/dist/terrain/lib/terrain-heightmap-types.d.ts.map +1 -0
  248. package/dist/terrain/lib/terrain-heightmap-types.js +5 -0
  249. package/dist/terrain/lib/terrain-heightmap-types.js.map +1 -0
  250. package/dist/terrain/lib/terrain-neighborhood.d.ts +15 -0
  251. package/dist/terrain/lib/terrain-neighborhood.d.ts.map +1 -0
  252. package/dist/terrain/lib/terrain-neighborhood.js +58 -0
  253. package/dist/terrain/lib/terrain-neighborhood.js.map +1 -0
  254. package/dist/terrain/lib/utils/version.d.ts +2 -0
  255. package/dist/terrain/lib/utils/version.d.ts.map +1 -0
  256. package/dist/terrain/lib/utils/version.js +8 -0
  257. package/dist/terrain/lib/utils/version.js.map +1 -0
  258. package/dist/terrain/libs/README.md +10 -0
  259. package/dist/terrain/libs/martini-LICENSE +15 -0
  260. package/dist/terrain/libs/martini.d.mts +19 -0
  261. package/dist/terrain/libs/martini.mjs +164 -0
  262. package/dist/terrain/quantized-mesh-loader-types.d.ts +18 -0
  263. package/dist/terrain/quantized-mesh-loader-types.d.ts.map +1 -0
  264. package/dist/terrain/quantized-mesh-loader-types.js +26 -0
  265. package/dist/terrain/quantized-mesh-loader-types.js.map +1 -0
  266. package/dist/terrain/quantized-mesh-loader.d.ts +5 -0
  267. package/dist/terrain/quantized-mesh-loader.d.ts.map +1 -0
  268. package/dist/terrain/quantized-mesh-loader.js +31 -0
  269. package/dist/terrain/quantized-mesh-loader.js.map +1 -0
  270. package/dist/terrain/quantized-mesh-writer.d.ts +35 -0
  271. package/dist/terrain/quantized-mesh-writer.d.ts.map +1 -0
  272. package/dist/terrain/quantized-mesh-writer.js +251 -0
  273. package/dist/terrain/quantized-mesh-writer.js.map +1 -0
  274. package/dist/terrain/terrain-format.d.ts +22 -0
  275. package/dist/terrain/terrain-format.d.ts.map +1 -0
  276. package/dist/terrain/terrain-format.js +25 -0
  277. package/dist/terrain/terrain-format.js.map +1 -0
  278. package/dist/terrain/terrain-loader-types.d.ts +17 -0
  279. package/dist/terrain/terrain-loader-types.d.ts.map +1 -0
  280. package/dist/terrain/terrain-loader-types.js +33 -0
  281. package/dist/terrain/terrain-loader-types.js.map +1 -0
  282. package/dist/terrain/terrain-loader.d.ts +16 -0
  283. package/dist/terrain/terrain-loader.d.ts.map +1 -0
  284. package/dist/terrain/terrain-loader.js +58 -0
  285. package/dist/terrain/terrain-loader.js.map +1 -0
  286. package/dist/terrain/unbundled.d.ts +5 -0
  287. package/dist/terrain/unbundled.d.ts.map +1 -0
  288. package/dist/terrain/unbundled.js +6 -0
  289. package/dist/terrain/unbundled.js.map +1 -0
  290. package/dist/terrain/workers/quantized-mesh-worker.d.ts +2 -0
  291. package/dist/terrain/workers/quantized-mesh-worker.d.ts.map +1 -0
  292. package/dist/terrain/workers/quantized-mesh-worker.js +7 -0
  293. package/dist/terrain/workers/quantized-mesh-worker.js.map +1 -0
  294. package/dist/terrain/workers/terrain-worker.d.ts +2 -0
  295. package/dist/terrain/workers/terrain-worker.d.ts.map +1 -0
  296. package/dist/terrain/workers/terrain-worker.js +7 -0
  297. package/dist/terrain/workers/terrain-worker.js.map +1 -0
  298. package/dist/terrain-worker.js +18238 -0
  299. package/package.json +344 -4
  300. package/src/geotiff/advanced.ts +29 -0
  301. package/src/geotiff/bundled.ts +6 -0
  302. package/src/geotiff/discover-geotiff.ts +70 -0
  303. package/src/geotiff/geotiff-format.ts +27 -0
  304. package/src/geotiff/geotiff-loader-types.ts +50 -0
  305. package/src/geotiff/geotiff-loader.ts +107 -0
  306. package/src/geotiff/geotiff-raster-loader-types.ts +31 -0
  307. package/src/geotiff/geotiff-raster-loader.ts +85 -0
  308. package/src/geotiff/geotiff-raster-types.ts +72 -0
  309. package/src/geotiff/geotiff-source-loader-types.ts +55 -0
  310. package/src/geotiff/geotiff-source-loader.ts +1738 -0
  311. package/src/geotiff/index.ts +6 -0
  312. package/src/geotiff/lib/load-geotiff.ts +88 -0
  313. package/src/geotiff/lib/ome/load-ome-tiff.ts +55 -0
  314. package/src/geotiff/lib/ome/ome-indexers.ts +132 -0
  315. package/src/geotiff/lib/ome/ome-utils.ts +78 -0
  316. package/src/geotiff/lib/ome/omexml.ts +183 -0
  317. package/src/geotiff/lib/ome/utils.ts +43 -0
  318. package/src/geotiff/lib/tiff/decode-tiff-samples.ts +214 -0
  319. package/src/geotiff/lib/tiff/geotiff-decoder-adapter.ts +114 -0
  320. package/src/geotiff/lib/tiff/geotiff-source-adapter.ts +65 -0
  321. package/src/geotiff/lib/tiff/plan-tiff-blocks.ts +130 -0
  322. package/src/geotiff/lib/tiff/read-tiff-directory.ts +243 -0
  323. package/src/geotiff/lib/tiff/tiff-gdal-metadata.ts +59 -0
  324. package/src/geotiff/lib/tiff/tiff-metadata.ts +204 -0
  325. package/src/geotiff/lib/tiff/tiff-numeric-decoder.ts +87 -0
  326. package/src/geotiff/lib/tiff/tiff-source-decoder.ts +112 -0
  327. package/src/geotiff/lib/tiff/tiff-types.ts +56 -0
  328. package/src/geotiff/lib/tiff-pixel-source.ts +103 -0
  329. package/src/geotiff/lib/utils/Pool.ts.disabled +99 -0
  330. package/src/geotiff/lib/utils/decoder.worker.ts.disabled +21 -0
  331. package/src/geotiff/lib/utils/proxies.ts.disabled +96 -0
  332. package/src/geotiff/lib/utils/tiff-utils.ts +49 -0
  333. package/src/geotiff/loaders.ts +79 -0
  334. package/src/geotiff/ometiff-source-loader-types.ts +47 -0
  335. package/src/geotiff/ometiff-source-loader.ts +420 -0
  336. package/src/geotiff/types.ts +87 -0
  337. package/src/geotiff/unbundled.ts +6 -0
  338. package/src/index.ts +57 -0
  339. package/src/lerc/bundled.ts +6 -0
  340. package/src/lerc/index.ts +10 -0
  341. package/src/lerc/lerc-format.ts +16 -0
  342. package/src/lerc/lerc-loader-types.ts +51 -0
  343. package/src/lerc/lerc-loader.ts +41 -0
  344. package/src/lerc/lerc-wasm-url.ts +9 -0
  345. package/src/lerc/lib/parsers/lerc/lerc-types.ts +45 -0
  346. package/src/lerc/libs/lerc/LICENSE +101 -0
  347. package/src/lerc/libs/lerc/NOTICE +23 -0
  348. package/src/lerc/libs/lerc/lerc-wasm.wasm +0 -0
  349. package/src/lerc/unbundled.ts +6 -0
  350. package/src/lerc/workers/lerc-worker.ts +8 -0
  351. package/src/quantized-mesh.ts +5 -0
  352. package/src/terrain/bundled.ts +8 -0
  353. package/src/terrain/heightmap.ts +30 -0
  354. package/src/terrain/index.ts +41 -0
  355. package/src/terrain/lib/decode-quantized-mesh.ts +329 -0
  356. package/src/terrain/lib/decode-terrain-heightmap.ts +68 -0
  357. package/src/terrain/lib/delatin/index.ts +495 -0
  358. package/src/terrain/lib/helpers/skirt.ts +172 -0
  359. package/src/terrain/lib/parse-quantized-mesh.ts +122 -0
  360. package/src/terrain/lib/parse-terrain.ts +217 -0
  361. package/src/terrain/lib/terrain-contracts.ts +68 -0
  362. package/src/terrain/lib/terrain-height-field.ts +355 -0
  363. package/src/terrain/lib/terrain-height-grid.ts +157 -0
  364. package/src/terrain/lib/terrain-heightmap-types.ts +35 -0
  365. package/src/terrain/lib/terrain-neighborhood.ts +69 -0
  366. package/src/terrain/lib/utils/version.ts +8 -0
  367. package/src/terrain/libs/README.md +10 -0
  368. package/src/terrain/libs/martini-LICENSE +15 -0
  369. package/src/terrain/libs/martini.d.mts +19 -0
  370. package/src/terrain/libs/martini.mjs +164 -0
  371. package/src/terrain/quantized-mesh-loader-types.ts +44 -0
  372. package/src/terrain/quantized-mesh-loader.ts +46 -0
  373. package/src/terrain/quantized-mesh-writer.ts +380 -0
  374. package/src/terrain/terrain-format.ts +28 -0
  375. package/src/terrain/terrain-loader-types.ts +52 -0
  376. package/src/terrain/terrain-loader.ts +79 -0
  377. package/src/terrain/unbundled.ts +8 -0
  378. package/src/terrain/workers/quantized-mesh-worker.ts +8 -0
  379. package/src/terrain/workers/terrain-worker.ts +8 -0
@@ -0,0 +1,214 @@
1
+ // loaders.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
4
+
5
+ import type {TypedArray} from '@loaders.gl/core/loader-utils';
6
+ import type {TiffDirectory} from './tiff-types';
7
+ import {
8
+ getTiffDimension,
9
+ getTiffNumbers,
10
+ planTiffBlocks,
11
+ selectTiffBands
12
+ } from './plan-tiff-blocks';
13
+
14
+ /** Explicit support decision; unsupported encodings may use the compatibility decoder. */
15
+ export class UnsupportedTiffEncodingError extends Error {
16
+ /** Records why the original decoder cannot interpret this encoding. */
17
+ constructor(message: string) {
18
+ super(message);
19
+ this.name = 'UnsupportedTiffEncodingError';
20
+ }
21
+ }
22
+
23
+ /** Native planar decoding result independent of any compatibility decoder objects. */
24
+ export type TiffSampleResult = {
25
+ /** Selected raw arrays in requested original-band order. */
26
+ readonly data: TypedArray[];
27
+ /** Native window width. */
28
+ readonly width: number;
29
+ /** Native window height. */
30
+ readonly height: number;
31
+ };
32
+
33
+ /** Bounds and cancellation for a native read; complete-image decoding uses the same path. */
34
+ export type TiffSampleOptions = {
35
+ /** Native half-open pixel window; defaults to the complete image. */
36
+ readonly window?: readonly number[];
37
+ /** Original band indices; defaults to every band. */
38
+ readonly bands?: readonly number[];
39
+ /** Maximum output pixels; default 16 million. */
40
+ readonly maxPixels?: number;
41
+ /** Maximum output bytes; default 256 MiB. */
42
+ readonly maxDecodedBytes?: number;
43
+ /** Caller cancellation checked before allocation, each block, and cooperative yields. */
44
+ readonly signal?: AbortSignal;
45
+ };
46
+
47
+ /** Checks that the original decoder supports stored samples without making a fallback decision on malformed data. */
48
+ export function checkTiffEncoding(directory: TiffDirectory): void {
49
+ const compression = getTiffDimension(directory, 259, 1);
50
+ const predictor = getTiffDimension(directory, 317, 1);
51
+ const fillOrder = getTiffDimension(directory, 266, 1);
52
+ const photometric = getTiffNumbers(directory, 262)[0];
53
+ if (compression !== 1 || predictor !== 1 || fillOrder !== 1 || photometric === 6) {
54
+ throw new UnsupportedTiffEncodingError(
55
+ 'TIFF compression, predictor, bit order or YCbCr packing requires the compatibility decoder'
56
+ );
57
+ }
58
+ const bandCount = getTiffDimension(directory, 277, 1);
59
+ const bits = getTiffNumbers(directory, 258, [1]);
60
+ const formats = getTiffNumbers(directory, 339, [1]);
61
+ for (let band = 0; band < bandCount; band++)
62
+ createSampleArray(
63
+ getBandValue(bits, band, bandCount),
64
+ getBandValue(formats, band, bandCount),
65
+ 0
66
+ );
67
+ }
68
+
69
+ /** Decodes uncompressed integer/float tiles and strips directly into owned planar arrays. */
70
+ export async function decodeTiffSamples(
71
+ data: ArrayBuffer,
72
+ directory: TiffDirectory,
73
+ littleEndian: boolean,
74
+ options: TiffSampleOptions = {}
75
+ ): Promise<TiffSampleResult> {
76
+ options.signal?.throwIfAborted();
77
+ checkTiffEncoding(directory);
78
+ const bandCount = getTiffDimension(directory, 277, 1);
79
+ const bands = selectTiffBands(options.bands, bandCount);
80
+ const window = options.window ?? [
81
+ 0,
82
+ 0,
83
+ getTiffDimension(directory, 256),
84
+ getTiffDimension(directory, 257)
85
+ ];
86
+ const blocks = planTiffBlocks(directory, data.byteLength, window, bands);
87
+ const width = window[2] - window[0];
88
+ const height = window[3] - window[1];
89
+ const pixels = width * height;
90
+ const bits = getTiffNumbers(directory, 258, [1]);
91
+ const formats = getTiffNumbers(directory, 339, [1]);
92
+ const bandBytes = Array.from(
93
+ {length: bandCount},
94
+ (_, band) => getBandValue(bits, band, bandCount) / 8
95
+ );
96
+ const byteLength = pixels * bands.reduce((sum, band) => sum + bandBytes[band], 0);
97
+ const maxPixels = options.maxPixels ?? 16_000_000;
98
+ const maxBytes = options.maxDecodedBytes ?? 256 * 1024 * 1024;
99
+ if (![maxPixels, maxBytes].every(value => Number.isSafeInteger(value) && value > 0))
100
+ throw new Error('Invalid TIFF sample budgets');
101
+ if (
102
+ !Number.isSafeInteger(pixels) ||
103
+ pixels > maxPixels ||
104
+ !Number.isSafeInteger(byteLength) ||
105
+ byteLength > maxBytes
106
+ )
107
+ throw new Error('TIFF decoded output budget exceeded');
108
+ // Stored block sizes are validated before output allocation; no decoder scratch buffers are created.
109
+ const chunkyBytes = bandBytes.reduce((sum, value) => sum + value, 0);
110
+ for (const block of blocks) {
111
+ const expectedBytes =
112
+ block.width * block.height * (block.band === undefined ? chunkyBytes : bandBytes[block.band]);
113
+ if (!Number.isSafeInteger(expectedBytes) || expectedBytes !== block.byteLength)
114
+ throw new Error('Invalid uncompressed TIFF block byte count');
115
+ }
116
+ options.signal?.throwIfAborted();
117
+ const arrays = bands.map(band =>
118
+ createSampleArray(
119
+ getBandValue(bits, band, bandCount),
120
+ getBandValue(formats, band, bandCount),
121
+ pixels
122
+ )
123
+ );
124
+ let sampleOffset = 0;
125
+ const bandOffsets = bandBytes.map(byteLength => {
126
+ const offset = sampleOffset;
127
+ sampleOffset += byteLength;
128
+ return offset;
129
+ });
130
+ const view = new DataView(data);
131
+ let copiedValues = 0;
132
+ for (const block of blocks) {
133
+ options.signal?.throwIfAborted();
134
+ const firstColumn = Math.max(window[0], block.column);
135
+ const lastColumn = Math.min(window[2], block.column + block.width);
136
+ const firstRow = Math.max(window[1], block.row);
137
+ const lastRow = Math.min(window[3], block.row + block.height);
138
+ for (let row = firstRow; row < lastRow; row++) {
139
+ for (let column = firstColumn; column < lastColumn; column++) {
140
+ const storedPixel = (row - block.row) * block.width + column - block.column;
141
+ const outputPixel = (row - window[1]) * width + column - window[0];
142
+ for (let position = 0; position < bands.length; position++) {
143
+ const band = bands[position];
144
+ if (block.band !== undefined && block.band !== band) continue;
145
+ const offset =
146
+ block.offset +
147
+ storedPixel * (block.band === undefined ? chunkyBytes : bandBytes[band]) +
148
+ (block.band === undefined ? bandOffsets[band] : 0);
149
+ arrays[position][outputPixel] = readSample(
150
+ view,
151
+ offset,
152
+ getBandValue(bits, band, bandCount),
153
+ getBandValue(formats, band, bandCount),
154
+ littleEndian
155
+ );
156
+ if (++copiedValues % 32768 === 0) {
157
+ await new Promise<void>(resolve => setTimeout(resolve, 0));
158
+ options.signal?.throwIfAborted();
159
+ }
160
+ }
161
+ }
162
+ }
163
+ }
164
+ options.signal?.throwIfAborted();
165
+ return {data: arrays, width, height};
166
+ }
167
+
168
+ /** Reads a per-band tag, accepting the common scalar convention without accepting truncated arrays. */
169
+ function getBandValue(values: readonly number[], band: number, bandCount: number): number {
170
+ if (values.length !== 1 && values.length !== bandCount)
171
+ throw new Error('Invalid TIFF per-band tag length');
172
+ return values[values.length === 1 ? 0 : band];
173
+ }
174
+
175
+ /** Allocates the precise original sample representation; unsupported types never widen silently. */
176
+ function createSampleArray(bits: number, format: number, length: number): TypedArray {
177
+ if (format === 1) {
178
+ if (bits === 8) return new Uint8Array(length);
179
+ if (bits === 16) return new Uint16Array(length);
180
+ if (bits === 32) return new Uint32Array(length);
181
+ }
182
+ if (format === 2) {
183
+ if (bits === 8) return new Int8Array(length);
184
+ if (bits === 16) return new Int16Array(length);
185
+ if (bits === 32) return new Int32Array(length);
186
+ }
187
+ if (format === 3) {
188
+ if (bits === 32) return new Float32Array(length);
189
+ if (bits === 64) return new Float64Array(length);
190
+ }
191
+ throw new UnsupportedTiffEncodingError(
192
+ 'TIFF sample representation requires the compatibility decoder'
193
+ );
194
+ }
195
+
196
+ /** Reads one stored sample with explicit TIFF byte order. */
197
+ function readSample(
198
+ view: DataView,
199
+ offset: number,
200
+ bits: number,
201
+ format: number,
202
+ littleEndian: boolean
203
+ ): number {
204
+ if (format === 3)
205
+ return bits === 32
206
+ ? view.getFloat32(offset, littleEndian)
207
+ : view.getFloat64(offset, littleEndian);
208
+ if (format === 2) {
209
+ if (bits === 8) return view.getInt8(offset);
210
+ return bits === 16 ? view.getInt16(offset, littleEndian) : view.getInt32(offset, littleEndian);
211
+ }
212
+ if (bits === 8) return view.getUint8(offset);
213
+ return bits === 16 ? view.getUint16(offset, littleEndian) : view.getUint32(offset, littleEndian);
214
+ }
@@ -0,0 +1,114 @@
1
+ // loaders.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
4
+
5
+ import type {TypedArray} from '@loaders.gl/core/loader-utils';
6
+ import {waitForPromiseWithSignal} from '@loaders.gl/core/loader-utils';
7
+ import {fromArrayBuffer} from 'geotiff';
8
+ import type {TiffNumericDecoder, TiffNumericImage} from './tiff-numeric-decoder';
9
+ import type {TiffSampleOptions} from './decode-tiff-samples';
10
+ import {selectTiffBands} from './plan-tiff-blocks';
11
+
12
+ /** Compatibility backend; only this adapter exposes the library to the numeric decoder boundary. */
13
+ export async function openGeoTIFFNumericDecoder(
14
+ data: ArrayBuffer,
15
+ signal?: AbortSignal
16
+ ): Promise<TiffNumericDecoder> {
17
+ signal?.throwIfAborted();
18
+ const dataset = await waitForPromiseWithSignal(fromArrayBuffer(data, signal), signal);
19
+ const imageCount = await waitForPromiseWithSignal(dataset.getImageCount(), signal);
20
+ const images: TiffNumericImage[] = [];
21
+ for (let index = 0; index < imageCount; index++) {
22
+ signal?.throwIfAborted();
23
+ const image = await waitForPromiseWithSignal(dataset.getImage(index), signal);
24
+ const width = image.getWidth();
25
+ const height = image.getHeight();
26
+ const bandCount = image.getSamplesPerPixel();
27
+ if (
28
+ ![width, height, bandCount].every(value => Number.isSafeInteger(value) && value > 0) ||
29
+ bandCount > 65535
30
+ )
31
+ throw new Error('Invalid TIFF image dimensions or band count');
32
+ /** Applies the common output policy before compatibility decoder allocation. */
33
+ const readSamples = async (options: TiffSampleOptions = {}) => {
34
+ options.signal?.throwIfAborted();
35
+ const bands = selectTiffBands(options.bands, bandCount);
36
+ const window = options.window ?? [0, 0, width, height];
37
+ if (
38
+ window.length !== 4 ||
39
+ !window.every(value => Number.isSafeInteger(value) && value >= 0) ||
40
+ window[0] >= window[2] ||
41
+ window[1] >= window[3] ||
42
+ window[2] > width ||
43
+ window[3] > height
44
+ )
45
+ throw new Error('Invalid TIFF native window');
46
+ const outputWidth = window[2] - window[0];
47
+ const outputHeight = window[3] - window[1];
48
+ const pixelCount = outputWidth * outputHeight;
49
+ const estimatedBytes =
50
+ pixelCount *
51
+ bands.reduce(
52
+ (sum, band) =>
53
+ sum +
54
+ getCompatibilitySampleBytes(image.getSampleFormat(band), image.getBitsPerSample(band)),
55
+ 0
56
+ );
57
+ const maxPixels = options.maxPixels ?? 16_000_000;
58
+ const maxBytes = options.maxDecodedBytes ?? 256 * 1024 * 1024;
59
+ if (![maxPixels, maxBytes].every(value => Number.isSafeInteger(value) && value > 0))
60
+ throw new Error('Invalid TIFF sample budgets');
61
+ if (
62
+ !Number.isSafeInteger(pixelCount) ||
63
+ pixelCount > maxPixels ||
64
+ !Number.isSafeInteger(estimatedBytes) ||
65
+ estimatedBytes > maxBytes
66
+ )
67
+ throw new Error('TIFF decoded output budget exceeded');
68
+ const result = await waitForPromiseWithSignal(
69
+ image.readRasters({
70
+ window: [...window],
71
+ samples: bands,
72
+ interleave: false,
73
+ signal: options.signal
74
+ }),
75
+ options.signal
76
+ );
77
+ options.signal?.throwIfAborted();
78
+ const arrays = result as unknown as TypedArray[];
79
+ if (
80
+ arrays.length !== bands.length ||
81
+ result.width !== outputWidth ||
82
+ result.height !== outputHeight ||
83
+ arrays.some(array => !ArrayBuffer.isView(array) || array.length !== pixelCount) ||
84
+ arrays.reduce((sum, array) => sum + array.byteLength, 0) > maxBytes
85
+ )
86
+ throw new Error('Invalid or oversized compatibility TIFF output');
87
+ return {data: arrays, width: outputWidth, height: outputHeight};
88
+ };
89
+ images.push({
90
+ width,
91
+ height,
92
+ bandCount,
93
+ fileDirectory: {...image.getFileDirectory()},
94
+ geoKeys: image.getGeoKeys() ?? null,
95
+ metadata: image.getGDALMetadata() ?? null,
96
+ noData: image.getGDALNoData() ?? null,
97
+ bandMetadata: Array.from(
98
+ {length: bandCount},
99
+ (_, band) => image.getGDALMetadata(band) ?? null
100
+ ),
101
+ readSamples
102
+ });
103
+ }
104
+ signal?.throwIfAborted();
105
+ return {backend: 'geotiff', images};
106
+ }
107
+
108
+ /** Returns the compatibility backend's allocated sample width before decoding. */
109
+ function getCompatibilitySampleBytes(format: number, bits: number): number {
110
+ if ((format === 1 || format === 2) && Number.isInteger(bits) && bits > 0 && bits <= 32)
111
+ return bits <= 8 ? 1 : bits <= 16 ? 2 : 4;
112
+ if (format === 3 && (bits === 16 || bits === 32 || bits === 64)) return bits === 64 ? 8 : 4;
113
+ throw new Error('Unsupported compatibility TIFF sample representation');
114
+ }
@@ -0,0 +1,65 @@
1
+ // loaders.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
4
+
5
+ import {fromBlob, GeoTIFF} from 'geotiff';
6
+ import type {GeoTIFFImage} from 'geotiff';
7
+ import type {
8
+ TiffByteSource,
9
+ TiffSourceDecoder,
10
+ TiffSourceDirectory,
11
+ TiffSourceImage,
12
+ TiffRasterReadResult
13
+ } from './tiff-source-decoder';
14
+
15
+ /** Opens the compatibility source behind a library-independent region decoder facade. */
16
+ export async function openGeoTIFFSourceDecoder(
17
+ source: Blob | TiffByteSource,
18
+ signal?: AbortSignal
19
+ ): Promise<TiffSourceDecoder> {
20
+ const dataset =
21
+ source instanceof Blob
22
+ ? await fromBlob(source, signal)
23
+ : await GeoTIFF.fromSource(source, {cache: false}, signal);
24
+ const originalImages = new WeakMap<TiffSourceImage, GeoTIFFImage>();
25
+ const imageCache = new Map<number, TiffSourceImage>();
26
+ return {
27
+ getImageCount: () => dataset.getImageCount(),
28
+ /** Wraps each image once; the original image is accessible only inside this adapter. */
29
+ getImage: async (index: number) => {
30
+ const cached = imageCache.get(index);
31
+ if (cached) return cached;
32
+ const original = await dataset.getImage(index);
33
+ const image: TiffSourceImage = {
34
+ fileDirectory: {
35
+ ...original.fileDirectory,
36
+ NewSubfileType: original.fileDirectory.NewSubfileType ?? 0
37
+ } as TiffSourceDirectory,
38
+ getWidth: () => original.getWidth(),
39
+ getHeight: () => original.getHeight(),
40
+ getSamplesPerPixel: () => original.getSamplesPerPixel(),
41
+ getTileWidth: () => original.getTileWidth(),
42
+ getTileHeight: () => original.getTileHeight(),
43
+ getBitsPerSample: band => original.getBitsPerSample(band),
44
+ getSampleFormat: band => original.getSampleFormat(band),
45
+ getGeoKeys: () => original.getGeoKeys() ?? null,
46
+ getGDALMetadata: band => original.getGDALMetadata(band) ?? null,
47
+ getGDALNoData: () => original.getGDALNoData() ?? null,
48
+ getBoundingBox: () => original.getBoundingBox(),
49
+ getResolution: reference => original.getResolution(originalImages.get(reference)),
50
+ getOrigin: () => original.getOrigin(),
51
+ readRasters: async options =>
52
+ (await original.readRasters(options)) as unknown as TiffRasterReadResult
53
+ };
54
+ imageCache.set(index, image);
55
+ originalImages.set(image, original);
56
+ return image;
57
+ },
58
+ readRasters: async options =>
59
+ (await dataset.readRasters(options)) as unknown as TiffRasterReadResult,
60
+ close: async () => {
61
+ imageCache.clear();
62
+ await dataset.close();
63
+ }
64
+ };
65
+ }
@@ -0,0 +1,130 @@
1
+ // loaders.gl
2
+ // SPDX-License-Identifier: MIT
3
+ // SPDX-FileCopyrightText: Copyright (c) vis.gl contributors
4
+
5
+ import type {TiffBlock, TiffDirectory} from './tiff-types';
6
+ import {checkTiffRange} from './read-tiff-directory';
7
+
8
+ /** Reads numeric tag values, rejecting lossy conversions when an integer drives addressing. */
9
+ export function getTiffNumbers(
10
+ directory: TiffDirectory,
11
+ tag: number,
12
+ defaults: readonly number[] = []
13
+ ): number[] {
14
+ const values = directory.tags.get(tag);
15
+ if (values === undefined) return [...defaults];
16
+ if (typeof values === 'string') throw new Error(`Invalid numeric TIFF tag ${tag}`);
17
+ return values.map(value => {
18
+ const number = Number(value);
19
+ if (typeof value === 'bigint' && (!Number.isSafeInteger(number) || BigInt(number) !== value)) {
20
+ throw new Error('TIFF integer tag exceeds safe precision');
21
+ }
22
+ return number;
23
+ });
24
+ }
25
+
26
+ /** Requires one positive integer for dimensions and block geometry. */
27
+ export function getTiffDimension(
28
+ directory: TiffDirectory,
29
+ tag: number,
30
+ defaultValue?: number
31
+ ): number {
32
+ const values = getTiffNumbers(directory, tag, defaultValue === undefined ? [] : [defaultValue]);
33
+ if (
34
+ values.length !== 1 ||
35
+ !Number.isSafeInteger(values[0]) ||
36
+ values[0] <= 0 ||
37
+ (tag === 277 && values[0] > 65535)
38
+ ) {
39
+ throw new Error(`Invalid TIFF dimension tag ${tag}`);
40
+ }
41
+ return values[0];
42
+ }
43
+
44
+ /** Validates selected original bands without changing their order. */
45
+ export function selectTiffBands(bands: readonly number[] | undefined, bandCount: number): number[] {
46
+ const selected =
47
+ bands === undefined ? Array.from({length: bandCount}, (_, index) => index) : [...bands];
48
+ if (
49
+ !selected.length ||
50
+ new Set(selected).size !== selected.length ||
51
+ !selected.every(band => Number.isSafeInteger(band) && band >= 0 && band < bandCount)
52
+ ) {
53
+ throw new Error('Invalid TIFF band selection');
54
+ }
55
+ return selected;
56
+ }
57
+
58
+ /** Plans only intersecting blocks, retaining physical edge-tile strides and planar band identities. */
59
+ export function planTiffBlocks(
60
+ directory: TiffDirectory,
61
+ fileLength: number,
62
+ window: readonly number[],
63
+ bands?: readonly number[]
64
+ ): TiffBlock[] {
65
+ const imageWidth = getTiffDimension(directory, 256);
66
+ const imageHeight = getTiffDimension(directory, 257);
67
+ const bandCount = getTiffDimension(directory, 277, 1);
68
+ const selectedBands = selectTiffBands(bands, bandCount);
69
+ if (
70
+ window.length !== 4 ||
71
+ !window.every(value => Number.isSafeInteger(value) && value >= 0) ||
72
+ window[0] >= window[2] ||
73
+ window[1] >= window[3] ||
74
+ window[2] > imageWidth ||
75
+ window[3] > imageHeight
76
+ ) {
77
+ throw new Error('Invalid TIFF native window');
78
+ }
79
+ const planarConfiguration = getTiffDimension(directory, 284, 1);
80
+ if (planarConfiguration !== 1 && planarConfiguration !== 2)
81
+ throw new Error('Invalid TIFF planar configuration');
82
+ const tiled = directory.tags.has(324);
83
+ if (tiled && (directory.tags.has(273) || directory.tags.has(279)))
84
+ throw new Error('Conflicting TIFF tile and strip storage');
85
+ const blockWidth = tiled ? getTiffDimension(directory, 322) : imageWidth;
86
+ const blockHeight = tiled
87
+ ? getTiffDimension(directory, 323)
88
+ : getTiffDimension(directory, 278, imageHeight);
89
+ const columns = Math.ceil(imageWidth / blockWidth);
90
+ const rows = Math.ceil(imageHeight / blockHeight);
91
+ const blocksPerBand = columns * rows;
92
+ const expectedBlocks = blocksPerBand * (planarConfiguration === 2 ? bandCount : 1);
93
+ if (!Number.isSafeInteger(expectedBlocks)) throw new Error('Unsafe TIFF block count');
94
+ const offsets = getTiffNumbers(directory, tiled ? 324 : 273);
95
+ const lengths = getTiffNumbers(directory, tiled ? 325 : 279);
96
+ if (offsets.length !== expectedBlocks || lengths.length !== expectedBlocks)
97
+ throw new Error('Invalid TIFF block table lengths');
98
+ // Validate all descriptors, including unselected blocks; a selected read must not hide malformed metadata.
99
+ offsets.forEach((offset, index) => {
100
+ if (lengths[index] <= 0) throw new Error('Invalid TIFF block byte count');
101
+ checkTiffRange(offset, lengths[index], fileLength);
102
+ });
103
+ const blocks: TiffBlock[] = [];
104
+ for (const band of planarConfiguration === 2 ? selectedBands : [undefined]) {
105
+ for (
106
+ let rowIndex = Math.floor(window[1] / blockHeight);
107
+ rowIndex < Math.ceil(window[3] / blockHeight);
108
+ rowIndex++
109
+ ) {
110
+ for (
111
+ let columnIndex = Math.floor(window[0] / blockWidth);
112
+ columnIndex < Math.ceil(window[2] / blockWidth);
113
+ columnIndex++
114
+ ) {
115
+ const index = (band ?? 0) * blocksPerBand + rowIndex * columns + columnIndex;
116
+ const row = rowIndex * blockHeight;
117
+ blocks.push({
118
+ offset: offsets[index],
119
+ byteLength: lengths[index],
120
+ column: columnIndex * blockWidth,
121
+ row,
122
+ width: blockWidth,
123
+ height: tiled ? blockHeight : Math.min(blockHeight, imageHeight - row),
124
+ band
125
+ });
126
+ }
127
+ }
128
+ }
129
+ return blocks;
130
+ }