结构体
class	GlfwWindow

struct	QueenEngineInstance

struct	QueenGreenScreenParam

struct	QueenMakeupParam

struct	QueenSegmentBGParam

类型定义
typedef void(*	queen_backgroundSegment_callback) (uint8_t *mask_data, int width, int height)

typedef void(*	queen_alg_gesture_callback) (int handCount, int gestureType, int actionType)

typedef void *	queen_engine_t

枚举
enum	QUEEN_RESULT_CODE { QUEEN_RESULT_CODE_OK = 0 , QUEEN_RESULT_CODE_INVALID_LICENSE = 1 , QUEEN_RESULT_CODE_INVALID_PARAM = 2 , QUEEN_RESULT_CODE_NO_EFFECT = 3 , QUEEN_RESULT_CODE_FAIL = 4 , QUEEN_RESULT_CODE_INVALID_HANDLE = 5 }

enum	kQueenBeautyType { kQueenBeautyTypeSkinBuffing = 0 , kQueenBeautyTypeFaceBuffing = 1 , kQueenBeautyTypeMakeup = 2 , kQueenBeautyTypeFaceShape = 3 , kQueenBeautyTypeSkinWhiting = 4 , kQueenBeautyTypeLUT = 5 , kQueenBeautyTypeBackgroundProcess = 6 , kQueenBeautyTypeAutoFilter = 7 , kQueenBeautyTypeMax = 8 }

enum	kQueenBeautyFilterMode { kQueenBeautyFilterModeDefault = 0 , kQueenBeautyFilterModeSkinBuffing_Natural = 1 , kQueenBeautyFilterModeSkinBuffing_Strong = 2 , kQueenBeautyFilterModeFaceShape_Baseline = 11 , kQueenBeautyFilterModeFaceShape_Main = 12 , kQueenBeautyFilterModeFaceShape_High = 13 , kQueenBeautyFilterModeFaceShape_Max = 14 , kQueenBeautyFilterModeFaceMakeup_Baseline = 21 , kQueenBeautyFilterModeFaceMakeup_High = 22 }

enum	kQueenBeautyParams { kQueenBeautyParamsSkinBuffing = 1 , kQueenBeautyParamsSharpen = 2 , kQueenBeautyParamsWhitening = 3 , kQueenBeautyParamsPouch = 4 , kQueenBeautyParamsNasolabialFolds = 5 , kQueenBeautyParamsLUT = 6 , kQueenBeautyParamsWhiteTeeth = 7 , kQueenBeautyParamsLipstick = 8 , kQueenBeautyParamsBlush = 9 , kQueenBeautyParamsLipstickColorParam = 10 , kQueenBeautyParamsLipstickGlossParam = 11 , kQueenBeautyParamsLipstickBrightnessParam = 12 , kQueenBeautyParamsBrightenEye = 13 , kQueenBeautyParamsSkinRed = 14 , kQueenBeautyParamsWrinkles = 15 , kQueenBeautyParamsBrightenFace = 16 , kQueenBeautyParamsAutoLRate = 17 , kQueenBeautyParamsAutoARate = 18 , kQueenBeautyParamsAutoBRate = 19 }

enum	kQueenBeautyMakeupType { kQueenBeautyMakeupTypeWhole = 0 , kQueenBeautyMakeupTypeHighlight = 1 , kQueenBeautyMakeupTypeEyeball = 2 , kQueenBeautyMakeupTypeMouth = 3 , kQueenBeautyMakeupTypeWocan = 4 , kQueenBeautyMakeupTypeEyeBrow = 5 , kQueenBeautyMakeupTypeBlush = 6 , kQueenBeautyMakeupTypeEyeShadow = 7 , kQueenBeautyMakeupTypeEyeliner = 8 , kQueenBeautyMakeupTypeEyelash = 9 , kQueenBeautyMakeupTypeMakeupMax = 10 }

enum	kQueenBeautyFaceShapeType { kQueenBeautyFaceShapeTypeCutCheek = 0 , kQueenBeautyFaceShapeTypeCutFace = 1 , kQueenBeautyFaceShapeTypeThinFace = 2 , kQueenBeautyFaceShapeTypeLongFace = 3 , kQueenBeautyFaceShapeTypeLowerJaw = 4 , kQueenBeautyFaceShapeTypeHigherJaw = 5 , kQueenBeautyFaceShapeTypeThinJaw = 6 , kQueenBeautyFaceShapeTypeThinMandible = 7 , kQueenBeautyFaceShapeTypeBigEye = 8 , kQueenBeautyFaceShapeTypeEyeAngle1 = 9 , kQueenBeautyFaceShapeTypeCanthus = 10 , kQueenBeautyFaceShapeTypeCanthus1 = 11 , kQueenBeautyFaceShapeTypeEyeAngle2 = 12 , kQueenBeautyFaceShapeTypeEyeTDAngle = 13 , kQueenBeautyFaceShapeTypeThinNose = 14 , kQueenBeautyFaceShapeTypeNosewing = 15 , kQueenBeautyFaceShapeTypeNasalHeight = 16 , kQueenBeautyFaceShapeTypeNoseTipHeight = 17 , kQueenBeautyFaceShapeTypeMouthWidth = 18 , kQueenBeautyFaceShapeTypeMouthSize = 19 , kQueenBeautyFaceShapeTypeMouthHigh = 20 , kQueenBeautyFaceShapeTypePhiltrum = 21 , kQueenBeautyFaceShapeTypeHairLine = 22 , kQueenBeautyFaceShapeTypeSmile = 23 , kQueenBeautyFaceShapeTypeMAX = 24 }

