ArPoint

Represents a point in space that ARCore is tracking.

Summary

Enumerations

ArPointOrientationMode{
  AR_POINT_ORIENTATION_INITIALIZED_TO_IDENTITY = 0,
  AR_POINT_ORIENTATION_ESTIMATED_SURFACE_NORMAL = 1
}
enum
Indicates the orientation mode of the ArPoint.

Typedefs

ArPoint typedef
struct ArPoint_
An arbitrary point in space (reference type, long-lived).

Functions

ArPoint_getOrientationMode(const ArSession *session, const ArPoint *point, ArPointOrientationMode *out_orientation_mode)
void
Returns the ArPointOrientationMode of the point.
ArPoint_getPose(const ArSession *session, const ArPoint *point, ArPose *out_pose)
void
Returns the pose of the point.

Enumerations

ArPointOrientationMode

 ArPointOrientationMode

Indicates the orientation mode of the ArPoint.

Properties
AR_POINT_ORIENTATION_ESTIMATED_SURFACE_NORMAL

The orientation of the ArPoint will follow the behavior described in ArHitResult_getHitPose.

AR_POINT_ORIENTATION_INITIALIZED_TO_IDENTITY

The orientation of the ArPoint is initialized to identity but may adjust slightly over time.

Typedefs

ArPoint

struct ArPoint_ ArPoint

An arbitrary point in space (reference type, long-lived).

Functions

ArPoint_getOrientationMode

void ArPoint_getOrientationMode(
  const ArSession *session,
  const ArPoint *point,
  ArPointOrientationMode *out_orientation_mode
)

Returns the ArPointOrientationMode of the point.

For ArPoint objects created by ArFrame_hitTest. If ArPointOrientationMode is AR_POINT_ORIENTATION_ESTIMATED_SURFACE_NORMAL, then normal of the surface centered around the ArPoint was estimated successfully.

Details
Parameters
session
The ARCore session.
point
The point to retrieve the pose of.
out_orientation_mode
OrientationMode output result for the point.

ArPoint_getPose

void ArPoint_getPose(
  const ArSession *session,
  const ArPoint *point,
  ArPose *out_pose
)

Returns the pose of the point.

If ArPoint_getOrientationMode returns AR_POINT_ORIENTATION_ESTIMATED_SURFACE_NORMAL, the orientation will follow the behavior described in ArHitResult_getHitPose. If ArPoint_getOrientationMode returns AR_POINT_ORIENTATION_INITIALIZED_TO_IDENTITY, then returns an orientation that is identity or close to identity.

Details
Parameters
session
The ARCore session.
point
The point to retrieve the pose of.
out_pose
An already-allocated ArPose object into which the pose will be stored.