Class

CIFaceFeature

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

Declaration

class CIFaceFeature : CIFeature

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

var bounds: CGRect

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

var hasFaceAngle: Bool

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

var faceAngle: Float

The rotation of the face.

Identifying Facial Features

var hasLeftEyePosition: Bool

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

var hasRightEyePosition: Bool

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

var hasMouthPosition: Bool

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

var leftEyePosition: CGPoint

The coordinates of the left eye, in image coordinates.

var rightEyePosition: CGPoint

The coordinates of the right eye, in image coordinates

var mouthPosition: CGPoint

The coordinates of the mouth, in image coordinates

var hasSmile: Bool

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

var leftEyeClosed: Bool

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

var rightEyeClosed: Bool

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

Tracking Distinct Faces in Video

var hasTrackingID: Bool

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

var trackingID: Int32

The tracking identifier of the face object.

var hasTrackingFrameCount: Bool

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

var trackingFrameCount: Int32

The tracking frame count of the face.

Relationships

Inherits From

CIFeature