Skip to content

/AWS1/CL_REKCOMPAREFACESRSP

CompareFacesResponse

CONSTRUCTOR

IMPORTING

Optional arguments:

io_sourceimageface TYPE REF TO /AWS1/CL_REKCOMPAREDSRCIMAGE00 /AWS1/CL_REKCOMPAREDSRCIMAGE00

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

it_facematches TYPE /AWS1/CL_REKCOMPAREFACESMATCH=>TT_COMPAREFACESMATCHLIST TT_COMPAREFACESMATCHLIST

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.

it_unmatchedfaces TYPE /AWS1/CL_REKCOMPAREDFACE=>TT_COMPAREFACESUNMATCHLIST TT_COMPAREFACESUNMATCHLIST

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

iv_srcimageorientationcorr TYPE /AWS1/REKORIENTATIONCORRECTION /AWS1/REKORIENTATIONCORRECTION

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.

iv_tgtimageorientationcorr TYPE /AWS1/REKORIENTATIONCORRECTION /AWS1/REKORIENTATIONCORRECTION

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.


Queryable Attributes

SourceImageFace

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

Accessible with the following methods

Method Description
GET_SOURCEIMAGEFACE() Getter for SOURCEIMAGEFACE

FaceMatches

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.

Accessible with the following methods

Method Description
GET_FACEMATCHES() Getter for FACEMATCHES, with configurable default
ASK_FACEMATCHES() Getter for FACEMATCHES w/ exceptions if field has no value
HAS_FACEMATCHES() Determine if FACEMATCHES has a value

UnmatchedFaces

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

Accessible with the following methods

Method Description
GET_UNMATCHEDFACES() Getter for UNMATCHEDFACES, with configurable default
ASK_UNMATCHEDFACES() Getter for UNMATCHEDFACES w/ exceptions if field has no valu
HAS_UNMATCHEDFACES() Determine if UNMATCHEDFACES has a value

SourceImageOrientationCorrection

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.

Accessible with the following methods

Method Description
GET_SRCIMAGEORIENTATIONCORR() Getter for SOURCEIMAGEORIENTATIONCORR, with configurable def
ASK_SRCIMAGEORIENTATIONCORR() Getter for SOURCEIMAGEORIENTATIONCORR w/ exceptions if field
HAS_SRCIMAGEORIENTATIONCORR() Determine if SOURCEIMAGEORIENTATIONCORR has a value

TargetImageOrientationCorrection

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.

Accessible with the following methods

Method Description
GET_TGTIMAGEORIENTATIONCORR() Getter for TARGETIMAGEORIENTATIONCORR, with configurable def
ASK_TGTIMAGEORIENTATIONCORR() Getter for TARGETIMAGEORIENTATIONCORR w/ exceptions if field
HAS_TGTIMAGEORIENTATIONCORR() Determine if TARGETIMAGEORIENTATIONCORR has a value