Plane Detection

Magic Leap 2 tries to understand its environment using feature points and planes.

If a cluster of feature points appears to lie on common horizontal or vertical surfaces, Magic Leap labels this cluster as a geometric plane and classifies it as being a floor, wall, or ceiling.

Each detected plane contains information about its alignment, center position, size, and extents. This information can be useful for placing virtual objects that rest on flat surfaces.

caution

This feature requires the SPATIAL_MAPPING permission to be enabled in your project's Manifest Settings. (Edit > Project Settings > Magic Leap > Manifest Settings)

info

Because the Magic Leap 2 uses feature points to detect planes, flat surfaces without texture, such as a white wall, may not be detected properly.

📄️ Plane Classification

Learn how the Magic Leap classifies surfaces.

📄️ Query Planes

Learn how to query planes Magic Leap that were detected by the Magic Leap.

See also

• AR Foundation Manual
  • A quick start guide for AR Foundations.
• AR Foundation Plane Detection
  • Unity Guide about using the Plane Manager for plane detection in AR Foundations.
• Unity XR Plane Subsystem
  • Unity's overview of the XR plane subsystem.
• UnityEngine.XR.ARFoundation.ARPlane
  • AR Plane API that shows what type of information can be obtained from each plane.