enum	kQueenBeautyBlend { kQueenBeautyBlendNormal = 0 , kQueenBeautyBlendLighten = 1 , kQueenBeautyBlendDarken = 2 , kQueenBeautyBlendMultiply = 3 , kQueenBeautyBlendDivide = 4 , kQueenBeautyBlendAverage = 5 , kQueenBeautyBlendAdd = 6 , kQueenBeautyBlendSubtract = 7 , kQueenBeautyBlendDifference = 8 , kQueenBeautyBlendNegation = 9 , kQueenBeautyBlendExclusion = 10 , kQueenBeautyBlendScreen = 11 , kQueenBeautyBlendOverlay = 12 , kQueenBeautyBlendSoftLight = 13 , kQueenBeautyBlendHardLight = 14 , kQueenBeautyBlendColorDodge = 15 , kQueenBeautyBlendColorBurn = 16 , kQueenBeautyBlendLinearDodge = 17 , kQueenBeautyBlendLinearBurn = 18 , kQueenBeautyBlendLinearLight = 19 , kQueenBeautyBlendVividLight = 20 , kQueenBeautyBlendPinLight = 21 , kQueenBeautyBlendHardMix = 22 , kQueenBeautyBlendReflect = 23 , kQueenBeautyBlendGlow = 24 , kQueenBeautyBlendPhoenix = 25 , kQueenBeautyBlendHue = 26 , kQueenBeautyBlendSaturation = 27 , kQueenBeautyBlendLuminosity = 28 , kQueenBeautyBlendColor = 29 , kQueenBeautyBlendCurve = 30 , kQueenBeautyBlendLabMix = 31 , kQueenBeautyBlendMax }

enum	kQEFlip { kQEFlipNone = 0 , kQEFlipX = 1 , kQEFlipY = 2 }

enum	kQueenBackgroundProcessType { kQueenBackgroundBlur = 0 , kQueenBackgroundTransparent = 1 }

enum	kQueenStaticGestureType { kQueenStaticGestureTypeNone = -1 , kQueenStaticGestureTypeOther , kQueenStaticGestureTypeNumber1 , kQueenStaticGestureTypeNumber2 , kQueenStaticGestureTypeNumber3 , kQueenStaticGestureTypeNumber4 , kQueenStaticGestureTypeNumber5 , kQueenStaticGestureTypeNumber6 , kQueenStaticGestureTypeNumber7 , kQueenStaticGestureTypeNumber8 , kQueenStaticGestureTypeNumber9 , kQueenStaticGestureTypeFist , kQueenStaticGestureTypeOK , kQueenStaticGestureTypeHeart , kQueenStaticGestureTypeThumbUp , kQueenStaticGestureTypeRingPinky , kQueenStaticGestureTypePinky , kQueenStaticGestureTypeGun , kQueenStaticGestureTypeILoveyRock , kQueenStaticGestureTypePaw , kQueenStaticGestureTypeMidFinger , kQueenStaticGestureTypeVulcanSalute , kQueenStaticGestureTypeMidTip , kQueenStaticGestureTypeRingTip , kQueenStaticGestureTypeCup , kQueenStaticGestureTypeSnake , kQueenStaticGestureTypeFingersTogether , kQueenStaticGestureTypeMax }

enum	kQueenHandActionType { kQueenHandActionTypeUnKnown = -2 , kQueenHandActionTypeNone = -1 , kQueenHandActionTypeLeft , kQueenHandActionTypeRight , kQueenHandActionTypeGoodbye , kQueenHandActionTypeSwipLeft , kQueenHandActionTypeSwipRight , kQueenHandActionTypeSwipUp , kQueenHandActionTypeSwipDown , kQueenHandActionTypeThumbUpDynamic , kQueenHandActionTypeZoomIn , kQueenHandActionTypeZoomOut , kQueenHandActionTypeMax }

函数
QUEEN_EXTERN const char *	queen_engine_getSDKVersion ()

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_create (queen_engine_t handle, const char resDir=nullptr, const char *aliyunUID=nullptr)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_set (queen_engine_t handle, char resDir=nullptr, char aliyunUID=nullptr)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_destory (queen_engine_t handle)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_resetAllGLState (queen_engine_t handle)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_setInputFlip (queen_engine_t handle, kQEFlip flip)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_setRenderAndFaceFlip (queen_engine_t handle, kQEFlip renderFlip, kQEFlip faceInfoFlip)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_setShowFaceDetectPoint (queen_engine_t handle, bool value)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_setInputTexture (queen_engine_t handle, uint32_t textureId, int width, int height)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_setOutRect (queen_engine_t handle, int originX, int originY, int width, int height)

