The level of confidence normalized to `[0, 1]` where `1` is most confident.
The only exception is results coming from `CoreMLRequest`, where confidence values are forwarded as is from relevant CoreML models
- Parameters:
- boundingBox: The bounding rectangle of the detected face.
- revision: The revision of the `DetectFaceRectanglesRequest` that provided the bounding box.
If no revision is provided, a default value is assumed. Different revisions can affect how the bounding box is interpreted by Vision.
get · iOS 18.0+
boundingBox
TypeScript
get boundingBox(): NormalizedRect
Swift declaration
var boundingBox: NormalizedRect
The bounding box of the object.
The coordinate system is normalized to the dimensions of the processed image, with the origin at the lower-left corner of the image.
set · iOS 18.0+
boundingBox
TypeScript
set boundingBox(value: NormalizedRect)
Swift declaration
var boundingBox: NormalizedRect
The bounding box of the object.
The coordinate system is normalized to the dimensions of the processed image, with the origin at the lower-left corner of the image.
get · iOS 18.0+
description
TypeScript
get description(): string
Swift declaration
var description: String { get }
A textual representation of this instance.
Calling this property directly is discouraged. Instead, convert an
instance of any type to a string by using the `String(describing:)`
initializer. This initializer works with any type, and uses the custom
`description` property for types that conform to
`CustomStringConvertible`:
struct Point: CustomStringConvertible {
let x: Int, y: Int
var description: String {
return "(\(x), \(y))"
}
}
let p = Point(x: 21, y: 30)
let s = String(describing: p)
print(s)
// Prints "(21, 30)"
The conversion of `p` to a string in the assignment to `s` uses the
`Point` type's `description` property.
get · iOS 18.0+
captureQuality
TypeScript
get captureQuality(): (FaceObservation_CaptureQuality) | null
Swift declaration
var captureQuality: FaceObservation.CaptureQuality?
The quality of the face capture.
This value is nil for face observations produced by a `DetectFaceRectanglesRequest` analysis.
Use ``DetectFaceCaptureQualityRequest`` to detect capture quality.
set · iOS 18.0+
captureQuality
TypeScript
set captureQuality(value: (FaceObservation_CaptureQuality) | null)
Swift declaration
var captureQuality: FaceObservation.CaptureQuality?
The quality of the face capture.
This value is nil for face observations produced by a `DetectFaceRectanglesRequest` analysis.
Use ``DetectFaceCaptureQualityRequest`` to detect capture quality.
get · iOS 18.0+
originatingRequestDescriptor
TypeScript
get originatingRequestDescriptor(): (RequestDescriptor) | null
Swift declaration
let originatingRequestDescriptor: RequestDescriptor?
The descriptor of the request that produced the observation.
get · iOS 18.0+
yaw
TypeScript
get yaw(): _Foundation_Measurement<_Foundation_UnitAngle>
Swift declaration
let yaw: Measurement<UnitAngle>
The yaw angle of a face.
This value indicates the rotational angle of the face around the y-axis.
get · iOS 18.0+
roll
TypeScript
get roll(): _Foundation_Measurement<_Foundation_UnitAngle>
Swift declaration
let roll: Measurement<UnitAngle>
The roll angle of a face.
This value indicates the rotational angle of the face around the z-axis.
get · iOS 18.0+
uuid
TypeScript
get uuid(): string
Swift declaration
let uuid: UUID
The unique identifier for the observation.
get · iOS 18.0+
pitch
TypeScript
get pitch(): _Foundation_Measurement<_Foundation_UnitAngle>
Swift declaration
let pitch: Measurement<UnitAngle>
The pitch angle of a face.
This value indicates the rotational angle of the face around the x-axis.
get · iOS 18.0+
landmarks
TypeScript
get landmarks(): (FaceObservation_Landmarks2D) | null
Swift declaration
var landmarks: FaceObservation.Landmarks2D?
The facial features of the detected face.
This value is nil for face observations produced by a `DetectFaceRectanglesRequest` analysis.
Use the `DetectFaceLandmarksRequest` class to find facial features.
set · iOS 18.0+
landmarks
TypeScript
set landmarks(value: (FaceObservation_Landmarks2D) | null)
Swift declaration
var landmarks: FaceObservation.Landmarks2D?
The facial features of the detected face.
This value is nil for face observations produced by a `DetectFaceRectanglesRequest` analysis.
Use the `DetectFaceLandmarksRequest` class to find facial features.
get · iOS 18.0+
timeRange
TypeScript
get timeRange(): (_CoreMedia_CMTimeRange) | null
Swift declaration
let timeRange: CMTimeRange?
The time range of the reported observation.
When evaluating a sequence of image buffers, use this property to determine each observation’s start time and duration.