Fix various typings (#1324)

* Add TilesRenderer cameras in typings

* Add missing typings in Ellipsoid

* Improve DebugTilesPlugin typings

* Fix WMTSTilesOverlay typings (aligned with WMTSTilesPlugin)

* Deprecate load in favor of loadAsync in LoaderBase typings

* WMTSTilesOverlay: url is optional

Author: xawill

src/core/renderer/loaders/LoaderBase.d.ts

@@ -2,7 +2,9 @@ export class LoaderBase<Result = any, ParseResult = Promise< Result >> {
 
 	fetchOptions: any;
 	workingPath: string;
+	/** @deprecated in favor of `loadAsync` */
 	load( url: string ): Promise< Result >;
+	loadAsync( url: string ): Promise< Result >;
 	resolveExternalURL( url: string ): string;
 	parse( buffer: ArrayBuffer ): ParseResult;
 

src/three/plugins/DebugTilesPlugin.d.ts

@@ -1,4 +1,4 @@
-import { Color } from 'three';
+import { Color, Object3D } from 'three';
 import { Tile } from '3d-tiles-renderer/core';
 
 export enum ColorMode {}
@@ -24,7 +24,7 @@ export class DebugTilesPlugin {
 		maxDebugDepth?: number,
 		maxDebugDistance?: number,
 		maxDebugError?: number,
-		customColorCallback?: ( val: Tile, target: Color ) => void,
+		customColorCallback?: ( tile: Tile, object: Object3D ) => void,
 		unlit?: boolean,
 		enabled?: boolean,
 	} );

src/three/plugins/images/ImageOverlayPlugin.d.ts

@@ -1,4 +1,5 @@
 import { Color, Matrix4, WebGLRenderer } from 'three';
+import { WMTSCapabilitiesResult, WMTSLayer, WMTSTileMatrixSet } from '../loaders/WMTSCapabilitiesLoader.js';
 
 export class ImageOverlayPlugin {
 
@@ -82,10 +83,12 @@ export class WMSTilesOverlay extends ImageOverlay {
 export class WMTSTilesOverlay extends ImageOverlay {
 
 	constructor( options: {
-		levels: number,
-		dimension: number,
-		url: string,
-		bounds?: [ number, number, number, number ],
+		dimensions?: { [ key: string ]: any } | null,
+		url?: string | null,
+		capabilities?: WMTSCapabilitiesResult | null,
+		layer?: WMTSLayer | string | null,
+		tileMatrixSet?: WMTSTileMatrixSet | string | null,
+		style?: string,
 
 		color: number | Color,
 		opacity: number,

src/three/renderer/math/Ellipsoid.d.ts

@@ -16,6 +16,7 @@ export class Ellipsoid {
 	getCartographicToNormal( lat: number, lon: number, target: Vector3 ): Vector3;
 	getPositionToNormal( pos: Vector3, target: Vector3 ): Vector3;
 	getPositionToSurfacePoint( pos: Vector3, target: Vector3 ): Vector3;
+	getPositionElevation( pos: Vector3 ): number;
 
 	getEastNorthUpFrame( lat: number, lon: number, height: number, target: Matrix4 ): Matrix4;
 	getOrientedEastNorthUpFrame( lat: number, lon: number, height: number, az: number, el: number, roll: number, target: Matrix4 ): Matrix4;
@@ -42,4 +43,12 @@ export class Ellipsoid {
 		target: Matrix4, frame: Frames,
 	): Matrix4;
 
+	intersectRay( ray: Ray, target: Vector3 ): Vector3 | null;
+
+	calculateHorizonDistance( latitude: number, elevation: number ): number;
+	calculateEffectiveRadius( latitude: number ): number;
+
+	copy( source: Ellipsoid ): Ellipsoid;
+	clone(): Ellipsoid;
+
 }

src/three/renderer/tiles/TilesRenderer.d.ts

@@ -24,6 +24,7 @@ export interface TilesRendererEventMap {
 export class TilesRenderer<TEventMap extends TilesRendererEventMap = TilesRendererEventMap> extends TilesRendererBase implements EventDispatcher<TEventMap> {
 
 	ellipsoid: Ellipsoid;
+	cameras: Camera[];
 	autoDisableRendererCulling : boolean;
 	optimizeRaycast : boolean;