expo-face-detector
Version:
Lets you use the power of Google Mobile Vision (https://developers.google.com/vision/face-detection-concepts) framework to detect faces on images.
183 lines • 6.12 kB
TypeScript
export declare type Point = {
x: number;
y: number;
};
export declare type FaceFeature = {
/**
* An object containing face bounds.
*/
bounds: FaceFeatureBounds;
/**
* Probability that the face is smiling. Returned only if detection classifications property is
* set to `FaceDetectorClassifications.all`.
*/
smilingProbability?: number;
/**
* Position of the left ear in image coordinates. Returned only if detection classifications
* property is set to `FaceDetectorLandmarks.all`.
*/
leftEarPosition?: Point;
/**
* Position of the right ear in image coordinates. Returned only if detection classifications
* property is set to `FaceDetectorLandmarks.all`.
*/
rightEarPosition?: Point;
/**
* Position of the left eye in image coordinates. Returned only if detection classifications
* property is set to `FaceDetectorLandmarks.all`.
*/
leftEyePosition?: Point;
/**
* Probability that the left eye is open. Returned only if detection classifications property is
* set to `FaceDetectorClassifications.all`.
*/
leftEyeOpenProbability?: number;
/**
* Position of the right eye in image coordinates. Returned only if detection classifications
* property is set to `FaceDetectorLandmarks.all`.
*/
rightEyePosition?: Point;
/**
* Probability that the right eye is open. Returned only if detection classifications property is
* set to `FaceDetectorClassifications.all`.
*/
rightEyeOpenProbability?: number;
/**
* Position of the left cheek in image coordinates. Returned only if detection classifications
* property is set to `FaceDetectorLandmarks.all`.
*/
leftCheekPosition?: Point;
/**
* Position of the right cheek in image coordinates. Returned only if detection classifications
* property is set to `FaceDetectorLandmarks.all`.
*/
rightCheekPosition?: Point;
/**
* Position of the left edge of the mouth in image coordinates. Returned only if detection
* classifications property is set to `FaceDetectorLandmarks.all`.
*/
leftMouthPosition?: Point;
/**
* Position of the center of the mouth in image coordinates. Returned only if detection
* classifications property is set to `FaceDetectorLandmarks.all`.
*/
mouthPosition?: Point;
/**
* Position of the right edge of the mouth in image coordinates. Returned only if detection
* classifications property is set to `FaceDetectorLandmarks.all`.
*/
rightMouthPosition?: Point;
/**
* Position of the bottom edge of the mouth in image coordinates. Returned only if detection
* classifications property is set to `FaceDetectorLandmarks.all`.
*/
bottomMouthPosition?: Point;
/**
* Position of the nose base in image coordinates. Returned only if detection classifications
* property is set to `FaceDetectorLandmarks.all`.
*/
noseBasePosition?: Point;
/**
* Yaw angle of the face (heading, turning head left or right).
*/
yawAngle?: number;
/**
* Roll angle of the face (bank).
*/
rollAngle?: number;
/**
* A face identifier (used for tracking, if the same face appears on consecutive frames it will
* have the same `faceID`).
*/
faceID?: number;
};
export declare type FaceFeatureBounds = {
/**
* Size of the square containing the face in image coordinates,
*/
size: {
width: number;
height: number;
};
/**
* Position of the top left corner of a square containing the face in image coordinates,
*/
origin: Point;
};
export declare enum FaceDetectorMode {
fast = 1,
accurate = 2
}
export declare enum FaceDetectorLandmarks {
none = 1,
all = 2
}
export declare enum FaceDetectorClassifications {
none = 1,
all = 2
}
export declare type Image = {
/**
* URI of the image.
*/
uri: string;
/**
* Width of the image in pixels.
*/
width: number;
/**
* Height of the image in pixels.
*/
height: number;
/**
* Orientation of the image (value conforms to the EXIF orientation tag standard).
*/
orientation: number;
};
/**
* In order to configure detector's behavior modules pass a settings object which is then
* interpreted by this module.
*/
export declare type DetectionOptions = {
/**
* Whether to detect faces in fast or accurate mode. Use `FaceDetector.FaceDetectorMode.{fast, accurate}`.
*/
mode?: FaceDetectorMode;
/**
* Whether to detect and return landmarks positions on the face (ears, eyes, mouth, cheeks, nose).
* Use `FaceDetector.FaceDetectorLandmarks.{all, none}`.
*/
detectLandmarks?: FaceDetectorLandmarks;
/**
* Whether to run additional classifications on detected faces (smiling probability, open eye
* probabilities). Use `FaceDetector.FaceDetectorClassifications.{all, none}`.
*/
runClassifications?: FaceDetectorClassifications;
/**
* Minimal interval in milliseconds between two face detection events being submitted to JS.
* Use, when you expect lots of faces for long time and are afraid of JS Bridge being overloaded.
* @default `0`
*/
minDetectionInterval?: number;
/**
* Flag to enable tracking of faces between frames. If true, each face will be returned with
* `faceID` attribute which should be consistent across frames.
* @default `false`
*/
tracking?: boolean;
};
export declare type DetectionResult = {
/**
* Array of faces objects.
*/
faces: FaceFeature[];
image: Image;
};
/**
* Detect faces on a picture.
* @param uri `file://` URI to the image.
* @param options A map of detection options.
* @return Returns a Promise which fulfils with [`DetectionResult`](#detectionresult) object.
*/
export declare function detectFacesAsync(uri: string, options?: DetectionOptions): Promise<DetectionResult>;
//# sourceMappingURL=FaceDetector.d.ts.map