Makeup Prefabs

Basic Concepts

Each makeup prefab represents a specific region of the face and uses a similar set of settings:

// ...
    {
        "color": "0.95 0.70 0.54",
        "finish": "natural",
        "coverage": "mid"
    }
// ...

color - A required solid color for the region in RGB string format.

finish - A required finish preset (for example, natural or matte). See available options for the specific region below.

coverage - A required coverage intensity. It can be low, mid, high, or a number in [0.0, 1.0]. The string shorthands l/lo, m/mi, and h/hi/hig are also accepted. makeup_eyelashes supports only the mid and high presets (or a numeric value).

Generally, makeup doesn't work with multiple faces, but some makeup effects may support 2 and more faces. Check out the description.

Makeup Base

"faces": [
    {
        "makeup_base": {
            "mode": "quality",
            "smooth": "0 1",
            "smokey": 0
        }
        // ...
    }
    // ...
]

Parameter	Description	Default Value
`mode`	Processing mode. Allowed values are `speed` and `quality`; `quality` uses more computationally intensive algorithms. 'quality' mode is not available with multiple faces makeup config.	`"speed"`
`smooth`	Smooths facial skin. The value contains two strengths in the range `[0, 1]`: `whole face` and `under eyes`.	`"0 1"`
`smokey`	Smoky-eye index. A value of `0` disables the smoky-eye effect; `1`, `2`, `3`, or `4` selects a different set of smoky-eye textures for the first two eyeshadow layers.	`0`

note

To enable multifaces feature for makeup_base, create another array in faces list and add makeup_base config to it. Parameters for faces with indexes 1,2... must correspond to the parameters for the face with index 0.

"faces": [
    {
        "makeup_base": {
            "mode": "speed",
            "smooth": "0 1",
            "smokey": 0
        }
        // ...
    },
    {
        "makeup_base": {
            "mode": "speed",
            "smooth": "0 1",
            "smokey": 0
        }
        // ...
    }
    // ...
]

Eye Bags

Usage

"faces": [
    {
        "makeup_eyebags": {
            "alpha": 0.8
        },
        // ...
    }
    // ...
]

alpha (optional) - The opacity of under-eye circles, in the range [0, 1]. The default value is 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.

note

To enable multifaces feature for makeup_concealer, create another array in faces list and add makeup_concealer config to it. Parameters for faces with indexes 1,2... must correspond to the parameters for the face with index 0.

"faces": [
    {
        "makeup_concealer": {
            "color": "0.94 0.73 0.66",
            "finish": "natural",
            "coverage": "mid"
        },
        // ...
    },
    {
        "makeup_concealer": {
            "color": "0.94 0.73 0.66",
            "finish": "natural",
            "coverage": "mid"
        },
        // ...
    }
    // ...
]

Preview

Contour

Usage

"faces": [
    {
        "makeup_contour": {
            "color": "1 0 0",
            "finish": "normal",
            "coverage": "mid"
        },
        // ...
    }
    // ...
]

finish - One of: normal.

note

To enable multifaces feature for makeup_contour, create another array in faces list and add makeup_contour config to it. Parameters for faces with indexes 1,2... must correspond to the parameters for the face with index 0.

"faces": [
    {
        "makeup_contour": {
            "color": "1 0 0",
            "finish": "normal",
            "coverage": "mid"
        },
        // ...
    },
    {
        "makeup_contour": {
            "color": "1 0 0",
            "finish": "normal",
            "coverage": "mid"
        },
        // ...
    }
    // ...
]

Preview

Highlighter

Usage

"faces": [
    {
        "makeup_highlighter": {
            "color": "0.9 0.80 0.83",
            "finish": "shimmer",
            "coverage": "mid"
        },
        // ...
    }
    // ...
]

finish - One of: shimmer.

note

To enable multifaces feature for makeup_highlighter, create another array in faces list and add makeup_highlighter config to it. Parameters for faces with indexes 1,2... must correspond to the parameters for the face with index 0.

"faces": [
    {
        "makeup_highlighter": {
            "color": "0.9 0.80 0.83",
            "finish": "shimmer",
            "coverage": "mid"
        },
        // ...
    },
    {
        "makeup_highlighter": {
            "color": "0.9 0.80 0.83",
            "finish": "shimmer",
            "coverage": "mid"
        },
        // ...
    }
    // ...
]

Preview

Blush

Usage

"faces": [
    {
        "makeup_blush": {
            "color": "0.88 0.65 0.75",
            "finish": "shimmer",
            "coverage": "mid"
        },
        // ...
    }
    // ...
]

