Class

VNFaceObservation

Face or facial-feature information detected by an image analysis request.

Declaration

@interface VNFaceObservation : VNDetectedObjectObservation

Overview

This type of observation results from a VNDetectFaceRectanglesRequest. It contains information about facial landmarks and regions found in the image.

Topics

Creating an Observation

+ faceObservationWithRequestRevision:boundingBox:roll:yaw:

Creates a face observation with the given revision number, bounding box, roll, and yaw.

Finding Face Landmarks

landmarks

The facial features found in the detected face.

VNFaceLandmarks2D

A collection of all facial features detected in a face observation, with 2D geometry information for each.

VNFaceLandmarkRegion2D

2D geometry information for a specific facial feature.

VNFaceLandmarks

The abstract superclass for containers of face landmark information.

VNFaceLandmarkRegion

The abstract superclass for information about a specific face landmark.

Determining Facial Orientation

roll

The detected face's roll angle, as populated by the VNDetectFaceRectanglesRequest.

yaw

The detected face's yaw angle, as populated by the VNDetectFaceRectanglesRequest.

Determining Capture Quality

faceCaptureQuality

The capture quality of the face, normalized between 0.0 and 1.0.

Beta
VNDetectFaceCaptureQualityRequest

A request that produces a floating-point number representing the capture quality of a given face in a photo.

Beta

Relationships

See Also

Face Detection

VNDetectFaceRectanglesRequest

An image analysis request that finds faces within an image.

VNDetectFaceLandmarksRequest

An image analysis request that finds facial features (such as the eyes and mouth) in an image.

Beta Software

This documentation contains preliminary information about an API or technology in development. This information is subject to change, and software implemented according to this documentation should be tested with final operating system software.

Learn more about using Apple's beta software