rotation#

object

The rotation object defines how the actor’s head will be rotated about the neck, while the neck remains upright. When we generate your datapoint, the coordinates of the neck are set first using the location setting; afterwards, we rotate the head about the neck using pitch, yaw, and roll settings that you define here.

The pitch, yaw, and roll fields are floating-point values measured in degrees. Pitch can range from -90 to 90, while yaw and roll can range from -45 to 45.

Tip

Use this visualization tool to experiment with rotating the actor’s head in the scene. Note that the visualizer rotates the head and neck together; when you create your datapoints, the neck will be held still while the head is tilted around it in a realistic fashion.

The rotation object contains the following fields:

"rotation": {
  "pitch": //Tilts the head up and down. Positive values tilt the head up; negative values tilt the head down.
  "yaw": //Turns the head from side to side. Positive values turn the head to its left; negative values turn the head to its right.
  "roll": //Tilts the head from side to side. Positive values tilt the head counterclockwise (from the head's point of view) while negative values tilt the head clockwise.
},

Important

Rotations of the head are applied in a specific order: first pitch, then yaw, then roll.

Sample usage

Location in the data request

In the JSON hierarchy of the data request, the rotation object is found here:

{
  "datapoints": [
    {
      "human": {
        "head": {
          "rotation": {

          }
        }
      }
    }
  ]
}

A sample complete rotation object

"rotation": {
  "pitch": -10,
  "yaw": -15,
  "roll": 0,
},

These values will generate a head that is tilted slightly upward and to the right.