NAME

Paws::Rekognition::FaceDetail

USAGE

This class represents one of two things:

Arguments in a call to a service

Use the attributes of this class as arguments to methods. You shouldn't make instances of this class. Each attribute should be used as a named argument in the calls that expect this type of object.

As an example, if Att1 is expected to be a Paws::Rekognition::FaceDetail object:

  $service_obj->Method(Att1 => { AgeRange => $value, ..., Sunglasses => $value  });

Results returned from an API call

Use accessors for each attribute. If Att1 is expected to be an Paws::Rekognition::FaceDetail object:

  $result = $service_obj->Method(...);
  $result->Att1->AgeRange

DESCRIPTION

Structure containing attributes of the face that the algorithm detected.

A FaceDetail object contains either the default facial attributes or all facial attributes. The default attributes are BoundingBox, Confidence, Landmarks, Pose, and Quality.

GetFaceDetection is the only Amazon Rekognition Video stored video operation that can return a FaceDetail object with all attributes. To specify which attributes to return, use the FaceAttributes input parameter for StartFaceDetection. The following Amazon Rekognition Video operations return only the default attributes. The corresponding Start operations don't have a FaceAttributes input parameter.

  • GetCelebrityRecognition

  • GetPersonTracking

  • GetFaceSearch

The Amazon Rekognition Image DetectFaces and IndexFaces operations can return all facial attributes. To specify which attributes to return, use the Attributes input parameter for DetectFaces. For IndexFaces, use the DetectAttributes input parameter.

ATTRIBUTES

AgeRange => Paws::Rekognition::AgeRange

  The estimated age range, in years, for the face. Low represents the
lowest estimated age and High represents the highest estimated age.

Beard => Paws::Rekognition::Beard

  Indicates whether or not the face has a beard, and the confidence level
in the determination.

BoundingBox => Paws::Rekognition::BoundingBox

  Bounding box of the face. Default attribute.

Confidence => Num

  Confidence level that the bounding box contains a face (and not a
different object such as a tree). Default attribute.

Emotions => ArrayRef[Paws::Rekognition::Emotion]

  The emotions that appear to be expressed on the face, and the
confidence level in the determination. The API is only making a
determination of the physical appearance of a person's face. It is not
a determination of the personE<rsquo>s internal emotional state and
should not be used in such a way. For example, a person pretending to
have a sad face might not be sad emotionally.

Eyeglasses => Paws::Rekognition::Eyeglasses

  Indicates whether or not the face is wearing eye glasses, and the
confidence level in the determination.

EyesOpen => Paws::Rekognition::EyeOpen

  Indicates whether or not the eyes on the face are open, and the
confidence level in the determination.

Gender => Paws::Rekognition::Gender

  The predicted gender of a detected face.

Landmarks => ArrayRef[Paws::Rekognition::Landmark]

  Indicates the location of landmarks on the face. Default attribute.

MouthOpen => Paws::Rekognition::MouthOpen

  Indicates whether or not the mouth on the face is open, and the
confidence level in the determination.

Mustache => Paws::Rekognition::Mustache

  Indicates whether or not the face has a mustache, and the confidence
level in the determination.

Pose => Paws::Rekognition::Pose

  Indicates the pose of the face as determined by its pitch, roll, and
yaw. Default attribute.

Quality => Paws::Rekognition::ImageQuality

  Identifies image brightness and sharpness. Default attribute.

Smile => Paws::Rekognition::Smile

  Indicates whether or not the face is smiling, and the confidence level
in the determination.

Sunglasses => Paws::Rekognition::Sunglasses

  Indicates whether or not the face is wearing sunglasses, and the
confidence level in the determination.

SEE ALSO

This class forms part of Paws, describing an object used in Paws::Rekognition

BUGS and CONTRIBUTIONS

The source code is located here: https://github.com/pplu/aws-sdk-perl

Please report bugs to: https://github.com/pplu/aws-sdk-perl/issues