Android & iOS

When using the setEffect feature to refresh the beautification effects, you may refer to the following parameter table. The effectName constants, as delineated in the parameter table, are defined within the XmagicConstant.java file for Android, and within the XmagicConstant.h file for iOS.
Note: If the SDK version you're using is V3.3.0 or earlier, please consult the Android Legacy Beautification Parameter Table, iOS Legacy Beautification Parameter Table.

Beautification, Body Beautification

Type
Name

effectName

effectValue

resourcePath

Constant Name

Constant Value

Effect Intensity

Resource Path

Beauty filter
Brighten0
BEAUTY_WHITEN0
beauty.lutFoundationAlpha0
0 ~ 100
Before V3.9.0: No
V3.9.0 and later: 【Optional】custom white lut path
Brighten
BEAUTY_WHITEN
beauty.lutFoundationAlpha
0 ~ 100
Before V3.9.0: No
V3.9.0 and later: 【Optional】custom white lut path
Brighten 2
BEAUTY_WHITEN2
beauty.lutFoundationAlpha2
0 ~ 100
Before V3.9.0: No
V3.9.0 and later: 【Optional】custom white lut path
Brighten 3
BEAUTY_WHITEN3
beauty.lutFoundationAlpha3
0 ~ 100
Before V3.9.0: No
V3.9.0 and later: 【Optional】custom white lut path
Black
(V3.7.0)
BEAUTY_BLACK_1
beauty.lutBlackAlpha1
0 ~ 100
No
Brown
(V3.7.0)
BEAUTY_BLACK_2
beauty.lutBlackAlpha2
0 ~ 100
No
Smooth skin
BEAUTY_SMOOTH
smooth.smooth
0 ~ 100
No
Rosy skin
BEAUTY_ROSY
smooth.rosy
0 ~ 100
No
Screen Adjustment
Contrast
BEAUTY_CONTRAST
beauty.imageContrastAlpha
-100 ~ 100
No
Saturation
BEAUTY_SATURATION
smooth.saturation
-100 ~ 100
No
Sharpness
BEAUTY_CLEAR
beauty.lutClearAlpha
0 ~ 100
No
Sharpen
BEAUTY_SHAPE
smooth.sharpen
0 ~ 100
No
Brightness
(V3.8.0)
BEAUTY_IMAGE_BRIGHTNESS
beauty.imageBrightness
-100 ~ 100
NO
Denoise
(V3.6.0)
BEAUTY_IMAGE_DENOISE
postEffect.denoise
0 ~ 100
No
Warmth
BEAUTY_IMAGE_WARMTH
beauty.imageWarmth
-100 ~ 100
No
Tint
BEAUTY_IMAGE_TINT
beauty.imageTint
-100 ~ 100
No
Advanced Aesthetics
Big eyes
BEAUTY_ENLARGE_EYE
basicV7.enlargeEye
0 ~ 100
No
Bright eyes
BEAUTY_EYE_LIGHTEN
beauty.eyeLighten
0 ~ 100
No
Eye distance
BEAUTY_EYE_DISTANCE
basicV7.eyeDistance
-100 ~ 100
No
Eye corners
BEAUTY_EYE_ANGLE
basicV7.eyeAngle
-100 ~ 100
No
Eye width
BEAUTY_EYE_WIDTH
basicV7.eyeWidth
-100 ~ 100
No
Eye height
BEAUTY_EYE_HEIGHT
basicV7.eyeHeight
-100 ~ 100
No
Eye position
(V3.8.0)
BEAUTY_EYE_POSITION
basicV7.eyePosition
-100 ~ 100
No
Eye out corner
(V3.9.0)
BEAUTY_EYE_OUT_CORNER
basicV7.eyeOutCorner
-100 ~ 100
No
Eye bags
BEAUTY_FACE_REMOVE_EYE_BAGS
beauty.removeEyeBags
0 ~ 100
No
Angle of eyebrows
BEAUTY_EYEBROW_ANGLE
basicV7.eyebrowAngle
-100 ~ 100
No
Eyebrow distance
BEAUTY_EYEBROW_DISTANCE
basicV7.eyebrowDistance
-100 ~ 100
No
Eyebrow height
BEAUTY_EYEBROW_HEIGHT
basicV7.eyebrowHeight
-100 ~ 100
No
Eyebrow length
BEAUTY_EYEBROW_LENGTH
basicV7.eyebrowLength
-100 ~ 100
No
Thickness of the eyebrows
BEAUTY_EYEBROW_THICKNESS
basicV7.eyebrowThickness
-100 ~ 100
No
Eyebrow ridge
BEAUTY_EYEBROW_RIDGE
basicV7.eyebrowRidge
-100 ~ 100
No
thin Nose
BEAUTY_NOSE_THIN
basicV7.thinNose
0 ~ 100
No
Nose wings
BEAUTY_NOSE_WING
basicV7.noseWing
-100 ~ 100
No
Nose position
BEAUTY_NOSE_HEIGHT
basicV7.noseHeight
-100 ~ 100
No
Nasal bridge
BEAUTY_NOSE_BRIDGE_WIDTH
basicV7.noseBridgeWidth
-100 ~ 100
No
Mountain Root
BEAUTY_NASION
basicV7.nasion
-100 ~ 100
No
White teeth
BEAUTY_TOOTH_WHITEN
beauty.toothWhiten
0 ~ 100
No
Mouth Shape
BEAUTY_MOUTH_SIZE
basicV7.mouthSize
-100 ~ 100
No
Lip height
BEAUTY_MOUTH_HEIGHT
basicV7.mouthHeight
-100 ~ 100
No
Lip Width
BEAUTY_MOUTH_WIDTH
basicV7.mouthWidth
-100 ~ 100
No
Lip position
BEAUTY_MOUTH_POSITION
basicV7.mouthPosition
-100 ~ 100
No
Smiling lips
BEAUTY_SMILE_FACE
basicV7.smileFace
-100 ~ 100
No
Face width
BEAUTY_FACE_THIN
basicV7.thinFace
0 ~ 100
No
Slim face - Natural
BEAUTY_FACE_NATURE
basicV7.natureFace
0 ~ 100
No
Slim face-Goddess
BEAUTY_FACE_GODNESS
basicV7.godnessFace
0 ~ 100
No
Slim face- Handsome
BEAUTY_FACE_MALE_GOD
basicV7.maleGodFace
0 ~ 100
No
V-shaped face
BEAUTY_FACE_V
basicV7.vFace
0 ~ 100
No
Slim jaw
BEAUTY_FACE_JAW
basicV7.faceJaw
0 ~ 100
No
Short Face
BEAUTY_FACE_SHORT
basicV7.shortFace
0 ~ 100
No
Face shape
BEAUTY_FACE_BASIC
liquefaction.basic3
0 ~ 100
No
Chin
BEAUTY_FACE_THIN_CHIN
basicV7.chin
-100 ~ 100
No
Forehead
BEAUTY_FACE_FOREHEAD
basicV7.forehead
-100 ~ 100
No
Wrinkle Removal
BEAUTY_FACE_REMOVE_WRINKLE
beauty.removeWrinkle
0 ~ 100
No
Eliminate Nasolabial Folds
BEAUTY_FACE_REMOVE_LAW_LINE
beauty.removeLawLine
0 ~ 100
No
Cheekbones
BEAUTY_FACE_THIN_CHEEKBONE
basicV7.cheekboneThin
0 ~ 100
No
Single-point makeup
Lipstick
BEAUTY_MOUTH_LIPSTICK
beauty.faceFeatureLipsLut
0 ~ 100
The absolute path of the lipstick image on the mobile phone or the relative path to the beauty model file directory Example: /images/beauty/lips_fuguhong.png
Blush
BEAUTY_FACE_RED_CHEEK
beauty.faceFeatureRedCheek
0 ~ 100
Example: /images/beauty/saihong_jianyue.png
Contour
BEAUTY_FACE_SOFTLIGHT
beauty.faceFeatureSoftlight
0 ~ 100
Example: /images/beauty/liti_ziran.png
HairColor
(V3.7.0)
BEAUTY_HAIR_COLOR_LUT
beauty.hairColorLut
0 ~ 100
Example: /images/hair_color/red.png
Eyeshadow
BEAUTY_FACE_EYE_SHADOW
beauty.faceFeatureEyesMakeup.eyeShadow
0 ~ 100
Example: /images/beauty/eyes_makeup_eye_shadow_0-albatross.png
Eyeliner
BEAUTY_FACE_EYE_LINER
beauty.faceFeatureEyesMakeup.eyeLiner
0 ~ 100
Example: /images/beauty/eyes_makeup_eye_liner_0.png
Eyelashes
BEAUTY_FACE_EYELASH
beauty.faceFeatureEyesMakeup.eyelash
0 ~ 100
Example: /images/beauty/eyes_makeup_eyelash_0.png
Eyebrows
BEAUTY_FACE_EYEBROW
beauty.faceFeatureEyesMakeup.eyebrow
0 ~ 100
Example: /images/beauty/eyes_makeup_eyebrow_0.png
Colored Contacts
BEAUTY_FACE_EYEBALL
beauty.faceFeatureEyesMakeup.eyeball
0 ~ 100
Example: /images/beauty/eyes_makeup_eyeball_0.png
Eyelids
(V3.8.0)
BEAUTY_FACE_MAKEUP_EYELIDS
beauty.faceFeatureEyesMakeup.eyelids
0 ~ 100
Example: /images/beauty/eyes_makeup_eyelids_kaishan.png
Wocan
(V3.8.0)
BEAUTY_FACE_MAKEUP_EYEWOCAN
beauty.faceFeatureEyesMakeup.eyewocan
0 ~ 100
Example: /images/beauty/eyes_makeup_eye_wocan_keai.png
Body beautification
One-click slimming
BODY_AUTOTHIN_BODY_STRENGTH
body.autothinBodyStrength
0 ~ 100
No
Long legs
BODY_LEG_STRETCH
body.legStretch
0 ~ 100
No
Thin legs
BODY_SLIM_LEG_STRENGTH
body.slimLegStrength
0 ~ 100
No
Slim waist
BODY_WAIST_STRENGTH
body.waistStrength
0 ~ 100
No
Slim shoulders
BODY_THIN_SHOULDER_STRENGTH
body.thinShoulderStrength
0 ~ 100
No
Chest Adjustment
BODY_ENLARGE_CHEST_STRENGTH
body.enlargeChestStrength
-100 ~ 100
No
Small head
BODY_SLIM_HEAD_STRENGTH
body.slimHeadStrength
0 ~ 100
No

