Makeup Prefabs
Basic concepts
Each makeup prefab represents a specific region of the face and has a
similar style of settings:
// ...
{
"color": "0.95 0.70 0.54",
"finish": "natural",
"coverage": "mid"
}
// ...
color - Solid color of the region in RGB string format.
finish - Type of the finish surface (e.g. natural, matte).
See available options for the specific region below.
coverage - Coverage intensity. Can be low, mid, high
or float number in the range [0.0, 1.0].
Makeup Base
"faces": [
{
"makeup_base": {
"mode": "quality",
"smooth": "0 1",
"smokey": 0
}
// ...
}
// ...
]
| Parameter | Description | Optional | Default Value |
|---|---|---|---|
| Can be 'speed' or 'quality' (to use heavy algorithms). |  |
|
| Smooths face skin. Contains 2 values of the smoothing strength for corresponding regions: | |
|
| Smokey eyes index. 0 disables smokey eyes; 1, 2, 3 or 4 selects different set of smokey eyes textures for the first two eyeshadow layers. | |
|
Eyebags
Usage
"faces": [
{
"makeup_eyebags": {
"alpha": 0.8
},
// ...
}
// ...
]
alpha (optional) - Transparency for eyes circles in the range from 0 to 1. Default value: 0.8.
Preview
Foundation
Usage
"faces": [
{
"makeup_foundation": {
"color": "0.95 0.70 0.54",
"finish": "natural",
"coverage": "mid"
},
// ...
}
// ...
]
finish - One of: natural, matte, radiance.
Preview
Concealer
Usage
"faces": [
{
"makeup_concealer": {
"color": "0.94 0.73 0.66",
"finish": "natural",
"coverage": "mid"
},
// ...
}
// ...
]
finish - One of: natural, matte.
Preview
Contour
Usage
"faces": [
{
"makeup_contour": {
"color": "1 0 0",
"finish": "normal",
"coverage": "mid"
},
// ...
}
// ...
]
finish - One of: normal.
Preview
Highlighter
Usage
"faces": [
{
"makeup_highlighter": {
"color": "0.9 0.80 0.83",
"finish": "shimmer",
"coverage": "mid"
},
// ...
}
// ...
]
finish - One of: shimmer.
Preview
Blush
Usage
"faces": [
{
"makeup_blush": {
"color": "0.88 0.65 0.75",
"finish": "shimmer",
"coverage": "mid"
},
// ...
}
// ...
]
finish - One of: shimmer, matte, cream_shine.
Preview
Lipstick
Usage
"faces": [
{
"makeup_lipstick": {
"color": "0.88 0.47 0.61",
"finish": "shimmer",
"coverage": "high"
},
// ...
}
// ...
]
finish - One of: shimmer, matte_dry, matte_cream, matte_powder, matte_liquid, cream_shine, glossy_cream_plumping, balm, balm_light, glossy_cream_shimmer, cream_vividcolors, matte_velvet, cream_shine_glitter, matte_velvet_sparkling, matte_sheer_lightcolors, matte_cream_vividcolors, metallic_cream, matte_velvet_sparkling_lightcolors, matte_light, metallic_shine, metallic_dry_lightcolors, satin, shine, cream, clear, cream_darkcolors, clear_shimmer, metallic_sheer.
Preview
Lipsliner
Usage
"faces": [
{
"makeup_lipsliner": {
"color": "0.99 0.0 0.0",
"finish": "shimmer",
"coverage": "high",
"liner": "3 5"
},
// ...
}
// ...
]
finish - One of: shimmer.
liner (optional) - Liner options contain 2 values: liner width and softness. Default value: 3 5.
Preview
Eyeshadow
Usage
"faces": [
{
"makeup_eyeshadow": [
{
"color": "0.21 0.42 0.32",
"finish": "matte",
"coverage": "high"
},
{
"color": "0.3 0.58 0.47",
"finish": "shimmer",
"coverage": "high"
},
{
"color": "1.00 0.91 0.27",
"finish": "metallic",
"coverage": "high"
}
],
// ...
}
// ...
]
Can be an object with one eyeshadow definition, or an array of the eyeshadows (max length 3) applied one after another.
finish - One of: shimmer, matte, matte_powder,
glitter_metallic, glitter, metallic, glitter_sheer, cream.
Preview
Eyelashes
Usage
"faces": [
{
"makeup_eyelashes": {
"color": "0 0 0",
"finish": "volume",
"coverage": "high"
},
// ...
}
// ...
]
finish - One of: volume, lengthening, lengthandvolume, natural, natural_bottom
Preview
Eyeliner
Usage
"faces": [
{
"makeup_eyeliner": {
"color": "0.0 0.0 0.0",
"finish": "matte_liquid",
"coverage": "high"
},
// ...
}
// ...
]
finish - One of: shimmer, cream, matte_liquid,
matte_cream, matte_dark, metallic, shimmer, glitter, cream_lightcolors.
Preview
Eyebrows
Usage
"faces": [
{
"makeup_eyebrows": {
"color": "0.39 0.26 0.27",
"finish": "matte",
"coverage": "mid"
},
// ...
}
// ...
]
finish - One of: matte, wet, clear.
Preview
Lipsshine
Usage
"faces": [
{
"makeup_lipsshine": {
"color": "1.0 0.0 0.0",
"finish": "glitter",
"coverage": "mid"
},
// ...
}
// ...
]
finish - One of: shine, glitter.
Preview
Lips Gloss
Usage
"faces": [
{
"makeup_lipsgloss": {
"threshold" : 0.96,
"contour" : 0.45,
"weakness" : 0.5,
"multiplier": 1.5,
"alpha": 0.8
},
// ...
}
// ...
]
| Parameter | Description | Optional | Default Value |
|---|---|---|---|
| Gloss threshold. Higher value - smaller blick. | |
|
| Blick contour softness. | |
|
| Blick mask weakness. Higher value - smaller blick. | |
|
| Blick mask multiplier. | |
|
| Blick mask visibility. | |
|
Preview
Lips Chameleon
Usage
"faces": [
{
"makeup_lipschameleon": {
"colors": [
{
"color": "#3342b0",
"finish": "metallic_cream",
"coverage": "high"
},
{
"color": "#a028b0",
"finish": "metallic_cream",
"coverage": "high"
}
],
"threshold" : 0.92,
"contour" : 0.3,
"weakness" : 0.25
}
// ...
}
// ...
]
| Parameter | Description | Optional | Default Value |
|---|---|---|---|
| Array of lipsticks parameters. Must contain 2 elements with color/finish/coverage fields. | + | + |
| Solid color of the region in RGB string format. | + | + |
| Type of the finish surface (shimmer, matte_dry, matte_cream, matte_powder, matte_liquid, cream_shine, glossy_cream_plumping, balm, balm_light, glossy_cream_shimmer, cream_vividcolors, matte_velvet, cream_shine_glitter, matte_velvet_sparkling, matte_sheer_lightcolors, matte_cream_vividcolors, metallic_cream, matte_velvet_sparkling_lightcolors, matte_light, metallic_shine, metallic_dry_lightcolors, satin, shine, cream, clear, cream_darkcolors, clear_shimmer, metallic_sheer). | + | + |
| Lipstick coverage intensity. | + | + |
| Chameleon mask threshold. Higher value - smaller mask. | |
|
| Chameleon mask contour softness | |
|
| Chameleon mask weakness. Higher value - smaller mask. | |
|
Preview
Eyelids Gloss
Usage
"faces": [
{
"makeup_eyelidsgloss": {
"threshold" : 0.95,
"contour" : 0.6,
"weakness" : 0.6,
"multiplier": 1.5,
"alpha": 1
}
// ...
}
// ...
]
| Parameter | Description | Optional | Default Value |
|---|---|---|---|
| Gloss threshold. Higher value - smaller blick. | |
|
| Blick contour softness. | |
|
| Blick mask weakness. Higher value - smaller blick. | |
|
| Blick mask multiplier. | |
|
| Blick mask visibility. | |
|
Preview
Eyelids Chameleon
Usage
"faces": [
{
"makeup_eyelids_chameleon": {
"colors": {
"bottom": [
{
"color": "#3342b0",
"finish": "shimmer",
"coverage": "high"
},
{
"color": "#3342b0",
"finish": "shimmer",
"coverage": "high"
},
{
"color": "#3342b0",
"finish": "shimmer",
"coverage": "high"
}
],
"upper": [
{
"color": "#a028b0",
"finish": "shimmer",
"coverage": "high"
},
{
"color": "#a028b0",
"finish": "shimmer",
"coverage": "high"
},
{
"color": "#a028b0",
"finish": "shimmer",
"coverage": "high"
}
]
},
"threshold" : 0.92,
"contour" : 0.3,
"weakness" : 0.25
}
// ...
}
// ...
]
| Parameter | Description | Optional | Default Value |
|---|---|---|---|
| Container of bottom and upper colors. | + | + |
| Array of bottom colors. May contain up to 3 elements with color/finish/coverage data. | + | + |
| Array of upper colors. May contain up to 3 elements with color/finish/coverage data. | + | + |
| Solid color of the region in RGB string format. | + | + |
| Type of the finish surface (shimmer, matte, matte_powder, glitter_metallic, glitter, metallic, glitter_sheer, cream). | + | + |
| Coverage intensity. | + | + |
| Chameleon mask threshold. Higher value - smaller mask. | |
|
| Chameleon mask contour softness | |
|
| Chameleon mask weakness. Higher value - smaller mask. | |
|
Preview
Lips Glitter
Usage
"faces": [
{
"makeup_lips_glitter": {
"color" : "0.7 0.3 0.7",
"alpha": 0.75
}
// ...
}
// ...
]
| Parameter | Description | Optional | Default Value |
|---|---|---|---|
| Glitter color in RGB format. | |
|
| Glitter effect visibility. | |
|
Preview
Eyelids Glitter
Usage
"faces": [
{
"makeup_eyelids_glitter": {
"color" : "1.0 0.0 0.5",
"alpha": 0.75
}
// ...
}
// ...
]
| Parameter | Description | Optional | Default Value |
|---|---|---|---|
| Glitter color in RGB format. | |
|
| Glitter effect visibility. | |
|
Preview
All Features
Lets combine all features together:
Example
{
"faces": [
{
"makeup_base": {
"smooth": "0 1",
"mode": "quality"
},
"makeup_eyebags": {
"alpha": 0.8
},
"makeup_foundation": {
"color": "0.95 0.70 0.54",
"finish": "natural",
"coverage": "mid"
},
"makeup_concealer": {
"color": "0.94 0.73 0.66",
"finish": "natural",
"coverage": 1
},
"makeup_contour": {
"color": "1 0 0",
"finish": "normal",
"coverage": "mid"
},
"makeup_highlighter": {
"color": "0.9 0.80 0.83",
"finish": "shimmer",
"coverage": "mid"
},
"makeup_blush": {
"color": "0.88 0.65 0.75",
"finish": "shimmer",
"coverage": "mid"
},
"makeup_lipstick": {
"color": "0.88 0.47 0.61",
"finish": "shimmer",
"coverage": "high"
},
"makeup_lipsliner": {
"color": "0.99 0.0 0.0",
"finish": "shimmer",
"coverage": "high",
"liner": "3 5"
},
"makeup_eyeshadow": [
{
"color": "0.21 0.42 0.32",
"finish": "matte",
"coverage": "high"
},
{
"color": "0.3 0.58 0.47",
"finish": "shimmer",
"coverage": "high"
},
{
"color": "1.00 0.91 0.27",
"finish": "metallic",
"coverage": "high"
}
],
"makeup_eyeliner": {
"color": "0.0 0.0 0.0",
"finish": "matte_liquid",
"coverage": "high"
},
"makeup_eyebrows": {
"color": "0.39 0.26 0.27",
"finish": "matte",
"coverage": "mid"
},
"makeup_lipsshine": {
"color": "1.0 0.0 0.0",
"finish": "glitter",
"coverage": "mid"
},
"makeup_eyelashes": {
"color": "1 0 0",
"finish": "volume",
"coverage": "high"
},
"makeup_lipsgloss": {
"threshold" : 0.96,
"contour" : 0.45,
"weakness" : 0.5,
"multiplier": 1.5,
"alpha": 0.8
},
"makeup_eyelidsgloss": {
"threshold" : 0.95,
"contour" : 0.6,
"weakness" : 0.6,
"multiplier": 1.5,
"alpha": 1
}
}
],
"scene": "test_makeup",
"version": "2.0.0"
}
Preview
