detectFacesFromBytes method
Future<List<Face> >
detectFacesFromBytes(
- Uint8List imageBytes, {
- FaceDetectionMode mode = FaceDetectionMode.full,
Detects faces in encoded image bytes and returns detailed results.
The imageBytes parameter should contain encoded image data (JPEG, PNG, etc.).
For pre-decoded cv.Mat input, use detectFacesFromMat instead.
The mode parameter controls which features are computed:
- FaceDetectionMode.fast: Only detection and landmarks
- FaceDetectionMode.standard: Adds 468-point face mesh
- FaceDetectionMode.full: Adds iris tracking (152 points: 76 per eye)
Returns a List of Face objects, one per detected face.
Throws StateError if initialize has not been called successfully. Throws FormatException if the image bytes cannot be decoded.
Implementation
Future<List<Face>> detectFacesFromBytes(
Uint8List imageBytes, {
FaceDetectionMode mode = FaceDetectionMode.full,
}) async {
_requireReady();
return _runTrackedDetection(
() => _detectFacesFromBytesUntracked(imageBytes, mode),
);
}