Face Effects Overview
Introduction
Lens Studio provides a variety of Face Effects you can add to your Lenses. These effects range from face modifications which require no assets, to attachments requiring simple 2D textures, to more complex effects with 3D animated assets. These effects can be used on their own or together, and can be applied to one or more faces.
Face Effects
This guide provides a general overview of each available Face Effect in Lens Studio.
Face Retouch
The Face Retouch effect offers a number of features for retouching the user's face. These features include Soft Skin, Teeth Whitening, Eye Sharpening and Eye Whitening. The Face Retouch object works best when subtly applied to the face. All face templates utilize a very subtle Face Retouch effect enabled by default.
Eye Color
The Eye Color effect allows you to change the color of the user's eyes. It also allows you to create subtle eye reflections with the more advanced Texture mode.
Face Liquify
The Face Liquify effect spherically warps the face. You are able to configure how big and how intense the effect is. The Face Liquify object is perfect for making funny or exaggerated faces. See the Distort template for an example.
Face Stretch
The Face Stretch effect allows you to stretch points of the user's face. It’s perfect for creating fun and playful face expressions. See the Distort template for an example.
Face Inset
The Face Inset object allows you to map a feature of your face (e.g. eyes) to other areas of your face. This allows you to, for example, replace your eyes with mouths or map an eye to the center of your forehead. See the Distort template for an example.
Face Mask
The Face Mask effect maps a 2D texture to your face. The texture appears to be painted on your skin and contorts with facial movements. It’s great for full face masks but also can be used to create realistic makeup. See the Face Paint and Photo template for an example.
2D Face Attachment
The Face Image effect attaches a 2D textured plane to your head. See the 2D Objects template for an example.
3D Face Attachment
You can use a similar technique to attach 3D objects as well by replacing the 2D image with a 3D Mesh Visual. See the 3D Objects template for an example and the Head Attached 3D Objects guide for more information.
Face Mesh
The Face Mesh resource provides a 3D mesh that will mimic the user’s facial expression in real time. It can be used anywhere a mesh may be used.
Face Landmarks
Face Landmarks are 93 points that are tracked with the user's face. Like Object tracking, the position of the points are in screen space.
Face Expressions
The Face Expressions Effect allows you to get information about the current expression of the user’s face--such as whether they are currently blinking their left eye, opening their mouth, and more.
Eye Tracking
The Eye Tracking effect allows you to track the position and rotation of the user’s eyes.
Face Texture
The Face Texture effect allows you to get a your Camera texture centered around a part of your face. It can be used, for example, for creating a picture in picture effect, or for applying a user’s face to a 3D object in your Lens.
Face Image Picker Texture
The Face Image Picker Texture resource allows you to get an image from your device's camera roll centered around a face. It can be used to apply the face of a person saved to your camera roll to a 3D object in your Lens scene. The texture is very similar to Face Texture but is driven by the device's camera roll instead of the live camera. In fact, if you have a project that's already using Face Texture, simply replacing that texture with a Face Image Picker Texture will upgrade it to a from camera roll experience.
Face Interactivity
Additionally, you can use facial movements to trigger behaviors in your lens. Example of facial triggers include:
- Opens mouth
- Smile
- Raise eyebrows
- Kiss
For a more complete list see the Events API page. See the Trigger template for an example.
Related Guides
Please refer to the guides below for additional information: