Struct CompareFacesOutput

#[non_exhaustive]
pub struct CompareFacesOutput {
    pub source_image_face: Option<ComparedSourceImageFace>,
    pub face_matches: Option<Vec<CompareFacesMatch>>,
    pub unmatched_faces: Option<Vec<ComparedFace>>,
    pub source_image_orientation_correction: Option<OrientationCorrection>,
    pub target_image_orientation_correction: Option<OrientationCorrection>,
    /* private fields */
}

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.

source_image_face: Option<ComparedSourceImageFace>

The face in the source image that was used for comparison.

face_matches: Option<Vec<CompareFacesMatch>>

An array of faces in the target image that match the source image face. Each CompareFacesMatch object provides the bounding box, the confidence level that the bounding box contains a face, and the similarity score for the face in the bounding box and the face in the source image.

unmatched_faces: Option<Vec<ComparedFace>>

An array of faces in the target image that did not match the source image face.

source_image_orientation_correction: Option<OrientationCorrection>

The value of SourceImageOrientationCorrection is always null.

If the input image is in .jpeg format, it might contain exchangeable image file format (Exif) metadata that includes the image's orientation. Amazon Rekognition uses this orientation information to perform image correction. The bounding box coordinates are translated to represent object locations after the orientation information in the Exif metadata is used to correct the image orientation. Images in .png format don't contain Exif metadata.

Amazon Rekognition doesn’t perform image correction for images in .png format and .jpeg images without orientation information in the image Exif metadata. The bounding box coordinates aren't translated and represent the object locations before the image is rotated.

target_image_orientation_correction: Option<OrientationCorrection>

The value of TargetImageOrientationCorrection is always null.

If the input image is in .jpeg format, it might contain exchangeable image file format (Exif) metadata that includes the image's orientation. Amazon Rekognition uses this orientation information to perform image correction. The bounding box coordinates are translated to represent object locations after the orientation information in the Exif metadata is used to correct the image orientation. Images in .png format don't contain Exif metadata.

Amazon Rekognition doesn’t perform image correction for images in .png format and .jpeg images without orientation information in the image Exif metadata. The bounding box coordinates aren't translated and represent the object locations before the image is rotated.

Implementations

impl CompareFacesOutput

pub fn source_image_face(&self) -> Option<&ComparedSourceImageFace>

The face in the source image that was used for comparison.

pub fn face_matches(&self) -> &[CompareFacesMatch]

An array of faces in the target image that match the source image face. Each CompareFacesMatch object provides the bounding box, the confidence level that the bounding box contains a face, and the similarity score for the face in the bounding box and the face in the source image.

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

pub fn unmatched_faces(&self) -> &[ComparedFace]

An array of faces in the target image that did not match the source image face.

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

pub fn source_image_orientation_correction( &self, ) -> Option<&OrientationCorrection>

The value of SourceImageOrientationCorrection is always null.

If the input image is in .jpeg format, it might contain exchangeable image file format (Exif) metadata that includes the image's orientation. Amazon Rekognition uses this orientation information to perform image correction. The bounding box coordinates are translated to represent object locations after the orientation information in the Exif metadata is used to correct the image orientation. Images in .png format don't contain Exif metadata.

Amazon Rekognition doesn’t perform image correction for images in .png format and .jpeg images without orientation information in the image Exif metadata. The bounding box coordinates aren't translated and represent the object locations before the image is rotated.

pub fn target_image_orientation_correction( &self, ) -> Option<&OrientationCorrection>

The value of TargetImageOrientationCorrection is always null.

If the input image is in .jpeg format, it might contain exchangeable image file format (Exif) metadata that includes the image's orientation. Amazon Rekognition uses this orientation information to perform image correction. The bounding box coordinates are translated to represent object locations after the orientation information in the Exif metadata is used to correct the image orientation. Images in .png format don't contain Exif metadata.

Amazon Rekognition doesn’t perform image correction for images in .png format and .jpeg images without orientation information in the image Exif metadata. The bounding box coordinates aren't translated and represent the object locations before the image is rotated.

impl CompareFacesOutput

pub fn builder() -> CompareFacesOutputBuilder

Creates a new builder-style object to manufacture CompareFacesOutput.

Trait Implementations

impl Clone for CompareFacesOutput

fn clone(&self) -> CompareFacesOutput

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CompareFacesOutput

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

Formats the value using the given formatter.

impl PartialEq for CompareFacesOutput

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl RequestId for CompareFacesOutput

fn request_id(&self) -> Option<&str>

Returns the request ID, or None if the service could not be reached.

impl StructuralPartialEq for CompareFacesOutput