PLEASE USE VRCFT v5.0.0: https://github.com/benaclejames/VRCFaceTracking/releases
Several fixes and expansions upon the last release build of VRCFaceTracking Unified Expressions. These changes also are very close to finalization of this PR and there are expected to be very few reworks/fixes at this state.
NOTE: Modules built for VRCFT 4.0.0 (UI) are not compatible with this build, and will need to be adapted to work within the new Unified architecture. Test modules for common interfaces such as the Quest Pro and SRanipal are included; Existing modules will be adapted to Unified Expressions soon.
Additions
- Exposed v2 (Unified) base and combined parameters to output.
- Accessed via
v2/...
for base Unified parameters, Simple parameters, and merged parameters.
- Accessed via
- Drastically expanded Unified expressions base standard.
- The main intention was to link the base parameters closer to underlying facial anatomy. Many parameters are still abstractions of more complex muscle groups such as the Lip parameters. Included comments linking to different anatomies.
- Unified Expressions
- Unified Simple Conversions
- Unified Combined
- Added Unified Simple expressions to represent common conversions of more general expressions from the base Unified set of parameters.
- Includes a mapper to retain consistent convergence of parameters.
- Simplified Calibration usage on window
- This is just intended to test out the capabilities of the calibration within VRCFaceTracking. A fuller implementation of the calibrator will be implemented with a potential UI update (including individual parameter calibration, smoothing, etc. mutations).
- Calibrator can be disabled with a toggle.
Improvements
- Drastically improved Unified to SRanipal conversion
- Fixed common conversions from more robust tracking interfaces, fixed EyeLidExpandedSqueeze behavior.
- Improved Quest Pro tracking
- Eyelids should be better tracked, fixes for Sneer overdriving the MouthUpperUp type parameters.
- Adjusted EyeTrackingActive and LipTrackingActive parameters
- OSC receiver now parses these parameters and properly toggles VRCFT module states.
- Fixed an oversight that sent these parameters even when modules were not initialized (Allows outside VRCFT apps to freely work around).
- More robust parameter parsing
- Parameters can now be loaded with any level of directory eg.
.../JawOpen
or.../v2/JawOpen
- Also applies to Binary parameters.
- Parameters can now be loaded with any level of directory eg.
Install / Usage
Included below are the executable for VRCFaceTracking and in-dev Modules for testing with! Includes the ALVR/headless Module, Quest OpenXR module, MeowFace module, and SRanipal module.
Run VRCFaceTracking executable from anywhere. Include desired modules in %appdata%\VRCFaceTracking\CustomLibs
.
NOTE: Make sure to Unblock all dll's in CustomLibs! Right click each .dll
, go to Properties, and check the Unblock
checkbox and apply.
NOTE: SRanipal and QuestOpenXR modules have dependencies within the ModuleLibs subfolder in CustomLibs. Please make sure they are included and are unblocked as well!
NOTE: SRanipal module requires the latest runtime (Runtime 1.3.6.X+ included with Vive Console on Steam) in order to work and supports the Focus 3's face and eye tracking.
Full Changelog: v5.0.0-pre...v5.0.0-pre-2