finish - One of: shimmer, matte, cream_shine.

note

To enable multifaces feature for makeup_blush, create another array in faces list and add makeup_blush config to it. Parameters for faces with indexes 1,2... must correspond to the parameters for the face with index 0.

"faces": [
    {
        "makeup_blush": {
            "color": "0.88 0.65 0.75",
            "finish": "shimmer",
            "coverage": "mid"
        },
        // ...
    },
    {
        "makeup_blush": {
            "color": "0.88 0.65 0.75",
            "finish": "shimmer",
            "coverage": "mid"
        },
        // ...
    }
    // ...
]

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

Lip Liner

Usage

"faces": [
    {
        "makeup_lipsliner": {
            "color": "0.99 0.0 0.0",
            "finish": "shimmer",
            "coverage": "high",
            "liner": "3 5"
        },
        // ...
    }
    // ...
]

finish - One of: shimmer.

liner (optional) - Contains two values: liner width and softness. The default value is 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"
            }
        ],
        // ...
    }
    // ...
]

The value can be an object containing one eyeshadow definition or an array of up to three eyeshadow definitions applied in sequence.

finish - One of: shimmer, matte, matte_powder, glitter_metallic, glitter, metallic, glitter_sheer, cream.

note

To enable multifaces feature for makeup_eyeshadow, create another array in faces list and add makeup_eyeshadow config to it. Parameters for faces with indexes 1,2... must correspond to the parameters for the face with index 0.

"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"
            }
        ],
        // ...
    },
    {
        "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"
            }
        ],
        // ...
    }
    // ...
]

Preview

Eyelashes

Usage

"faces": [
    {
        "makeup_eyelashes": {
            "color": "0 0 0",
            "finish": "volume",
            "coverage": "high"
        },
        // ...
    }
    // ...
]

finish - One of: volume, lengthening, lengthandvolume, natural, natural_bottom.

note

To enable multifaces feature for makeup_eyelashes, create another array in faces list and add makeup_eyelashes config to it. Parameters for faces with indexes 1,2... must correspond to the parameters for the face with index 0.

"faces": [
    {
        "makeup_eyelashes": {
            "color": "0 0 0",
            "finish": "volume",
            "coverage": "high"
        },
        // ...
    },
    {
        "makeup_eyelashes": {
            "color": "0 0 0",
            "finish": "volume",
            "coverage": "high"
        },
        // ...
    }
    // ...
]

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, glitter, cream_lightcolors.

note

To enable multifaces feature for makeup_eyeliner, create another array in faces list and add makeup_eyeliner config to it. Parameters for faces with indexes 1,2... must correspond to the parameters for the face with index 0.

"faces": [
    {
        "makeup_eyeliner": {
            "color": "0.0 0.0 0.0",
            "finish": "matte_liquid",
            "coverage": "high"
        },
        // ...
    },
    {
        "makeup_eyeliner": {
            "color": "0.0 0.0 0.0",
            "finish": "matte_liquid",
            "coverage": "high"
        },
        // ...
    }
    // ...
]

Preview

Eyebrows

Usage

"faces": [
    {
        "makeup_eyebrows": {
            "color": "0.39 0.26 0.27",
            "finish": "matte",
            "coverage": "mid"
        },
        // ...
    }
    // ...
]

finish - One of: matte, wet, clear.

Preview

Lip Shine

Usage

"faces": [
    {
        "makeup_lipsshine": {
            "color": "1.0 0.0 0.0",
            "finish": "glitter",
            "coverage": "mid"
        },
        // ...
    }
    // ...
]

finish - One of: shine, glitter.

Preview

Lip Gloss

Usage

"faces": [
    {
        "makeup_lipsgloss": {
            "threshold": 0.96,
            "contour": 0.45,
            "weakness": 0.5,
            "multiplier": 1.5,
            "saturation": 0.1,
            "alpha": 0.8
        },
        // ...
    }
    // ...
]

Parameter	Description	Default Value
`threshold`	Gloss threshold. Higher values produce a smaller highlight.	`0.95`
`contour`	Highlight contour softness.	`0.5`
`weakness`	Highlight-mask weakness. Higher values produce a smaller highlight.	`0.5`
`multiplier`	Highlight-mask multiplier.	`1.5`
`alpha`	Highlight visibility.	`0.0`
`saturation`	Gloss saturation.	`0.1`

Preview

