tencent cloud

PrevNext

Feedback

search by keyword

Recent Pages

Documentation
Tencent Effect SDK
    Documentation
    Download PDF

    Android & iOS

    Last updated: 2024-11-28 09:31:33
    Download PDF
      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
      Brighten -
      Bright White
      BEAUTY_WHITEN0
      beauty.lutFoundationAlpha0
      0 ~ 100
      Before V3.9.0: No
      V3.9.0 and later: 【Optional】custom white lut path
      Brighten -
      Natural
      BEAUTY_WHITEN
      beauty.lutFoundationAlpha
      0 ~ 100
      Before V3.9.0: No
      V3.9.0 and later: 【Optional】custom white lut path
      Brighten -
      Pinkish White
      BEAUTY_WHITEN2
      beauty.lutFoundationAlpha2
      0 ~ 100
      Before V3.9.0: No
      V3.9.0 and later: 【Optional】custom white lut path
      Brighten -
      Cool White
      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
      Nose size
      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
      Nasion
      BEAUTY_NASION
      basicV7.nasion
      -100 ~ 100
      No
      White teeth
      BEAUTY_TOOTH_WHITEN
      beauty.toothWhiten
      0 ~ 100
      No
      Lip 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
      Face length
      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
      Wrinkles
      BEAUTY_FACE_REMOVE_WRINKLE
      beauty.removeWrinkle
      0 ~ 100
      No
      Smile lines
      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
      Eyeball
      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
      Breast Adjust
      BODY_ENLARGE_CHEST_STRENGTH
      body.enlargeChestStrength
      -100 ~ 100
      No
      Head size
      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
      （V3.9.0）
      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
      Contact Us

      Contact our sales team or business advisors to help your business.

      Contact Us
      Technical Support

      Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

      Submit a Ticket
      7x24 Phone Support
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      Privacy PolicyLegalCookie Policy