com.asus.robotframework.API.results

Class DetectFaceResult

java.lang.Object

com.asus.robotframework.API.results.DetectFaceResult

All Implemented Interfaces:

android.os.Parcelable

public class DetectFaceResult
extends java.lang.Object
implements android.os.Parcelable

Nested Class Summary

Nested classes/interfaces inherited from interface android.os.Parcelable

android.os.Parcelable.ClassLoaderCreator, android.os.Parcelable.Creator

Field Summary

Fields

Modifier and Type	Field and Description
static android.os.Parcelable.Creator	CREATOR

Fields inherited from interface android.os.Parcelable

CONTENTS_FILE_DESCRIPTOR, PARCELABLE_WRITE_RETURN_VALUE

Constructor Summary

Constructors

Constructor and Description
DetectFaceResult(java.lang.String faceID, int trackID, PointF3D mLoc, BBox3D mBox, Rectangle2D locCam, PointF3D faceAngle, boolean hasValidHeadROI, boolean hasValidDepth, boolean isCandidateObj, HeadGazeDirection headGazeDirection, int headPoseConfidence)

Method Summary

Modifier and Type	Method and Description
int	describeContents()
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()
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
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
DetectFaceResult	setFaceEmotion(int emotion)
void	writeToParcel(android.os.Parcel dest, int flags)

Methods inherited from class java.lang.Object

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

Field Detail

CREATOR

public static final android.os.Parcelable.Creator CREATOR

Constructor Detail

DetectFaceResult

public DetectFaceResult(java.lang.String faceID,
                        int trackID,
                        PointF3D mLoc,
                        BBox3D mBox,
                        Rectangle2D locCam,
                        PointF3D faceAngle,
                        boolean hasValidHeadROI,
                        boolean hasValidDepth,
                        boolean isCandidateObj,
                        HeadGazeDirection headGazeDirection,
                        int headPoseConfidence)

Method Detail

describeContents

public int describeContents()

Specified by:

describeContents in interface android.os.Parcelable

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()

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

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

setFaceEmotion

public DetectFaceResult setFaceEmotion(int emotion)

writeToParcel

public void writeToParcel(android.os.Parcel dest,
                          int flags)

Specified by:

writeToParcel in interface android.os.Parcelable