API

The located Function under com.tenginekit.

init

Parameter

• context: context in activity，
• config: AndroidConfig is the config of work

    Face.init(Context context, AndroidConfig config);

For example, set the default configuration like this.

    Face.init(context,
            AndroidConfig
                .create()
                .setCameraMode()
                .setDefaultFunc()
                .setDefaultInputImageFormat()
                .setInputImageSize(previewWidth, previewHeight)
                .setOutputImageSize(OutputWidth, OutputHeight)
        );

AndoridConfig

.create() First create an AndroidConfig.

Configuration mode:

.setNormalMode() Set to normal mode
.setCameraMode() Set to camera mode(This mode will automatically rotate the picture according to the front and rear camera)
.setHandleMode(HandleMode mHandleMode) Parameter transmission mode setting mode

    public enum HandleMode{
        Normal, // Normal mode
        Camera // Camera mode
    }

Configure input picture format:

.setDefaultInputImageFormat() Set the default picture format (YUV_NV21)
.setInputImageFormat(ImageFormat imageFormat) Parameter transmission mode to set input picture format

    public enum ImageFormat
    {
        YUV_NV21,
        RGB,
        RGBA,
        GRAY
    }

Configure input and output:

.setInputImageSize(int w, int h) Input width and height (preview_w, preview_h)
.setOutputImageSize() Output width and height (display size)

Configuration function (functions are based on image detection):

.setDefaultFunc() Set default functions (face detection and key points)
.openFunc(Func func) Pass parameter setting function (image detection must be set to AndroidConfig.Func.Detect or AndroidConfig.Func.BlazeFace)

    public enum Func
    {
        Detect,
        Landmark,
        Attribution,
        BlazeFace,
        FaceMesh,
    }

Tips：BlazeFace, FaceMesh models are from Google，The project address is：https://github.com/google/mediapipe

get detect infos

Since all functions are based on face detection, first create an object of Face.FaceDetect. Detect detection will be faster, BlazeFace will be more accurate and the angle can be larger (BlazeFace is based on the Google model). Will eventually return a FaceDetectInfo list;

Parameter

• imageData: Input data

    Face.FaceDetect faceDetect = Face.detect(imageData);
    List<FaceDetectInfo> faceDetectInfos = faceDetect.getDetectInfos();

get landmark infos

The face key point function is based on face detection, so the landmark information acquisition method should be based on the Face.FaceDetect object created earlier. Finally returns a FaceLandmarkInfo list;

    List<LandmarkInfo> landmarkInfos = faceDetect.landmark2d();;

get 3D landmark infos(This feature is based on Google model)

The face key point function is based on face detection, so the 3d landmark information acquisition method should be based on the Face.FaceDetect object created earlier. Finally returns a FaceLandmark3dInfo list;

    List<FaceLandmark3dInfo> landmarkInfos = faceDetect.landmark3d();;

get attribution infos

The attribute function is based on face detection, so the method of obtaining attribute information is based on the Face.FaceDetect object created earlier. Finally returns a FaceAttributionInfo list;

    List<AttributionInfo> attributionInfos = faceDetect.attribution();

switch camera

Switching cameras is only useful when in camera mode.

Parameter

• back:Whether it is a rear camera

    Face.Camera.switchCamera(boolean back); 

set rotation

Setting rotation is only useful in camera mode.

Parameter

• ori: Rotation angle (vertical to 0°)
• isScreenRotate: whether the display area follows rotation
• outputW: show width
• outputH: show height

    Face.Camera.setRotation(int ori, boolean isScreenRotate, int outputW, int outputH);

release

    FaceManager.getInstance().release();

Data structure

FaceDetectInfo

.asRect() is a method in FaceDetectInfo, which can directly return an object of class Rect.

FaceLandmarkInfo

FaceLandmark3dInfo

FaceAttributionInfo

FaceLandmarkPoint

ImageHandleApi

Parameter

• bitmap: Android picture
• inputX1: input the upper left corner of the picture x
• inputY1: input image in the upper left corner y
• inputX2: Enter the bottom right corner of the picture x
• inputY2: Enter the lower right corner of the picture y
• ouputW: width of output picture
• outputH: the height of the output picture
• rotation: rotation angle
• mirror: whether to mirror

    synchronized static public Bitmap convertImage(Bitmap bitmap,
                                    int inputX1, int inputY1, int inputX2, int inputY2,
                                    int outputW, int outputH, int rotation, boolean mirror);

Parameter

• data: input picture byte data
• imageOutputFormat: output image format
• ouputW: width of output picture
• outputH: the height of the output picture
• rotation: rotation angle
• mirror: whether to mirror

    synchronized static public byte[] convertCameraYUVData(byte[] data,
                                    AndroidConfig.ImageFormat imageOutputFormat,
                                    int inputW, int inputH,
                                    int outputW, int outputH, int rotation, boolean mirror

Parameter

• data: input picture byte data
• inputW: input picture width
• inputH: input image height
• ouputW: width of output picture
• outputH: the height of the output picture
• rotation: rotation angle
• mirror: whether to mirror

    synchronized static public Bitmap convertCameraYUVData(byte[] data,
                                    int inputW, int inputH,
                                    int outputW, int outputH,
                                    int rotation, boolean mirror

Parameter

• data: input picture byte data
• imageInputFormat: input image format
• imageOutputFormat: output image format
• inputW: input picture width
• inputH: input image height
• inputX1: input the upper left corner of the picture x
• inputY1: input image in the upper left corner y
• inputX2: Enter the bottom right corner of the picture x
• inputY2: Enter the lower right corner of the picture y
• ouputW: width of output picture
• outputH: the height of the output picture
• rotation: rotation angle
• mirror: whether to mirror

    synchronized static public byte[] convertImage(byte[] data,
                                    AndroidConfig.ImageFormat imageInputFormat, AndroidConfig.ImageFormat imageOutputFormat,
                                    int inputW, int inputH,
                                    int inputX1, int inputY1, int inputX2, int inputY2,
                                    int outputW, int outputH, int rotation, boolean mirror