Face Pose

Analyzes face rotation and position of a face in a video stream. The event listener continuously gets the data in a JSON object as FaceAI detects face rotation in a video stream. The face rotation angle data is represented in terms of radiants as Pitch, Roll, and Yaw.

Method

To start or stop analysis of face rotation and position in a video stream.

• Class: EnxFaceAI
• Method: -(void)enableFacePose:(BOOL)enable;

Parameter

• enable: Boolean. Set it to true to enable or start the Face Pose analysis. Otherwise set it to false.

Delegate Method

• FaceAI:didFacePoseData:value : This method is received repeatedly with Face Rotation and Position Analysis data as a JSON object.

JSON Object: Received with Face Rotation and Position Analysis data.

{	output: {
		pose: {
			pitch: Number, 
			roll: Number, 
			yaw: Number
		}
	}
}

Analysis Data Explanation

• output : Face Rotation & Position Report
  • pose : Filtered (smoothened) pose rotation angles expressed in radiants as pitch, roll and yaw.

Note: The maximum and minimum ranges for rotation angles are currently limited to +- (Pi/2) in radians, corresponding to +- (90°) in degrees, for each of the 3 axes. The zero point is when a face looks straight at the camera.

Sample Code

// Start Face Pose
[FaceAI enableFacePose:true];

- (void)FaceAI:(EnxFaceAI *_Nullable)FaceAI didFacePoseData:(NSString *_Nullable)type value:(NSString *_Nullable)value{

}