Struct FaceAnnotation 

#[non_exhaustive]
pub struct FaceAnnotation {

    pub bounding_poly: Option<BoundingPoly>,
    pub fd_bounding_poly: Option<BoundingPoly>,
    pub landmarks: Vec<Landmark>,
    pub roll_angle: f32,
    pub pan_angle: f32,
    pub tilt_angle: f32,
    pub detection_confidence: f32,
    pub landmarking_confidence: f32,
    pub joy_likelihood: Likelihood,
    pub sorrow_likelihood: Likelihood,
    pub anger_likelihood: Likelihood,
    pub surprise_likelihood: Likelihood,
    pub under_exposed_likelihood: Likelihood,
    pub blurred_likelihood: Likelihood,
    pub headwear_likelihood: Likelihood,
    /* private fields */
}

A face annotation object contains the results of face detection.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

bounding_poly: Option<BoundingPoly>

The bounding polygon around the face. The coordinates of the bounding box are in the original image’s scale. 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.

fd_bounding_poly: Option<BoundingPoly>

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 <code>fd</code> (face detection) prefix.

landmarks: Vec<Landmark>

Detected face landmarks.

roll_angle: f32

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].

pan_angle: f32

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].

tilt_angle: f32

Pitch angle, which indicates the upwards/downwards angle that the face is pointing relative to the image’s horizontal plane. Range [-180,180].

detection_confidence: f32

Detection confidence. Range [0, 1].

landmarking_confidence: f32

Face landmarking confidence. Range [0, 1].

joy_likelihood: Likelihood

Joy likelihood.

sorrow_likelihood: Likelihood

Sorrow likelihood.

anger_likelihood: Likelihood

Anger likelihood.

surprise_likelihood: Likelihood

Surprise likelihood.

under_exposed_likelihood: Likelihood

Under-exposed likelihood.

blurred_likelihood: Likelihood

Blurred likelihood.

headwear_likelihood: Likelihood

Headwear likelihood.

Implementations

impl FaceAnnotation

pub fn new() -> Self

pub fn set_bounding_poly<T>(self, v: T) -> Self

where T: Into<BoundingPoly>,

Sets the value of bounding_poly.

pub fn set_or_clear_bounding_poly<T>(self, v: Option<T>) -> Self

where T: Into<BoundingPoly>,

Sets or clears the value of bounding_poly.

pub fn set_fd_bounding_poly<T>(self, v: T) -> Self

where T: Into<BoundingPoly>,

Sets the value of fd_bounding_poly.

pub fn set_or_clear_fd_bounding_poly<T>(self, v: Option<T>) -> Self

where T: Into<BoundingPoly>,

Sets or clears the value of fd_bounding_poly.

pub fn set_landmarks<T, V>(self, v: T) -> Self

where T: IntoIterator<Item = V>, V: Into<Landmark>,

Sets the value of landmarks.

pub fn set_roll_angle<T: Into<f32>>(self, v: T) -> Self

Sets the value of roll_angle.

pub fn set_pan_angle<T: Into<f32>>(self, v: T) -> Self

Sets the value of pan_angle.

pub fn set_tilt_angle<T: Into<f32>>(self, v: T) -> Self

Sets the value of tilt_angle.

pub fn set_detection_confidence<T: Into<f32>>(self, v: T) -> Self

Sets the value of detection_confidence.

pub fn set_landmarking_confidence<T: Into<f32>>(self, v: T) -> Self

Sets the value of landmarking_confidence.

pub fn set_joy_likelihood<T: Into<Likelihood>>(self, v: T) -> Self

Sets the value of joy_likelihood.

pub fn set_sorrow_likelihood<T: Into<Likelihood>>(self, v: T) -> Self

Sets the value of sorrow_likelihood.

pub fn set_anger_likelihood<T: Into<Likelihood>>(self, v: T) -> Self

Sets the value of anger_likelihood.

pub fn set_surprise_likelihood<T: Into<Likelihood>>(self, v: T) -> Self

Sets the value of surprise_likelihood.

pub fn set_under_exposed_likelihood<T: Into<Likelihood>>(self, v: T) -> Self

Sets the value of under_exposed_likelihood.

pub fn set_blurred_likelihood<T: Into<Likelihood>>(self, v: T) -> Self

Sets the value of blurred_likelihood.

pub fn set_headwear_likelihood<T: Into<Likelihood>>(self, v: T) -> Self

Sets the value of headwear_likelihood.

Trait Implementations

impl Clone for FaceAnnotation

fn clone(&self) -> FaceAnnotation

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FaceAnnotation

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for FaceAnnotation

fn default() -> FaceAnnotation

Returns the “default value” for a type.

impl Message for FaceAnnotation

fn typename() -> &'static str

The typename of this message.

impl PartialEq for FaceAnnotation

fn eq(&self, other: &FaceAnnotation) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for FaceAnnotation