A utility class for taking a set of SkinnedMeshes or morph target geometry and baking it into a single, static geometry that a BVH can be generated for.
On this page
Properties
useGroups: boolean
If true then groups are used to support an array of materials on the mesh.
applyWorldTransforms: boolean
Whether to transform the vertices of the geometry by the world transforms of each mesh when generating.
attributes: Array<string>
The set of attributes to copy onto the static geometry.
Methods
new StaticGeometryGenerator( meshes: Object3D | Array<Object3D> )Takes an array of object hierarchies to bake into a single static geometry.
getMaterials(): Array<Material>Returns an array of materials for the meshes to be merged. These can be used alongside the
generated geometry when creating a mesh: new Mesh( geometry, generator.getMaterials() ).
generate( targetGeometry?: BufferGeometry ): BufferGeometryGenerates a single, static geometry for the passed meshes. When generating for the first time an empty target geometry is expected. The same generated geometry can be passed into the function on subsequent calls to update the geometry in place to save memory. An error will be thrown if the attributes or geometry on the meshes to bake has been changed and are incompatible lengths, types, etc.
On subsequent calls the "index" buffer will not be modified so any BVH generated for the
geometry is unaffected. Once the geometry is updated the MeshBVH.refit function can be
called to update the BVH.