Skip to content

Unified Expressions Release Candidate.

Latest
Compare
Choose a tag to compare
@regzo2 regzo2 released this 12 Feb 20:44
· 32 commits to Quest-Pro since this release

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.
  • Drastically expanded Unified expressions base standard.
  • 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.

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