eyebrows#

object

The eyebrows object is responsible for setting the style, color, and other attributes of the actor’s eyebrows.

This object is optional; if you do not want your actor to have eyebrows, simply leave it out or set it equal to null.

Note

If the eyebrows object is included, all of its child objects must be included as well.

The eyebrows object contains the following fields:

"eyebrows": {
  "id": //A UUID that defines the actor's eyebrow style
  "color_settings": {
    "melanin": //The amount of black color in the eyebrow hairs
    "redness": //The amount of red color in the eyebrow hairs
    "whiteness": //How much the eyebrow hairs have gone grey or, at higher values, white
    "roughness": //How diffuse light as it reflects off of the hairs, which defines how shiny or dull the hair is
    "index_of_refraction": //How much light rays change direction as they travel through the hairs
  }
},

Sample usage

Location in the data request

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

{
  "datapoints": [
    {
      "human": {
        "head": {
          "eyebrows": {

          },
        }
      },
    }
  ]
}

A sample complete eyebrows object

"eyebrows": {
  "id": "9411c79a-11b8-47e9-b1af-f3af34acc400",
  "color_settings": {
    "melanin": 0.5,
    "redness": 0.6,
    "whiteness": 0.0,
    "roughness": 0.2,
    "index_of_refraction": 1.4
  }
},

The above values will create a typical pair of male eyebrows with light brown hair.


id#

string

The id field selects a specific pair of eyebrows from our catalog of eyebrow styles.

The unique identifier (UUID) that you enter into this field defines the shape of the eyebrows but not their color or behavior in the light.

Tip

To download a CSV with a complete list of available eyebrow styles, click here

Datagen has dozens of eyebrow textures, labeled by gender:

Female

To download a CSV with a complete list of female eyebrow styles, click here

Male

To download a CSV with a complete list of male eyebrow styles, click here

Sample usage

A sample id field and its location in the data request

In the JSON hierarchy of the data request, the id field is found here:

{
  "datapoints": [
    {
      "human": {
        "head": {
          "eyebrows": {
            "id": "829b0d6e-102a-4bad-8c87-22a0148ed72c",
          },
        }
      }
    }
  ]
}

This value will generate a pair of male eyebrows.


color_settings#

object

The color_settings object contains a variety of controls that you can use to adjust the color and shine of the actor’s eyebrows.

The color_settings object contains the following fields:

"color_settings": {
  "melanin": //The amount of melanin in the eyebrows, which defines how dark they are
  "redness": //The ratio between pheomelanin and eumelanin, which defines how red the eyebrows are
  "whiteness": //How much the eyebrows have gone grey or white
  "roughness": //How diffuse light as it reflects off of the hairs, which defines how shiny or dull the hair is
  "index_of_refraction": //How much light rays change direction as they travel through the hairs
},

Sample usage

Location in the data request

In the JSON hierarchy of the data request, the color_settings field is found here:

{
  "datapoints": [
    {
      "human": {
        "id": "101a0478-03e7-4e93-a33d-9bc22f6fdb4b",
        "head": {
          "eyebrows": {
            "color_settings": {

            }
          }
        }
      }
    }
  ]
}

A sample complete color_settings object

"color_settings": {
  "melanin": 0.5,
  "redness": 1,
  "whiteness": 0.9,
  "roughness": 0.2,
  "index_of_refraction": 1.4
}

These values will generate a pair of eyebrows that used to be red before they turned nearly all white.


melanin and redness#

64-bit floats

The melanin and redness values together define the color of the actor’s eyebrows. Melanin is the amount of black color in the hairs; redness is the amount of red. Both fields can accept floating-point values between 0 and 1:

../../_images/eyebrow_grid.png

As you can see in the images above, the relationship between melanin and redness is not linear. The two influence each other greatly. At very high and very low concentrations of melanin, changing the redness has little or no effect. When melanin has medium-level values, the effects of redness are more noticeable.

The values for typical hair colors are:

Blonde: melanin=0.2, redness=0

Red: melanin=0.5, redness=1

Black: melanin=1, redness=0

Dark brown: melanin=0.8, redness=0.2

Light brown: melanin=0.5, redness=0.6

Sample usage

Sample melanin and redness fields and their location in the data request

In the JSON hierarchy of the data request, the melanin and redness fields are found here:

{
  "datapoints": [
    {
      "human": {
        "head": {
          "eyebrows": {
            "color_settings": {
              "melanin": 0.8,
              "redness": 0.2,
            }
          }
        }
      }
    }
  ]
}

These values will generate a pair of light brown eyebrows.


whiteness#

64-bit float

The whiteness field defines how much of the hair has begun to go grey or white. This field accepts floating-point values from 0 (no white hairs) to 1 (fully white).

../../_images/eyebrows_Whiteness_0.png

"whiteness"=0#

../../_images/eyebrows_Whiteness_0.25.png

"whiteness"=0.25#

../../_images/eyebrows_Whiteness_0.5.png

"whiteness"=0.5#

../../_images/eyebrows_Whiteness_0.75.png

"whiteness"=0.75#

../../_images/eyebrows_Whiteness_1.png

"whiteness"=1#

While the increase in grey and white hairs using this field is not strictly linear, it is still useful to think of this value as whitening the hair roughly in percentage terms. As a rule, values between 0.4 and 0.7 generate greying eyebrows, while values above 0.7 generate white eyebrows.

Sample usage

A sample whiteness field and its location in the data request

In the JSON hierarchy of the data request, the whiteness field is found here:

{
  "datapoints": [
    {
      "human": {
        "head": {
          "eyebrows": {
            "color_settings": {
              "whiteness": 0.3,
            }
          }
        }
      }
    }
  ]
}

This value will generate eyebrows that have just barely begun to go grey.


roughness#

64-bit float

The roughness field affects the reflectivity of the hair. The rougher the surface of the hair, the more light gets absorbed within it and gets reflected as diffuse light rather than mirror-like reflections.

This field accepts floating-point values from 0.15 to 0.5.

../../_images/Eyebrows_Roughness_0.15.png

roughness=0.15#

../../_images/Eyebrows_Roughness_0.225.png

roughness=0.225#

../../_images/Eyebrows_Roughness_0.5.png

roughness=0.5#

Sample usage

A sample roughness field and its location in the data request

In the JSON hierarchy of the data request, the roughness field is found here:

{
  "datapoints": [
    {
      "human": {
        "head": {
          "eyebrows": {
            "color_settings": {
              "roughness": 0.4,
            }
          }
        }
      }
    }
  ]
}

This value will generate eyebrows that have very little shine to them.


index_of_refraction#

64-bit float

The index_of_refraction field affects how the hair bends light that is traveling through it. All hair is at least somewhat translucent, lighter hair in particular. Simulating the changes in the direction of light rays as they travel through the hair is an important part of making hair look realistic.

This field accepts floating-point values from 1.4 to 1.65.

../../_images/Eyebrows_IOR_1.4.png

index_of_refraction=1.4#

../../_images/Eyebrows_IOR_1.525.png

index_of_refraction=1.525#

../../_images/Eyebrows_IOR_1.65.png

index_of_refraction=1.65#

Although the hair in the above images may appear to be of slightly different colors, they all have the same amount of melanin; the only change is in how light reflects inside and through the individual hairs.

Sample usage

A sample index_of_refraction field and its location in the data request

In the JSON hierarchy of the data request, the index_of_refraction field is found here:

{
  "datapoints": [
    {
      "human": {
        "head": {
          "eyebrows": {
            "color_settings": {
              "index_of_refraction": 1.6,
            }
          }
        }
      }
    }
  ]
}

This value will generate hair with a high index of refraction.