@loaders.gl/pointclouds 0.0.0-stage → 5.0.0-beta.10

package/LAS-README.md

@@ -0,0 +1,12 @@
+# @loaders.gl/pointclouds/las
+
+[loaders.gl](https://loaders.gl/docs) is a collection of framework-independent 3D and geospatial parsers and encoders.
+
+This module contains loaders and writers for the LAS and LAZ formats.
+
+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/LICENSE

@@ -0,0 +1,24 @@
+loaders.gl is licensed under the MIT license
+
+Copyright (c) vis.gl contributors
+Copyright (c) 2015 Uber Technologies, Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.
+
+For adapted portions, see THIRD-PARTY-NOTICES.md and the applicable upstream terms.

package/PCD-README.md

@@ -0,0 +1,12 @@
+# @loaders.gl/pointclouds/pcd
+
+[loaders.gl](https://loaders.gl/docs) is a collection of framework-independent 3D and geospatial parsers and encoders.
+
+This module contains loaders for the PCD format.
+
+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/PLY-README.md

@@ -0,0 +1,38 @@
+# @loaders.gl/pointclouds/ply
+
+[loaders.gl](https://loaders.gl/docs) is a collection of loaders for big data visualizations.
+
+This module contains loaders for the PLY format.
+
+## Gaussian splats
+
+PLY files now parse as Arrow tables by default. Gaussian Splat PLY files can use the same path:
+
+```ts
+import {parse} from '@loaders.gl/core';
+import {PLYLoader} from '@loaders.gl/pointclouds/ply';
+
+const table = await parse(arrayBuffer, PLYLoader, {
+  ply: {shape: 'arrow-table'}
+});
+
+console.log(table.data.schema.metadata.get('loaders_gl.semantic_type'));
+console.log(table.data.getChild('scale_0'));
+console.log(table.data.getChild('rot_0'));
+console.log(table.data.getChild('opacity'));
+console.log(table.data.getChild('f_dc_0'));
+```
+
+GraphDECO-style Gaussian Splat PLY files are identified with
+`loaders_gl.semantic_type: gaussian-splats` schema metadata. Field metadata records encoding
+conventions such as `loaders_gl.gaussian_splats.encoding: log` for `scale_*` columns and
+`loaders_gl.gaussian_splats.encoding: logit` for `opacity`.
+
+Set `ply.shape: 'mesh'` explicitly when legacy mesh/point-cloud data is required.
+
+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/README.md

@@ -1,3 +1,12 @@
-# Temporary Holding Version
+# @loaders.gl/pointclouds
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+LAS, LAZ, PCD, and PLY point cloud and mesh loaders and writers.
+
+Supported formats: LAS, LAZ, PCD, PLY.
+
+LAS, LAZ, PCD, and PLY loaders and writers. PLY supports both point clouds and meshes.
+
+## Sources and credits
+
+See the [pointclouds notice inventory](https://github.com/visgl/loaders.gl/blob/master/modules/pointclouds/THIRD-PARTY-NOTICES.md)
+and [Attributions and Credits](https://loaders.gl/docs/references-and-credits).

package/THIRD-PARTY-NOTICES.md

@@ -0,0 +1,27 @@
+# @loaders.gl/pointclouds: sources and credits
+
+Uday Verma and Howard Butler's [plasio](https://github.com/verma/plasio) supplies the historical LAS/LAZ parser lineage; the [laz-perf parser](./src/las/lib/laz-perf/parse-las.ts) retains that reference. Plasio's MIT terms are reproduced in [plasio-LICENSE](./third-party-licenses/plasio-LICENSE).
+
+LAZ decoding integrations use [laz-perf](https://github.com/hobuinc/laz-perf) and [laz-rs](https://github.com/laz-rs/laz-rs). Compatibility reconstruction follows LASzip by rapidlasso GmbH: [Apache-2.0 license](./src/las/lib/LASZIP-LICENSE) and [notice](./src/las/lib/LASZIP-NOTICE). Runtime/backend choices do not erase the original parser lineage. The embedded laz-rs-wasm 0.1.0 manifest credits Thomas Montaigu and Chris Lee; its exact build revision/full notice is not recorded. The legacy embedded laz-perf asset also has conflicting SPDX/comment license labels. These historical gaps are tracked in the [repository audit](https://github.com/visgl/loaders.gl/blob/master/dev-docs/attribution-audit.md); the npm backend’s current license is not used to infer the older binary’s terms.
+
+The Plasio license text is copied from [upstream license commit 2a3856699c5416b8a609ad496f22e25f5cf60315](https://github.com/verma/plasio/blob/2a3856699c5416b8a609ad496f22e25f5cf60315/LICENSE). This identifies the license source, not an inferred parser fork revision.
+
+Filipe Caixeta, Mugen87 and the three.js contributors supplied the PCDLoader implementation adapted in [parse-pcd.ts](./src/pcd/lib/parse-pcd.ts). vis.gl adapted the parser for loaders.gl outputs. [Full three.js MIT license](./third-party-licenses/three-LICENSE).
+
+The separate [LZF decompressor](./src/pcd/lib/decompress-lzf.ts) credits taketwo’s three-pcd-loader (https://gitlab.com/taketwo/three-pcd-loader). Its historical revision and full accompanying notice are not recorded locally; do not infer those from the current three.js license.
+
+Wei Meng and the three.js contributors supplied the PLYLoader foundation adapted in [parse-ply.ts](./src/ply/lib/parse-ply.ts) and [parse-ply-in-batches.ts](./src/ply/lib/parse-ply-in-batches.ts). vis.gl supplies the streaming/table integration. [Full three.js MIT license](./third-party-licenses/three-LICENSE).
+
+## Scope and maintenance
+
+Original loaders.gl contributions are covered by [LICENSE](./LICENSE). The upstream
+notices above apply to their respective portions and do not change those terms.
+Source adaptations, separately installed libraries, format definitions and test
+data are different contributions. This index is not a transitive dependency
+bill of materials. Runtime dependencies can bring additional notices.
+
+Version information is recorded where the repository preserves it. Unpinned
+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.