Luxand FaceCrop SDK – Library Activation and Initialization
FaceCrop is a copy-protected library and must be activated with a registration key before its use. You need to pass the license key received from Luxand, Inc. to the fcActivate function before using Luxand FaceCrop functions. Almost all FaceCrop SDK functions will return the fcErrorNotActivated error code in case the library is not activated. To retrieve your license information, call fcGetLicenseInfo. This function returns the name the library is licensed to. You may need to use the fcGetHardwareID function to obtain your hardware ID if your license is restricted to one machine only. Additionally, you can find out a hardware ID by running the hardwareid program (ShowHardwareID.exe for Windows), which is located in /bin/ directory of the subdirectory that corresponds to the platform used.
fcGetHardwareID Function
Generates a Hardware ID code.
C++ Syntax:
int fcGetHardwareID(char* HardwareID);
Delphi Syntax:
function fcGetHardwareID(HardwareID: PChar): integer;
C# Syntax:
int fc.GetHardwareID(string HardwareID);
PHP Syntax:
string fcGetHardwareID(void);
VB Syntax:
Function fcVBGetHardwareID(ByRef HardwareID As Byte) As Long
Parameters:
HardwareID – address of the null-terminated string for receiving the Hardware ID code. You need to allocate at least 32 bytes of memory for this variable.
Return Value:
Returns fcErrorOk or hardware id in PHP, if successful.
fcActivate Function
Activates and initializes the FaceCrop library. It should be called before using any face cropping functions.
C++ Syntax:
int fcActivate(char* LicenseKey);
Delphi Syntax:
function fcActivate(LicenseKey: PChar): integer;
C# Syntax:
int fc.Activate(out string LicenseKey);
PHP Syntax:
int fcActivate(string $LicenseKey);
VB Syntax:
Function fcVBActivate(ByVal LicenseKey As String) As Long
Parameters:
LicenseKey– license key you received from Luxand, Inc.
Return Value:
Returns fcErrorOk if the registration key is valid and not expired.
fcGetLicenseInfo Function
Retrieves license information.
C++ Syntax:
int fcGetLicenseInfo(char* LicenseInfo);
Delphi Syntax:
function fcGetLicenseInfo(LicenseInfo: PChar): integer;
C# Syntax:
int fcGetLicenseInfo(out string LicenseInfo);
PHP Syntax:
string fcGetLicenseInfo(void);
VB Syntax:
Function fcVBGetLicenseInfo(ByRef LicenseInfo As Byte) As Long
Parameters:
LicenseInfo – address of the null-terminated string for receiving the license information. This variable should be allocated no less than 256 bytes of memory.
Return Value:
Returns fcErrorOk (or license info string in PHP), if successful.
fcFinalize Function
Finalizes the FaceCrop library. Should be called when the application is exited (note: it is not required to call this function in PHP).
C++ Syntax:
int fcFinalize();
Delphi Syntax:
function fcFinalize: integer;
C# Syntax:
int fc.Finalize();
VB Syntax:
Function fcVBFinalize() As Long
Return Value:
Returns fcErrorOk if successful.