Plugins: Add "TileFlatteningPlugin" (#1036)

* Add "setTileActive" plugin support

* Add initial tile flattening plugin

* Updates

* Add dispose function

* Add vertex iteration

* comment

* Add obb

* Use circle bounding volume

* fixes

* Update docs

* docs update

* Clone the geometry

* Use spheres rather than projected bounding spheres

* Fix AABB construction

* Update flattening plugin

* One comment

* lint fix

* lint fix

* Add force rerender

* Fixes

* Add d ts

* Fixes

Author: gkjohnson

src/base/TilesRendererBase.js

@@ -444,7 +444,7 @@ export class TilesRendererBase {
 
 		if ( tile.__active ) {
 
-			this.setTileActive( tile, false );
+			this.invokeOnePlugin( plugin => plugin.setTileActive && plugin.setTileActive( tile, false ) );
 			tile.__active = false;
 
 		}

src/base/traverseFunctions.js

@@ -481,7 +481,7 @@ export function toggleTiles( tile, renderer ) {
 
 			if ( tile.__wasSetActive !== setActive ) {
 
-				renderer.setTileActive( tile, setActive );
+				renderer.invokeOnePlugin( plugin => plugin.setTileActive && plugin.setTileActive( tile, setActive ) );
 
 			}
 

src/plugins/README.md

@@ -723,3 +723,47 @@ clearRegions(): void
 ```
 
 Remove all regions.
+
+## TileFlatteningPlugin
+
+A plugin that takes a shape as a mesh and direction along which to "flatten" vertices to the surface of the shape. Useful for shifting tile geometry to make room for new assets. Not compatible with other plugins that modify geometry such as `BatchedTilesPlugin`.
+
+### hasShape
+
+```js
+hasShape( shape: Object3D ): boolean
+```
+
+Returns whether the given object has been passed in as a shape.
+
+### addShape
+
+```js
+addShape( shape: Object3D, direction: Vector3 ): void
+```
+
+Adds the given object as a shape to flatten to in addition to the direction to flatten.
+
+### updateShape
+
+```js
+updateShape( shape: Object3D ): void
+```
+
+Notifies the plugin that the given shape (geometry, position) has been changed and "tile flattening" needs to be regenerated.
+
+### deleteShape
+
+```js
+deleteShape( shape: Object3D ): void
+```
+
+Deletes the given shape and regenerates the tile flattening.
+
+### clearShapes
+
+```js
+clearShapes(): void
+```
+
+Deletes all shapes and resets the tiles.

src/plugins/three/TileFlatteningPlugin.d.ts

@@ -0,0 +1,11 @@
+import { Mesh } from 'three';
+
+export class TileFatteningPlugin {
+
+	hasShape( mesh: Mesh ): boolean;
+	addShape( mesh: Mesh, direction: Vector3 ): void;
+	updateShape( mesh: Mesh ): void;
+	deleteShape( mesh ): boolean;
+	clearShapes(): void;
+
+}