Package software.amazon.awssdk.services.rekognition.model

Interface CompareFacesResponse.Builder

    • Method Detail

      • sourceImageFace

        CompareFacesResponse.Builder sourceImageFace​(ComparedSourceImageFace sourceImageFace)

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

        Parameters:
        sourceImageFace - The face in the source image that was used for comparison.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • faceMatches

        CompareFacesResponse.Builder faceMatches​(Collection<CompareFacesMatch> 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.

        Parameters:
        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.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • faceMatches

        CompareFacesResponse.Builder faceMatches​(CompareFacesMatch... 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.

        Parameters:
        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.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • faceMatches

        CompareFacesResponse.Builder faceMatches​(Consumer<CompareFacesMatch.Builder>... 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.

        This is a convenience method that creates an instance of the CompareFacesMatch.Builder avoiding the need to create one manually via CompareFacesMatch.builder() .

        When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to #faceMatches(List).

        Parameters:
        faceMatches - a consumer that will call methods on CompareFacesMatch.Builder
        Returns:
        Returns a reference to this object so that method calls can be chained together.
        See Also:
        #faceMatches(java.util.Collection)

      • unmatchedFaces

        CompareFacesResponse.Builder unmatchedFaces​(Collection<ComparedFace> unmatchedFaces)

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

        Parameters:
        unmatchedFaces - An array of faces in the target image that did not match the source image face.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • unmatchedFaces

        CompareFacesResponse.Builder unmatchedFaces​(ComparedFace... unmatchedFaces)

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

        Parameters:
        unmatchedFaces - An array of faces in the target image that did not match the source image face.
        Returns:
        Returns a reference to this object so that method calls can be chained together.

      • sourceImageOrientationCorrection

        CompareFacesResponse.Builder sourceImageOrientationCorrection​(String 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.

        Parameters:
        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.

        Returns:
        Returns a reference to this object so that method calls can be chained together.
        See Also:
        OrientationCorrection, OrientationCorrection

      • sourceImageOrientationCorrection

        CompareFacesResponse.Builder sourceImageOrientationCorrection​(OrientationCorrection 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.

        Parameters:
        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.

        Returns:
        Returns a reference to this object so that method calls can be chained together.
        See Also:
        OrientationCorrection, OrientationCorrection

      • targetImageOrientationCorrection

        CompareFacesResponse.Builder targetImageOrientationCorrection​(String 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.

        Parameters:
        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.

        Returns:
        Returns a reference to this object so that method calls can be chained together.
        See Also:
        OrientationCorrection, OrientationCorrection

      • targetImageOrientationCorrection

        CompareFacesResponse.Builder targetImageOrientationCorrection​(OrientationCorrection 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.

        Parameters:
        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.

        Returns:
        Returns a reference to this object so that method calls can be chained together.
        See Also:
        OrientationCorrection, OrientationCorrection