Struct aws_sdk_rekognition::types::FaceDetail

#[non_exhaustive]
pub struct FaceDetail {

    pub bounding_box: Option<BoundingBox>,
    pub age_range: Option<AgeRange>,
    pub smile: Option<Smile>,
    pub eyeglasses: Option<Eyeglasses>,
    pub sunglasses: Option<Sunglasses>,
    pub gender: Option<Gender>,
    pub beard: Option<Beard>,
    pub mustache: Option<Mustache>,
    pub eyes_open: Option<EyeOpen>,
    pub mouth_open: Option<MouthOpen>,
    pub emotions: Option<Vec<Emotion>>,
    pub landmarks: Option<Vec<Landmark>>,
    pub pose: Option<Pose>,
    pub quality: Option<ImageQuality>,
    pub confidence: Option<f32>,
    pub face_occluded: Option<FaceOccluded>,
    pub eye_direction: Option<EyeDirection>,
}

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.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

bounding_box: Option<BoundingBox>

Bounding box of the face. Default attribute.

age_range: Option<AgeRange>

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

smile: Option<Smile>

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

eyeglasses: Option<Eyeglasses>

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

sunglasses: Option<Sunglasses>

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

gender: Option<Gender>

The predicted gender of a detected face.

beard: Option<Beard>

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

mustache: Option<Mustache>

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

eyes_open: Option<EyeOpen>

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

mouth_open: Option<MouthOpen>

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

emotions: Option<Vec<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 person’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.

landmarks: Option<Vec<Landmark>>

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

pose: Option<Pose>

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

quality: Option<ImageQuality>

Identifies image brightness and sharpness. Default attribute.

confidence: Option<f32>

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

face_occluded: Option<FaceOccluded>

FaceOccluded should return "true" with a high confidence score if a detected face’s eyes, nose, and mouth are partially captured or if they are covered by masks, dark sunglasses, cell phones, hands, or other objects. FaceOccluded should return "false" with a high confidence score if common occurrences that do not impact face verification are detected, such as eye glasses, lightly tinted sunglasses, strands of hair, and others.

eye_direction: Option<EyeDirection>

Indicates the direction the eyes are gazing in, as defined by pitch and yaw.

Implementations

impl FaceDetail

pub fn bounding_box(&self) -> Option<&BoundingBox>

Bounding box of the face. Default attribute.

pub fn age_range(&self) -> Option<&AgeRange>

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

pub fn smile(&self) -> Option<&Smile>

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

pub fn eyeglasses(&self) -> Option<&Eyeglasses>

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

pub fn sunglasses(&self) -> Option<&Sunglasses>

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

pub fn gender(&self) -> Option<&Gender>

The predicted gender of a detected face.

pub fn beard(&self) -> Option<&Beard>

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

pub fn mustache(&self) -> Option<&Mustache>

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

pub fn eyes_open(&self) -> Option<&EyeOpen>

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

pub fn mouth_open(&self) -> Option<&MouthOpen>

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

pub fn emotions(&self) -> &[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 person’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.

If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .emotions.is_none().

pub fn landmarks(&self) -> &[Landmark]

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

If no value was sent for this field, a default will be set. If you want to determine if no value was sent, use .landmarks.is_none().

pub fn pose(&self) -> Option<&Pose>

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

pub fn quality(&self) -> Option<&ImageQuality>

Identifies image brightness and sharpness. Default attribute.

pub fn confidence(&self) -> Option<f32>

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

pub fn face_occluded(&self) -> Option<&FaceOccluded>

FaceOccluded should return "true" with a high confidence score if a detected face’s eyes, nose, and mouth are partially captured or if they are covered by masks, dark sunglasses, cell phones, hands, or other objects. FaceOccluded should return "false" with a high confidence score if common occurrences that do not impact face verification are detected, such as eye glasses, lightly tinted sunglasses, strands of hair, and others.

pub fn eye_direction(&self) -> Option<&EyeDirection>

Indicates the direction the eyes are gazing in, as defined by pitch and yaw.

impl FaceDetail

pub fn builder() -> FaceDetailBuilder

Creates a new builder-style object to manufacture FaceDetail.

Trait Implementations

impl Clone for FaceDetail

fn clone(&self) -> FaceDetail

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FaceDetail

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq for FaceDetail

fn eq(&self, other: &FaceDetail) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for FaceDetail