getFaceShapeAreaOptions [1/2]

Gets the facial beauty area options.

public abstract FaceShapeAreaOptions getFaceShapeAreaOptions(
      int shapeArea, Constants.MediaSourceType sourceType);
Since
v4.5.0

Calling this method can retrieve the current settings of the beauty effect.

Applicable scenarios

When the user opens the facial beauty area and shaping intensity menu in the app, you can call this method to get the current beauty effect options, then refresh the menu in the user interface according to the results, and update the UI.

Call timing

Call this method after calling enableVideo.

Restrictions

None.

Parameters

shapeArea
Facial enhancement areas.
  • FACE_SHAPE_AREA_NONE(-1): (Default) Invalid area, no beauty effect applied.
  • FACE_SHAPE_AREA_HEADSCALE(100): Head, used to achieve a smaller head effect. The adjustment range is [0,100]; the larger the value, the smaller the head becomes, with a preset value of 100.
  • FACE_SHAPE_AREA_FOREHEAD(101): Forehead, used to adjust the hairline height. The adjustment strength ranges from [-100,100], with positive values raising and negative values lowering the hairline. The greater the absolute value, the stronger the effect. The default value is 50.
  • FACE_SHAPE_AREA_FACECONTOUR(102): Face contour, used to achieve a slimmer face effect. The adjustment range is [0,100]; the larger the value, the stronger the slimming effect, with a preset value of 10.
  • FACE_SHAPE_AREA_FACELENGTH(103): Face length, used to achieve a longer face effect. The adjustment range is [-100,100]; positive values elongate the face, while negative values shorten it. The larger the value, the stronger the enhancement effect, with a preset value of 0.
  • FACE_SHAPE_AREA_FACEWIDTH(104): Face width, used to achieve a narrower face effect. The adjustment range is [0,100]; the larger the value, the stronger the narrowing effect, with a preset value of 10.
  • FACE_SHAPE_AREA_CHEEKBONE(105): Cheekbone, used to adjust cheekbone width. The adjustment range is [0,100]; the larger the value, the narrower the cheekbones, with a preset set value of 43.
  • FACE_SHAPE_AREA_CHEEK(106): Cheeks, used to adjust the cheeks width. The adjustment range is [0,100]; the larger the value, the narrower the cheeks, with a preset value of 50.
  • FACE_SHAPE_AREA_CHIN(108): Chin, used to adjust the chin length. The adjustment range is [-100,100]; positive values elongate the chin, while negative values shorten it. The larger the value, the stronger the enhancement effect, with a preset value of -20.
  • FACE_SHAPE_AREA_EYESCALE(200):Eyes, used to achieve a larger eye effect. The adjustment range is [0,100]; the larger the value, the larger the eye size, with a preset value of 50.
  • FACE_SHAPE_AREA_EYEDISTANCE(201): Eye distance adjustment. The range is [-100, 100], with a default value of 0. The greater the absolute value, the more noticeable the adjustment. Negative values indicate the opposite direction.
  • FACE_SHAPE_AREA_EYEPOSITION(202): Eye position adjustment. The range is [-100, 100], with a default value of 0. The greater the absolute value, the more noticeable the adjustment. Negative values indicate the opposite direction.
  • FACE_SHAPE_AREA_LOWEREYELID(203): Lower eyelid adjustment. The range is [0, 100], with a default value of 0. The larger the value, the more noticeable the adjustment.
  • FACE_SHAPE_AREA_EYEPUPILS(204): Pupil size adjustment. The range is [0, 100], with a default value of 0. The larger the value, the more noticeable the adjustment.
  • FACE_SHAPE_AREA_EYEINNERCORNER(205): Inner eye corner adjustment. The range is [0, 100], with a default value of 0. The larger the value, the more noticeable the adjustment.
  • FACE_SHAPE_AREA_EYEOUTERCORNER(206): Outer eye corner adjustment. The range is [0, 100], with a default value of 0. The larger the value, the more noticeable the adjustment.
  • FACE_SHAPE_AREA_NOSELENGTH(300): Nose length, used to achieve a longer nose effect. The adjustment range is [-100,100]; positive values elongate the nose, while negative values shorten it. The larger the value, the stronger the enhancement effect, with a preset value of -10.
  • FACE_SHAPE_AREA_NOSEWIDTH(301): Nose width, used to achieve a slimmer nose effect. The adjustment range is [-100,100]; positive values make the nose wider, while negative values make it narrower. The larger the value, the stronger the enhancement effect, with a preset value of 72.
  • FACE_SHAPE_AREA_NOSEWING(302): Nose wing adjustment. The range is [0, 100], with a default value of 0. The larger the value, the more noticeable the adjustment.
  • FACE_SHAPE_AREA_NOSEROOT(303): Nose root adjustment. The range is [0, 100], with a default value of 0. The larger the value, the more noticeable the adjustment.
  • FACE_SHAPE_AREA_NOSEBRIDGE(304): Nose bridge adjustment. The range is [0, 100], with a default value of 0. The larger the value, the more noticeable the adjustment.
  • FACE_SHAPE_AREA_NOSETIP(305): Nose tip adjustment. The range is [0, 100], with a default value of 0. The larger the value, the more noticeable the adjustment.
  • FACE_SHAPE_AREA_NOSEGENERAL(306): Overall nose adjustment. The range is [0, 100], with a default value of 0. The larger the value, the more noticeable the adjustment.
  • FACE_SHAPE_AREA_MOUTHSCALE(400): Mouth, used to achieve a larger mouth effect. The adjustment strength ranges from [0,100], with larger values resulting in a larger mouth. The default value is 50.
  • FACE_SHAPE_AREA_MOUTHPOSITION(401): Mouth position adjustment. The range is [-100, 100], with a default value of 0. The greater the absolute value, the more noticeable the adjustment. Negative values indicate the opposite direction.
  • FACE_SHAPE_AREA_MOUTHSMILE(402): Mouth smile adjustment. The range is [0, 100], with a default value of 0. The larger the value, the more noticeable the adjustment.
  • FACE_SHAPE_AREA_MOUTHLIP(403): Lip shape adjustment. The range is [0, 100], with a default value of 0. The larger the value, the more noticeable the adjustment.
  • FACE_SHAPE_AREA_EYEBROWPOSITION(500): Eyebrow position adjustment. The range is [-100, 100], with a default value of 0. The greater the absolute value, the more noticeable the adjustment. Negative values indicate the opposite direction.
  • FACE_SHAPE_AREA_EYEBROWTHICKNESS(501): Eyebrow thickness adjustment. The range is [0, 100], with a default value of 0. The larger the value, the more noticeable the adjustment.
sourceType
The type of the media source to which the filter effect is applied. See MediaSourceType.
Attention: In this method, this parameter supports only the following two settings:
  • Use the default value PRIMARY_CAMERA_SOURCE if you use camera to capture local video.
  • Set this parameter to CUSTOM_VIDEO_SOURCE if you use custom video source.

Returns

  • A pointer to the FaceShapeAreaOptions instance, if the method call succeeds.
  • NULL is returned, if the method call fails.