Notch Notch Manual 0.9.23
 Light | Dark
Face Tracker

Face Tracker

Searches the supplied image or video for faces.



Method #

This node searches the supplied image or video for faces. if a face is found, a mesh is generated then tracked along with the image.

CPU Tracking #

Face tracking using this method is based on machine learning. It uses a preprocessed database generated from hundreds of different images of faces to recognise new faces in the images given to it. This database is required by the Face Tracker node; it is loaded as a “Machine Learning Database” resource and is set via the “Training Database” parameter.

An example database is available for download here. You can also download sample project files.

Face tracking with this method is very is CPU-intensive; face recognition takes 1-2 frames on CPU. In order to keep rendering performant, this is performed in parallel to the rest of the graphics processing in the frame. As such, there is an inherent additional latency in the output of the node - typically two frames, but this may be reduced to one frame using the “Low Latency” option at the cost of reduced frame rate. To simplify use, the image output from the Face Tracking node is delayed so it is in sync with the geometry generated by the node: if you are using the face geometry from the detected face with a Face Tracking Geometry node, you can use the image stored on the Face Tracker node to texture it and they will be in sync.

NVIDIA Face Tracking (RTX Only) #

This method uses the NVIDIA RTX AI based face tracking solution to generate a face mesh, and track the points between frames. This features requires an NVIDIA RTX enabled graphics card, as well as the NVIDIA AR drivers (available here). Running on the GPU, this method is far faster than the CPU based alternative and can be used with a 3D Face mesh instead of a 2D mesh.

For more information on the NVIDIA Broadcast Integration, see here
Important information for Step 2: NVIDIA 20xx (Turing), 30xx (Ampere) and 40xx (Ada) cards have different AR SDK downloads. Make sure you download the correct one for your graphics card.

Troubleshooting #

Error: The “Face Tracking Geometry” node is marked as red in the node graph #

You’re missing the NVIDIA Broadcast Engine AR SDK. Please download and install it.

General #

When the Face Tracking node finds a face it generates a mesh which may be used as geometry by the Face Tracking Geometry node, or used to deform a matching 3D object’s vertices using the Face Tracking Deformer node. The image output by the Face Tracking node can either pass through the original input; or output a mask from the detected face geometry in either the RGB or Alpha channels. Only one face can be detected at a time, so multi-face tracking is currently not supported.

The Face Tracker also analyses the detected face pose to determine whether the eyes and mouth are open, the positions of several key points such as the eyes, and the overall approximate rotation and scale of the face. These values are available as envelopes that can be extracted from the node via an Extractor modifier and can, for example, be linked to Image2D nodes in order to attach 2D images to points on the face. The Face Found envelope is set to 0 if no face is found, or 1 if there is.

To improve performance further, there is the option to downsample the input image before face detection - as this typically does not have to be processed at full resolution to find faces. Downsample Steps defines the number of downsample iterations: 1 means half width, half height and so on.

It must be noted that face tracking, while reasonably solid and robust, is not perfect. There is a degree of tolerance but care must be taken with the input feed to ensure that the algorithm is able to perform to its best. In particular:

  • Face detection works best in good, balanced, even lighting, with a subject facing straight on to the camera and good image quality. The technique is not intended to work with moving cameras but is tolerant to some degree.
  • Excessive facial hair, hats, novelty glasses, low frame rates and fast motion may impact the result.
  • The face must be at least 300 pixels high in the source image. Smaller faces will most likely not be detected.
  • The face detection algorithm can detect multiple faces in a single image, but at present only one face is tracked. To keep consistency the largest face in the image is chosen each frame.


These properties control the core behaviours of the node.

Preview In ViewportPreview the effect blended with alpha in the viewport.
Preview RGB In ViewportPreview the colour values in the viewport.
Preview Alpha In ViewportPreview the alpha values in the viewport.
ActiveEnables or disables the effect. Disabling the effect means it will no longer compute, so disabling a node when not in use can improve performance.
Downsample StepsThe number of times the input image is halved in size before face detection is executed - to increase performance.
Frame SkipsThe number of input frames that are skipped. a 60Hz feed may be processed at 30Hz to increase overall system performance.
Low LatencyReduce the number of frames between processing and getting the result, at the cost of reduced overall performance.
Output Image ModeDefines the image generated by the node.
  • Original Image : The original image is output with no modifications.
  • Face Mask : A white mask is generated against a black background.
  • Face Mask + RGB : A mask is generated and multiplied against the original image, against a black background.
  • Original Image with Alpha Mask : The original image is output, with the mask applied to the alpha.|
Show Bounding BoxesRender bounding boxes of detected faces on screen.
Reset Face When LostReset the face data when a face cannot be found.
SolverWhich solver to use for face tracking.
  • CPU : Use the cpu solver. slower, but hardware agnostic.
  • NVIDIA Face Tracking (RTX Only) : Use an nvidia face tracking solution. faster, but only functions with an rtx gpu.
Training Database“the machine learning database resource”: - required for cpu face tracking to work.


NameDescriptionTypical Input
Effect MaskMask out areas that Post-FX applied to this node won’t be applied.Video Loader
Alpha ImageUse a seperate video nodes luminance values to overwrite the alpha channel of the image.Video Loader