QUEEN_EXTERN int	queen_engine_autoGenOutTexture (queen_engine_t handle)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_updateOutTexture (queen_engine_t handle, uint32_t textureId, int width, int height)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_render (queen_engine_t handle, bool withFinish=false)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_render_with_i420 (queen_engine_t handle, void buffer, int width, int height, void bufferOut)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_enableBeautyType (queen_engine_t handle, kQueenBeautyType type, bool enabled, bool debug=false, kQueenBeautyFilterMode mode=kQueenBeautyFilterModeDefault)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_addMaterial (queen_engine_t handle, const char *path)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_removeMaterial (queen_engine_t handle, const char *path)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_setMakeup (queen_engine_t handle, kQueenBeautyMakeupType type, const char **paths, int pathLen, kQueenBeautyBlend blend=kQueenBeautyBlendNormal, int fps=20)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_setMakeupAlpha (queen_engine_t handle, kQueenBeautyMakeupType type, float alpha)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_updateFaceShapeType (queen_engine_t handle, kQueenBeautyFaceShapeType type, float value)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_setLutImage (queen_engine_t handle, const char *path, bool flipY)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_setBeautyParams (queen_engine_t handle, kQueenBeautyParams type, float value)

QUEEN_EXTERN float	queen_engine_getBeautyParams (queen_engine_t handle, kQueenBeautyParams type)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_setSegmentBackgroundImage (queen_engine_t handle, const char *path, bool flipX=false, bool flipY=false)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_setGreenScreen (queen_engine_t handle, const char *backgroundPath, bool blueScreenEnabled, float threshold=1.0f, bool autoThreshold=true, bool outputGrayMask=false)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_setPureColorToBackground (queen_engine_t handle, const char *backgroundPath, int colorType=0, float threshold=0)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_setSegmentInfoFlipY (queen_engine_t handle, bool segmentInfoFlipY)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_setAISegmentForegroundPadding (queen_engine_t handle, int padding)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_setSegmentBackgroundProcessType (queen_engine_t handle, kQueenBackgroundProcessType type)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_setPowerSaving (queen_engine_t handle, bool enable)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_registerBackgroundSegment_callback (queen_engine_t handle, queen_backgroundSegment_callback callbackFunc, const char *name)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_unRegisterBackgroundSegment (queen_engine_t handle, const char *name)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_registerGesture_callback (queen_engine_t handle, queen_alg_gesture_callback callbackFunc, const char *name)

QUEEN_EXTERN QUEEN_RESULT_CODE	queen_engine_unRegisterGesture (queen_engine_t handle, const char *name)

类型定义说明

◆ queen_alg_gesture_callback

typedef void(* queen::queen_alg_gesture_callback) (int handCount, int gestureType, int actionType)

手势识别回调函数

参数

handCount	识别到手的数量
gestureType	手势类型，参考kQueenStaticGestureType
actionType	动作类型，参考kQueenHandActionType

在文件 queen_engine.h 第 41 行定义.

◆ queen_backgroundSegment_callback

typedef void(* queen::queen_backgroundSegment_callback) (uint8_t *mask_data, int width, int height)

实景抠像遮罩回调函数

参数

mask_data	size=width*height的单通道灰度图
width	mask宽
height	mask高

在文件 queen_engine.h 第 32 行定义.

◆ queen_engine_t

typedef void* queen::queen_engine_t

queen_engine 句柄

在文件 queen_engine_configInfo.h 第 47 行定义.

枚举类型说明

◆ kQEFlip

enum queen::kQEFlip

图像翻转方向

枚举值
kQEFlipNone	不翻转
kQEFlipX	延X轴翻转
kQEFlipY	延Y轴翻转

在文件 queen_engine_configInfo.h 第 449 行定义.

◆ kQueenBackgroundProcessType

enum queen::kQueenBackgroundProcessType

智能抠图人像背景处理方式

枚举值
kQueenBackgroundBlur	背景虚化
kQueenBackgroundTransparent	背景透明

在文件 queen_engine_configInfo.h 第 464 行定义.

◆ kQueenBeautyBlend

enum queen::kQueenBeautyBlend

美妆混合模式

枚举值
kQueenBeautyBlendNormal	正常
kQueenBeautyBlendLighten	变亮
kQueenBeautyBlendDarken	变暗
kQueenBeautyBlendMultiply	正片叠底
kQueenBeautyBlendDivide	划分
kQueenBeautyBlendAverage	平均
kQueenBeautyBlendAdd	线性减淡
kQueenBeautyBlendSubtract	减去
kQueenBeautyBlendDifference	差值
kQueenBeautyBlendNegation	反向
kQueenBeautyBlendExclusion	排除
kQueenBeautyBlendScreen	滤色
kQueenBeautyBlendOverlay	叠加
kQueenBeautyBlendSoftLight	柔光
kQueenBeautyBlendHardLight	强光
kQueenBeautyBlendColorDodge	颜色减淡
kQueenBeautyBlendColorBurn	颜色加深
kQueenBeautyBlendLinearDodge	线性减淡
kQueenBeautyBlendLinearBurn	线性加深
kQueenBeautyBlendLinearLight	线性光
kQueenBeautyBlendVividLight	亮光
kQueenBeautyBlendPinLight	点光
kQueenBeautyBlendHardMix	实色混合
kQueenBeautyBlendReflect	反射
kQueenBeautyBlendGlow	发光
kQueenBeautyBlendPhoenix	颗粒
kQueenBeautyBlendHue	色相
kQueenBeautyBlendSaturation	饱和度
kQueenBeautyBlendLuminosity	明度
kQueenBeautyBlendColor	颜色
kQueenBeautyBlendCurve	曲线
kQueenBeautyBlendLabMix	视觉融合模式
kQueenBeautyBlendMax	最大值

在文件 queen_engine_configInfo.h 第 343 行定义.

◆ kQueenBeautyFaceShapeType

enum queen::kQueenBeautyFaceShapeType

美型类型

枚举值
kQueenBeautyFaceShapeTypeCutCheek	颧骨，值的范围[0,1]，默认0
kQueenBeautyFaceShapeTypeCutFace	削脸，值的范围[0,1]，默认0
kQueenBeautyFaceShapeTypeThinFace	瘦脸，值的范围[0,1]，默认0
kQueenBeautyFaceShapeTypeLongFace	脸长，值的范围[0,1]，默认0
kQueenBeautyFaceShapeTypeLowerJaw	下巴缩短，值的范围[-1,1]，默认0
kQueenBeautyFaceShapeTypeHigherJaw	下巴拉长，值的范围[-1,1]，默认0
kQueenBeautyFaceShapeTypeThinJaw	瘦下巴，值的范围[0,1]，默认0
kQueenBeautyFaceShapeTypeThinMandible	瘦下颌，值的范围[0,1]，默认0
kQueenBeautyFaceShapeTypeBigEye	大眼，值的范围[0,1]，默认0
kQueenBeautyFaceShapeTypeEyeAngle1	眼角1，值的范围[0,1]，默认0
kQueenBeautyFaceShapeTypeCanthus	眼距，值的范围[-1,1]，默认0
kQueenBeautyFaceShapeTypeCanthus1	拉宽眼距，值的范围[-1,1]，默认0
kQueenBeautyFaceShapeTypeEyeAngle2	眼角2，值的范围[-1,1]，默认0
kQueenBeautyFaceShapeTypeEyeTDAngle	眼睛高度，值的范围[-1,1]，默认0
kQueenBeautyFaceShapeTypeThinNose	瘦鼻，值的范围[0,1]，默认0
kQueenBeautyFaceShapeTypeNosewing	鼻翼，值的范围[0,1]，默认0
kQueenBeautyFaceShapeTypeNasalHeight	鼻长，值的范围[-1,1]，默认0
kQueenBeautyFaceShapeTypeNoseTipHeight	鼻头长，值的范围[-1,1]，默认0
kQueenBeautyFaceShapeTypeMouthWidth	唇宽，值的范围[-1,1]，默认0
kQueenBeautyFaceShapeTypeMouthSize	嘴唇大小，值的范围[-1,1]，默认0
kQueenBeautyFaceShapeTypeMouthHigh	唇高，值的范围[-1,1]，默认0
kQueenBeautyFaceShapeTypePhiltrum	人中，值的范围[-1,1]，默认0
kQueenBeautyFaceShapeTypeHairLine	发际线，值的范围[-1,1]，默认0
kQueenBeautyFaceShapeTypeSmile	嘴角上扬(微笑)，值的范围[0,1]，默认0
kQueenBeautyFaceShapeTypeMAX	最大值

在文件 queen_engine_configInfo.h 第 262 行定义.

◆ kQueenBeautyFilterMode

enum queen::kQueenBeautyFilterMode

对应美颜类型的模式

枚举值
kQueenBeautyFilterModeDefault	默认值
kQueenBeautyFilterModeSkinBuffing_Natural	磨皮-自然
kQueenBeautyFilterModeSkinBuffing_Strong	磨皮-明显
kQueenBeautyFilterModeFaceShape_Baseline	美型-基准线
kQueenBeautyFilterModeFaceShape_Main	美型-主流
kQueenBeautyFilterModeFaceShape_High	美型-偏大变化
kQueenBeautyFilterModeFaceShape_Max	美型-夸张
kQueenBeautyFilterModeFaceMakeup_Baseline	美妆-基准线
kQueenBeautyFilterModeFaceMakeup_High	美妆-强烈

在文件 queen_engine_configInfo.h 第 108 行定义.

◆ kQueenBeautyMakeupType

enum queen::kQueenBeautyMakeupType

美妆类型

枚举值
kQueenBeautyMakeupTypeWhole	整妆
kQueenBeautyMakeupTypeHighlight	高光
kQueenBeautyMakeupTypeEyeball	美瞳
kQueenBeautyMakeupTypeMouth	口红
kQueenBeautyMakeupTypeWocan	卧蚕
kQueenBeautyMakeupTypeEyeBrow	眉毛
kQueenBeautyMakeupTypeBlush	腮红
kQueenBeautyMakeupTypeEyeShadow	眼影
kQueenBeautyMakeupTypeEyeliner	眼线
kQueenBeautyMakeupTypeEyelash	睫毛
kQueenBeautyMakeupTypeMakeupMax	最大值

在文件 queen_engine_configInfo.h 第 223 行定义.

◆ kQueenBeautyParams

enum queen::kQueenBeautyParams

美颜参数，值为float，除基础美颜外需要先将功能打开，对应参数才有效