Lip 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
`colors`	An array containing exactly two lipstick objects. Parameters: `color` - Required solid color in RGB string format. `finish` - Required lipstick finish; accepts the same preset values as `makeup_lipstick`. `coverage` - Required coverage preset or a number in `[0, 1]`; `strength` is accepted as a legacy alias.	+	+
`threshold`	Chameleon-mask threshold. Higher values produce a smaller mask.		`0.92`
`contour`	Chameleon-mask contour softness.		`0.3`
`weakness`	Chameleon-mask weakness. Higher values produce a smaller mask.		`0.25`

colors is required. threshold, contour, and weakness are optional and use the defaults shown in the table. The runtime applies exactly the two entries in colors.

Preview

Eyelid Gloss

Usage

"faces": [
    {
        "makeup_eyelidsgloss": {
            "threshold": 0.95,
            "contour": 0.6,
            "weakness": 0.6,
            "multiplier": 1.5,
            "saturation": 0.1,
            "alpha": 1
        }
        // ...
    }
    // ...
]

Parameter	Description	Default Value
`threshold`	Gloss threshold. Higher values produce a smaller highlight.	`0.98`
`contour`	Highlight contour softness.	`0.5`
`weakness`	Highlight-mask weakness. Higher values produce a smaller highlight.	`0.5`
`multiplier`	Highlight-mask multiplier.	`1.5`
`alpha`	Highlight visibility.	`0.0`
`saturation`	Gloss saturation.	`0.1`

Preview

Eyelid 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
`colors`	An object containing `bottom` and/or `upper` arrays. At least one array is required, and each array accepts one to three color definitions. Parameters: `bottom` - Optional array of one to three `{color, finish, coverage}` definitions. `upper` - Optional array of one to three `{color, finish, coverage}` definitions.	+	+
`threshold`	Chameleon-mask threshold. Higher values produce a smaller mask.		`0.92`
`contour`	Chameleon-mask contour softness.		`0.3`
`weakness`	Chameleon-mask weakness. Higher values produce a smaller mask.		`0.25`

colors must contain bottom, upper, or both. Each array accepts one to three definitions. threshold, contour, and weakness are optional and use the defaults shown in the table.

Preview

Lip Glitter

Usage

"faces": [
    {
        "makeup_lips_glitter": {
            "color": "0.7 0.3 0.7",
            "alpha": 0.75,
            "light_direction": "0.5 0.3 0.8"
        }
        // ...
    }
    // ...
]

Parameter	Description	Default Value
`color`	Glitter color in RGB format.	`"0 0 0"`
`alpha`	Glitter effect visibility.	`0.0`
`light_direction`	Light-direction vector. The default is used when the squared magnitude of the supplied vector is less than or equal to `0.01`.	`"0.5 0.3 0.8"`

Preview

Eyelid Glitter

Usage

"faces": [
    {
        "makeup_eyelids_glitter": {
            "color": "0.7 0.3 0.7",
            "alpha": 0.75,
            "light_direction": "0.5 -0.6 0.7"
        }
        // ...
    }
    // ...
]

Parameter	Description	Default Value
`color`	Glitter color in RGB format.	`"0 0 0"`
`alpha`	Glitter effect visibility.	`0.0`
`light_direction`	Light-direction vector. The default is used when the squared magnitude of the supplied vector is less than or equal to `0.01`.	`"0.5 -0.6 0.7"`

Preview

All Features

Let's combine all features:

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,
                "saturation": 0.1,
                "alpha": 0.8
            },
            "makeup_eyelidsgloss": {
                "threshold": 0.95,
                "contour": 0.6,
                "weakness": 0.6,
                "multiplier": 1.5,
                "saturation": 0.1,
                "alpha": 1
            }
        }
    ],
    "scene": "test_makeup",
    "version": "2.0.0"
}

Preview

Basic Concepts​

Makeup Base​

Eye Bags​

Foundation​

Concealer​

Contour​

Highlighter​

Blush​

Lipstick​

Lip Liner​

Eyeshadow​

Eyelashes​

Eyeliner​

Eyebrows​

Lip Shine​

Lip Gloss​

Lip Chameleon​

Eyelid Gloss​

Eyelid Chameleon​

Lip Glitter​

Eyelid Glitter​

All Features​

Basic Concepts

Makeup Base

Eye Bags

Foundation

Concealer

Contour

Highlighter

Blush

Lipstick

Lip Liner

Eyeshadow

Eyelashes

Eyeliner

Eyebrows

Lip Shine

Lip Gloss

Lip Chameleon

Eyelid Gloss

Eyelid Chameleon

Lip Glitter

Eyelid Glitter

All Features