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": { } } } } ] }