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

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

See Also

Image Feature Detection

class CIDetector

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

class CIFeature

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

class CIRectangleFeature

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

class CITextFeature

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

class CIQRCodeFeature

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