This is an old revision of the document!

Face API > BS2_ScanFaceEx

BS2_ScanFaceEx

[+ 2.7.1] FaceStation F2 Scans the face from a device and extracts template and image data.

Declaration

#include "BS_API.h"
 
int BS2_ScanFaceEx(void* context, uint32_t deviceId, BS2FaceEx* faceEx, uint8_t enrollmentThreshold, OnReadyToScan ptrReadyToScan);
See BS2FaceEx Structure

Parameter

  • [In] context : Context
  • [In] deviceId : Device ID
  • [Out] faceEx : Face data settings pointer
  • [In] enrollmentThreshold : Threshold required for face enrollment

Refer to BS2FaceConfig::enrollThreshold

  • [Out] ptrReadyToScan : Callback function called when face scanning is ready

Return Value

If successfully done, BS_SDK_SUCCESS will be returned.
If there is an error, the corresponding error code will be returned.