I am going to try and write up a document for each of the options and what they do and how and when you would/should use them

[TrickleDownClown]

Can someone explain what the "Max Face Similarity Threshold" option does? A definition or example and higher value vs. lower value. When I tried lower I ended up with no swapping at all. Higher value seems to leave less flickering.

I am unsure why without knowing what it does and how it should be used.

Thanks

[lysxelapsed]

C0untFloyd answered this, and another question regarding det-size you could use for the doc (thx!) here #100

In short: If set to 0.0, the face needs to be exactly the same as the selected to enable the swap for that frame. Higher values will swap more frames, but maybe in undesired angles or even wrong faces. My default setting is around 0.75 and am getting good results for my taste.

[TrickleDownClown]

Ah awesome. Thanks, I'll start compiling. I also found 75 works pretty well

[beanzie]

I think the use of this setting is also dependent on the face selection method, i.e using "First found" bypasses the comparison of faces and just executes the swap for any face. If multiple faces are found in the frame it swaps the leftmost one.

[C0untFloyd]

@TrickleDownClown What's the holdup on the document 😜