<!--
{
  "availability" : [
    "iOS: 5.0.0 -",
    "iPadOS: 5.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.7.0 -",
    "tvOS: -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "CoreImage",
  "identifier" : "/documentation/CoreImage/CIFaceFeature",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Core Image"
    ],
    "preciseIdentifier" : "c:objc(cs)CIFaceFeature"
  },
  "title" : "CIFaceFeature"
}
-->

# CIFaceFeature

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

```
class CIFaceFeature
```

## Overview> Note: In macOS 10.13, iOS 11, and tvOS 11 or later, the Vision framework replaces this
> class for identifying and analyzing image features. See `VNDetectFaceRectanglesRequest`.
> See <doc://com.apple.documentation/documentation/Vision/VNDetectFaceRectanglesRequest>)

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`](/documentation/CoreImage/CIFaceFeature/bounds-swift.property)

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

[`hasFaceAngle`](/documentation/CoreImage/CIFaceFeature/hasFaceAngle-swift.property)

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

[`faceAngle`](/documentation/CoreImage/CIFaceFeature/faceAngle-swift.property)

The rotation of the face.

### Identifying Facial Features

[`hasLeftEyePosition`](/documentation/CoreImage/CIFaceFeature/hasLeftEyePosition-swift.property)

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

[`hasRightEyePosition`](/documentation/CoreImage/CIFaceFeature/hasRightEyePosition-swift.property)

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

[`hasMouthPosition`](/documentation/CoreImage/CIFaceFeature/hasMouthPosition-swift.property)

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

[`leftEyePosition`](/documentation/CoreImage/CIFaceFeature/leftEyePosition-swift.property)

The image coordinate of the center of the left eye.

[`rightEyePosition`](/documentation/CoreImage/CIFaceFeature/rightEyePosition-swift.property)

The image coordinate of the center of the right eye.

[`mouthPosition`](/documentation/CoreImage/CIFaceFeature/mouthPosition-swift.property)

The image coordinate of the center of the mouth.

[`hasSmile`](/documentation/CoreImage/CIFaceFeature/hasSmile-swift.property)

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

[`leftEyeClosed`](/documentation/CoreImage/CIFaceFeature/leftEyeClosed-swift.property)

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

[`rightEyeClosed`](/documentation/CoreImage/CIFaceFeature/rightEyeClosed-swift.property)

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

### Tracking Distinct Faces in Video

[`hasTrackingID`](/documentation/CoreImage/CIFaceFeature/hasTrackingID-swift.property)

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

[`trackingID`](/documentation/CoreImage/CIFaceFeature/trackingID-swift.property)

The tracking identifier of the face object.

[`hasTrackingFrameCount`](/documentation/CoreImage/CIFaceFeature/hasTrackingFrameCount-swift.property)

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

[`trackingFrameCount`](/documentation/CoreImage/CIFaceFeature/trackingFrameCount-swift.property)

The tracking frame count of the face.


---

Copyright &copy; 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)