Level of Detail Meshing (Experimental)
Overview
Niantic Spatial Meshing reconstructs the visible geometry of the scene, allowing AR characters and objects to interact physically with their environment. By default, the spatial resolution used for this reconstruction is constant. Level of Detail Meshing is a new experimental feature that changes the local resolution of the reconstruction based on how far the player is from specific points in space. While they are far away, world details are rendered coarsely, but as they approach, the resolution becomes finer, showing a more precise version of the geometry.
Enabling Levels of Detail
To enable Level of Detail Meshing, expand the XROrigin in the Hierarchy and select the object that contains your Lightship Meshing Extension.
Then, in the Inspector under "Experimental Meshing Options," check the box for "Enable Levels of Detail".
Choose a value from 2 to 5, with 5 providing the most detail and 2 the least.
(Setting this to 1 or 0 will result in the default behavior: no additional levels of detail.)
Enabling levels of detail in conjunction with Distance-based Volumetric Cleanup is not recommended.
How is Level of Detail Defined?
When a new Mesh Block is surfaced to Unity, it creates a new GameObject in the Trackables section of the Hierarchy. The names for these GameObjects follow the format Mesh-<32 digit number>-<32 zeroes>, where the first digit of the 32-digit number is the level of detail used to reconstruct the triangles in the mesh. Each level doubles the voxel size and block size for that mesh region. For example, a Level 3 mesh block covers a cubic region with sides 8 times longer than a Level 1 mesh block and contains voxels that are 8 times larger.
Level of Detail Setup Examples
We provide two examples for how to set up meshing level of detail in your project. The first example, taken at a distance of 30 meters, is suitable for indoor use, while the second, taken at 100 meters, is better for outdoor experiences.
Example indoor configuration:
Example outdoor configuration:
