# FaceDetectorOptions.Builder public static class **FaceDetectorOptions.Builder** extends [Object](https://developer.android.com/reference/java/lang/Object.html) Builder class of `https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions`. ### Public Constructor Summary |---|---| | | [Builder](https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.Builder#Builder())() Creates a new builder to build `https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions`. | ### Public Method Summary |---|---| | [FaceDetectorOptions](https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions) | [build](https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.Builder#build())() Builds a face detector instance. | | [FaceDetectorOptions.Builder](https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.Builder) | [enableTracking](https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.Builder#enableTracking())() Enables face tracking, which will maintain a consistent ID for each face when processing consecutive frames. | | [FaceDetectorOptions.Builder](https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.Builder) | [setClassificationMode](https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.Builder#setClassificationMode(int))(int classificationMode) Indicates whether to run additional classifiers for characterizing attributes such as "smiling" and "eyes open" as defined in `https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.ClassificationMode`. | | [FaceDetectorOptions.Builder](https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.Builder) | [setContourMode](https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.Builder#setContourMode(int))(int contourMode) Sets whether to detect no contours or all contours as defined in `https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.ContourMode`. | | [FaceDetectorOptions.Builder](https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.Builder) | [setExecutor](https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.Builder#setExecutor(java.util.concurrent.Executor))([Executor](https://developer.android.com/reference/java/util/concurrent/Executor.html) executor) Sets the custom `https://developer.android.com/reference/java/util/concurrent/Executor.html` to use. | | [FaceDetectorOptions.Builder](https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.Builder) | [setLandmarkMode](https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.Builder#setLandmarkMode(int))(int landmarkMode) Sets whether to detect no landmarks or all landmarks as defined in `https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.LandmarkMode`. | | [FaceDetectorOptions.Builder](https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.Builder) | [setMinFaceSize](https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.Builder#setMinFaceSize(float))(float minFaceSize) Sets the smallest desired face size, expressed as a proportion of the width of the head to the image width. | | [FaceDetectorOptions.Builder](https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.Builder) | [setPerformanceMode](https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.Builder#setPerformanceMode(int))(int performanceMode) Extended option for controlling additional accuracy / speed trade-offs in performing face detection as defined in `https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.PerformanceMode`. | ### Inherited Method Summary From class java.lang.Object |---|---| | [Object](https://developer.android.com/reference/java/lang/Object.html) | clone() | | boolean | equals([Object](https://developer.android.com/reference/java/lang/Object.html) arg0) | | void | finalize() | | final [Class](https://developer.android.com/reference/java/lang/Class.html)\ | getClass() | | int | hashCode() | | final void | notify() | | final void | notifyAll() | | [String](https://developer.android.com/reference/java/lang/String.html) | toString() | | final void | wait(long arg0, int arg1) | | final void | wait(long arg0) | | final void | wait() | ## Public Constructors #### public **Builder** () Creates a new builder to build `https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions`. ## Public Methods #### public [FaceDetectorOptions](https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions) **build** () Builds a face detector instance. #### public [FaceDetectorOptions.Builder](https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.Builder) **enableTracking** () Enables face tracking, which will maintain a consistent ID for each face when processing consecutive frames. Tracking should be disabled for handling a series of non-consecutive still images. #### public [FaceDetectorOptions.Builder](https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.Builder) **setClassificationMode** (int classificationMode) Indicates whether to run additional classifiers for characterizing attributes such as "smiling" and "eyes open" as defined in `https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.ClassificationMode`. Default: `https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions#CLASSIFICATION_MODE_NONE` ##### Parameters | classificationMode | the classification mode used by the detector. One of `https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions#CLASSIFICATION_MODE_NONE` or `https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions#CLASSIFICATION_MODE_ALL` | |---|---| #### public [FaceDetectorOptions.Builder](https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.Builder) **setContourMode** (int contourMode) Sets whether to detect no contours or all contours as defined in `https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.ContourMode`. Processing time increases as the number of contours to search for increases, so detecting all contours will increase the overall detection time. Note that contours are detected for only the most prominent face in an image. Default: `https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions#CONTOUR_MODE_NONE` ##### Parameters | contourMode | the contour mode used by the detector. One of `https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions#CONTOUR_MODE_NONE` or `https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions#CONTOUR_MODE_ALL`. | |---|---| #### public [FaceDetectorOptions.Builder](https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.Builder) **setExecutor** ([Executor](https://developer.android.com/reference/java/util/concurrent/Executor.html) executor) Sets the custom `https://developer.android.com/reference/java/util/concurrent/Executor.html` to use. If no `https://developer.android.com/reference/java/util/concurrent/Executor.html` is set, an internal background thread pool will be used. Most clients should not need to call this method. ##### Parameters | executor | the `https://developer.android.com/reference/java/util/concurrent/Executor.html` to use | |---|---| ##### Returns - this object, for chaining method calls #### public [FaceDetectorOptions.Builder](https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.Builder) **setLandmarkMode** (int landmarkMode) Sets whether to detect no landmarks or all landmarks as defined in `https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.LandmarkMode`. Processing time increases as the number of landmarks to search for increases, so detecting all landmarks will increase the overall detection time. Detecting landmarks can improve pose estimation. Default: `https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions#LANDMARK_MODE_NONE` ##### Parameters | landmarkMode | the landmark mode used by the detector. One of `https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions#LANDMARK_MODE_NONE` or `https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions#LANDMARK_MODE_ALL`. | |---|---| #### public [FaceDetectorOptions.Builder](https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.Builder) **setMinFaceSize** (float minFaceSize) Sets the smallest desired face size, expressed as a proportion of the width of the head to the image width. For example, if a value of 0.1 is specified then the smallest face to search for is roughly 10% of the width of the image being searched. Setting the min face size is a performance vs. accuracy trade-off: setting the face size smaller will enable the detector to find smaller faces but detection will take longer; setting the face size larger may exclude smaller faces but will run faster. This is not a hard limit on face size; the detector may find faces slightly smaller than specified, so it can not be used to filter out face sizes. Default minimum face size is 0.1. ##### Parameters | minFaceSize | the head size to search for relative to the size of the image, in the range of 0.0 and 1.0. For example, a setting of 0.5 would indicate that detected faces is preferred to fill at least half of the image width. However, the detector may still find faces slightly smaller than specified, so it can not be used to filter out face sizes. | |---|---| #### public [FaceDetectorOptions.Builder](https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.Builder) **setPerformanceMode** (int performanceMode) Extended option for controlling additional accuracy / speed trade-offs in performing face detection as defined in `https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions.PerformanceMode`. In general, choosing the more accurate mode will generally result in longer runtime, whereas choosing the faster mode will generally result in detecting fewer faces. Default: `https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions#PERFORMANCE_MODE_FAST` ##### Parameters | performanceMode | fast/accurate trade-off mode. One of `https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions#PERFORMANCE_MODE_FAST` or `https://developers.google.com/android/reference/com/google/mlkit/vision/face/FaceDetectorOptions#PERFORMANCE_MODE_ACCURATE`. | |---|---|