Interface RecognizeCelebritiesResponse.Builder

  • Method Details

    • celebrityFaces

      Details about each celebrity found in the image. Amazon Rekognition can detect a maximum of 64 celebrities in an image. Each celebrity object includes the following attributes: Face, Confidence, Emotions, Landmarks, Pose, Quality, Smile, Id, KnownGender, MatchConfidence, Name, Urls .

      Parameters:
      celebrityFaces - Details about each celebrity found in the image. Amazon Rekognition can detect a maximum of 64 celebrities in an image. Each celebrity object includes the following attributes: Face, Confidence, Emotions, Landmarks, Pose, Quality, Smile, Id, KnownGender, MatchConfidence, Name, Urls.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
    • celebrityFaces

      RecognizeCelebritiesResponse.Builder celebrityFaces(Celebrity... celebrityFaces)

      Details about each celebrity found in the image. Amazon Rekognition can detect a maximum of 64 celebrities in an image. Each celebrity object includes the following attributes: Face, Confidence, Emotions, Landmarks, Pose, Quality, Smile, Id, KnownGender, MatchConfidence, Name, Urls .

      Parameters:
      celebrityFaces - Details about each celebrity found in the image. Amazon Rekognition can detect a maximum of 64 celebrities in an image. Each celebrity object includes the following attributes: Face, Confidence, Emotions, Landmarks, Pose, Quality, Smile, Id, KnownGender, MatchConfidence, Name, Urls.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
    • celebrityFaces

      Details about each celebrity found in the image. Amazon Rekognition can detect a maximum of 64 celebrities in an image. Each celebrity object includes the following attributes: Face, Confidence, Emotions, Landmarks, Pose, Quality, Smile, Id, KnownGender, MatchConfidence, Name, Urls .

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

      When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to celebrityFaces(List<Celebrity>).

      Parameters:
      celebrityFaces - a consumer that will call methods on Celebrity.Builder
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:
    • unrecognizedFaces

      RecognizeCelebritiesResponse.Builder unrecognizedFaces(Collection<ComparedFace> unrecognizedFaces)

      Details about each unrecognized face in the image.

      Parameters:
      unrecognizedFaces - Details about each unrecognized face in the image.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
    • unrecognizedFaces

      RecognizeCelebritiesResponse.Builder unrecognizedFaces(ComparedFace... unrecognizedFaces)

      Details about each unrecognized face in the image.

      Parameters:
      unrecognizedFaces - Details about each unrecognized face in the image.
      Returns:
      Returns a reference to this object so that method calls can be chained together.
    • unrecognizedFaces

      RecognizeCelebritiesResponse.Builder unrecognizedFaces(Consumer<ComparedFace.Builder>... unrecognizedFaces)

      Details about each unrecognized face in the image.

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

      When the Consumer completes, SdkBuilder.build() is called immediately and its result is passed to unrecognizedFaces(List<ComparedFace>).

      Parameters:
      unrecognizedFaces - a consumer that will call methods on ComparedFace.Builder
      Returns:
      Returns a reference to this object so that method calls can be chained together.
      See Also:
    • orientationCorrection

      RecognizeCelebritiesResponse.Builder orientationCorrection(String orientationCorrection)

      Support for estimating image orientation using the the OrientationCorrection field has ceased as of August 2021. Any returned values for this field included in an API response will always be NULL.

      The orientation of the input image (counterclockwise direction). If your application displays the image, you can use this value to correct the orientation. The bounding box coordinates returned in CelebrityFaces and UnrecognizedFaces represent face locations before the image orientation is corrected.

      If the input image is in .jpeg format, it might contain exchangeable image (Exif) metadata that includes the image's orientation. If so, and the Exif metadata for the input image populates the orientation field, the value of OrientationCorrection is null. The CelebrityFaces and UnrecognizedFaces bounding box coordinates represent face locations after Exif metadata is used to correct the image orientation. Images in .png format don't contain Exif metadata.

      Parameters:
      orientationCorrection -

      Support for estimating image orientation using the the OrientationCorrection field has ceased as of August 2021. Any returned values for this field included in an API response will always be NULL.

      The orientation of the input image (counterclockwise direction). If your application displays the image, you can use this value to correct the orientation. The bounding box coordinates returned in CelebrityFaces and UnrecognizedFaces represent face locations before the image orientation is corrected.

      If the input image is in .jpeg format, it might contain exchangeable image (Exif) metadata that includes the image's orientation. If so, and the Exif metadata for the input image populates the orientation field, the value of OrientationCorrection is null. The CelebrityFaces and UnrecognizedFaces bounding box coordinates represent face locations after Exif metadata is used to correct the image orientation. Images in .png format don't contain Exif metadata.

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

      RecognizeCelebritiesResponse.Builder orientationCorrection(OrientationCorrection orientationCorrection)

      Support for estimating image orientation using the the OrientationCorrection field has ceased as of August 2021. Any returned values for this field included in an API response will always be NULL.

      The orientation of the input image (counterclockwise direction). If your application displays the image, you can use this value to correct the orientation. The bounding box coordinates returned in CelebrityFaces and UnrecognizedFaces represent face locations before the image orientation is corrected.

      If the input image is in .jpeg format, it might contain exchangeable image (Exif) metadata that includes the image's orientation. If so, and the Exif metadata for the input image populates the orientation field, the value of OrientationCorrection is null. The CelebrityFaces and UnrecognizedFaces bounding box coordinates represent face locations after Exif metadata is used to correct the image orientation. Images in .png format don't contain Exif metadata.

      Parameters:
      orientationCorrection -

      Support for estimating image orientation using the the OrientationCorrection field has ceased as of August 2021. Any returned values for this field included in an API response will always be NULL.

      The orientation of the input image (counterclockwise direction). If your application displays the image, you can use this value to correct the orientation. The bounding box coordinates returned in CelebrityFaces and UnrecognizedFaces represent face locations before the image orientation is corrected.

      If the input image is in .jpeg format, it might contain exchangeable image (Exif) metadata that includes the image's orientation. If so, and the Exif metadata for the input image populates the orientation field, the value of OrientationCorrection is null. The CelebrityFaces and UnrecognizedFaces bounding box coordinates represent face locations after Exif metadata is used to correct the image orientation. Images in .png format don't contain Exif metadata.

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