expression#
object
The expression object defines the type and the intensity of your actor’s facial expression. The expression type is defined using a string, while the intensity is a float that ranges from 0 (neutral expression) to 1 (maximum intensity).
Surprise (intensity 1)# |
Disgust (intensity 0.75)# |
Happiness (intensity 0.75)# |
Anger (intensity 1)# |
Neutral expression# |
Fear (intensity 0.75)# |
Mouth open (intensity 0.25)# |
Sadness (intensity 0.5)# |
Contempt (intensity 0.25)# |
The expression object contains the following fields:
"expression": { "name": //The type of expression, such as happiness or disgust. "intensity": //The intensity of the expression, from 0 to 1. }
Sample usage
Location in the data request
In the JSON hierarchy of the data request, the
expressionfield is found here:{ "datapoints": [ { "human": { "expression": { } } } ] }
A sample complete expression object
"expression": { "name": "contempt", "intensity": 0.5 }These values will generate a facial expression that looks like this:
name#
string
The name field defines the type of expression that your actor will be wearing on their face.
|
|
|
|
|
|
|
|
|
|
Sample usage
A sample name field and its location in the data request
In the JSON hierarchy of the data request, the name field is found here:
{
"datapoints": [
{
"human": {
"expression": {
"name": "happiness",
}
}
}
]
}
This value will generate an actor with a happy expression:
intensity#
Float
The intensity field defines the intensity of the actor’s facial expression from 0 (neutral expression) to 1 (full intensity). The intensity will be applied to the facial expression (happiness, surprise, etc.) that you defined in the name field above.
Here are examples of how the facial expression scales up as it moves from 0 to 1:
Note
In all cases, an expression of intensity 0 is indistinguishable from a neutral expression; we recommend you use a minimum intensity of 0.1.
Contempt
Happiness
Mouth open
None
Note
The intensity field is ignored when the actor’s expression is defined as “none”.
Surprise
Sample usage
A sample intensity field and its location in the data request
In the JSON hierarchy of the data request, the intensity field is found here:
{
"datapoints": [
{
"human": {
"expression": {
"intensity": 5,
}
}
}
]
}
This value will generate an actor with a very intense expression - in this case, disgust:
