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.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "mpfb_get_face_units"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | ||
| refresh | No | ||
| include_zero | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||