枚举值
kQueenBeautyParamsSkinBuffing	基础美颜参数项，基础美颜默认打开，不需要手动调用打开接口磨皮，值的范围[0,1] ，默认0
kQueenBeautyParamsSharpen	基础美颜参数项，基础美颜默认打开，不需要手动调用打开接口锐化，值的范围[0,1] ，默认0
kQueenBeautyParamsWhitening	基础美颜参数项，基础美颜默认打开，不需要手动调用打开接口美白，值的范围[0,1] ，默认0
kQueenBeautyParamsPouch	脸部美颜参数项，需要先打开QueenBeautyTypeFaceBuffing 项去眼袋，值的范围[0,1]，默认0
kQueenBeautyParamsNasolabialFolds	脸部美颜参数项，需要先打开QueenBeautyTypeFaceBuffing 项去法令纹，值的范围[0,1]，默认0
kQueenBeautyParamsLUT	色卡滤镜参数项，需要先打开QueenBeautyTypeLUT 项色卡滤镜强度，值的范围[0,1]，默认0
kQueenBeautyParamsWhiteTeeth	脸部美颜参数项，需要先打开QueenBeautyTypeFaceBuffing 项白牙，值的范围[0,1]，默认0
kQueenBeautyParamsLipstick	脸部美颜参数项，需要先打开QueenBeautyTypeFaceBuffing 项口红，值的范围[0,1]，默认0
kQueenBeautyParamsBlush	脸部美颜参数项，需要先打开QueenBeautyTypeFaceBuffing 项腮红，值的范围[0,1]，默认0
kQueenBeautyParamsLipstickColorParam	脸部美颜参数项，需要先打开QueenBeautyTypeFaceBuffing 项口红色相 [-0.5,0.5], 默认0
kQueenBeautyParamsLipstickGlossParam	脸部美颜参数项，需要先打开QueenBeautyTypeFaceBuffing 项口红饱和度[0,1], 默认0
kQueenBeautyParamsLipstickBrightnessParam	脸部美颜参数项，需要先打开QueenBeautyTypeFaceBuffing 项口红明度[0,1], 默认0
kQueenBeautyParamsBrightenEye	脸部美颜参数项，需要先打开QueenBeautyTypeFaceBuffing 项亮眼[0,1], 默认0
kQueenBeautyParamsSkinRed	脸部美颜参数项，需要先打开QueenBeautyTypeFaceBuffing 项红润[0,1], 默认0
kQueenBeautyParamsWrinkles	脸部美颜参数项，需要先打开QueenBeautyTypeFaceBuffing 项祛皱纹[0,1], 默认0
kQueenBeautyParamsBrightenFace	脸部美颜参数项，需要先打开QueenBeautyTypeFaceBuffing 项祛暗沉[0,1], 默认0
kQueenBeautyParamsAutoLRate	脸部美颜参数项，需要先打开 QueenBeautyTypeAutoFilter 项智能美颜亮度调节比例[-1,1]
kQueenBeautyParamsAutoARate	脸部美颜参数项，需要先打开 QueenBeautyTypeAutoFilter 项智能美颜色度a调节比例[-1,1]
kQueenBeautyParamsAutoBRate	脸部美颜参数项，需要先打开 QueenBeautyTypeAutoFilter 项智能美颜色度b调节比例[-1,1]

在文件 queen_engine_configInfo.h 第 141 行定义.

◆ kQueenBeautyType

enum queen::kQueenBeautyType

美颜类型，需要哪种美颜需要先打开

枚举值
kQueenBeautyTypeSkinBuffing	基础美颜（主要包括磨皮、锐化）
kQueenBeautyTypeFaceBuffing	脸部美颜（主要包括去眼袋、法令纹、白牙、口红、腮红）
kQueenBeautyTypeMakeup	美妆（主要包括整妆、高光、美瞳、口红、眼妆）
kQueenBeautyTypeFaceShape	美型（主要包括瘦脸、瘦下巴、大眼、瘦鼻、美唇等）
kQueenBeautyTypeSkinWhiting	基础美颜（美白）
kQueenBeautyTypeLUT	滤镜，当设置滤镜后，可以指定一个滤镜图片
kQueenBeautyTypeBackgroundProcess	背景处理，实景抠图，使背景虚化
kQueenBeautyTypeAutoFilter	功能类型: 智能美颜
kQueenBeautyTypeMax	最大值

在文件 queen_engine_configInfo.h 第 75 行定义.

◆ kQueenHandActionType

enum queen::kQueenHandActionType

手部动作识别的类别

枚举值
kQueenHandActionTypeUnKnown	未知类型
kQueenHandActionTypeNone	没有识别到
kQueenHandActionTypeLeft	拇指指左
kQueenHandActionTypeRight	拇指指右
kQueenHandActionTypeGoodbye	拜拜
kQueenHandActionTypeSwipLeft	左滑
kQueenHandActionTypeSwipRight	右滑
kQueenHandActionTypeSwipUp	上滑
kQueenHandActionTypeSwipDown	下滑
kQueenHandActionTypeThumbUpDynamic	伸出大拇指
kQueenHandActionTypeZoomIn	放大
kQueenHandActionTypeZoomOut	缩小
kQueenHandActionTypeMax	手部动作识别类型数量

在文件 queen_engine_configInfo.h 第 566 行定义.

◆ kQueenStaticGestureType

enum queen::kQueenStaticGestureType

手势识别的类别

