NOTICE: This is obsolete since version 0.7.0. You should calibrate your face dimensions (only width) via the GUI in the Config window.

---

Customize 3D Head model

Update 0.6.5 introduces a new preview of a change which allows users to, hopefully, reduce glitching.

As it's on early stage, this setting is only accesible via editing prefs.ini file. On this version, you will not find any GUI to customize them.

What's the idea?

Internally, AITrack estimates the head rotation by scaling and rotating a 3D model of a human head. Obviously, not all heads are similar to this 3D model (some are longer, wider, narrower...) and, if your head is too different from the base 3D model, the software will struggle finding a good solution. This could be (one of) the cause(s) for the glitching for some users.

As for the moment (v0.6.5), a test of the possible solution will be available via the above mentioned prefs.ini. Depending on user's feedback, this feature will be ditched or further developed by including a more user-friendly configuration GUI.

How to configure it

You must find the lines with the settings:

...
head_3d_scale_x=1
head_3d_scale_y=1
head_3d_scale_z=1
...

Their default values are 1 for all of them. So, if you mess something up while editing them, set them back to 1 and its behaviour will be the same as the previous versions.

Each one of the settings will scale the internal 3D head model so it matches better with your head (this is shown on the next image):

You should tune the values by try and failure until (hopefully), the glitching goes away.

For example, if your face is wider, you should increase head_3d_scale_x to 1.something and leave the other parameters as default. Conversely, if your face is narrower, you could increase head_3d_scale_y or decrease head_3d_scale_x.

Note: Increase the values by a small amount. People, generally, doesn't tend to deviate much from the standard 3D model.