GoogleARCore.AugmentedFace

Caution: The ARCore SDK for Unity is deprecated, and no longer supported in Unity 2020 and later. This SDK should only be used by developers working on existing projects which are unable to migrate to Unitys AR Foundation.

Key Point: Developers starting new projects should instead use the ARCore Extensions for AR Foundation with Unity.

A face detected and trackable by ARCore.

Summary

Inheritance

Inherits from: GoogleARCore.Trackable

Properties
CenterPose	Pose Gets the position and orientation of the face's center in world space.

Public functions
GetNormals(List< Vector3 > normals)	void Gets a list of normals of the face mesh.
GetRegionPose(AugmentedFaceRegion region)	Pose Gets the position and orientation of a face region in world space.
GetTextureCoordinates(List< Vector2 > textureCoordinates)	void Gets a list of texture coordinates of the face mesh.
GetTriangleIndices(List< int > indices)	void Gets a list of triangle indices of the face mesh.
GetVertices(List< Vector3 > vertices)	void Gets the vertices of the face mesh.

Properties

CenterPose

Pose CenterPose

Gets the position and orientation of the face's center in world space.

The face center is defined to have the origin located behind the nose and between the two cheek bones. The forward vector of the pose (+Z) points out the back of the person's head. The up vector of the pose (+Y) points out the top of the person's head. The right vector of the pose (+X) points to the left side of the person's face.

Public functions

GetNormals

void GetNormals(
  List< Vector3 > normals
)

Gets a list of normals of the face mesh.

Details
Parameters	normals A list of vertex normals. The list will be empty when the motion tracking state is TrackingState.Paused or TackingState.Stopped.

GetRegionPose

Pose GetRegionPose(
  AugmentedFaceRegion region
)

Gets the position and orientation of a face region in world space.

Details
Parameters	region The face region to query the pose.
Returns	The position and orientation of a face region in world space.

GetTextureCoordinates

void GetTextureCoordinates(
  List< Vector2 > textureCoordinates
)

Gets a list of texture coordinates of the face mesh.

Details
Parameters	textureCoordinates A list of texture coordinates. The list will be empty when the motion tracking state is TrackingState.Paused or TackingState.Stopped.

GetTriangleIndices

void GetTriangleIndices(
  List< int > indices
)

Gets a list of triangle indices of the face mesh.

Details
Parameters	indices A list of indices. The list will be empty when the motion tracking state is TrackingState.Paused or TackingState.Stopped.

GetVertices

void GetVertices(
  List< Vector3 > vertices
)

Gets the vertices of the face mesh.

Vector -Z is points forward out of the face.

Details
Parameters	vertices A list to be filled with the vertices of the face mesh. The list will be empty when the motion tracking state is TrackingState.Paused or TackingState.Stopped.