mpfb_get_face_units
Read the live ARKit face unit values applied to a MakeHuman character's face in Blender, including optional zero values, without changing anything.
Instructions
Read the ARKit face units currently applied to a MakeHuman character's
face - the live !ex- shape key values mpfb_set_face_units writes.
Changes nothing.
result's face_units is one entry per face unit: face_unit (the bare ARKit
name, e.g. "jawOpen"), value, and shapekey_present - whether a
real shape key backs this value or MPFB is reporting a default for a
unit that has never been touched. Defaults to the non-zero units only;
include_zero (default false) returns all 52.
known_face_units is always present regardless of whether a
subject resolves: every legal name mpfb_set_face_units will accept,
grouped by facial region (brow, eye, cheek, jaw, mouth, nose, tongue)
the way MPFB's own composer panel lays out its sliders.
faceunits01_installed is always present too, and is the one
thing that separates "a neutral face" from "the faceunits01 asset pack
was never installed" - both read as every unit at 0.0, and MPFB
itself gives no other way to tell them apart. That check is cached for
the Blender session; refresh (default false) busts the cache, which
matters if the pack was installed after this Blender started.
A subject that cannot be resolved to a basemesh is an answer, found: false with a sentence, not an error; basemesh_name names the object
the answer was actually read from.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| refresh | No | ||
| include_zero | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||