Archive:Kdenlive/Manual/Effects/Blur and hide/Auto Mask

From KDE UserBase Wiki

Auto Mask

This effect can be used to mask peoples faces. It uses motion estimation to track subjects and mask faces. It is the MLT filter autotrack_rectangle

Demo

The #evp parser function was deprecated in EmbedVideo 2.0. Please convert your parser function tag to #ev.

How to apply Auto Mask

See video below on how to use this effect. Warning: The effect is not 100% reliable.

Motion Tracking

The Auto Mask effect can also be used to track motion of an object and use it later as keyframes for an effect / transition. (This functionality is not working in ver 0.9.10 of kdenlive - mantis 3338)

Note

The method described here is a re-purposing of the motion tracking data that the Auto Mask effect calculates. You do not need to follow the method described below to generate an Auto Mask that will obscure faces. The instructions in the above video should be enough. Nor can you use the method describe below to improve the tracking of the mask created by the Auto Mask effect.


To use this feature, first add the clip you want to analyse in timeline, and add the "Auto Mask" effect to it - Figure 1.

Figure 1.

Go to the first frame where your object is visible, and adjust the yellow rectangle so that is surrounds the object, like the hand in Figure 1.

Then click on the Analyse button in the effect options. This will start an analysis of the clip (you can follow its progress in the Project Tree view).

Figure 2.

When the job is finished, the motion tracking data is stored in the clip properties. To use this data, you can for example add a title clip over the clip you just analysed, like in the screenshot in Figure 2..

Figure 3.

Next step is to import the motion data in the transition. To do this, first select the clip you have analysed, then select the transition using the CTRL key so that both items are selected. Finally, go in the transitions's config menu and select Import keyframes from clip. You can now delete the "Auto Mask" effect from the clip in timeline and play the project to see your title clip following the object.

Figure 4.


Checking the Limit keyframes number checkbox In the "Import Keyframes" dialog (Figure 4) will cause Kdenlive to only import every nth frame (where n is the number selected in the combo box). This is a useful feature if you want to manually edit the keyframes that are imported because it allows you limit the number of key frames you will need to manually edit. If this check box is not checked then you import a key frame for every frame that is in the source clip.
Checking the Size checkbox in the "Import Keyframes" dialog (Figure 4) will cause Kdenlive to also import the size information from the keyframes data and this will mean that the transition will be adjusted to be the same size as the obscure rectangle.

Deleting Motion Tracking Data

The motion tracking data is saved with the clip properties. You can view this data and delete it from the clip properties dialog - Figure 5.


Figure 5.


Note

A defect preventing this effect from working has recently been fixed.


See defect 348975