head
#
object
The head
object is responsible for constructing the head of the human actor in your scene. These fields define every aspect of what goes into generating a virtual head: the hair color, direction of gaze, facial expression, and so on.
The head
object contains the following fields:
"head": { "eyes": { //Settings that define eye texture, closure, and direction of gaze } "hair": { //Settings that define hair style and color } "facial_hair": { //Settings that define facial hair style and color } "eyebrows": { //Settings that define eyebrow style and color } "expression": { //The expression on the actor's face: type and intensity } "location": { //The position of the actor's head in the scene, using global coordinates } "rotation": { // The rotation of the head about the neck } }
Sample usage
Location in the data request
In the JSON hierarchy of the data request, the head
object is found here:
{ "datapoints": [ { "human": { "head": { } } } ] }
A sample complete head object
"head": { "eyes": { "id": "73ddd6f7-4866-4cf5-9681-2ce1922247de", "target_of_gaze": { "direction": { "z": 0.0, "y": -1.0, "x": 0.0 }, "distance": 15.0 }, "eyelid_closure": 0.5 }, "facial_hair": { "id": "082671c1-7bce-4942-a5f7-75a7de3d2367", "color_settings": { "melanin": 0.9, "redness": 0.2, "whiteness": 0.1, "roughness": 0.2, "index_of_refraction": 1.4 } }, "hair": { "id": "83a89fae-6f42-4c80-a86b-dff0ef14e969", "color_settings": { "melanin": 0.9, "redness": 0.2, "whiteness": 0.1, "roughness": 0.2, "index_of_refraction": 1.4 } }, "eyebrows": { "id": "77fa29bd-75c7-43f2-8f5a-522b7918beee", "color_settings": { "melanin": 0.9, "redness": 0.2, "whiteness": 0.1, "roughness": 0.2, "index_of_refraction": 1.4 } }, "location": { "x": 0.0, "y": -0.38, "z": 0.1 }, "rotation": { "yaw": 15, "roll": 0, "pitch": 10 }, "expression": { "name": "anger", "intensity": 0.3 } } The values above will generate a human head tilted slightly down and to the left, with half-closed brown eyes, black hair with the slightest tinge of red, a buzz-cut and partial beard with black, and wearing a mildly angry expression.