EyeQ Docs
API ReferenceC API Reference

Enums

Enumeration types in the Perfectly Clear C API.

This page documents all enumeration types in the Perfectly Clear C API.

Pixel formats

These enumerations define the supported image pixel formats for processing.

PFCPIXELFORMAT

Defines the format and byte order of image pixel data passed to the SDK.

ValueDescription
PFC_PixelFormat24bppRGB24-bit RGB, 8 bits per channel
PFC_PixelFormat24bppBGR24-bit BGR, 8 bits per channel
PFC_PixelFormat32bppABGR32-bit ABGR with alpha
PFC_PixelFormat32bppARGB32-bit ARGB with alpha
PFC_PixelFormat48bppRGB48-bit RGB, 16 bits per channel
PFC_PixelFormat48bppBGR48-bit BGR, 16 bits per channel
PFC_PixelFormat64bppARGB64-bit ARGB, 16 bits per channel
PFC_PixelFormat64bppABGR64-bit ABGR, 16 bits per channel

Engine status

These codes indicate the result of engine initialization operations.

PFCENGINESTATUS

Reports the status of a PFCENGINE instance after creation.

ValueDescription
ENGINESTATUS_OKEngine created successfully
ENGINESTATUS_FB_LIBRARY_LOAD_FAILUnable to load the SFB library
ENGINESTATUS_FB_FUNCTION_NOT_FOUNDUnable to locate SFB functions

Feature flags

These flags control which correction features are calculated during image analysis.

PFCFEATURE

Specifies which correction types to calculate, and can be combined with bitwise OR for multiple features.

ValueDescription
CALC_CORECalculate for Core correction
CALC_NRCalculate for Noise Removal
CALC_FBCalculate for Face Beautification
CALC_RECalculate for Red Eye Removal
CALC_ALLCalculate for all classic features
CALC_NOTINTCALCSkip Abnormal Tint pre-calculations
CALC_NOFAESkip Face Aware Exposure pre-calculations
CALC_FAEHISPEEDUse fast mode for Face Aware Exposure
CALC_SCENE_DETECTIONCalculate Scene Detection
CALC_COMPOSITECalculate Composite Detection
CALC_SKINTONECalculate Skin Tone Detection
CALC_AICOLORCalculate Auto White Balance

Presets

These identifiers select built-in parameter configurations optimized for different use cases.

PFCPRESETID

Identifies a built-in preset that initializes correction parameters with optimized default values.

ValueDescription
PRESET_NONEAll corrections off
PRESET_BEAUTIFYGood defaults for portraits
PRESET_BEAUTIFYPLUSStronger beautification
PRESET_DETAILSLegacy iAuto Details
PRESET_VIVIDGood for landscapes
PRESET_INTELLIGENTAUTOLegacy Intelligent Auto
PRESET_IAUTO_2019iAuto 2019
PRESET_IAUTO_2019_REiAuto 2019 with Red Eye
PRESET_IAUTO_21iAuto 2021
PRESET_IAUTO_21_ASIAiAuto 2021 for Asian skin tones
PRESET_IAUTO_PEOPLEDefault preset for 2023

Correction modes

These enumerations configure the behavior of specific correction algorithms.

TINTCORRECTION

Controls the sensitivity of abnormal tint detection and correction.

ValueDescription
TINTCORRECT_AGGRESSIVEAggressive detection
TINTCORRECT_DEFAULTModerate detection
TINTCORRECT_CONSERVATIVEMinimum false positives
TINTCORRECT_STRONGESTHighest sensitivity

CONTRASTMODE

Selects between contrast enhancement and detail preservation modes.

ValueDescription
HIGH_CONTRASTHigher contrast
HIGH_DEFINITIONMore shadow and highlight details

DCFMODE

Controls the Digital Color Fidelity analysis mode for color accuracy.

ValueDescription
DCF_STANDARDFor normal photos
DCF_VIVIDFor more color vibrancy

AGGRESSIVENESS

Sets how aggressively the Auto Exposure algorithm adjusts brightness.

ValueDescription
AGGRESSIVENESS_CONSERVATIVELess aggressive
AGGRESSIVENESS_MODERATEModerate
AGGRESSIVENESS_AGGRESSIVEMore aggressive

BIASMODE

Configures skin tone and depth bias preferences for exposure calculations.

ValueDescription
BIAS_NONETurn off bias
BIAS_ASIAN_PREFERENCEAsian skin tone
BIAS_AVERAGE_PREFERENCEAverage or Normal
BIAS_BRIGHTER_PREFERENCEBrighter tone
BIAS_AUTOAuto-calculated

Face beautification modes

These enumerations configure Face Beautification correction behaviors.

SKINMODE

Determines whether skin corrections apply only to detected faces or to all skin regions.

ValueDescription
SKINMODE_FACEFace regions only
SKINMODE_BODYAll skin regions

SKINSMOOTHTYPE

Selects the intensity and style of skin smoothing applied to faces.

ValueDescription
SKINSMOOTHTYPE_SUBTLEKeeps face texture
SKINSMOOTHTYPE_DEFAULTBalanced
SKINSMOOTHTYPE_SUPERSMOOTHMore aggressive

SKINTONINGTYPE

Specifies the type of skin tone adjustment to apply.

