struct · iOS 18.0+ · SDK 27.1
struct DetectFaceLandmarksRequestAn image analysis request that finds facial features like eyes and mouth in an image. By default, a face landmarks request first locates all faces in the input image, then analyzes each to detect facial features. If you’ve already located all the faces in an image, or want to detect landmarks 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<DetectFaceLandmarksRequest_Revision>static let supportedRevisions: [DetectFaceLandmarksRequest.Revision]The collection of currently-supported revisions for `DetectFaceLandmarksRequest`.
get revision(): DetectFaceLandmarksRequest_Revisionlet revision: DetectFaceLandmarksRequest.RevisionThe request's configured revision.
static init(revision?: (DetectFaceLandmarksRequest_Revision) | null): DetectFaceLandmarksRequestinit(_ revision: DetectFaceLandmarksRequest.Revision? = nil)No declarations were skipped in this snapshot.