Perfectly Clear SDK Documentation
8.4.5.252
|
Public Interface for the Perfeclty Clear SDK. More...
Go to the source code of this file.
Data Structures | |
struct | PFCPOINT |
Struct defining a point. More... | |
struct | PFCRECT |
Struct defining a rectangle. More... | |
struct | PFCFBFACEINFO |
Structure defining face area detected from the SFB library. More... | |
struct | PFCFaceRect |
Structure defining face attributes detected by the Face Detection library. More... | |
struct | PFCENGINE |
Struct defining an PFC engine instance. More... | |
struct | PFCIMAGE |
Struct defining an image to be used in PFC library. More... | |
struct | PFCCOREPARAM |
Structure encapsulating the CORE processing parameters. More... | |
struct | PFCFBPARAM |
Structure encapsulating Face Beautification parameters. More... | |
struct | PFCNRPARAM |
Structure encapsulating Noise Removal parameters. More... | |
struct | PFCREPARAM |
Structure encapsulating Red Eye Correction parameters. More... | |
struct | PFC3DLutInfo |
Struct. More... | |
struct | PFCCOREMask |
Struct describing mask for grad filter, all coordinates are relative (Y/height, X/width) in final crop-rotated image */. More... | |
struct | PFCV3PARAM |
Struct describing V3 parameters. More... | |
struct | PFCPARAM |
Struct PFCPARAM the master structure of all processing parameters. More... | |
struct | PFCIMAGEPROFILE |
Struct defining an image profile as calculated from PFC_Calc() function. More... | |
struct | BGMASKPARAM |
Struct defining parameters for building BG mask. More... | |
Macros | |
#define | NRRETCODE(x) (x & 0x000000FF) |
Decode return status of Noise Removal from master return code. | |
#define | CORERETCODE(x) ((x >> 8) & 0x000000FF) |
Decode return status of Core correction from master return code. | |
#define | FBRETCODE(x) ((x >> 16) & 0x000000FF) |
Decode return status of Face Beautification from master return code. | |
#define | RERETCODE(x) ((x >> 24) & 0x000000FF) |
Decode return status of Red Eye correction from master return code. | |
#define | PFCINTERNAL void* |
Internal used pointer type. | |
#define | PFCPROFILE PFCIMAGEPROFILE* |
Define. | |
#define | PFCBGPROFILE PFCINTERNAL |
For use in background color synchronization. | |
Typedefs | |
typedef BOOL(* | PFC_PROGRESS) (int iPercent) |
typedef struct PFCFaceRect | PFCFACERECT |
Structure defining face attributes detected by the Face Detection library. More... | |
typedef struct PFCCOREMask | PFCCOREMask |
Struct describing mask for grad filter, all coordinates are relative (Y/height, X/width) in final crop-rotated image */. | |
Enumerations | |
enum | PFCPIXELFORMAT |
defines the format of the image data More... | |
enum | PFCENGINESTATUS |
ENUM for engine initialization status. More... | |
enum | PFCFEATURE |
ENUM controlling types of calculations at the pre-calculation stage. More... | |
enum | PFCPRESETID |
ENUM for presets support by this SDK. More... | |
enum | TINTCORRECTION |
Enumeration defining different abnormal tint analysis mode. More... | |
enum | CONTRASTMODE |
Enumeration defining contrast mode. More... | |
enum | DCFMODE |
Enumeration defining DCF analysis mode. More... | |
enum | AGGRESSIVENESS |
Enumeration defining Auto Exposure calculation modes. More... | |
enum | BIASMODE |
Enumeration defining BIAS analysis mode. More... | |
enum | SKINMODE |
Enumeration defining modes in Perfect Smooth analysis. More... | |
enum | SKINSMOOTHTYPE |
Enumeration defining types of Skin Smoothing correction. More... | |
enum | SKINTONINGTYPE |
Enumeration defining type of Skin Toning correction. More... | |
enum | LIPSHARPENTYPE |
Enumeration defining Lip Sharpening mode. More... | |
enum | PFCNR_STATUS |
Enumeration defining status of Noise Removal pre-calculation. More... | |
enum | PFCCORE_STATUS |
Enumeration defining status of Core pre-calculation. More... | |
enum | PFCFB_STATUS |
Enumeration defining status of Face Beautification pre-calculation. More... | |
enum | PFCRE_STATUS |
Enumeration defining status of Red Eye pre-calculation. More... | |
enum | PFCAPPLYSTATUS |
Enumeration defining return code from the Apply() function. More... | |
enum | PFCCORE_MASK_TYPE |
Enumeration describing mapping of PFCMask and PFC_MASK_TYPE with 'PFC' -> 'PFCCORE'. More... | |
Functions | |
bool | PFC_HasFaceBeautification (PFCENGINE *pEngine) |
Check if Face Beautification is available. More... | |
int | PFC_FBFaceCount (PFCPROFILE pImageProfile) |
Return number of faces detected. More... | |
int | PFC_FAEFaceCount (PFCIMAGEPROFILE *pImageProfile) |
Return number of faces detected during Face Aware Exposure analysis. More... | |
LPPFCFACERECT | PFC_EnumFAEFaceRect (PFCIMAGEPROFILE *pImageProfile, LPPFCFACERECT p) |
Utility function to enumerate faces detected during Face Aware Exposure analysis. More... | |
bool | PFC_IsNoiseDetected (PFCIMAGEPROFILE *pImageProfile, int iNoisePreset) |
Query if noise is detected. More... | |
bool | PFC_GetFaceInfo (PFCIMAGEPROFILE *pImageProfile, PFCFBFACEINFO *pFace, int index) |
Utility function to query geometry of detected faces. More... | |
bool | PFC_AbnormalTintDetected (PFCIMAGEPROFILE *pImageProfile, TINTCORRECTION eTintMethod) |
Query if abnormal tint is detected. More... | |
void | PFC_SetParam (PFCPARAM ¶m, PFCPRESETID id=PRESET_IAUTO_2019) |
Initialize a PFCPARAM structure. More... | |
PFCAPPLYSTATUS | PFC_Apply (PFCIMAGE *pImage, PFCENGINE *pEngine, PFCPROFILE pImageProfile, PFCPARAM ¶m, PFC_PROGRESS progfn=NULL, int iOpacity=100, void *pBGProfile=NULL) |
Correct image with parameters. More... | |
PFCAPPLYSTATUS | PFC_ApplyLocal (PFCIMAGE *pImage, int xOffset, int yOffset, int widthOrig, int heightOrig, PFCENGINE *pEngine, PFCPROFILE pImageProfile, PFCPARAM ¶m, int iOpacity=100) |
Apply correction locally. More... | |
PFCPROFILE | PFC_Calc (PFCIMAGE *pImage, PFCIMAGE *pImageds, PFCENGINE *pEngine, unsigned int feature=CALC_ALL, int iISO=-1, char *pCameraModel=NULL, PFCPROFILE pImageProfile=NULL, PFC_PROGRESS progfn=NULL, BOOL bRejectMonolith=TRUE) |
Perform initial analysis on images. More... | |
PFCENGINE * | PFC_CreateEngine () |
Create PFCENGINE instance. More... | |
void | PFC_DestroyEngine (PFCENGINE *p) |
Destroy PFCENGINE instance and release associated resources. More... | |
void | PFC_ReleaseProfile (PFCPROFILE pProfile) |
Release PFCPROFILE instance. More... | |
int | PFC_AutoCorrect (PFCIMAGE *pImage, PFCIMAGE *pImageds, PFCPARAM ¶m, int iISO=-1, char *pCameraModel=NULL, BOOL bFastFAE=FALSE, PFC_PROGRESS progfn=NULL) |
Single function to perform Perfectly Clear correction. More... | |
int | PFC_AutoCorrectPreset (PFCIMAGE *pImage, PFCIMAGE *pImageds, PFCPRESETID id=PRESET_IAUTO_2019, int iISO=-1, char *pCameraModel=NULL, BOOL bFastFAE=FALSE, PFC_PROGRESS progfn=NULL) |
Single function to perform Perfectly Clear corrections. More... | |
int | PFC_ReadPresets (PFCPARAM ¶m, char *filename) |
Load image processing settings from a .preset file. Use this function to load image processing settings from a .preset file. You can export these from Perfectly Clear Workbench or Perfectly Clear Complete. Note: the first preset in the file will be used to load the settings into the param struct - so please export a single preset at a time for this purpose. More... | |
int | PFC_ReadPresetsFromStream (PFCPARAM ¶m, const char *s) |
Load image processing settings from a char buffer. More... | |
void | PFC_SetSingleThreadedEngine (PFCENGINE *p, bool bSingleThreaded) |
Force processing to be single threaded. More... | |
void | PFC_GetVersion (char *buf, int *len, bool bFormatted=false) |
Get info string with version and features. More... | |
PFCAPPLYSTATUS | PFC_Resize (PFCIMAGE *pImageSrc, PFCIMAGE *pImageDst) |
Perform image resizing. More... | |
PFCAPPLYSTATUS | PFC_TransposeExif (PFCIMAGE *pImageSrc, int iEXIFOrientation) |
Transpose image upright from/to EXIF Orientation. More... | |
int | PFC_SetProtectionPath (const char *utf8FolderPath, const char *liceseCode=NULL) |
Set path to location of SDK License files This enables license protection and allows activation using a license key file provided by EyeQ. More... | |
void | PFC_SetAddonPath (const char *utf8AddonPath) |
Set path to directory containing runtime add-ons such as .looks file(s) This enables searching for add-on (such as v3.looks) in specified location instead of current working directory of the calling process. More... | |
Public Interface for the Perfeclty Clear SDK.
Definition in file PerfectlyClearPro.h.
typedef BOOL(* PFC_PROGRESS) (int iPercent) |
defines the call format of a progress function. return TRUE to cancel processing. FALSE to continue.
Definition at line 36 of file PerfectlyClearPro.h.
typedef struct PFCFaceRect PFCFACERECT |
Structure defining face attributes detected by the Face Detection library.
Detection levels:*
enum AGGRESSIVENESS |
Enumeration defining Auto Exposure calculation modes.
Definition at line 279 of file PerfectlyClearPro.h.
enum BIASMODE |
Enumeration defining BIAS analysis mode.
Definition at line 287 of file PerfectlyClearPro.h.
enum CONTRASTMODE |
Enumeration defining contrast mode.
Definition at line 265 of file PerfectlyClearPro.h.
enum DCFMODE |
Enumeration defining DCF analysis mode.
Enumerator | |
---|---|
DCF_STANDARD | For normal photo. |
DCF_VIVID | For more color vibrancy. |
Definition at line 272 of file PerfectlyClearPro.h.
enum LIPSHARPENTYPE |
Enumeration defining Lip Sharpening mode.
Enumerator | |
---|---|
LIPSHARPENTYPE_FINE | Fine touch of sharpening. |
LIPSHARPENTYPE_MEDIUM | Stronger sharpening. Details are more pronounced. |
LIPSHARPENTYPE_COARSE | Lip details are coarsely pronounced. |
Definition at line 321 of file PerfectlyClearPro.h.
enum PFCAPPLYSTATUS |
Enumeration defining return code from the Apply() function.
Definition at line 380 of file PerfectlyClearPro.h.
enum PFCCORE_MASK_TYPE |
Enumeration describing mapping of PFCMask and PFC_MASK_TYPE with 'PFC' -> 'PFCCORE'.
Definition at line 490 of file PerfectlyClearPro.h.
enum PFCCORE_STATUS |
Enumeration defining status of Core pre-calculation.
Definition at line 341 of file PerfectlyClearPro.h.
enum PFCENGINESTATUS |
ENUM for engine initialization status.
Definition at line 155 of file PerfectlyClearPro.h.
enum PFCFB_STATUS |
Enumeration defining status of Face Beautification pre-calculation.
Definition at line 352 of file PerfectlyClearPro.h.
enum PFCFEATURE |
ENUM controlling types of calculations at the pre-calculation stage.
Definition at line 162 of file PerfectlyClearPro.h.
enum PFCNR_STATUS |
Enumeration defining status of Noise Removal pre-calculation.
Definition at line 329 of file PerfectlyClearPro.h.
enum PFCPIXELFORMAT |
defines the format of the image data
Definition at line 39 of file PerfectlyClearPro.h.
enum PFCPRESETID |
ENUM for presets support by this SDK.
Enumerator | |
---|---|
PRESET_BEAUTIFY | Beautify. |
PRESET_BEAUTIFYPLUS | Beautify Plus. |
PRESET_DETAILS | Details. |
PRESET_VIVID | Vivid. |
PRESET_INTELLIGENTAUTO | Intelligent Auto. |
PRESET_IAUTO_2019 | New iAuto for even better image corrections. |
PRESET_IAUTO_2019_RE | Same as iAuto 2019 but also with Red Eye Correction enabled. |
Definition at line 175 of file PerfectlyClearPro.h.
enum PFCRE_STATUS |
Enumeration defining status of Red Eye pre-calculation.
Enumerator | |
---|---|
PFC_RE_SUCCESS | Success. |
PFC_RE_NOTENABLED | Feature not enabled. |
PFC_RE_FULLRES_REQUIRED | Full res image (pImage) is missing. |
PFC_RE_NOT_FOUND | Red eye not found. |
PFC_RE_GEN_ERROR | General error. |
PFC_RE_INVALID_PARAMETER | Invalid parameter. |
PFC_RE_NO_MEMORY | Insufficient memory. |
PFC_RE_CANCELLED | Process cancelled. |
PFC_RE_NOT_SUPPORTED | Not supported. |
Definition at line 367 of file PerfectlyClearPro.h.
enum SKINMODE |
Enumeration defining modes in Perfect Smooth analysis.
Enumerator | |
---|---|
SKINMODE_FACE | Apply correction ONLY on skin regions included in faces. |
SKINMODE_BODY | Apply correction on most skin regions regardless they are linked with a face or not. |
Definition at line 296 of file PerfectlyClearPro.h.
enum SKINSMOOTHTYPE |
Enumeration defining types of Skin Smoothing correction.
Enumerator | |
---|---|
SKINSMOOTHTYPE_SUBTLE | The subtle correction removes the wrinkles and spots alone while it keeps the texture of the face unchanged. |
SKINSMOOTHTYPE_DEFAULT | This type of correction provides a more uniform appearance to the complexion. It combines the natural look of the SUBTLE mode with the improved efficiency of SUPERSMOOTH. |
SKINSMOOTHTYPE_SUPERSMOOTH | This is a more aggressive and effective correction where the appearance of the entire skin (including wrinkles, spots, hot spots) is changed (softened). |
Definition at line 303 of file PerfectlyClearPro.h.
enum SKINTONINGTYPE |
Enumeration defining type of Skin Toning correction.
Enumerator | |
---|---|
SKINTONINGTYPE_WHITE | Whitens (bleaches) face. Recommended mainly for darker skin. |
SKINTONINGTYPE_PALE | Makes skin look lighter and more pale. |
SKINTONINGTYPE_WARM | Warms skin tone. |
SKINTONINGTYPE_TAN | Darkens skin, makes it look naturally tanned. |
SKINTONINGTYPE_FOUNDATION | Adjust skin to user defined foundation color. |
Definition at line 311 of file PerfectlyClearPro.h.
enum TINTCORRECTION |
Enumeration defining different abnormal tint analysis mode.
Enumerator | |
---|---|
TINTCORRECT_AGGRESSIVE | Aggressive detection of tint. |
TINTCORRECT_DEFAULT | Moderate level of tint detection. |
TINTCORRECT_CONSERVATIVE | Priority on minimum false positive detection. |
TINTCORRECT_STRONGEST | Highest sensitivity level of tint detection. |
Definition at line 256 of file PerfectlyClearPro.h.
bool PFC_AbnormalTintDetected | ( | PFCIMAGEPROFILE * | pImageProfile, |
TINTCORRECTION | eTintMethod | ||
) |
Query if abnormal tint is detected.
Utility function to query if abnormal tint is detected at certain detection mode.
pImageProfile | [in] - Profile returned from PFC_Calc() function. |
eTintMethod | [in] - TINTCORRECTION enum to specify tint detection method used. |
PFCAPPLYSTATUS PFC_Apply | ( | PFCIMAGE * | pImage, |
PFCENGINE * | pEngine, | ||
PFCPROFILE | pImageProfile, | ||
PFCPARAM & | param, | ||
PFC_PROGRESS | progfn = NULL , |
||
int | iOpacity = 100 , |
||
void * | pBGProfile = NULL |
||
) |
Correct image with parameters.
Perform correction to image as defined by the PFCIMAGE structure using user parameters as defined in a PFCPARAM structure. Correction requires profile as calculated by the PFC_Calc() function.
pImage | [in, out] - Pointer to a PFCIMAGE structure that defines the image to be processed. |
pEngine | [in] - Pointer returned from PFC_CreateEngine() function. |
pImageProfile | [in] - Pointer to PFCPROFILE structure which is returned from the PFC_Calc() function. |
param | [in] - PFCPARAM structure that carries the process parameters. |
progfn | [in] - Pointer to progress monitoring function. See definition of PFC_PROGRESS. |
iOpacity | [in] - Control opacity of NR and CORE corrections. Range from 0 (non applied) to 100 (fully applied). |
pBGProfile | [in, out] - pointer to PFCBGPROFILE used for PFC_BGSync and BGApply |
0 | The correction is successful. | ||||||||||
> 0 |
| ||||||||||
< 0 | PFCAPPLYSTATUS enum. |
PFCAPPLYSTATUS PFC_ApplyLocal | ( | PFCIMAGE * | pImage, |
int | xOffset, | ||
int | yOffset, | ||
int | widthOrig, | ||
int | heightOrig, | ||
PFCENGINE * | pEngine, | ||
PFCPROFILE | pImageProfile, | ||
PFCPARAM & | param, | ||
int | iOpacity = 100 |
||
) |
Apply correction locally.
Perform CORE correction only to partial image as defined by the PFCIMAGE structure using user parameters as defined in a PFCPARAM structure. Correction requires profile as calculated by the PFC_Calc() function.IMPORTANT: Only the core correction is applied.
pImage | [in, out] - Pointer to PFCIMAGE structure that defines the image to be processed. |
xOffset | [in] - Horizontal (x) offset of image segment defined in pImage with respect to the original image. |
yOffset | [in] - Vertical (y) offset of image segment defined in pImage with respect to the original image. |
widthOrig | [in] - Pixel width of the original image. |
heightOrig | [in] - Pixel height of the original image. |
pEngine | [in] - Pointer returned from PFC_CreateEngine() function. |
pImageProfile | [in] - Pointer to PFCPROFILE structure which is returned from the PFC_Calc() function. |
param | [in] - PFCPARAM structure that carries the process parameters. |
iOpacity | [in] - Control opacity of NR and CORE corrections. Range from 0 (non applied) to 100 (fully applied). |
0 | The correction is successful. |
> 0 | PFCCORE_STATUS enum. |
< 0 | PFCAPPLYSTATUS enum. |
int PFC_AutoCorrect | ( | PFCIMAGE * | pImage, |
PFCIMAGE * | pImageds, | ||
PFCPARAM & | param, | ||
int | iISO = -1 , |
||
char * | pCameraModel = NULL , |
||
BOOL | bFastFAE = FALSE , |
||
PFC_PROGRESS | progfn = NULL |
||
) |
Single function to perform Perfectly Clear correction.
Composite function that takes an input picture and enhances it base on user parameters. This function encapsulates all the details such as PFCENGINE, PFCPROFILE etc. and is suitable for use in server type mass processing environment. See sample project "SampleBasic" for usage details.
pImage | [in, out] - Pointer to a PFCIMAGE structure that defines the image to be processed. |
pImageds | [in] - Pointer to a PFCIMAGE structure that defines a supplementary down sampled image to be used in pre-calc analysis. This parameter can be NULL. However the use of such supplementary image is highly recommended. |
param | [in] - PFCPARAM structure that carries the process parameters. |
iISO | [in] - ISO value when the image is taken. Use -1 if not known. |
pCameraModel | [in] - Text string of camera model which the picture is taken with. Set to NULL if not known. |
bFastFAE | [in] - Set to true to run a faster Face Aware Exposure Calculation. Default is false. |
progfn | [in] - Pointer to progress monitoring function. See definition of PFC_PROGRESS. |
0 | The correction is successful. | ||||||||||
> 0 |
| ||||||||||
< 0 | PFCAPPLYSTATUS enum. |
int PFC_AutoCorrectPreset | ( | PFCIMAGE * | pImage, |
PFCIMAGE * | pImageds, | ||
PFCPRESETID | id = PRESET_IAUTO_2019 , |
||
int | iISO = -1 , |
||
char * | pCameraModel = NULL , |
||
BOOL | bFastFAE = FALSE , |
||
PFC_PROGRESS | progfn = NULL |
||
) |
Single function to perform Perfectly Clear corrections.
Composite function that takes an input picture and enhances it using preset parameters specified by PFCPRESETID id.
pImage | [in, out] - Pointer to a PFCIMAGE structure that defines the image to be processed. |
pImageds | [in] - Pointer to a PFCIMAGE structure that defines a supplementary down sampled image to be used in pre-calc analysis. This parameter can be NULL. However the use of such supplementary image is highly recommended. |
id | [in] - PFCPRESETID to specify a preset to use. |
iISO | [in] - ISO value when the image is taken. Use -1 if not known. |
pCameraModel | [in] - Text string of camera model which the picture is taken with. Set to NULL if not known. |
bFastFAE | [in] - Set to true to run a faster Face Aware Exposure Calculation. Default is false. |
progfn | [in] - Pointer to progress monitoring function. See definition of PFC_PROGRESS. |
PFCPROFILE PFC_Calc | ( | PFCIMAGE * | pImage, |
PFCIMAGE * | pImageds, | ||
PFCENGINE * | pEngine, | ||
unsigned int | feature = CALC_ALL , |
||
int | iISO = -1 , |
||
char * | pCameraModel = NULL , |
||
PFCPROFILE | pImageProfile = NULL , |
||
PFC_PROGRESS | progfn = NULL , |
||
BOOL | bRejectMonolith = TRUE |
||
) |
Perform initial analysis on images.
Performs initial analysis and calculation of image specific profile parameters. Profile calculation can be done incrementally. For example if calculation is done initially on Perfectly Clear Core. Calculation of other feature, say Face Beautification, can be done in subsequent calls to PFC_Calc().
pImage | [in] - Pointer to a PFCIMAGE structure that defines the image to be processed. | ||||||||||||||||
pImageds | [in] - Pointer to a PFCIMAGE structure that defines a supplementary down sampled image (approx. 1024 longest dimension) to aid in red eye detection. Set this parameter to NULL if you don't supply this image. | ||||||||||||||||
pEngine | [in] - Pointer returned from the PFC_CreateEngine() function. | ||||||||||||||||
feature | [in] - Specify the type of calculations. Possible values are:
| ||||||||||||||||
iISO | [in] - ISO value when the image is taken. Use -1 if not known. | ||||||||||||||||
pCameraModel | [in] - Text string of camera model which the picture is taken with. Set to NULL if not known. | ||||||||||||||||
pImageProfile | [in] - Pointer to PFCPROFILE. Leave as NULL if this is first time calling the PFC_Calc function. | ||||||||||||||||
progfn | [in] - Pointer to progress monitoring function. See definition of PFC_PROGRESS. | ||||||||||||||||
bRejectMonolith | [in] - Set to TRUE to enable rejection of simple graphics on which Perfectly Clear processing might not be desirable. |
PFCENGINE* PFC_CreateEngine | ( | ) |
Create PFCENGINE instance.
Create core engine for use in Perfectly Clear image processing pipeline. The PFCENGINE module created by this function can be used in the entire session before PFC_DestroyEngine() is called.
void PFC_DestroyEngine | ( | PFCENGINE * | p | ) |
Destroy PFCENGINE instance and release associated resources.
Release PFCENGINE module created by function PFC_CreateEngine() and release all resouces used by the PFCENGINE.
p | [in] - pointer to PFCENGINE instance to be released. |
LPPFCFACERECT PFC_EnumFAEFaceRect | ( | PFCIMAGEPROFILE * | pImageProfile, |
LPPFCFACERECT | p | ||
) |
Utility function to enumerate faces detected during Face Aware Exposure analysis.
Pointer to the next face info as described in PFCFACERECT.
Example:
pImageProfile | [in] - Pointer to PFCPROFILE structure which is returned from the PFC_Calc() function. |
p | [in] - LPPFCFACERECT type. Last face rect returned from this function. |
int PFC_FAEFaceCount | ( | PFCIMAGEPROFILE * | pImageProfile | ) |
Return number of faces detected during Face Aware Exposure analysis.
Get number of faces detected during Face Aware Exposure analysis.
pImageProfile | [in] - Pointer to PFCPROFILE structure which is returned from the PFC_Calc() function. |
int PFC_FBFaceCount | ( | PFCPROFILE | pImageProfile | ) |
Return number of faces detected.
Get number of faces detected in the Face Beautification processing.
pImageProfile | [in] - Profile instance returned from PFC_Calc function. |
bool PFC_GetFaceInfo | ( | PFCIMAGEPROFILE * | pImageProfile, |
PFCFBFACEINFO * | pFace, | ||
int | index | ||
) |
Utility function to query geometry of detected faces.
Return True if face information is retrieved successfully. False if face is not detected or index is out of bound.
Example:
pImageProfile | [in] - Profile returned from PFC_Calc() function. |
pFace | [in] - Pointer to PFCFBFACEINFO structure that carries face and eye details upon successful retrieval. |
index | [in] - Index navigating the list. Must be >=0 and < number of faces. |
void PFC_GetVersion | ( | char * | buf, |
int * | len, | ||
bool | bFormatted = false |
||
) |
Get info string with version and features.
buf | [in, out] - receives zero terminate string of no more than len lenght, if NULL len will receive length to be allocated |
len | [in, out] - call with NULL first param to get necessary len to allocate, then pass it on next call |
bFormatted | - output key=value formatted ("version=x.x.x;commit=xxxx;avx=1;..."), or ("x.x.x xxx avx ...") |
bool PFC_HasFaceBeautification | ( | PFCENGINE * | pEngine | ) |
Check if Face Beautification is available.
pEngine | [in] - Pointer returned from PFC_CreateEngine() function |
bool PFC_IsNoiseDetected | ( | PFCIMAGEPROFILE * | pImageProfile, |
int | iNoisePreset | ||
) |
Query if noise is detected.
True if noise is detected when noise preset is iPreset. False otherwise. If Noise calculation is not enabled during PFC_Calc(), this query returns False.
pImageProfile | [in] - Profile returned from PFC_Calc() function. |
iNoisePreset | [in] - Noise preset to be checked. |
int PFC_ReadPresets | ( | PFCPARAM & | param, |
char * | filename | ||
) |
Load image processing settings from a .preset file. Use this function to load image processing settings from a .preset file. You can export these from Perfectly Clear Workbench or Perfectly Clear Complete. Note: the first preset in the file will be used to load the settings into the param struct - so please export a single preset at a time for this purpose.
param | [in, out] - PFCPARAM structure to fill with the process parameters. |
filename | [in] - Path and filename for the .preset file to read and load. |
return code | meaning |
---|---|
0 | OK |
-1 | Attribute errors |
-2 | Unable to open file |
-3 | File read error |
-4 | Parse error |
-5 | Cannot convert text |
-6 | No text node |
-7 | Element depth exceeded |
-8 | Invalid preset file |
int PFC_ReadPresetsFromStream | ( | PFCPARAM & | param, |
const char * | s | ||
) |
Load image processing settings from a char buffer.
Use this function to load image processing settings from a char buffer (stream). You can export these from Perfectly Clear Workbench or Perfectly Clear Complete. Note: the first preset in the file will be used to load the settings into the param struct - so please export a single preset at a time for this purpose. This function is very similar to PFC_ReadPresets, but accepts the preset data from a file stream instead of from a file on disk.
param | [in, out] - PFCPARAM structure to fill with the process parameters. |
s | [in] - const char buffer to read and load presets from. |
return code | meaning |
---|---|
0 | OK |
-1 | Attribute errors |
-2 | Unable to open file |
-3 | File read error |
-4 | Parse error |
-5 | Cannot convert text |
-6 | No text node |
-7 | Element depth exceeded |
-8 | Invalid preset file |
void PFC_ReleaseProfile | ( | PFCPROFILE | pProfile | ) |
Release PFCPROFILE instance.
Release PFCPROFILE instance and its associated resources.
pProfile | [in] - pointer to PFCPROFILE instance returned from PFC_Calc funciton. |
PFCAPPLYSTATUS PFC_Resize | ( | PFCIMAGE * | pImageSrc, |
PFCIMAGE * | pImageDst | ||
) |
Perform image resizing.
pImageSrc | [in] - Input image |
pImageDst | [out] - output image |
void PFC_SetAddonPath | ( | const char * | utf8AddonPath | ) |
Set path to directory containing runtime add-ons such as .looks file(s) This enables searching for add-on (such as v3.looks) in specified location instead of current working directory of the calling process.
utf8AddonPath | [in] - UTF8 encoded path to the folder that contains .looks file(s) |
void PFC_SetParam | ( | PFCPARAM & | param, |
PFCPRESETID | id = PRESET_IAUTO_2019 |
||
) |
Initialize a PFCPARAM structure.
SetParam initializes a PFCPARAM structure with parameters pertaining to Athentech preset as identified by the PFCPRESETID. If preset id is not provided, the default preset values will be used.
param | [in, out] - PFCPARAM structure to be set. |
id | [in] - enum PFCPRESETID (default to PRESET_IAUTO_2019). |
int PFC_SetProtectionPath | ( | const char * | utf8FolderPath, |
const char * | liceseCode = NULL |
||
) |
Set path to location of SDK License files This enables license protection and allows activation using a license key file provided by EyeQ.
utf8FolderPath | [in] - UTF8 encoded path to the folder that contains the SDK license files |
liceseCode | [in] - optional 18-digits license code to be used instead of license.key in utf8FolderPath |
return code | meaning |
---|---|
0 | OK |
101 | Undetermined errors |
102 | Success: Active license |
103 | Success: Active trial |
104 | License expired |
105 | System time tampered |
106 | Product not authorized |
107 | Product not found |
108 | Invalid license |
109 | License returned |
110 | Product inactive |
111 | Invalid trial period |
112 | Too many activation |
113 | Trial expired |
114 | License number inactive |
115 | Exceed allowed activation |
116 | Subscription expired |
117 | Invalid system date |
118 | Product in invalid state |
119 | No available licenses |
120 | Duplicate device ID |
121 | High missing heartbeat |
void PFC_SetSingleThreadedEngine | ( | PFCENGINE * | p, |
bool | bSingleThreaded | ||
) |
Force processing to be single threaded.
Set bSingleThreaded to TRUE to force processing in single thread mode.
p | [in, out] - pointer to PFCENGINE instance as returned from PFC_CreateEngine(). |
bSingleThreaded | [in] - set to TRUE to enable single thread processing. |
PFCAPPLYSTATUS PFC_TransposeExif | ( | PFCIMAGE * | pImageSrc, |
int | iEXIFOrientation | ||
) |
Transpose image upright from/to EXIF Orientation.
pImageSrc | [in, out] - image to transpose |
iEXIFOrientation | [in] - EXIF orientation tag value. Use negative to do reverse (upright to orientation) |