The running mode of the task. Default to the image mode.
FaceLandmarker has three running modes: 1) The image mode for detecting
face landmarks on single image inputs. 2) The video mode for detecting
face landmarks on the decoded frames of a video. 3) The live stream mode
for detecting face landmarks on the live stream of input data, such as
from camera. In this mode, the "result_callback" below must be specified
to receive the detection results asynchronously.
num_faces
The maximum number of faces that can be detected by the
FaceLandmarker.
min_face_detection_confidence
The minimum confidence score for the face
detection to be considered successful.
min_face_presence_confidence
The minimum confidence score of face presence
score in the face landmark detection.
min_tracking_confidence
The minimum confidence score for the face tracking
to be considered successful.
output_face_blendshapes
Whether FaceLandmarker outputs face blendshapes
classification. Face blendshapes are used for rendering the 3D face model.
output_facial_transformation_matrixes
Whether FaceLandmarker outputs facial
transformation_matrix. Facial transformation matrix is used to transform
the face landmarks in canonical face to the detected face, so that users
can apply face effects on the detected landmarks.
result_callback
The user-defined result callback for processing live stream
data. The result callback should only be specified when the running mode
is set to the live stream mode.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-05-01 UTC."],[],[],null,["# mp.tasks.vision.FaceLandmarkerOptions\n\n\u003cbr /\u003e\n\n|---------------------------------------------------------------------------------------------------------------------------------------|\n| [View source on GitHub](https://github.com/google/mediapipe/blob/master/mediapipe/tasks/python/vision/face_landmarker.py#L2935-L3007) |\n\nOptions for the face landmarker task. \n\n mp.tasks.vision.FaceLandmarkerOptions(\n base_options: ../../../mp/tasks/BaseOptions,\n running_mode: ../../../mp/tasks/vision/RunningMode = ../../../mp/tasks/vision/FaceDetectorOptions#running_mode,\n num_faces: int = 1,\n min_face_detection_confidence: float = 0.5,\n min_face_presence_confidence: float = 0.5,\n min_tracking_confidence: float = 0.5,\n output_face_blendshapes: bool = False,\n output_facial_transformation_matrixes: bool = False,\n result_callback: Optional[Callable[[FaceLandmarkerResult, image_module.Image, int], None]] = None\n )\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Attributes ---------- ||\n|-----------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `base_options` | Base options for the face landmarker task. |\n| `running_mode` | The running mode of the task. Default to the image mode. FaceLandmarker has three running modes: 1) The image mode for detecting face landmarks on single image inputs. 2) The video mode for detecting face landmarks on the decoded frames of a video. 3) The live stream mode for detecting face landmarks on the live stream of input data, such as from camera. In this mode, the \"result_callback\" below must be specified to receive the detection results asynchronously. |\n| `num_faces` | The maximum number of faces that can be detected by the FaceLandmarker. |\n| `min_face_detection_confidence` | The minimum confidence score for the face detection to be considered successful. |\n| `min_face_presence_confidence` | The minimum confidence score of face presence score in the face landmark detection. |\n| `min_tracking_confidence` | The minimum confidence score for the face tracking to be considered successful. |\n| `output_face_blendshapes` | Whether FaceLandmarker outputs face blendshapes classification. Face blendshapes are used for rendering the 3D face model. |\n| `output_facial_transformation_matrixes` | Whether FaceLandmarker outputs facial transformation_matrix. Facial transformation matrix is used to transform the face landmarks in canonical face to the detected face, so that users can apply face effects on the detected landmarks. |\n| `result_callback` | The user-defined result callback for processing live stream data. The result callback should only be specified when the running mode is set to the live stream mode. |\n\n\u003cbr /\u003e\n\nMethods\n-------\n\n### `__eq__`\n\n __eq__(\n other\n )\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n\u003cbr /\u003e\n\n| Class Variables --------------- ||\n|---------------------------------------|------------------------------------------|\n| min_face_detection_confidence | `0.5` |\n| min_face_presence_confidence | `0.5` |\n| min_tracking_confidence | `0.5` |\n| num_faces | `1` |\n| output_face_blendshapes | `False` |\n| output_facial_transformation_matrixes | `False` |\n| result_callback | `None` |\n| running_mode | `\u003cVisionTaskRunningMode.IMAGE: 'IMAGE'\u003e` |\n\n\u003cbr /\u003e"]]