Module Values.DetectFacesResponseSource

Detects faces within an image that is provided as input. DetectFaces detects the 100 largest faces in the image. For each face detected, the operation returns face details. These details include a bounding box of the face, a confidence value (that the bounding box contains a face), and a fixed set of attributes such as facial landmarks (for example, coordinates of eye and mouth), pose, presence of facial occlusion, and so on. The face-detection algorithm is most effective on frontal faces. For non-frontal or obscured faces, the algorithm might not detect the faces or might detect faces with lower confidence. You pass the input image either as base64-encoded image bytes or as a reference to an image in an Amazon S3 bucket. If you use the AWS CLI to call Amazon Rekognition operations, passing image bytes is not supported. The image must be either a PNG or JPEG formatted file. This is a stateless API operation. That is, the operation does not persist any data. This operation requires permissions to perform the rekognition:DetectFaces action.

Sourcetype nonrec t = {
  1. faceDetails : FaceDetailList.t option;
    (*

    Details of each face found in the image.

    *)
  2. orientationCorrection : OrientationCorrection.t option;
    (*

    The value of OrientationCorrection 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.

    *)
}
Sourcetype nonrec error = [
  1. | `AccessDeniedException of AccessDeniedException.t
  2. | `ImageTooLargeException of ImageTooLargeException.t
  3. | `InternalServerError of InternalServerError.t
  4. | `InvalidImageFormatException of InvalidImageFormatException.t
  5. | `InvalidParameterException of InvalidParameterException.t
  6. | `InvalidS3ObjectException of InvalidS3ObjectException.t
  7. | `ProvisionedThroughputExceededException of ProvisionedThroughputExceededException.t
  8. | `ThrottlingException of ThrottlingException.t
  9. | `Unknown_operation_error of string * string option
]
Sourceval make : ?faceDetails:??? -> ?orientationCorrection:??? -> unit -> t
Sourceval error_of_json : string -> Yojson.Safe.t -> [> `AccessDeniedException of unit | `ImageTooLargeException of unit | `InternalServerError of unit | `InvalidImageFormatException of unit | `InvalidParameterException of unit | `InvalidS3ObjectException of unit | `ProvisionedThroughputExceededException of unit | `ThrottlingException of unit | `Unknown_operation_error of string * string option ]
Sourceval error_of_xml : string -> Awso.Xml.t -> [> `AccessDeniedException of unit | `ImageTooLargeException of unit | `InternalServerError of unit | `InvalidImageFormatException of unit | `InvalidParameterException of unit | `InvalidS3ObjectException of unit | `ProvisionedThroughputExceededException of unit | `ThrottlingException of unit | `Unknown_operation_error of string * string option ]
Sourceval error_to_json : error -> Yojson.Safe.t
Sourceval to_value : t -> [> `Structure of (string * [> `Enum of string | `List of [> `Structure of (string * [> `Float of Percent.t | `List of [> `Structure of (string * [> `Enum of string | `Float of Percent.t ]) list ] list | `Structure of (string * [> `Boolean of Boolean.t | `Enum of string | `Float of Float_.t | `Integer of UInteger.t ]) list ]) list ] list ]) list ]
Sourceval to_query : t -> Awso.Client.Query.t
Sourceval of_xml : Awso.Xml.t -> t
Sourceval of_string : string -> t
Sourceval of_json : Yojson.Safe.t -> t
Sourceval to_json : t -> Yojson.Safe.t