@loaders.gl/tile-converter 5.0.0-alpha.10 → 5.0.0-alpha.11

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 (55) hide show
  1. package/README.md +33 -0
  2. package/dist/converter.min.cjs +103 -103
  3. package/dist/i3s-server/bin/i3s-server.min.cjs +1 -1
  4. package/dist/index.cjs +651 -547
  5. package/dist/index.js +641 -537
  6. package/dist/v5/adapters.cjs +1756 -200
  7. package/dist/v5/adapters.d.ts +13 -2
  8. package/dist/v5/adapters.js +1755 -190
  9. package/dist/v5/browser.cjs +12 -0
  10. package/dist/v5/browser.d.ts +12 -2
  11. package/dist/v5/browser.js +19 -1
  12. package/dist/v5/core.cjs +54 -0
  13. package/dist/v5/core.js +54 -0
  14. package/dist/v5/i3s-mesh-conversion.d.ts +10 -4
  15. package/dist/v5/i3s-mesh-sink.d.ts +25 -0
  16. package/dist/v5/i3s-mesh-source-features.d.ts +13 -0
  17. package/dist/v5/i3s-mesh-source-material.d.ts +5 -0
  18. package/dist/v5/i3s-mesh-source.d.ts +30 -0
  19. package/dist/v5/index.cjs +10 -0
  20. package/dist/v5/index.d.ts +10 -2
  21. package/dist/v5/index.js +17 -1
  22. package/dist/v5/mesh-conversion.d.ts +11 -2
  23. package/dist/v5/mesh-features.d.ts +9 -0
  24. package/dist/v5/mesh-source-texture.d.ts +2 -0
  25. package/dist/v5/mesh-source.d.ts +8 -1
  26. package/dist/v5/mesh.d.ts +6 -1
  27. package/dist/v5/point-cloud-source-encoder.d.ts +4 -7
  28. package/dist/v5/point-cloud-spatial.d.ts +22 -0
  29. package/dist/v5/point-cloud-tileset-sink.d.ts +28 -0
  30. package/dist/v5/point-cloud.d.ts +26 -1
  31. package/dist/v5/resource-fetcher.d.ts +18 -0
  32. package/dist/v5/spatial-conversion.d.ts +3 -1
  33. package/package.json +23 -23
  34. package/src/v5/adapters.ts +21 -2
  35. package/src/v5/browser.ts +36 -2
  36. package/src/v5/i3s-mesh-conversion.ts +58 -18
  37. package/src/v5/i3s-mesh-sink.ts +351 -0
  38. package/src/v5/i3s-mesh-source-features.ts +279 -0
  39. package/src/v5/i3s-mesh-source-material.ts +157 -0
  40. package/src/v5/i3s-mesh-source.ts +227 -0
  41. package/src/v5/index.ts +34 -2
  42. package/src/v5/mesh-conversion.ts +41 -11
  43. package/src/v5/mesh-draco.ts +47 -3
  44. package/src/v5/mesh-features.ts +319 -0
  45. package/src/v5/mesh-source-features.ts +37 -6
  46. package/src/v5/mesh-source-texture.ts +47 -0
  47. package/src/v5/mesh-source.ts +83 -21
  48. package/src/v5/mesh.ts +16 -7
  49. package/src/v5/point-cloud-conversion.ts +9 -1
  50. package/src/v5/point-cloud-source-encoder.ts +31 -20
  51. package/src/v5/point-cloud-spatial.ts +280 -0
  52. package/src/v5/point-cloud-tileset-sink.ts +234 -0
  53. package/src/v5/point-cloud.ts +159 -32
  54. package/src/v5/resource-fetcher.ts +110 -0
  55. package/src/v5/spatial-conversion.ts +84 -0
package/README.md CHANGED
@@ -475,3 +475,36 @@ error in the supplied budget. This sink does not infer source LOD relationships
475
475
  The [browser example](../../examples/website/i3s-slpk/README.md) demonstrates up to 64
476
476
  selected leaf contents, aggregate transport/decoded byte gates, download and incremental
477
477
  preview. SLPK still uses the single-mesh sink; multi-node I3S authoring is a separate increment.
478
+
479
+
480
+ ### Source CRS preparation
481
+
482
+ Both mesh codecs accept `createI3SConversionSpatialContext` for selected absolute I3S
483
+ geometry. Its `transformGeometryAsync` keeps positions in Float64 through unit, elevation,
484
+ and CRS operations before destination writers rebase to float32 and check precision.
485
+ Use the explicit I3S `normalReferenceFrame` when its vectors use a local ENU basis.
486
+
487
+ Point-source conversion accepts the same context as `spatialContext`. Cartesian affine
488
+ placement or longitude/latitude offsets are resolved before the CRS operation;
489
+ `getTileEncodingOptions` then receives the prepared target-frame tile for RTC selection.
490
+ The direct async `transformPointCloudSourceTile` helper supports separate preparation.
491
+ Source metadata must agree with the context. For already transformed ECEF content, a native
492
+ EPSG:4978 context can flatten renderer placement without repeating the source operation.
493
+ Ambiguous renderer coordinates fail explicitly. See the [v5 API guide](../../docs/modules/tile-converter/api-reference/v5-conversion.md)
494
+ for supported layouts, normal frames, and application-owned spatial resources.
495
+
496
+ ### Original I3S mesh input
497
+
498
+ The v5 adapters export `createI3SMeshTilesetConversionSource` for a selected
499
+ I3S mesh profile. Use a dedicated source-backed runtime with `i3s.geometryMode: 'source'`
500
+ to retain absolute Float64 source coordinates and original normals. Pair the GLB codec
501
+ with `autoOrigin: true` to choose the placement origin after spatial transformation.
502
+ One encoded PNG/JPEG base-color texture and explicit wrapping are preserved without decoding
503
+ pixels. `features` reads standard scalar/string attribute resources into a caller-declared Arrow
504
+ schema using an `objectIdProperty`, optional `sourceFeatureIdProperty` and `maxAttributeBytes`.
505
+ Signed/unsigned 64-bit properties retain exact bigint values; triangle ownership must be complete.
506
+ Supply `readExternalResource` for external textures/attributes, including byte limits, archive
507
+ resolution, authentication and decompression. `getFeatures` remains the custom alternative.
508
+ Unsupported atlas regions, colors, richer maps, domains/dates and layouts fail explicitly.
509
+ See the v5 conversion API reference for the exact source profile and an example mapping.
510
+ See the [v5 conversion reference](../../docs/modules/tile-converter/api-reference/v5-conversion.md).