枚举值
kQueenStaticGestureTypeNone	没有识别到
kQueenStaticGestureTypeOther	其他手势
kQueenStaticGestureTypeNumber1	数字1 / 申食指
kQueenStaticGestureTypeNumber2	数字2 / yeah / 剪刀手
kQueenStaticGestureTypeNumber3	数字3
kQueenStaticGestureTypeNumber4	数字4
kQueenStaticGestureTypeNumber5	数字5
kQueenStaticGestureTypeNumber6	数字6 / 电话
kQueenStaticGestureTypeNumber7	数字7
kQueenStaticGestureTypeNumber8	数字8 / 单指手枪
kQueenStaticGestureTypeNumber9	数字9
kQueenStaticGestureTypeFist	拳头
kQueenStaticGestureTypeOK	OK
kQueenStaticGestureTypeHeart	单手比心
kQueenStaticGestureTypeThumbUp	伸大拇指
kQueenStaticGestureTypeRingPinky	申小指和无名指
kQueenStaticGestureTypePinky	申小指
kQueenStaticGestureTypeGun	双指手枪
kQueenStaticGestureTypeILoveyRock	摇滚 / 我爱你
kQueenStaticGestureTypePaw	爪子
kQueenStaticGestureTypeMidFinger	中指
kQueenStaticGestureTypeVulcanSalute	VULCAN SALUTE 星际迷航手势
kQueenStaticGestureTypeMidTip	掐中指
kQueenStaticGestureTypeRingTip	掐无名指
kQueenStaticGestureTypeCup	杯子
kQueenStaticGestureTypeSnake	蛇
kQueenStaticGestureTypeFingersTogether	手指并拢
kQueenStaticGestureTypeMax	手势识别类型数量

在文件 queen_engine_configInfo.h 第 476 行定义.

◆ QUEEN_RESULT_CODE

enum queen::QUEEN_RESULT_CODE

状态码

枚举值
QUEEN_RESULT_CODE_OK	正常
QUEEN_RESULT_CODE_INVALID_LICENSE	license校验失败
QUEEN_RESULT_CODE_INVALID_PARAM	参数错误
QUEEN_RESULT_CODE_NO_EFFECT	没有应用任何Queen的特效处理
QUEEN_RESULT_CODE_FAIL	失败
QUEEN_RESULT_CODE_INVALID_HANDLE	非法句柄

在文件 queen_engine_configInfo.h 第 51 行定义.

函数说明

◆ queen_engine_addMaterial()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_addMaterial	(	queen_engine_t	handle,
		const char *	path
	)

增加贴纸/贴图/实景抠图需要替换的背景

参数

handle	queen_engine句柄
path	要添加的素材的路径

返回: 接口调用状态码

◆ queen_engine_autoGenOutTexture()

QUEEN_EXTERN int queen::queen_engine_autoGenOutTexture ( queen_engine_t handle )

自动生成输出纹理

参数

handle queen_engine句柄

返回: 输出的纹理ID

◆ queen_engine_create()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_create	(	queen_engine_t *	handle,
		const char *	resDir = `nullptr`,
		const char *	aliyunUID = `nullptr`
	)

创建引擎句柄

注解: 必须在GL线程执行

参数

handle	queen_engine句柄
resDir	资源目录，utf8编码字符串，默认是null，即exe同级目录
handle	aliyunUID 阿里云账号ID

返回: 接口调用状态码

◆ queen_engine_destory()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_destory ( queen_engine_t handle )

销毁引擎

注解: 必须在创建引擎的线程执行

参数

handle queen_engine句柄

返回: 接口调用状态码

◆ queen_engine_enableBeautyType()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_enableBeautyType	(	queen_engine_t	handle,
		kQueenBeautyType	type,
		bool	enabled,
		bool	debug = `false`,
		kQueenBeautyFilterMode	mode = `kQueenBeautyFilterModeDefault`
	)

功能开关接口

参数

handle	queen_engine句柄
type	功能类型
enabled	是否开启
debug	调试辅助线是否展示，需要人脸识别才生效
isWithGLContext	当前是否有gl上下文环境

返回: 接口调用状态码

◆ queen_engine_getBeautyParams()

QUEEN_EXTERN float queen::queen_engine_getBeautyParams	(	queen_engine_t	handle,
		kQueenBeautyParams	type
	)

获取功能参数

参数

handle	queen_engine句柄
type	功能类型

返回: 返回功能参数值

◆ queen_engine_getSDKVersion()

QUEEN_EXTERN const char * queen::queen_engine_getSDKVersion ( )

获取sdk版本

返回: sdk版本号

◆ queen_engine_registerBackgroundSegment_callback()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_registerBackgroundSegment_callback	(	queen_engine_t	handle,
		queen_backgroundSegment_callback	callbackFunc,
		const char *	name
	)

获取实景抠像遮罩回调函数注册接口

参数

handle	queen_engine句柄
callbackFunc	回调的函数
name	函数名

返回: 接口调用状态码

◆ queen_engine_registerGesture_callback()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_registerGesture_callback	(	queen_engine_t	handle,
		queen_alg_gesture_callback	callbackFunc,
		const char *	name
	)

获取手势识别结果函数注册接口

参数

handle	queen_engine句柄
callbackFunc	回调的函数
name	函数名

返回: 接口调用状态码

◆ queen_engine_removeMaterial()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_removeMaterial	(	queen_engine_t	handle,
		const char *	path
	)

删除贴纸/贴图/实景抠图需要替换的背景

参数

handle	queen_engine句柄
path	要删除的素材的路径

返回: 接口调用状态码

◆ queen_engine_render()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_render	(	queen_engine_t	handle,
		bool	withFinish = `false`
	)

处理纹理数据

参数

handle	queen_engine句柄
withFinish	是否同步，如果要取数据，则为true

返回: 接口调用状态码

