Class FaceAnnotation

A face annotation object contains the results of face detection.

Attributes
NameDescription
google.cloud.vision_v1p3beta1.types.BoundingPolybounding_poly
The bounding polygon around the face. The coordinates of the bounding box are in the original image's scale, as returned in ``ImageParams``. The bounding box is computed to "frame" the face in accordance with human expectations. It is based on the landmarker results. Note that one or more x and/or y coordinates may not be generated in the ``BoundingPoly`` (the polygon will be unbounded) if only a partial face appears in the image to be annotated.
google.cloud.vision_v1p3beta1.types.BoundingPolyfd_bounding_poly
The ``fd_bounding_poly`` bounding polygon is tighter than the ``boundingPoly``, and encloses only the skin part of the face. Typically, it is used to eliminate the face from any image analysis that detects the "amount of skin" visible in an image. It is not based on the landmarker results, only on the initial face detection, hence the fd (face detection) prefix.
Sequence[google.cloud.vision_v1p3beta1.types.FaceAnnotation.Landmark]landmarks
Detected face landmarks.
floatroll_angle
Roll angle, which indicates the amount of clockwise/anti-clockwise rotation of the face relative to the image vertical about the axis perpendicular to the face. Range [-180,180].
floatpan_angle
Yaw angle, which indicates the leftward/rightward angle that the face is pointing relative to the vertical plane perpendicular to the image. Range [-180,180].
floattilt_angle
Pitch angle, which indicates the upwards/downwards angle that the face is pointing relative to the image's horizontal plane. Range [-180,180].
floatdetection_confidence
Detection confidence. Range [0, 1].
floatlandmarking_confidence
Face landmarking confidence. Range [0, 1].
google.cloud.vision_v1p3beta1.types.Likelihoodjoy_likelihood
Joy likelihood.
google.cloud.vision_v1p3beta1.types.Likelihoodsorrow_likelihood
Sorrow likelihood.
google.cloud.vision_v1p3beta1.types.Likelihoodanger_likelihood
Anger likelihood.
google.cloud.vision_v1p3beta1.types.Likelihoodsurprise_likelihood
Surprise likelihood.
google.cloud.vision_v1p3beta1.types.Likelihoodunder_exposed_likelihood
Under-exposed likelihood.
google.cloud.vision_v1p3beta1.types.Likelihoodblurred_likelihood
Blurred likelihood.
google.cloud.vision_v1p3beta1.types.Likelihoodheadwear_likelihood
Headwear likelihood.

Inheritance

builtins.object > proto.message.Message > FaceAnnotation

Classes

Landmark

Landmark(mapping=None, *, ignore_unknown_fields=False, **kwargs)

A face-specific landmark (for example, a face feature).