<!--
{
  "availability" : [
    "iOS: 11.0.0 -",
    "iPadOS: 11.0.0 -",
    "macCatalyst: 13.1.0 -",
    "macOS: 10.13.0 -",
    "tvOS: 11.0.0 -",
    "visionOS: 1.0.0 -"
  ],
  "documentType" : "symbol",
  "framework" : "Vision",
  "identifier" : "/documentation/Vision/VNFaceObservation",
  "metadataVersion" : "0.1.0",
  "role" : "Class",
  "symbol" : {
    "kind" : "Class",
    "modules" : [
      "Vision"
    ],
    "preciseIdentifier" : "c:objc(cs)VNFaceObservation"
  },
  "title" : "VNFaceObservation"
}
-->

# VNFaceObservation

Face or facial-feature information that an image analysis request detects.

```
class VNFaceObservation
```

## Overview

This type of observation results from a [`VNDetectFaceRectanglesRequest`](/documentation/Vision/VNDetectFaceRectanglesRequest). It contains information about facial landmarks and regions it finds in the image.

## Topics

### Creating an Observation

[`init(requestRevision:boundingBox:roll:yaw:pitch:)`](/documentation/Vision/VNFaceObservation/init(requestRevision:boundingBox:roll:yaw:pitch:))

Creates an observation that contains the roll, yaw, and pitch of the face.

[`init(requestRevision:boundingBox:roll:yaw:)`](/documentation/Vision/VNFaceObservation/init(requestRevision:boundingBox:roll:yaw:))

Creates an observation that contains the roll and yaw of the face.

### Identifying Landmarks

[`landmarks`](/documentation/Vision/VNFaceObservation/landmarks)

The facial features of the detected face.

[`VNFaceLandmarks2D`](/documentation/Vision/VNFaceLandmarks2D)

A collection of facial features that a request detects.

[`VNFaceLandmarkRegion2D`](/documentation/Vision/VNFaceLandmarkRegion2D)

2D geometry information for a specific facial feature.

[`VNFaceLandmarks`](/documentation/Vision/VNFaceLandmarks)

The abstract superclass for containers of face landmark information.

[`VNFaceLandmarkRegion`](/documentation/Vision/VNFaceLandmarkRegion)

The abstract superclass for information about a specific face landmark.

### Determining Facial Orientation

[`roll`](/documentation/Vision/VNFaceObservation/roll)

The roll angle of a face in radians.

[`yaw`](/documentation/Vision/VNFaceObservation/yaw)

The yaw angle of a face in radians.

[`pitch`](/documentation/Vision/VNFaceObservation/pitch)

The pitch angle of a face in radians.

### Determining Capture Quality

[`faceCaptureQuality`](/documentation/Vision/VNFaceObservation/faceCaptureQuality-bjg5)

A value that indicates the quality of the face capture.

[`faceCaptureQuality`](/documentation/Vision/VNFaceObservation/faceCaptureQuality-2o4xv)

A value that indicates the quality of the face capture.


---

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)