◆ queen_engine_render_with_i420()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_render_with_i420	(	queen_engine_t	handle,
		void *	buffer,
		int	width,
		int	height,
		void *	bufferOut
	)

处理i420数据

参数

handle	queen_engine句柄
buffer	需要处理的数据
width	图像宽度
height	图像高度
bufferOut	处理完的数据

返回: 接口调用状态码

◆ queen_engine_resetAllGLState()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_resetAllGLState ( queen_engine_t handle )

重置GL环境

参数

handle queen_engine句柄

返回: 接口调用状态码

◆ queen_engine_set()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_set	(	queen_engine_t	handle,
		char *	resDir = `nullptr`,
		char *	aliyunUID = `nullptr`
	)

配置引擎

注解: 必须在GL线程执行

参数

handle	queen_engine句柄
resDir	资源目录，utf8编码字符串，默认是null，即exe同级目录
handle	aliyunUID 阿里云账号ID

返回: 接口调用状态码

◆ queen_engine_setAISegmentForegroundPadding()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_setAISegmentForegroundPadding	(	queen_engine_t	handle,
		int	padding
	)

调整实景抠图的前景边距

参数

handle	queen_engine句柄
padding	前景边距，[0,15]，默认0

返回: 接口调用状态码

◆ queen_engine_setBeautyParams()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_setBeautyParams	(	queen_engine_t	handle,
		kQueenBeautyParams	type,
		float	value
	)

设置功能参数

参数

handle	queen_engine句柄
type	功能类型
value	功能参数

返回: 接口调用状态码

◆ queen_engine_setGreenScreen()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_setGreenScreen	(	queen_engine_t	handle,
		const char *	backgroundPath,
		bool	blueScreenEnabled,
		float	threshold = `1.0f`,
		bool	autoThreshold = `true`,
		bool	outputGrayMask = `false`
	)

绿幕/蓝幕抠图

参数

handle	queen_engine句柄
backgroundPath	需要绿/蓝幕替换的背景资源路径，仅当outputGrayMask为false时生效，传空且outputGrayMask为false时即为取消抠图功能
blueScreenEnabled	是否蓝幕抠图
threshold	幕布敏感度[1,10]，默认1
autoThresholdEnabled	是否根据环境动态计算幕布敏感度，为true时调节参数threshold失效，为false时调节参数threshold生效
outputGrayMask	是否输出灰度图，为true的时候backgroundPath失效，为false时且backgroundPath为空即为取消抠图功能

返回: 接口调用状态码

◆ queen_engine_setInputFlip()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_setInputFlip	(	queen_engine_t	handle,
		kQEFlip	flip
	)

设置输入数据的翻转方向

参数

handle	queen_engine句柄
flip	翻转方向

返回: 接口调用状态码

◆ queen_engine_setInputTexture()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_setInputTexture	(	queen_engine_t	handle,
		uint32_t	textureId,
		int	width,
		int	height
	)

设置输入纹理

参数

handle	queen_engine句柄
textureId	输入纹理ID
width	图像宽度
height	图像高度

返回: 接口调用状态码

◆ queen_engine_setLutImage()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_setLutImage	(	queen_engine_t	handle,
		const char *	path,
		bool	flipY
	)

设置色卡滤镜

参数

handle	queen_engine句柄
path	滤镜路径，可以相对资源根目录路径，也可以是绝对路径
flipY	是否需要颠倒

返回: 接口调用状态码

◆ queen_engine_setMakeup()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_setMakeup	(	queen_engine_t	handle,
		kQueenBeautyMakeupType	type,
		const char **	paths,
		int	pathLen,
		kQueenBeautyBlend	blend = `kQueenBeautyBlendNormal`,
		int	fps = `20`
	)

设置美妆参数，每种美妆类型仅可存在一次，如不能同时设置两个整妆，可以整妆+口红+眼妆等等

参数

handle	queen_engine句柄
type	美妆类型
paths	美妆资源路径数组
pathLen	美妆资源数组长度
blend	美妆资源混合方式
fps	美妆资源渲染帧率

返回: 接口调用状态码

◆ queen_engine_setMakeupAlpha()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_setMakeupAlpha	(	queen_engine_t	handle,
		kQueenBeautyMakeupType	type,
		float	alpha
	)

设置美妆透明度

参数

handle	queen_engine句柄
type	美妆类型
alpha	透明度

返回: 接口调用状态码

◆ queen_engine_setOutRect()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_setOutRect	(	queen_engine_t	handle,
		int	originX,
		int	originY,
		int	width,
		int	height
	)

设置裁剪输出矩形 (默认为输入大小就不要设置)

参数

handle	queen_engine句柄
originX	x坐标
originY	y坐标
width	图像宽度
height	图像高度

返回: 接口调用状态码

◆ queen_engine_setPowerSaving()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_setPowerSaving	(	queen_engine_t	handle,
		bool	enable
	)

设置节能模式

参数

handle	queen_engine句柄
enable	是否开启

返回: 接口调用状态码

◆ queen_engine_setPureColorToBackground()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_setPureColorToBackground	(	queen_engine_t	handle,
		const char *	backgroundPath,
		int	colorType = `0`,
		float	threshold = `0`
	)

纯色抠图

参数

handle	queen_engine句柄
backgroundPath	需要纯色替换的背景资源路径, 传空时即为取消抠图功能
colorType	0:绿色, 1:蓝色, 2:青色, 3:紫色, 4:黄色, 5:红色
threshold	颜色敏感度[-1,1]，默认0

