Skip to main content

struct ModelSettings

(Niantic.Lightship.AR.NavigationMesh.ModelSettings)

Overview​

The ModelSettings struct provides a configuration for how LightshipNavMesh scans the real environment and creates a navigable space. An instance of ModelSettings is created by the LightshipNavMeshManager using the parameters specified by the user in the Inspector, and that instance is subsequently used to create a LightshipNavMesh that is configured this way.

struct ModelSettings {
		// fields
	
		 float TileSize;
		 float SpatialChunkSize;
		 int KernelSize;
		 float KernelStdDevTol;
		 float MaxSlope;
		 float MinElevation;
		 float StepHeight;
		 LayerMask LayerMask;

		// properties
	
		ModelSettings Default;

		// methods
	
		ModelSettings(
			float tileSize,
			float kernelStdDevTol,
			float maxSlope,
			float stepHeight,
			LayerMask layerMask
		);
	};

Detailed Documentation​

The ModelSettings struct provides a configuration for how LightshipNavMesh scans the real environment and creates a navigable space. An instance of ModelSettings is created by the LightshipNavMeshManager using the parameters specified by the user in the Inspector, and that instance is subsequently used to create a LightshipNavMesh that is configured this way.

Fields​

TileSize​

float TileSize

Size of a grid cell in meters.

SpatialChunkSize​

float SpatialChunkSize

Size of a spatial partition in square meters. Grid cells within the same chunk will be stored together.

KernelSize​

int KernelSize

The size of the kernel used to compute areal properties for each cell.

.. note::

This needs to be an odd integer.

KernelStdDevTol​

float KernelStdDevTol

The standard deviation tolerance value to use when determining node noise within a cell, outside of which the cell is considered too noisy to be walkable.

MaxSlope​

float MaxSlope

Maximum slope angle (degrees) of an area to be considered flat.

MinElevation​

float MinElevation

Minimum elevation (meters) a GridNode is expected to have in order to be walkable

StepHeight​

float StepHeight

The maximum amount two cells can differ in elevation to be considered on the same plane.

LayerMask​

LayerMask LayerMask

Specifies the layer of the environment to raycast.

Properties​

Default​

ModelSettings Default

Constructs a configuration with default settings.