human

The human object is responsible for constructing the human actor at the (metaphorical) center of your scene. These fields define every aspect of what goes into generating a virtual person: the base identity, hair color, the expression on their face, and so on.

The human object contains the following fields. You can click on a field to learn more about it:

"human": {
  "id": //A UUID that defines the identity of the actor in the scene.
  "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 face 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 human object is found here:

{
  "datapoints": [
    {
      "human": {

      }
    }
  ]
}

A sample complete human object

"human": {
  "id": "1a9113f7-07d0-45ef-a5bb-e27df951c02f",
  "head": {
    "eyes": {
      "id": "ebdd956c-b763-490e-9afb-baed2c98a0ff",
      "target_of_gaze": {
        "direction": {
          "x": 0.0,
          "y": -1.0,
          "z": 0.0
        },
        "distance": 15.0
      },
      "eyelid_closure": 0.0
    },
    "hair": {
      "id": "003cbe9f-3d2a-409c-bcfe-bfa085694199",
      "color_settings": {
        "melanin": 1,
        "redness": 0,
        "whiteness": 0,
        "roughness": 0.2,
        "index_of_refraction": 1.4
      }
    },
    "eyebrows": {
      "id": "829b0d6e-102a-4bad-8c87-22a0148ed72c",
      "color_settings": {
        "melanin": 1,
        "redness": 0,
        "whiteness": 0,
        "roughness": 0.2,
        "index_of_refraction": 1.4
      }
    },
    "location": {
      "x": 0.0,
      "y": 0.0,
      "z": 0.0
    },
    "rotation": {
      "yaw": 10,
      "pitch": 10,
      "roll": 10
    },
    "expression": {
     "name": "surprise",
     "intensity": 0.9
    }
  }
},

The values above will generate a datapoint showing a young hispanic male with brown eyes, kinky black hair in a crew cut style, the head tilted slightly to the right and downward, wearing a very surprised expression.