@loaders.gl/scene 5.0.0-beta.1 → 5.0.0-beta.10

package/DRACO-README.md

@@ -0,0 +1,15 @@
+# @loaders.gl/scene
+
+Draco compressed mesh and point cloud loaders and writers.
+
+Supported formats: Draco.
+
+`DracoLoader` returns a Mesh Arrow table by default. Set `draco.shape: 'mesh'` for the legacy
+Mesh object shape.
+
+For documentation please visit the [website](https://loaders.gl).
+
+## Sources and credits
+
+See [THIRD-PARTY-NOTICES.md](./THIRD-PARTY-NOTICES.md) for implementation lineage
+and applicable notices, and the project-wide [Attributions and Credits](https://loaders.gl/docs/references-and-credits).

package/GLTF-README.md

@@ -43,4 +43,4 @@ For documentation please visit the [website](https://loaders.gl).
 ## Sources and credits
 
 See [THIRD-PARTY-NOTICES.md](./THIRD-PARTY-NOTICES.md) for implementation lineage
-and applicable notices, and the project-wide [References and credits](https://loaders.gl/docs/references-and-credits).
+and applicable notices, and the project-wide [Attributions and Credits](https://loaders.gl/docs/references-and-credits).

package/OBJ-README.md

@@ -25,4 +25,4 @@ all copies or substantial portions of the Software.
 ## Sources and credits
 
 See [THIRD-PARTY-NOTICES.md](./THIRD-PARTY-NOTICES.md) for implementation lineage
-and applicable notices, and the project-wide [References and credits](https://loaders.gl/docs/references-and-credits).
+and applicable notices, and the project-wide [Attributions and Credits](https://loaders.gl/docs/references-and-credits).

package/README.md

@@ -1,6 +1,8 @@
 # @loaders.gl/scene
 
-Framework-independent loaders for scene description formats.
+glTF, GLB, OBJ, MTL, and OpenUSD scene loaders and writers.
+
+Supported formats: glTF, GLB, OBJ, MTL, OpenUSD, USD, USDA, USDZ. OpenUSD support covers ASCII USDA and uncompressed USDZ archives with an ASCII root layer.
 
 ## Installation
 
@@ -25,4 +27,13 @@ crate layers are not yet supported.
 ## Sources and credits
 
 See [THIRD-PARTY-NOTICES.md](./THIRD-PARTY-NOTICES.md) for implementation lineage
-and applicable notices, and the project-wide [References and credits](https://loaders.gl/docs/references-and-credits).
+and applicable notices, and the project-wide [Attributions and Credits](https://loaders.gl/docs/references-and-credits).
+
+## Draco geometry
+
+`DracoLoader` metadata is available from the scene root. Import `DracoLoaderWithParser` from `@loaders.gl/scene/draco-loader` for direct parsing, `DracoWriter` and encoding helpers from `@loaders.gl/scene/draco-writer`, and `getDracoLibraryOptions` from `@loaders.gl/scene/draco-library-options` for bundled runtime URLs. Draco supports both meshes and point clouds.
+
+
+- [USD and USDC format guide](https://loaders.gl/docs/modules/scene/usd/formats/usd): format, usage, feature support and output contract.
+
+- [STL format guide](https://loaders.gl/docs/modules/scene/stl): format, usage, feature support and output contract.

package/THIRD-PARTY-NOTICES.md

@@ -4,7 +4,7 @@ Scene loaders are developed by vis.gl contributors against OpenUSD/USDZ format d
 
 Benjamin Wasty's [gltf-loader-ts](https://github.com/bwasty/gltf-loader-ts) supplied adapted schema types in [gltf-json-schema.ts](./src/gltf/lib/types/gltf-json-schema.ts): [full MIT license](./third-party-licenses/gltf-loader-ts-LICENSE).
 
-Arseny Kapoulkine and meshoptimizer contributors supply the vendored meshopt decoder 1.3.0: [source/version/checksum](./src/gltf/libs/README.md) and [MIT license](./src/gltf/libs/meshoptimizer-LICENSE.md). Google Draco and Binomial Basis Universal are credited in their owning packages. Khronos and its contributors develop the glTF specification and extensions.
+Arseny Kapoulkine and meshoptimizer contributors supply the vendored meshopt decoder 1.3.0: [source/version/checksum](./src/gltf/libs/README.md) and [MIT license](./src/gltf/libs/meshoptimizer-LICENSE.md). Binomial Basis Universal is credited in the images package. Khronos and its contributors develop the glTF specification and extensions.
 
 Ricardo Cabello (mrdoob) and the three.js contributors supplied the OBJLoader implementation adapted in [parse-obj-meshes.ts](./src/obj/lib/parse-obj-meshes.ts). The port changes integration and output representation for loaders.gl. [Full three.js MIT license](./third-party-licenses/three-LICENSE).
 
@@ -21,3 +21,12 @@ historical ports are identified by retained source and Git history; no upstream
 version is inferred from a current dependency. Keep copyright headers, full
 terms, source/version information and material modification notes when updating.
 Retain this file and the applicable licenses when redistributing bundles or workers.
+## Draco
+
+Google’s [Draco](https://github.com/google/draco) supplies encoding and decoding, including adapted Web IDL types. Vendored runtimes are pinned to 1.5.7; see [versions, sources and checksums](./src/draco/libs/README.md). Retain the [Apache-2.0 license](./src/draco/libs/DRACO-LICENSE) with runtime and worker distributions.
+
+## Binary OpenUSD
+
+The dependency-free USDC decoder is adapted from THREE.js r187. See
+[src/usd/libs/README.md](./src/usd/libs/README.md) for source and modifications,
+and retain [MIT terms](./src/usd/libs/THREE-LICENSE) with distributions.