easy-three-utils 0.0.1

package/src/tileRenderer/plugins/index.d.ts

@@ -0,0 +1,17 @@
+// three.js plugins
+export { CesiumIonAuthPlugin } from './three/CesiumIonAuthPlugin';
+export { GoogleCloudAuthPlugin } from './three/GoogleCloudAuthPlugin';
+export { UpdateOnChangePlugin } from './three/UpdateOnChangePlugin';
+export { TileCompressionPlugin } from './three/TileCompressionPlugin';
+export { GLTFExtensionsPlugin } from './three/GLTFExtensionsPlugin';
+export { ReorientationPlugin } from './three/ReorientationPlugin';
+export { TilesFadePlugin } from './three/fade/TilesFadePlugin';
+export * from './three/DebugTilesPlugin';
+
+// common plugins
+export { ImplicitTilingPlugin } from './base/ImplicitTilingPlugin';
+
+// gltf extensions
+export { GLTFCesiumRTCExtension } from './three/gltf/GLTFCesiumRTCExtension';
+export { GLTFStructuralMetadataExtension } from './three/gltf/GLTFStructuralMetadataExtension';
+export { GLTFMeshFeaturesExtension } from './three/gltf/GLTFMeshFeaturesExtension';

package/src/tileRenderer/plugins/index.js

@@ -0,0 +1,17 @@
+// three.js plugins
+export { CesiumIonAuthPlugin } from './three/CesiumIonAuthPlugin.js';
+export { GoogleCloudAuthPlugin } from './three/GoogleCloudAuthPlugin.js';
+export { UpdateOnChangePlugin } from './three/UpdateOnChangePlugin.js';
+export { TileCompressionPlugin } from './three/TileCompressionPlugin.js';
+export { GLTFExtensionsPlugin } from './three/GLTFExtensionsPlugin.js';
+export { ReorientationPlugin } from './three/ReorientationPlugin.js';
+export { TilesFadePlugin } from './three/fade/TilesFadePlugin.js';
+export * from './three/DebugTilesPlugin.js';
+
+// common plugins
+export { ImplicitTilingPlugin } from './base/ImplicitTilingPlugin.js';
+
+// gltf extensions
+export { GLTFCesiumRTCExtension } from './three/gltf/GLTFCesiumRTCExtension.js';
+export { GLTFStructuralMetadataExtension } from './three/gltf/GLTFStructuralMetadataExtension.js';
+export { GLTFMeshFeaturesExtension } from './three/gltf/GLTFMeshFeaturesExtension.js';

package/src/tileRenderer/plugins/three/CesiumIonAuthPlugin.d.ts

@@ -0,0 +1,9 @@
+export class CesiumIonAuthPlugin {
+
+	constructor( options : {
+		apiToken: String,
+		assetId?: String | null,
+		autoRefreshToken?: Boolean
+	} );
+
+}

package/src/tileRenderer/plugins/three/CesiumIonAuthPlugin.js

