Эффекты

Дополнить изображение камеры можно с помощью эффектов.

Все эффекты перечисляются в конфигурационном файле mask.json в поле: "effects": [...]. Их можно сравнить со слоями в графическом редакторе.

Каждый эффект начинается с обязательного поля name — названия эффекта. Далее указываются все необходимые параметры, например: точка привязки, путь до текстуры, анимация, размер, смещение относительно точки привязки.

Пример объявления эффекта

JSON

{
    "preview": "Icon.png",
    "effects": [
        {
            "name": "beautify",
            "mix": 0.6
        },
        {
            "name": "patch",
            "anchor": "fullscreen",
            "texture": "Textures/Dust.png"
        },
        {
            "name": "colorfilter",
            "lookup": "ColorFilter/lookup.png",
            "intensity": 0.75
        }
    ]
}

Список эффектов

Эффект	Описание
`facemodel`	Трёхмерная маска, накладываемая поверх лица
`patch`	Плоскость с текстурой
`colorfilter`	Фильтр цветокоррекции
`beautify`	Сглаживание кожи лица
`liquifiedwarp`	Пластическая деформация
`posteffect`	Постэффекты
`copyface`	Копирование элементов лица
`pasteface`	Вставка элементов лица
`model3d`	3D-модель
`light`	Источник света для 3D-моделей

Важно! Применение эффектов к исходному изображению происходит в том порядке, в котором они описаны. Это значит, что эффекты, описанные строками выше, могут перекрываться теми, которые описаны строками ниже. Исключение из этого правила — 3D-эффекты (model3d, light). Они отрисовываются в том месте, где был объявлен первый такой эффект.

Отключение эффектов и их параметров

Отключить эффект можно двумя способами:

•
Добавить символ минуса - в поле с названием эффекта. Пример: -name.
•
Добавить дополнительное поле “disabled" : true/false (скрыть/показать) после поля с названием эффекта.

Пример отключения эффекта `patch`

JSON

{
  "preview": "Icon.png",
  "effects": [
    {
      "-name": "patch",
      ...
    },
    {
      "name": "patch",
      "disabled": true,
      ...
    }
  ]
}

С помощью символа - можно отключать и любой другой параметр эффекта. Для этого нужно добавить его в поле с названием параметра, например так: -texture.

Пример отключения параметра `texture`

JSON

{
    "preview": "Icon.png",
    "effects": [
        {
            "name": "patch",
            "anchor": "fullscreen",
            "-texture": "Textures/Red_overlay.png",
            "texture": "Textures/Blue_overlay.png"
        }
    ]
}

Отключать параметры удобно при тестировании нескольких вариантов, например, когда одну из текстур необходимо скрыть, а другую показать.

Эффекты

Пример объявления эффекта

Список эффектов

Отключение эффектов и их параметров

Пример отключения эффекта patch

Пример отключения параметра texture

Пример отключения эффекта `patch`

Пример отключения параметра `texture`