ValueDescription
SKINTONINGTYPE_WHITEWhitens face
SKINTONINGTYPE_PALELighter, more pale
SKINTONINGTYPE_WARMWarms skin tone
SKINTONINGTYPE_TANNaturally tanned
SKINTONINGTYPE_FOUNDATIONUser-defined color

LIPSHARPENTYPE

Controls the intensity of lip edge sharpening in portraits.

ValueDescription
LIPSHARPENTYPE_FINEFine sharpening
LIPSHARPENTYPE_MEDIUMStronger
LIPSHARPENTYPE_COARSECoarsely pronounced

Status codes

These enumerations report the results of SDK operations.

PFCAPPLYSTATUS

Indicates the result of PFC_Apply and PFC_AutoCorrect operations.

ValueDescription
APPLY_SUCCESSSuccess (value 0)
APPLY_ERROR_PROFILE_MISSINGProfile is NULL (value -1)
APPLY_ERROR_ENGINE_MISSINGEngine is NULL (value -2)
APPLY_CANCELLEDCancelled by callback (value -3)
APPLY_NOSOURCESource image is NULL (value -4)
APPLY_BADFORMATUnsupported pixel format (value -5)
APPLY_INVALIDLICENSEInvalid license (value -6)
APPLY_LOOKS_MISSINGLUT file not found (value -12)
APPLY_ERROR_AI_CORRECTION_MISSINGAI correction unavailable (value -13)

PFCNR STATUS

Reports the result of Noise Removal pre-calculation analysis.

ValueCodeDescription
PFC_NR_SUCCESS0Success
PFC_NR_NOTENABLED1Not enabled
PFC_NR_FULLRES_REQUIRED2Source image missing
PFC_NR_CANCELLED3Cancelled
PFC_NR_NOTFOUND7Noise not found

PFCCORE STATUS

Reports the result of Core correction pre-calculation analysis.

ValueCodeDescription
PFC_CORE_SUCCESS0Success
PFC_CORE_NOTENABLED1Not enabled
PFC_CORE_CANCELLED2Cancelled
PFC_CORE_NOSOURCEIMAGE3Source image missing
PFC_CORE_INSUFFICIENTMEMORY4Insufficient memory
PFC_CORE_MONOLITHIMAGE5Monolith image skipped
PFC_CORE_BELOWMINSIZE6Image too small
PFC_CORE_CLIPARTIMAGE7Clipart skipped

PFCFB STATUS

Reports the result of Face Beautification pre-calculation analysis.

ValueCodeDescription
PFC_FB_SUCCESS0Success
PFC_FB_NOTENABLED1Not enabled
PFC_FB_WARNING2Face not detected
PFC_FB_NOT_AVAILABLE10Feature unavailable

PFCRE STATUS

Reports the result of Red Eye correction pre-calculation analysis.

ValueCodeDescription
PFC_RE_SUCCESS0Success
PFC_RE_NOTENABLED1Not enabled
PFC_RE_NOT_FOUND3Red eye not found

Rejection options

These flags control automatic rejection of images that are unsuitable for correction.

PFCREJECTOPTION

Specifies which types of images should be automatically rejected during PFC_Calc.

ValueDescription
PFC_REJECT_NONEDisable rejection
PFC_REJECT_MONOLITHReject solid colors
PFC_REJECT_CLIPARTReject clipart (default)

AI features

These flags control loading and use of AI-powered correction features.

PFCAIFEATURE

Specifies which AI models to load when calling PFC_LoadAIEngine.

ValueRequired FilesDescription
AI_SCENE_DETECTIONpro and universal pnnScene detection
AI_CORRECTIONSdynamic.pnnAI corrections
AI_COMPOSITEcomposite.pnnComposite detection
AI_SKINTONEautoSkin tone detection
AI_COLORaicolor.pnnAI White Balance
AI_FACEMESHFace mesh modelFace mesh

PFCCOMPOSITE

Indicates the result of composite image detection analysis.

ValueDescription
PFC_COMPOSITE_FAILEDDetection failed
PFC_COMPOSITE_SKIPSkip processing
PFC_COMPOSITE_PHOTOIs a photo

Mask types

These values define mask shapes for gradient filter effects.

PFCCORE MASK TYPE

Specifies the shape of a gradient mask for selective corrections.

ValueDescription
MASK_NONEDo not apply
MASK_ALLBackground with 1.0 everywhere
MASK_RADIALEllipse mask
MASK_TOPLinear from top
MASK_BOTTOMLinear from bottom
MASK_ROUNDRECTRounded rectangle

PFC-SDK Version 10.7.2.1269 built from 4fa849d8101945eea725a08dd0dae5101f090fa0 on 11-10-2025.

Copyright © 2026 EyeQ Imaging Inc. All rights reserved.

Data Structures

Previous Page

Error codes

Next Page

On this page

Pixel formatsPFCPIXELFORMATEngine statusPFCENGINESTATUSFeature flagsPFCFEATUREPresetsPFCPRESETIDCorrection modesTINTCORRECTIONCONTRASTMODEDCFMODEAGGRESSIVENESSBIASMODEFace beautification modesSKINMODESKINSMOOTHTYPESKINTONINGTYPELIPSHARPENTYPEStatus codesPFCAPPLYSTATUSPFCNR STATUSPFCCORE STATUSPFCFB STATUSPFCRE STATUSRejection optionsPFCREJECTOPTIONAI featuresPFCAIFEATUREPFCCOMPOSITEMask typesPFCCORE MASK TYPE