Class

VNDetectFaceLandmarksRequest

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

Declaration

@interface VNDetectFaceLandmarksRequest : VNImageBasedRequest

Overview

By default, a face landmarks request first locates all faces in the input image, then analyzes each to detect facial features.

If you've already located all the faces in an image, or want to detect landmarks in only a subset of the faces in the image, set the inputFaceObservations property to an array of VNFaceObservation objects representing the faces you want to analyze. (You can either use face observations output by a VNDetectFaceRectanglesRequest or manually create VNFaceObservation instances with the bounding boxes of the faces you want to analyze.)

Topics

Configuring a Face Landmarks Request

VNFaceObservationAccepting

An image analysis request that operates on face observations.

Locating Face Landmarks

constellation

A variable describing how a face landmarks request orders or enumerates the resulting features.

Beta
VNRequestFaceLandmarksConstellation

An enumeration of face landmarks in a constellation object.

Beta

Versioning Face Landmark Detection

+ revision:supportsConstellation:

A Boolean variable that indicates whether the Vision framework supports a given constellation type for a given request revision.

Beta
VNDetectFaceLandmarksRequestRevision3

A constant for specifying revision 3 of VNDetectFaceLandmarksRequest.

Beta

Relationships

Inherits From

See Also

Face Detection

VNDetectFaceRectanglesRequest

An image analysis request that finds faces within an image.

VNFaceObservation

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

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