Filters, Cosmetics, Motion Effects, Segmentation

Type

effectName

effectValue

resourcePath

extraInfo

Constant Name

Constant Value

Effect Intensity

Resource Path

Additional Parameters (Key-Value Pair Type)

Filter
EFFECT_LUT
lut
0 ~ 100
The absolute path of the filter image on the mobile device, for instance: /data/user/0/com.tencent.pitumotiondemo.effects/files/xmagic/light_material/lut/aiqing_lf.png If you wish to cancel the filter, enter null here
No
Light makeup
EFFECT_LIGHT_MAKEUP
light.makeup
0~100
Absolute path to beauty materials on the mobile phone.
To cancel beauty makeup, fill in 'null' here

[Optional]makeupLutStrength: The filter strength in the makeup material, with a value ranging from "0" to "100"
Makeup
EFFECT_MAKEUP
makeup
0 ~ 100
Absolute path to beauty materials on the mobile phone. To cancel beauty makeup, fill in 'null' here
[Optional]makeupLutStrength: The filter strength in the makeup material, with a value ranging from "0" to "100"
[Optional]mergeWithCurrentMotion: Represents whether to superimpose on the current motion effect, "true" or "false". If this field is not filled, it is considered to be false
Motion
EFFECT_MOTION
motion
No
The absolute path of the motion graphics material on the mobile device, for instance: /data/user/0/com.tencent.pitumotiondemo.effects/files/xmagic/light_material/motion/video_keaituya If you wish to cancel the motion effect, fill in 'null' here
[Optional]mergeWithCurrentMotion: "true" or "false", indicating whether it is to be superimposed on the current motion effect. If this field is not filled out, it is assumed to be false
Background Demarcation
(ordinary)
EFFECT_SEGMENTATION
segmentation
No
The absolute path of the background segmentation material on the mobile phone If you want to cancel the segmentation, fill in null here
[Optional]mergeWithCurrentMotion: "true" or "false", indicating whether it is to be superimposed on the current motion effect. If this field is not filled out, it is assumed to be false
Background Demarcation
(Green Screen )
EFFECT_SEGMENTATION
segmentation
No
The absolute path of the background segmentation material on the mobile phone If you want to cancel the segmentation, fill in null here
[Required]segType:"green_background"
[Required]bgType: User-Defined Background Type, "0" represents images or pag, "1" represents videos
[Optional]bgPath: User-Defined Background Image or Video Path
[Optional]keyColor: Green Screen Color RGB, the format is like "#0x00ff00"
[Optional]mergeWithCurrentMotion: "true" or "false", indicates whether to overlay it on the current animation effect. If this field is not filled in, it is considered as false
Note: Either bgPath or keyColor must be set.
Background Demarcation
(Custom)
EFFECT_SEGMENTATION
segmentation
No
The absolute path of the background segmentation material on the mobile phone If you want to cancel the segmentation, fill in null here
[Required]segType:"custom_background"
[Required]bgType: User-defined background type, "0" denotes image or pag, "1" indicates a video
[Required]bgPath: Pathway for the user-defined background image or video
[Optional]mergeWithCurrentMotion:"true" or "false", specifies whether to overlay on the current motion effect. If this field is left blank, it’s assumed to be false