com.asus.robotframework.API.results

Class FaceResult

java.lang.Object

com.asus.robotframework.API.results.FaceResult

public class FaceResult
extends java.lang.Object

Created by Shen_Tsai on 2018/1/10.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	FaceResult.FaceResultKey

Constructor Summary

Constructors

Constructor and Description
FaceResult(java.lang.String json)

Method Summary

Modifier and Type	Method and Description
PointF3D	getFaceAngle() Return user face rotation angel, in order of roll = x, pitch = y, yaw = z PointF3D(pose.roll,pose.pitch,pose.yaw);
BBox3D	getFaceBox() Rectangular bounding box of the user's face in 3-D space.
int	getFaceEmotion() If request has face emotion, it will return the state of face emotion result
PointF3D	getFaceLoc() PointF3D of the mass center the visible user's face with trackID with respect to Robot Base Coordinates (in meters) x axis means robot to user depth, y means left/right shift, z means user height above ground
Rectangle2D	getFaceLocCam() Rectangle2D of the mass center the visible user's face in camera frame, normalize to 0 - 1 value. if ( 0.5 , 0.5 ) means face on camera frame center
java.util.HashMap<java.lang.String,java.lang.Float>	getFaceRecognitionScore() Get similarity score of face recognition, in pair of UUID / Score Score is similarity mormalize to 0-100, 100 means the same as enroll person
HeadGazeDirection	getHeadGazeDirection() get head gaze direction classify result
int	getHeadPoseConfidence() confidence value of head pose angle prediction, valid = 100, not-valid = 0
int	getTrackID() Track ID is an integer number used to provide temporal consistency to identify the face/person in the current tracked ID
java.lang.String	getUuid() If the request has face recognition process, it will return face ID (UUID) which recognizes faces
boolean	hasValidDepth() if this result is from intel estimation or our own depth average.
boolean	hasValidHeadROI() return whether this face is from true head detection or from body rectangle
boolean	isCandidateObj() if this detection result is only proposal region, not formal detected person

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

FaceResult

public FaceResult(java.lang.String json)

Method Detail

getFaceAngle

public PointF3D getFaceAngle()

Return user face rotation angel, in order of roll = x, pitch = y, yaw = z PointF3D(pose.roll,pose.pitch,pose.yaw);

Returns:

PointF3D of face angle

See Also:

PointF3D

getFaceBox

public BBox3D getFaceBox()

Rectangular bounding box of the user's face in 3-D space. The reference position of the bounding box is related to the body location (see TrackingResult.getBodyLoc()) * and the dimension of body is defined in meters.

Returns:

Bounding box of body

See Also:

BBox3D

getFaceEmotion

public int getFaceEmotion()

If request has face emotion, it will return the state of face emotion result

Returns:

Face motion state

getFaceLoc

public PointF3D getFaceLoc()

PointF3D of the mass center the visible user's face with trackID with respect to Robot Base Coordinates (in meters) x axis means robot to user depth, y means left/right shift, z means user height above ground

Returns:

PointF3D of the center user's face (in meters)

See Also:

PointF3D

getFaceLocCam

public Rectangle2D getFaceLocCam()

Rectangle2D of the mass center the visible user's face in camera frame, normalize to 0 - 1 value. if ( 0.5 , 0.5 ) means face on camera frame center

Returns:

Rectangle2D of the center user's face (in meters)

See Also:

Rectangle2D

getFaceRecognitionScore

public java.util.HashMap<java.lang.String,java.lang.Float> getFaceRecognitionScore()

Get similarity score of face recognition, in pair of UUID / Score Score is similarity mormalize to 0-100, 100 means the same as enroll person

Returns:

Recognition similarity score

getHeadGazeDirection

public HeadGazeDirection getHeadGazeDirection()

get head gaze direction classify result

Returns:

gaze direction

See Also:

HeadGazeDirection

getHeadPoseConfidence

public int getHeadPoseConfidence()

confidence value of head pose angle prediction, valid = 100, not-valid = 0

Returns:

confidence value

getTrackID

public int getTrackID()

Track ID is an integer number used to provide temporal consistency to identify the face/person in the current tracked ID

Returns:

Track ID

getUuid

public java.lang.String getUuid()

If the request has face recognition process, it will return face ID (UUID) which recognizes faces

Returns:

UUID

hasValidDepth

public boolean hasValidDepth()

if this result is from intel estimation or our own depth average.

Returns:

if this result is from intel estimation or our own depth average.

hasValidHeadROI

public boolean hasValidHeadROI()

return whether this face is from true head detection or from body rectangle

Returns:

return whether this face is from true head detection or from body rectangle

isCandidateObj

public boolean isCandidateObj()

if this detection result is only proposal region, not formal detected person

Returns:

if this detection result is only proposal region, not formal detected person