@@ -0,0 +1,175 @@
+import { GoogleCloudAuthPlugin } from './GoogleCloudAuthPlugin.js';
+
+export class CesiumIonAuthPlugin {
+
+	constructor( { apiToken, assetId = null, autoRefreshToken = false } ) {
+
+		this.name = 'CESIUM_ION_AUTH_PLUGIN';
+		this.apiToken = apiToken;
+		this.assetId = assetId;
+		this.autoRefreshToken = autoRefreshToken;
+		this.tiles = null;
+		this.endpointURL = null;
+
+		this._bearerToken = null;
+		this._tileSetVersion = - 1;
+		this._tokenRefreshPromise = null;
+		this._attributions = [];
+
+	}
+
+	init( tiles ) {
+
+		if ( this.assetId !== null ) {
+
+			tiles.rootURL = `https://api.cesium.com/v1/assets/${ this.assetId }/endpoint`;
+
+		}
+
+		this.tiles = tiles;
+		this.endpointURL = tiles.rootURL;
+
+		// reset the tiles in case this plugin was removed and re-added
+		tiles.resetFailedTiles();
+
+	}
+
+	loadRootTileSet() {
+
+		// ensure we have an up-to-date token and root url, then trigger the internal
+		// root tile set load function
+		return this._refreshToken()
+			.then( () => this.tiles.loadRootTileSet() );
+
+	}
+
+	preprocessURL( uri ) {
+
+		uri = new URL( uri );
+		if ( /^http/.test( uri.protocol ) && this._tileSetVersion != - 1 ) {
+
+			uri.searchParams.append( 'v', this._tileSetVersion );
+
+		}
+		return uri.toString();
+
+	}
+
+	fetchData( uri, options ) {
+
+		const tiles = this.tiles;
+		if ( tiles.getPluginByName( 'GOOGLE_CLOUD_AUTH_PLUGIN' ) !== null ) {
+
+			return null;
+
+		} else {
+
+			return Promise.resolve().then( async () => {
+
+				// wait for the token to refresh if loading
+				if ( this._tokenRefreshPromise !== null ) {
+
+					await this._tokenRefreshPromise;
+					uri = this.preprocessURL( uri );
+
+				}
+
+				const res = await fetch( uri, options );
+				if ( res.status >= 400 && res.status <= 499 && this.autoRefreshToken ) {
+
+					await this._refreshToken( options );
+					return fetch( this.preprocessURL( uri ), options );
+
+				} else {
+
+					return res;
+
+				}
+
+			} );
+
+		}
+
+	}
+
+	getAttributions( target ) {
+
+		if ( this.tiles.visibleTiles.size > 0 ) {
+
+			target.push( ...this._attributions );
+
+		}
+
+	}
+
+	_refreshToken( options ) {
+
+		if ( this._tokenRefreshPromise === null ) {
+
+			// construct the url to fetch the endpoint
+			const url = new URL( this.endpointURL );
+			url.searchParams.append( 'access_token', this.apiToken );
+
+			this._tokenRefreshPromise = fetch( url, options )
+				.then( res => {
+
+					if ( ! res.ok ) {
+
+						throw new Error( `CesiumIonAuthPlugin: Failed to load data with error code ${ res.status }` );
+
+					}
+
+					return res.json();
+
+				} )
+				.then( json => {
+
+					const tiles = this.tiles;
+					if ( 'externalType' in json ) {
+
+						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
+						tiles.registerPlugin( new GoogleCloudAuthPlugin( { apiToken: url.searchParams.get( 'key' ) } ) );
+
+					} else {
+
+						tiles.rootURL = json.url;
+						tiles.fetchOptions.headers = tiles.fetchOptions.headers || {};
+						tiles.fetchOptions.headers.Authorization = `Bearer ${ json.accessToken }`;
+
+						// save the version key if present
+						if ( url.searchParams.has( 'v' ) && this._tileSetVersion === - 1 ) {
+
+							const url = new URL( json.url );
+							this._tileSetVersion = url.searchParams.get( 'v' );
+
+						}
+
+						this._bearerToken = json.accessToken;
+						if ( json.attributions ) {
+
+							this._attributions = json.attributions.map( att => ( {
+								value: att.html,
+								type: 'html',
+								collapsible: att.collapsible,
+							} ) );
+
+						}
+
+					}
+
+					this._tokenRefreshPromise = null;
+
+					return json;
+
+				} );
+
+		}
+
+		return this._tokenRefreshPromise;
+
+	}
+
+}

package/src/tileRenderer/plugins/three/DebugTilesPlugin.d.ts

@@ -0,0 +1,29 @@
+import { Tile } from '../../base/Tile';
+import { Color } from 'three';
+
+export enum ColorMode {}
+export const NONE : ColorMode;
+export const SCREEN_ERROR : ColorMode;
+export const GEOMETRIC_ERROR : ColorMode;
+export const DISTANCE : ColorMode;
+export const DEPTH : ColorMode;
+export const RELATIVE_DEPTH : ColorMode;
+export const IS_LEAF : ColorMode;
+export const RANDOM_COLOR : ColorMode;
+export const RANDOM_NODE_COLOR: ColorMode;
+export const CUSTOM_COLOR: ColorMode;
+export class DebugTilesPlugin {
+
+	displayBoxBounds : Boolean;
+	displaySphereBounds : Boolean;
+	displayRegionBounds : Boolean;
+	colorMode : ColorMode;
+
+	maxDebugDepth : Number;
+	maxDebugDistance : Number;
+	maxDebugError : Number;
+
+	getDebugColor : ( val: Number, target: Color ) => void;
+	customColorCallback : ( val: Tile, target: Color ) => void;
+
+}