Class

CIFaceFeature

Information about a face detected in a still or video image.

Overview

The properties of a CIFaceFeature object provide information about the face’s eyes and mouth. A face object in a video can also have properties that track its location over time—tracking ID and frame count.

Topics

Locating Faces

bounds

A rectangle indicating the position and dimensions of the face in image coordinates.

hasFaceAngle

A Boolean value that indicates whether information about face rotation is available.

faceAngle

The rotation of the face.

Identifying Facial Features

hasLeftEyePosition

A Boolean value that indicates whether the detector found the face’s left eye.

hasRightEyePosition

A Boolean value that indicates whether the detector found the face’s right eye.

hasMouthPosition

A Boolean value that indicates whether the detector found the face’s mouth.

leftEyePosition

The coordinates of the left eye, in image coordinates.

rightEyePosition

The coordinates of the right eye, in image coordinates

mouthPosition

The coordinates of the mouth, in image coordinates

hasSmile

A Boolean value that indicates whether a smile is detected in the face.

leftEyeClosed

A Boolean value that indicates whether the a closed left eye is detected in the face.

rightEyeClosed

A Boolean value that indicates whether the a closed left eye is detected in the face.

Tracking Distinct Faces in Video

hasTrackingID

A Boolean value that indicates whether the face object has a tracking ID.

trackingID

The tracking identifier of the face object.

hasTrackingFrameCount

A Boolean value that indicates the face object has a tracking frame count.

trackingFrameCount

The tracking frame count of the face.

Relationships

Inherits From

See Also

Image Feature Detection

CIDetector

An image processor that identifies notable features (such as faces and barcodes) in a still image or video.

CIFeature

The abstract superclass for objects representing notable features detected in an image.

CIRectangleFeature

Information about a rectangular region detected in a still or video image.

CITextFeature

Information about a region likely to contain text detected in a still or video image.

CIQRCodeFeature

Information about a Quick Response code (a kind of 2D barcode) detected in a still or video image.