Docs, comments: Replace "tile set" with "tileset" (#1377)

* Update cases of "tile set" with "tileset"

* Update comments with tile set -> tileset

* Update docs

Author: gkjohnson

CHANGELOG.md

@@ -162,7 +162,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - Change `load-error` event field from `uri` to `url` as documented.
 - Fixed type definitions for some events.
 - B3DM, I3DM, PNTS Loaders: Fixed case where RTC_CENTER feature would not be parsed correctly.
-- Re-add "load-tile-set" event when child tile sets are loaded.
+- Re-add "load-tile-set" event when child tilesets are loaded.
 - Re-add url to "load-tile-set" event.
 - TMSTilesPlugin: Add support for limited bounds.
 
@@ -196,7 +196,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ### Changed
 - Internal "force-rerender" function renamed to "needs-render".
-- TilesRenderer: Move check for cameras after update traversal to enable loading the root tile set file without a camera defined.
+- TilesRenderer: Move check for cameras after update traversal to enable loading the root tileset file without a camera defined.
 
 ## [0.4.8] - 2025.04.07
 ### Fixed
@@ -207,7 +207,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - EnvironmentControls: Fixed shift key not working as expected.
 - Fixed error caused by loading a glTF file with no scenes.
 - GLTF Metadata Extensions: Fix case where an error would be thrown when non-mesh nodes are present.
-- Fixed case where tile sets with implicit tiling would not be loaded correctly if an external availability buffer was used.
+- Fixed case where tilesets with implicit tiling would not be loaded correctly if an external availability buffer was used.
 - Asynchronously process child tiles to avoid processing stalls.
 - CesiumIonPlugin: Forward "autoRefreshToken" value to GoogleCloudAuthPlugin.
 
@@ -220,7 +220,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ## [0.4.7] - 2025.03.03
 ### Added
-- GlobeControls: If no raycast intersection is fund then fallback to intersecting the tile set globe.
+- GlobeControls: If no raycast intersection is fund then fallback to intersecting the tileset globe.
 - EnvironmentControls, GlobeControls: Fix inertia calculations for orthographic cameras.
 - R3F EastNorthUpFrame: Add support for passing the ellipsoid in directly.
 - TilesRenderer.group: Added "matrixWorldInverse" field.
@@ -246,7 +246,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - Fix GLTF Metadata plugin not returning matrix values correctly.
 - TMS, XYZ Plugins: Fix case where texture would be distorted due to incorrect vertex placement when using mercator projection.
 - Case where TilesRenderer.root was not initialized before the "load-tile-set" event was fired.
-- R3F TilesRenderer: Update the tile set when a tile set is loaded.
+- R3F TilesRenderer: Update the tileset when a tileset is loaded.
 - ImageFormatPlugins: Fix plugin so it does not preclude updates incorrectly.
 - R3F TilesRenderer: Prevent reinstantiation of all child plugins, objects on options change.
 - R3F EastNorthUpFrame: Automatically update based on ellipsoid updates.
@@ -270,13 +270,13 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ## [0.4.4] - 2025.01.24
 ### Added
-- `load-error` events when model, tile set, and API token requests fail to fetch or parse.
+- `load-error` events when model, tileset, and API token requests fail to fetch or parse.
 - CanvasDOMOverlay: Add support for "ref".
 - CameraTransitionManager: Add `easeFunction` setting.
 - CameraTransitionManager: Add option to pass delta time to the update function.
 
 ### Fixed
-- Improved the behavior of `loadProgress` so it "bounces" less during loading by queueing all tiles load immediately (other than cases with external tile sets).
+- Improved the behavior of `loadProgress` so it "bounces" less during loading by queueing all tiles load immediately (other than cases with external tilesets).
 - Moved the dispatch location of "load-model", "tiles-load-start", and "tiles-load-end" so the behavior is more consistent.
 
 ## [0.4.3] - 2025.01.19
@@ -335,7 +335,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ### Changed
 - TilesFadePlugin: TilesRenderer will now fire visibility hidden events once the tile is completely faded out.
-- TilesFadePlugin: Fading tiles are now present in the tile set root rather than a sub group.
+- TilesFadePlugin: Fading tiles are now present in the tileset root rather than a sub group.
 - TileCompressionPlugin: Change the defaults to not automatically compress normals, uvs to avoid artifacts.
 - GlobeControls: Orthographic "near" margin around the globe has been increased from 10% to 25% of the large ellipsoid radius value.
 
@@ -390,7 +390,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 ## [0.3.40] - 2024.10.29
 ### Added
 - I3DMLoader: Add support for EAST_NORTH_UP semantic.
-- R3F TilesRenderer: Added `group` property for passing react properties to the root tile set object.
+- R3F TilesRenderer: Added `group` property for passing react properties to the root tileset object.
 - R3F `<CompassGizmo>` component.
 
 ### Changed
@@ -424,7 +424,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - Improve EnvironmentControls momementum thresholds so movement stops sooner.
 
 ### Fixed
-- Case where tile set scale was incorrectly used when computed screenspace error.
+- Case where tileset scale was incorrectly used when computed screenspace error.
 - Case where `setTileVisibility` could get called asymmetrically.
 - Case where `TilesFadePlugin` would hold on to scene geometry after disposal.
 
@@ -453,7 +453,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - EnvironmentControls: Added "enableDamping" option for inertial animation.
 - Ellipsoid: Added "getEastNorthUpAxes".
 - Ellipsoid: Added "getAzElRollFromRotationMatrix" and "getRotationMatrixFromAzElRoll"
-- TilesRendererBase: Tiles are now queued and sorted before triggering load to avoid only a single tile set branch loading and filling up the lru cache.
+- TilesRendererBase: Tiles are now queued and sorted before triggering load to avoid only a single tileset branch loading and filling up the lru cache.
 
 ### Changed
 - TilesOverlayPlugin: Changed constructor to take options object, instead.
@@ -497,14 +497,14 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 - GLTFStructureMetadata extension exits gracefully if no extension is present.
 
 ### Changed
-- CesiumIonTilesRenderer: Will immediately load the tile set after resolving credentials.
+- CesiumIonTilesRenderer: Will immediately load the tileset after resolving credentials.
 - Examples FadeTilesRenderer has been changed to a plugin.
 - Deprecated `GoogleTilesRenderer` and `CesiumIonTilesRenderer` in favor of using the new authentication plugins.
 - Loaders: ".load" function has been renamed to ".loadAsync".
 - Deprecated `onLoadTileset`, `onLoadModel`, `onDisposeModel`, and `onTileVisibilityChange` in favor of their event equivalents.
 - LRUCache: "unloadPriorityCallback" has been changted to take two tile arguments to sort instead of one.
 - DebugTilesRenderer has been deprecated in favor of the "DebugTilesPlugin".
-- LRU Cache unload priority function now unloads deepest tiles first, then least recently used, then non-external tile sets.
+- LRU Cache unload priority function now unloads deepest tiles first, then least recently used, then non-external tilesets.
 
 ## [0.3.35] - 2024.06.25
 ### Fixed
@@ -519,7 +519,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ## [0.3.33] - 2024.05.31
 ### Fixed
-- Remove logged error when a tile set is aborted.
+- Remove logged error when a tileset is aborted.
 - Adjusted raycast early exit behavior based on three.js r165.
 - EnvironmentControls: fix case where the dragging does not work from below
 - Remote glTF textures failing to load.
@@ -817,7 +817,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ## [0.2.1] - 2020-12-15
 ### Added
-- Support for external tile sets.
+- Support for external tilesets.
 - B3DM support for RTC_CENTER.
 
 ### Fixed

PLUGINS.md

@@ -108,7 +108,7 @@ _extends [EnvironmentControls](#environmentcontrols)_
 nearMargin = 0.25 : number
 ```
 
-The margin around the globe to include when positioning the camera near plane as a percentage of the max radius of the tile set ellipsoid. Useful for ensuring visualizations and other models are visible around the globe.
+The margin around the globe to include when positioning the camera near plane as a percentage of the max radius of the tileset ellipsoid. Useful for ensuring visualizations and other models are visible around the globe.
 
 Default is 25%.
 
@@ -118,7 +118,7 @@ Default is 25%.
 farMargin = 0 : number
 ```
 
-The margin around the globe to include when positioning the camera far plane as a percentage of the max radius of the tile set ellipsoid. Useful for ensuring visualizations and other models are visible around the globe.
+The margin around the globe to include when positioning the camera far plane as a percentage of the max radius of the tileset ellipsoid. Useful for ensuring visualizations and other models are visible around the globe.
 
 Default is 0%.
 

README.md

@@ -7,11 +7,11 @@
 
 Three.js renderer implementation for the [3D Tiles format](https://github.com/AnalyticalGraphicsInc/3d-tiles/blob/master/specification/). The renderer supports most of the 3D Tiles spec features with a few exceptions. For a list of available data sets and generation tools see the [3d Tiles resources](https://github.com/CesiumGS/3d-tiles/blob/main/RESOURCES.md) list.
 
-If a tile set or geometry does not load or render properly please make an issue! Example data is needed for adding and testing features. See the [Feature Complete Milestone](https://github.com/NASA-AMMOS/3DTilesRendererJS/milestone/1) for information on which features are not yet implemented.
+If a tileset or geometry does not load or render properly please make an issue! Example data is needed for adding and testing features. See the [Feature Complete Milestone](https://github.com/NASA-AMMOS/3DTilesRendererJS/milestone/1) for information on which features are not yet implemented.
 
 **Examples**
 
-[Dingo Gap Mars dataset with multiple tile sets](https://nasa-ammos.github.io/3DTilesRendererJS/example/bundle/mars.html)
+[Dingo Gap Mars dataset with multiple tilesets](https://nasa-ammos.github.io/3DTilesRendererJS/example/bundle/mars.html)
 
 [Kitchen sink example with all options here](https://nasa-ammos.github.io/3DTilesRendererJS/example/bundle/index.html)
 
@@ -73,7 +73,7 @@ npm install 3d-tiles-renderer --save
 
 ## Basic TilesRenderer
 
-Setting up a basic application with a 3D Tile Set.
+Setting up a basic application with a 3D Tileset.
 
 ```js
 import { TilesRenderer } from '3d-tiles-renderer';
@@ -85,7 +85,7 @@ tilesRenderer.setCamera( camera );
 tilesRenderer.setResolutionFromRenderer( camera, renderer );
 tilesRenderer.addEventListener( 'load-tile-set', () => {
 
-	// optionally center the tile set in case it's far off center
+	// optionally center the tileset in case it's far off center
 	const sphere = new Sphere();
 	tilesRenderer.getBoundingSphere( sphere );
 	tilesRenderer.group.position.copy( sphere.center ).multiplyScalar( - 1 );
@@ -111,7 +111,7 @@ function renderLoop() {
 
 ## Custom Material
 
-Setting up a 3D Tile Set using a custom material.
+Setting up a 3D Tileset using a custom material.
 
 ```js
 const tilesRenderer = new TilesRenderer( './path/to/tileset.json' );
@@ -246,7 +246,7 @@ fetch( url, { mode: 'cors' } )
 
 ## Render On Change
 
-The tile set and model load callbacks can be used to detect when the data has changed and a new render is necessary.
+The tileset and model load callbacks can be used to detect when the data has changed and a new render is necessary.
 
 ```js
 let needsRerender = true;
@@ -317,7 +317,7 @@ _extends `THREE.EventDispatcher` & [TilesRendererBase](https://github.com/NASA-A
 ### events
 
 ```js
-// Fired when a new root or child tile set is loaded.
+// Fired when a new root or child tileset is loaded.
 { type: 'load-tile-set', tileSet: Object, url: String }
 
 // Fired when a tile model is loaded.
@@ -330,7 +330,7 @@ _extends `THREE.EventDispatcher` & [TilesRendererBase](https://github.com/NASA-A
 // Fired when a tile model is disposed.
 { type: 'dispose-model', scene: THREE.Group, tile: Object }
 
-// Fired when the tile set hierarchy is ready for "update to be called
+// Fired when the tileset hierarchy is ready for "update to be called
 // again due to new content having loaded or asynchronous processing finished.
 { type: 'needs-update' }
 
@@ -346,13 +346,13 @@ _extends `THREE.EventDispatcher` & [TilesRendererBase](https://github.com/NASA-A
 // Fired when tile content begins downloading.
 { type: 'tile-download-start', tile: Object }
 
-// Fired when a tile content or the root tile set fails to load.
+// Fired when a tile content or the root tileset fails to load.
 { type: 'load-error', tile: Object | null, error: Error, url: string | URL }
 
-// Fired when a camera is added to be accounted for when traversing the tile set.
+// Fired when a camera is added to be accounted for when traversing the tileset.
 { type: 'add-camera', camera: Camera }
 
-// Fired when a camera is removed from being accounted for when traversing the tile set.
+// Fired when a camera is removed from being accounted for when traversing the tileset.
 { type: 'delete-camera', camera: Camera }
 
 // Fired when the resolution being rendered to is changed for any tracked camera.
@@ -365,7 +365,7 @@ _extends `THREE.EventDispatcher` & [TilesRendererBase](https://github.com/NASA-A
 fetchOptions = {} : Object
 ```
 
-Options passed to `fetch` when loading tile set and model data.
+Options passed to `fetch` when loading tileset and model data.
 
 ### .errorTarget
 
@@ -445,7 +445,7 @@ Queue for expanding and initializing tiles for traversal. Max jobs defaults to `
 group : Group
 ```
 
-The container group for the 3d tiles. Add this to the three.js scene in order to render it. The group includes an additional `matrixWorldInverse` field for transforming objects into the local tile set frame.
+The container group for the 3d tiles. Add this to the three.js scene in order to render it. The group includes an additional `matrixWorldInverse` field for transforming objects into the local tileset frame.
 
 ### .manager
 
@@ -469,23 +469,23 @@ Returns the total load progress between `[0, 1]`. Progress is measured since the
 readonly ellipsoid : Ellipsoid
 ```
 
-A definition on the ellipsoid used for the tile set. Defaults to the WGS84 ellipsoid and is modified if the `3DTILES_ELLIPSOID` plugin is present. Specified in the local frame of [TilesRenderer.group](#group).
+A definition on the ellipsoid used for the tileset. Defaults to the WGS84 ellipsoid and is modified if the `3DTILES_ELLIPSOID` plugin is present. Specified in the local frame of [TilesRenderer.group](#group).
 
 ### .constructor
 
 ```js
 constructor( url = null : String | null )
 ```
 
-Takes the url of the `tileset.json` for the tile set to be rendered.
+Takes the url of the `tileset.json` for the tileset to be rendered.
 
 ### .update
 
 ```js
 update() : void
 ```
 
-Updates the tiles to render and kicks off loads for the appropriate tiles in the 3d tile set.
+Updates the tiles to render and kicks off loads for the appropriate tiles in the 3d tileset.
 
 Both `group.matrixWorld` and all cameras world matrices are expected to be up to date before this is called.
 
@@ -503,23 +503,23 @@ If any tiles failed to load due to server or network issues then they will not b
 getBoundingBox( box : Box3 ) : boolean
 ```
 
-Sets `box` to the axis aligned root bounding box of the tile set in the [group](#group) frame. Returns `false` if the tile root is not loaded and the bounding box cannot be set.
+Sets `box` to the axis aligned root bounding box of the tileset in the [group](#group) frame. Returns `false` if the tile root is not loaded and the bounding box cannot be set.
 
 ### .getOrientedBoundingBox
 
 ```js
 getOrientedBoundingBox( box : Box3, boxTransform : Matrix4 ) : boolean;
 ```
 
-Sets `box` and `boxTransform` to the bounds and matrix that describe the oriented bounding box that encapsulates the root of the tile set. Returns `false` if the tile root is not loaded and the bounding box cannot be set.
+Sets `box` and `boxTransform` to the bounds and matrix that describe the oriented bounding box that encapsulates the root of the tileset. Returns `false` if the tile root is not loaded and the bounding box cannot be set.
 
 ### .getBoundingSphere
 
 ```js
 getBoundingSphere( sphere : Sphere ) : boolean;
 ```
 
-Sets `sphere` to the bounding sphere that encapsulates the root of the tile set. Returns `false` if the tile root is not loaded and the bounding sphere cannot be set.
+Sets `sphere` to the bounding sphere that encapsulates the root of the tileset. Returns `false` if the tile root is not loaded and the bounding sphere cannot be set.
 
 ### .hasCamera
 
@@ -535,15 +535,15 @@ Returns `true` if the camera has already been set on the renderer.
 setCamera( camera : Camera ) : boolean
 ```
 
-Adds the camera to the camera to be accounted for when traversing the tile set. Returns `false` if the camera is already being tracked. Returns `true` otherwise.
+Adds the camera to the camera to be accounted for when traversing the tileset. Returns `false` if the camera is already being tracked. Returns `true` otherwise.
 
 ### .deleteCamera
 
 ```js
 deleteCamera( camera : Camera ) : boolean
 ```
 
-Removes the given camera from being accounted for when traversing the tile set. Returns `false` if the camera was not tracked.
+Removes the given camera from being accounted for when traversing the tileset. Returns `false` if the camera was not tracked.
 
 ### .setResolution
 
@@ -568,7 +568,7 @@ Sets the resolution being rendered to for the given camera via renderer which ac
 forEachLoadedModel( callback : ( scene : Object3D, tile : object ) => void ) : void
 ```
 
-Fires the callback for every loaded scene in the hierarchy with the associated tile as the second argument. This can be used to update the materials of all loaded meshes in the tile set.
+Fires the callback for every loaded scene in the hierarchy with the associated tile as the second argument. This can be used to update the materials of all loaded meshes in the tileset.
 
 ### .registerPlugin
 
@@ -603,7 +603,7 @@ getAttributions( target = [] : Array ) : Array<{
 }>
 ```
 
-Returns a list of attributions for the data in the tile set. The list can change when tile visibility changes.
+Returns a list of attributions for the data in the tileset. The list can change when tile visibility changes.
 
 The "type" can be a "string", "html", or "image" depending on the type of attribution. Google Photorealistic Tiles, for example, returns a list of sources as a string.
 

TESTCASES.md

@@ -311,7 +311,7 @@ Verify that the external tileset does not load but the rest of the tileset conti
 
 Verify all steps happen as written.
 
-## Verify disposing of the tileset removes all sub tile sets
+## Verify disposing of the tileset removes all sub tilesets
 
 #### steps
 
@@ -326,7 +326,7 @@ Verify all steps happen as written.
 
 Verify that the total geometries in the render stats display is still "220".
 
-## Verify tileset raycasting with additive tile sets
+## Verify tileset raycasting with additive tilesets
 
 #### steps
 

src/core/plugins/CesiumIonAuthPlugin.js

@@ -74,7 +74,7 @@ export class CesiumIonAuthPlugin {
 	loadRootTileSet() {
 
 		// ensure we have an up-to-date token and root url, then trigger the internal
-		// root tile set load function
+		// root tileset load function
 		return this
 			.auth
 			.refreshToken()
@@ -142,7 +142,7 @@ export class CesiumIonAuthPlugin {
 			const url = new URL( json.options.url );
 			tiles.rootURL = json.options.url;
 
-			// if the tile set is "external" then assume it's a google API tile set
+			// if the tileset is "external" then assume it's a google API tileset
 			tiles.registerPlugin( new GoogleCloudAuthPlugin( {
 				apiToken: url.searchParams.get( 'key' ),
 				autoRefreshToken: this.autoRefreshToken,