The library usage level depends on the functionality required from Luxand FaceSDK. The typical scenario is as follows:
1. Activate FaceSDK by calling up the FSDK_ActivateLibrary function with the key sent by Luxand, Inc.
2. Initialize FaceSDK by calling up the FSDK_Initialize function.
3. Load images either from file, buffer, or the HBITMAP handle (FSDK_LoadImageFromFile, FSDK_LoadImageFromBuffer, FSDK_LoadImageFromHBitmap functions).
4. Set face detection parameters if needed (FSDK_SetFaceDetectionParameters, FSDK_SetFaceDetectionThreshold).
5. Use FaceSDK functions:
- Detect a face (FSDK_DetectFace) or multiple faces (FSDK_DetectMultipleFaces) in an image
- Detect facial features if needed (FSDK_DetectFacialFeatures, FSDK_DetectFacialFeaturesInRegion)
- Extract a face template from the image (FSDK_GetFaceTemplate, FSDK_GetFaceTemplateInRegion, FSDK_GetFaceTemplateUsingEyes)
- Match face templates (FSDK_MatchFaces) and acquire facial similarity level
- To find out if a face belongs to the same person, calculate the matching threshold at a given FAR or FRR rate (FSDK_GetMatchingThresholdAtFAR and FSDK_GetMatchingThresholdAtFRR functions).
6. Finalize the FaceSDK library (FSDK_Finalize function).
To work with a camera, follow these steps*:
1. Initialize camera capturing (FSDK_InitializeCapturing).
2. Get a list of web cameras available in the system (FSDK_GetCameraList).
3. Get list of video formats supported by the camera (FSDK_GetVideoFormatList).
4. Set the desired video format for the chosen camera (FSDK_SetVideoFormat).
5. Open a web camera (FSDK_OpenVideoCamera) or an IP camera (FSDK_OpenIPVideoCamera).
6. Grab frames (FSDK_GrabFrame) in a loop, displaying them and detecting/recognizing faces.
7. Close video camera (FSDK_CloseVideoCamera).
8. Delete the list of video formats (FSDK_FreeVideoFormatList).
9. Delete the list of web cameras (FSDK_FreeCameraList).
10. Finalize capturing (FSDK_FinalizeCapturing).
* If you work with an IP camera, you should not follow steps 2, 3, 4, 8 and 9.