返回: 接口调用状态码

◆ queen_engine_setRenderAndFaceFlip()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_setRenderAndFaceFlip	(	queen_engine_t	handle,
		kQEFlip	renderFlip,
		kQEFlip	faceInfoFlip
	)

设置人脸检测结果渲染方向

参数

handle	queen_engine句柄
renderFlip	渲染方向
faceInfoFlip	人脸检测点方向

返回: 接口调用状态码

◆ queen_engine_setSegmentBackgroundImage()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_setSegmentBackgroundImage	(	queen_engine_t	handle,
		const char *	path,
		bool	flipX = `false`,
		bool	flipY = `false`
	)

设置实景抠像的背景

参数

handle	queen_engine句柄
path	实景抠图需要替换的背景资源路径
flipX	是否水平翻转
flipY	是否上下翻转

返回: 接口调用状态码

◆ queen_engine_setSegmentBackgroundProcessType()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_setSegmentBackgroundProcessType	(	queen_engine_t	handle,
		kQueenBackgroundProcessType	type
	)

调整实景抠图的背景处理方式

参数

handle	queen_engine句柄
type	背景处理方式，默认为背景虚化

返回: 接口调用状态码

◆ queen_engine_setSegmentInfoFlipY()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_setSegmentInfoFlipY	(	queen_engine_t	handle,
		bool	segmentInfoFlipY
	)

抠图背景是否需要颠倒

参数

handle	queen_engine句柄
segmentInfoFlipY	背景是否需要上下颠倒

返回: 接口调用状态码

◆ queen_engine_setShowFaceDetectPoint()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_setShowFaceDetectPoint	(	queen_engine_t	handle,
		bool	value
	)

是否开启人脸检测Debug点位

参数

handle	queen_engine句柄
value	是否开启

返回: 接口调用状态码

◆ queen_engine_unRegisterBackgroundSegment()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_unRegisterBackgroundSegment	(	queen_engine_t	handle,
		const char *	name
	)

获取实景抠像遮罩回调函数注销接口

参数

handle	queen_engine句柄
name	函数名

返回: 接口调用状态码

◆ queen_engine_unRegisterGesture()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_unRegisterGesture	(	queen_engine_t	handle,
		const char *	name
	)

获取手势识别结果函数注销接口

参数

handle	queen_engine句柄
name	函数名

返回: 接口调用状态码

◆ queen_engine_updateFaceShapeType()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_updateFaceShapeType	(	queen_engine_t	handle,
		kQueenBeautyFaceShapeType	type,
		float	value
	)

设置美型参数

参数

handle	queen_engine句柄
type	美型类型
value	美型参数

返回: 接口调用状态码

◆ queen_engine_updateOutTexture()

QUEEN_EXTERN QUEEN_RESULT_CODE queen::queen_engine_updateOutTexture	(	queen_engine_t	handle,
		uint32_t	textureId,
		int	width,
		int	height
	)

设置输出纹理

参数

handle	需要输出的纹理ID
width	图像宽度
height	图像高度

返回: 接口调用状态码

结构体

类型定义

枚举

函数

类型定义说明

◆ queen_alg_gesture_callback

◆ queen_backgroundSegment_callback

◆ queen_engine_t

枚举类型说明

◆ kQEFlip

◆ kQueenBackgroundProcessType

◆ kQueenBeautyBlend

◆ kQueenBeautyFaceShapeType

◆ kQueenBeautyFilterMode

◆ kQueenBeautyMakeupType

◆ kQueenBeautyParams

◆ kQueenBeautyType

◆ kQueenHandActionType

◆ kQueenStaticGestureType

◆ QUEEN_RESULT_CODE

函数说明

◆ queen_engine_addMaterial()

◆ queen_engine_autoGenOutTexture()

◆ queen_engine_create()

◆ queen_engine_destory()

◆ queen_engine_enableBeautyType()

◆ queen_engine_getBeautyParams()

◆ queen_engine_getSDKVersion()

◆ queen_engine_registerBackgroundSegment_callback()

◆ queen_engine_registerGesture_callback()

◆ queen_engine_removeMaterial()

◆ queen_engine_render()

◆ queen_engine_render_with_i420()

◆ queen_engine_resetAllGLState()

◆ queen_engine_set()

◆ queen_engine_setAISegmentForegroundPadding()

◆ queen_engine_setBeautyParams()

◆ queen_engine_setGreenScreen()

◆ queen_engine_setInputFlip()

◆ queen_engine_setInputTexture()

◆ queen_engine_setLutImage()

◆ queen_engine_setMakeup()

◆ queen_engine_setMakeupAlpha()

◆ queen_engine_setOutRect()

◆ queen_engine_setPowerSaving()

◆ queen_engine_setPureColorToBackground()

◆ queen_engine_setRenderAndFaceFlip()

◆ queen_engine_setSegmentBackgroundImage()

◆ queen_engine_setSegmentBackgroundProcessType()

◆ queen_engine_setSegmentInfoFlipY()

◆ queen_engine_setShowFaceDetectPoint()

◆ queen_engine_unRegisterBackgroundSegment()

◆ queen_engine_unRegisterGesture()

◆ queen_engine_updateFaceShapeType()

◆ queen_engine_updateOutTexture()