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 falseNote: 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 |