@loaders.gl/tiles 5.0.0-alpha.1 → 5.0.0-alpha.10

package/LICENSE

@@ -24,8 +24,20 @@ THE SOFTWARE.
 
 Copyright (c) 2015 Uber Technologies, Inc.
 
-loaders.gl includes certain files from Cesium (https://github.com/AnalyticalGraphicsInc/cesium) 
-under the  Apache 2 License (found in the submodule: modules/3d-tiles):)
+Portions of modules/images/src/lib/category-api/binary-image-api.ts are based on
+binary-gltf-utils (https://github.com/Qantas94Heavy/binary-gltf-utils) under the
+MIT License reproduced above.
+
+Copyright (c) 2016-17 Karl Cheng
+
+Portions of modules/schema-utils/src/lib/utils/async-queue.ts are adapted from
+async-iter-demo (https://github.com/rauschma/async-iter-demo) under the MIT
+License reproduced above.
+
+Copyright (c) 2016 Axel Rauschmayer
+
+loaders.gl includes certain files from Cesium (https://github.com/CesiumGS/cesium)
+under the Apache 2.0 License, including files in modules/3d-tiles.
 
 Copyright 2011-2018 CesiumJS Contributors
 
@@ -38,4 +50,3 @@ Unless required by applicable law or agreed to in writing, software
 distributed under the License is distributed on an "AS IS" BASIS,
 WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 See the License for the specific language governing permissions and limitations under the License.
-

package/README.md

@@ -38,6 +38,32 @@ The shared `Tileset3DSource` contract owns:
 
 `Tileset3D` remains responsible for traversal, culling, request scheduling, selection, and cache management.
 
+### Camera-independent content traversal
+
+Conversion and inspection jobs can visit the complete dataset without creating a viewport:
+
+```ts
+import {traverseTilesetContents} from '@loaders.gl/tiles';
+
+for await (const {tile, contents} of traverseTilesetContents(tileset, {signal})) {
+  // `contents` preserves the tile's declared content order.
+  processTile(tile, contents);
+}
+```
+
+The traversal follows declared placements in depth-first order, resolves lazy 3D Tiles subtrees and
+I3S child headers through their source, and visits nested tilesets before descending into them.
+Repeated resource URLs remain separate visits when they appear at different placements, since each
+placement can have its own transform. By default, the caller owns loaded-content lifetime and
+should unload or destroy the tileset when processing completes.
+
+Pass `{signal, unloadContent: true}` with a runtime dedicated to traversal to unload newly read
+content when the iterator advances or closes, including on cancellation and errors. Preloaded
+content is retained. Finish processing each placement before requesting the next one; do not retain
+payloads or concurrently update the runtime. Tile placements and children remain available, and the
+caller still owns tileset destruction and source/archive lifetimes. This limits content retention,
+not decoder allocations, source caches, or the full dataset's metadata.
+
 For broader documentation please visit the [website](https://loaders.gl).
 
 ## Tileset2D