Class

ARPlaneAnchor

A 2D surface that ARKit detects in the physical environment.

Declaration

@interface ARPlaneAnchor : ARAnchor

Overview

When you enable planeDetection in a world tracking session, ARKit notifies your app of all the surfaces it observes using the device's back camera. ARKit calls your delegate's session:didAddAnchors: with a ARPlaneAnchor for each unique surface. And each plane anchor provides details about the surface, like its real world position and shape.

Topics

Orientation

alignment

The general orientation of the detected plane with respect to gravity.

ARPlaneAnchorAlignment

Values describing possible general orientations of a detected plane with respect to gravity.

Geometry

geometry

A coarse triangle mesh representing the general shape of the detected plane.

ARPlaneGeometry

A 3D mesh describing the shape of a detected plane in world-tracking AR sessions.

ARSCNPlaneGeometry

A SceneKit representation of the 2D shape of a plane, for use with plane detection results in an AR session.

Dimensions

center

The center point of the plane relative to its anchor position.

extent

The estimated width and length of the detected plane.

Classifying a Plane

classificationSupported

A Boolean value that indicates whether plane classification is available on the current device.

classification

A general characterization of what kind of real-world surface the plane anchor represents.

ARPlaneClassification

Possible characterizations of real-world surfaces represented by plane anchors.

classificationStatus

The current state of ARKit's process for classifying the plane anchor.

ARPlaneClassificationStatus

Possible states of ARKit's process for classifying plane anchors.

Relationships

Inherits From

See Also

World Tracking

Understanding World Tracking

Discover supporting concepts, features, and best practices for building great AR experiences.

ARWorldTrackingConfiguration

A configuration that monitors the iOS device's position and orientation, while enabling you to augment the environment that's in front of the user.

Tracking and Visualizing Planes

Detect surfaces in the physical environment and visualize their shape and location in 3D space.

ARCoachingOverlayView

A view that presents visual instructions that guide the user during session initialization and in limited tracking situations.

Beta
Placing Objects and Handling 3D Interaction

Place virtual content on real-world surfaces, and enable the user to interact with virtual content by using gestures.

ARWorldMap

The space-mapping state and set of anchors from a world-tracking AR session.

Saving and Loading World Data

Serialize a world tracking session to resume it later on.

Ray-Casting and Hit-Testing

Find 3D positions on real-world surfaces given a screen point.