struct · iOS 18.0+ · SDK 27.1
struct DetectFaceCaptureQualityRequestA request that determines the capture quality of faces in a photo. This request produces one ``FaceObservation`` object for each face analyzed. The `FaceObservation` will have a non-nil `captureQuality` containing a score that ranges in value from 0 to 1. Faces with quality closer to 1 are better lit, sharper, and more centrally positioned than faces with quality closer to 0. By default, a capture quality request first locates all faces in the input image, then analyzes each to detect capture quality. If you’ve already located all the faces in an image, or want to detect capture quality in only a subset of the faces in the image, set the `inputFaceObservations` property to an array of `FaceObservation` objects representing the faces you want to analyze. You can either use face observations output by a ``DetectFaceRectanglesRequest`` or manually create `FaceObservation` instances with the bounding boxes of the faces you want to analyze.
get inputFaceObservations(): (Array<FaceObservation>) | nullvar inputFaceObservations: [FaceObservation]?An array of `FaceObservation` objects to process as part of the request. The default is nil. When nil, Vision will first perform a `DetectFaceRectanglesRequest` and process all faces detected.
set inputFaceObservations(value: (Array<FaceObservation>) | null)var inputFaceObservations: [FaceObservation]?An array of `FaceObservation` objects to process as part of the request. The default is nil. When nil, Vision will first perform a `DetectFaceRectanglesRequest` and process all faces detected.
get descriptor(): RequestDescriptorvar descriptor: RequestDescriptor { get }An enum that identifies the request and request revision.
get regionOfInterest(): NormalizedRectvar regionOfInterest: NormalizedRectThe region of the image in which Vision will perform the request. The rectangle is normalized to the dimensions of the processed image. Its origin is specified relative to the image's lower-left corner. By default, the region of interest will be the full image.
set regionOfInterest(value: NormalizedRect)var regionOfInterest: NormalizedRectThe region of the image in which Vision will perform the request. The rectangle is normalized to the dimensions of the processed image. Its origin is specified relative to the image's lower-left corner. By default, the region of interest will be the full image.
setComputeDevice(computeDevice: (_CoreML_MLComputeDevice) | null, computeStage: ComputeStage): voidmutating func setComputeDevice(_ computeDevice: MLComputeDevice?, for computeStage: ComputeStage)Assigns a compute device for a compute stage. If the parameter `computeDevice` is `nil`, the framework removes any explicit compute device assignment and allows the framework to select the device. Configure any compute device for a given compute stage. When performing a request, the system makes a validity check. Use `supportedComputeStageDevices` to get valid compute devices for a request’s compute stages. - Parameters: - `computeDevice: `The compute device to assign to the compute stage. - `computeStage: `The compute stage.
static get supportedRevisions(): Array<DetectFaceCaptureQualityRequest_Revision>static let supportedRevisions: [DetectFaceCaptureQualityRequest.Revision]The collection of currently-supported revisions for `DetectFaceCaptureQualityRequest`.
get revision(): DetectFaceCaptureQualityRequest_Revisionlet revision: DetectFaceCaptureQualityRequest.RevisionThe request's configured revision.
static init(revision?: (DetectFaceCaptureQualityRequest_Revision) | null): DetectFaceCaptureQualityRequestinit(_ revision: DetectFaceCaptureQualityRequest.Revision? = nil)No declarations were skipped in this snapshot.