FaceTrackingModule
The FaceTrackingModule class enables tracking faces in 3D.

//==============================================================================
// The following example demonstrates how to control the rotation and scale of
// an object using face rotation and mouth openness.
//
// Project setup:
// - Insert a plane
//==============================================================================
// Load in the required modules
const FaceTracking = require('FaceTracking');
const Scene = require('Scene');
// Locate the plane in the Scene
const plane = Scene.root.find('plane0');
// Store a reference to a detected face
const face = FaceTracking.face(0);
//==============================================================================
// Control the rotation of the plane with the rotation of the face
//==============================================================================
// Store references to the transform of the plane and face
const planeTransform = plane.transform;
const faceTransform = face.cameraTransform;
// Bind the rotation of the face to the rotation of the plane
planeTransform.rotationX = faceTransform.rotationX;
planeTransform.rotationY = faceTransform.rotationY;
planeTransform.rotationZ = faceTransform.rotationZ;
//==============================================================================
// Control the scale of the plane with mouth openness
//==============================================================================
// Store a reference to the mouth openness with some additional mathematical
// operations to amplify the signal
const mouthOpenness = face.mouth.openness.mul(4).add(1);
// Bind the mouthOpenness signal to the x and y-axis scale signal of the plane
planeTransform.scaleX = mouthOpenness;
planeTransform.scaleY = mouthOpenness;

Property
Description
count
(get) count: ScalarSignal (set) (Not Available) Returns a ScalarSignal representing the number of faces tracked in the scene.

Method
Description
face
face(index: number): Face Returns the Face object from the detected face array at the specified index.

Class
Description
Cheek
The Cheek class exposes the details of a detected cheek.
Chin
The Chin class exposes the details of a detected chin.
Eye
The Eye class exposes the details of a detected eye.
Eyebrow
The Eyebrow class exposes the details of a detected eyebrow.
Face
The Face class exposes details of a tracked face.
Forehead
The Forehead class exposes the details of a detected forehead.
Mouth
The Mouth class exposes the details of a detected mouth.
Nose
The Nose class exposes the details of a detected nose.
Last modified 2yr ago
Copy link
On this page
Example
Properties
Methods
Classes