Face tracking shape detection failures

[gentlecolts]

Describe the bug?

I am basing my standard of "correct" off of the guide that was being distributed that used that one robot avatar with the blue face. As this guide is the only reference, including from any official sources, it is my only source of truth, and if that guide is inaccurate, an update would be appreciated.

With that said, the following shape names fail to be detected:

• ft.EyeLeftWide
• ft.EyeRightWide
• ft.LipUnderlayUpper
• ft.LipUnderlayOver

additionally, these also fail to be detected, but worth noting is that my eye mesh(es) are separated from the main body

• ft.PupilGrowLeft
• ft.PupilGrowRight
• ft.PupilNarrowLeft
• ft.PupilNarrowRight

The following shapes are picked up by the system, but are either misscategorized or shouldn't be picked up:

• ft.LipRaiseUpperLeft becomes LipMoveLeftUpper (while ft.LipMoveLeftUpper is correctly identified as LipMoveLeftUpper)
• ft.LipRaiseUpperRight becomes LipMoveRightUpper (while ft.LipMoveRightUpper is correctly identified as LipMoveRightUpper)
• ft.LipRaiseLowerLeft becomes LipMoveLeftLower (while ft.LipMoveLeftLower is correctly identified as LipMoveLeftLower)
• ft.LipRaiseLowerRight becomes LipMoveRightLower (while ft.LipMoveRightLower is correctly identified as LipMoveRightLower)
• ft.AngryLeft and ft.AngryRight being detected as just Angry, no left/right seemingly available. Additionally, I have a shape called lip angry which was used to produce the left/right face tracking angry, which is also picked up as Angry (I believe this to be correct), and additionally a gesture.angry which is meant to be a gesture version (affecting more of the face), that in a perfect world wouldn't be picked up for face tracking (idk if there's a good automatic solution here).
• SMILE (or, as Assimp currently imports it, SMILE.SMILE), is being picked up as SmileLeft
• FROWN (or, as Assimp currently imports it, FROWN.FROWN), is being picked up as FrownRight

To Reproduce

Import mesh(es) with above noted shape key names, setup face tracking during avatar setup

Expected behavior

noted above

Screenshots

No response

Resonite Version Number

Beta 2023.12.21.1127

What Platforms does this occur on?

Windows, Linux

What headset if any do you use?

No response

Log Files

n/a

Additional Context

No response

Reporters

zangooseoo

[gentlecolts]

It also is worth noting some of my own conventions:

• I tend to make symmetric blend shapes when possible (ex SMILE), and then use them to generate left/right versions for face tracking. I understand the value of having face tracking parameters for non-sided gestures as some avatars may lack the proper left/right shapes, however it may be useful to ignore the symmetric version of a shape when both the left and right version is detected
• I prepend all of my face tracking shapes with "ft.", and I know I'm not the only one that does this. It may be useful to adopt this convention as a means of hinting in the heuristics

[gentlecolts]

Additional ones I missed in the eye manager, I have the following blink-related shapes:

• Blink Upper and Blink Lower which I then combine to make Blink (which the game reads as Blink Lower.Blink Lower, Blink Upper.Blink Upper, and Blink.Blink currently), and other expressions/gestures
• ft.BlinkLeft and ft.BlinkRight which are the left and right blink shapes respectively

the eye manager appears to have detected Blink Lower.Blink Lower as the left eye "OpenCloseTarget", and Blink.Blink as the right eye "OpenCloseTarget", instead of the left/right blink shapes

[shiftyscales]

Can you please provide a sample avatar file which demonstrates this issue? Heuristic issues like this are a lot easier to figure out if there is a sample avatar/asset provided to test changes with.