api.assets.Head#

class datagen.api.assets.Head(*, eyes: Eyes, hair: Optional[Hair] = None, eyebrows: Optional[Hair] = None, facial_hair: Optional[Hair] = None, location: Point = None, rotation: Rotation = None, expression: Expression = None)#

Aspects of a 3D human asset that define the appearance and positioning of the head.

expression: Expression#

Defines the type and intensity of the human’s facial expression.

eyebrows: Optional[Hair]#

The eyebrows worn by this actor, including the 3D eyebrows asset and all related parameters such as color controls.

eyes: Eyes#

The pair of eyes worn by this actor, including the 3D eyes asset and all related parameters such as eye textures, direction of gaze, and eyelid closure.

facial_hair: Optional[Hair]#

The facial hair worn by this actor, including the 3D facial hair asset and all related parameters such as color controls.

hair: Optional[Hair]#

The hair worn by this actor, including the 3D hair asset and all related parameters such as color controls.

location: Point#

Defines the location of the actor in global coordinates, using a single reference point. Units are measured in meters.

Since an actor is not a point-sized object, these coordinates actually define the position of a point at the front of the actor’s neck: the small pocket at the center of the V. (This pocket is known in medicine as the “suprasternal notch”.)

The rest of the 3D actor is built around that point.

rotation: Rotation#

Defines the rotation of the human head about the neck, using three rotation controls measured in degrees.

The neck remains for the most part fixed and facing in the -y direction, with slight changes based on the intensity of the rotation.