Руководство по Unreal Engine Level Snapshots: безопасное управление вариантами сцены

Функция Level Snapshots в Unreal Engine позволяет сохранять состояние Actor в level, а также их компонентов и свойств на определённый момент времени, чтобы позднее восстановить его. В документации Epic говорится, что функция может использоваться не только в виртуальном продакшене, но и для управления сложными сценами и их вариантами. Руководство основано на описанном в документации принципе работы; на соответствующей странице не указана конкретная версия Unreal Engine, в которой доступна функция.

1. Включите плагин и перезапустите редактор

Перед использованием Level Snapshots включите плагин:

1. Откройте окно Project Settings в Unreal Editor.

2. Перейдите по пути Project Settings › Plugins › LevelSnapshots и включите плагин LevelSnapshots.

3. Подтвердите запрос редактора на перезапуск. После перезапуска доступ к меню Level Snapshots появится на главной панели инструментов и в окне Level Snapshots.

4. Если проект использует только nDisplay, при необходимости включите также плагин nDisplay Support For Level Snapshots. Epic отмечает, что поддержка nDisplay предоставляется отдельным плагином; если nDisplay не используется, включать его не нужно.

Если плагин не отображается в настройках проекта, сначала убедитесь, что выполнили все шаги установки и перезапустили редактор. В документации не указаны другие способы установки или требования к оборудованию.

2. Сохраните исходное состояние сцены

Создать snapshot можно тремя способами: нажать кнопку Level Snapshot на главной панели инструментов, выбрать Take Snapshot в окне Level Snapshots или выполнить команду Take Snapshot через Remote Control Web Application. Каждый из этих способов открывает окно Create Level Snapshot.

В этом окне укажите понятное название записи и при желании добавьте описание. Формат названия по умолчанию объединяет имя level, имя пользователя и время; перед сохранением его можно изменить. Snapshot сохраняется как Asset в каталоге, указанном в поле Root Directory. По умолчанию корневой каталог — LevelSnapshots, а вложенный каталог определяется именем level и датой создания записи. Можно изменить корневой каталог и вложенную папку для текущего snapshot, а также настроить формат названий по умолчанию для новых записей.

При изменении названия следите за тем, чтобы не перезаписать существующий snapshot. Согласно документации, название, изменённое перед сохранением, может стать названием по умолчанию для последующих записей. Понятная схема именования, отражающая сцену, вариант и назначение, помогает команде не путать записи.

3. Проверьте изменения перед восстановлением

Чтобы применить сохранённое состояние, выберите нужный Level Snapshot и нажмите Restore Level Snapshot. Изменения Actor, внесённые после создания записи, будут приведены к состоянию из snapshot. Новые Actor будут удалены из level, а ранее удалённые — добавлены снова. Трансформации и свойства Actor также вернутся к сохранённым значениям. Операцию можно отменить.

Перед восстановлением изучите список в правой части окна Level Snapshots. В нём показано, какие Actor, компоненты и свойства будут затронуты. С помощью флажков рядом с каждым изменением можно применить отдельные результаты или исключить их. Так, вместо полного восстановления всей сцены можно вернуть только освещение или положение одного Actor.

Если в проекте несколько level, в окне отображаются только snapshot, связанные с открытым level. Чтобы просмотреть записи другого level, откройте его в редакторе. В snapshot включаются и Actor, которые на момент создания записи не отображались в World Outliner. Поэтому при оценке сцены недостаточно смотреть только на видимые элементы — проверяйте также видимость Actor.

4. Сузьте выбор с помощью пользовательских фильтров

В level с большим количеством Actor фильтры помогают точнее определить, какие записи участвуют в восстановлении. Нажмите + Filter Group, чтобы добавить группу фильтров, а затем выберите готовый фильтр, фильтр C++ или пользовательский фильтр Blueprint в меню Add Filter. Выбрав фильтр, настройте необходимые для его работы параметры. Например, Actor Has Tag Filter требует указать тег Actor.

Фильтры в одной группе работают по логике AND: Actor должен соответствовать всем критериям группы, чтобы попасть в список. Дополнительные группы фильтров объединяются по логике OR: в результаты могут попасть Actor, соответствующие хотя бы одному критерию. Настроив фильтр, выберите snapshot и нажмите Refresh Results. Чтобы повторно использовать фильтры, сохраните или загрузите их через меню Load / Save Filter. Давайте общим фильтрам понятные названия, отражающие их назначение.

Для фильтра можно задать параметр Default Result: Include, Exclude или Do Not Care. Эти варианты определяют, нужно ли включать результат фильтра, исключать его или не учитывать состояние Actor, на которые фильтр напрямую не влияет. Фильтр также можно инвертировать, однако инверсия фильтра с настройкой Exclude может включить результаты. Поэтому перед созданием сложных правил полезно проверить логику фильтров на небольшом наборе элементов.

Частые ошибки

• Считать, что snapshot включает изменения Asset: состояния Asset, например Material, не сохраняются. Отслеживайте такие изменения отдельно с помощью source control.

• Упускать из виду элементы, которые не отслеживаются: Landscape, USD Actor и консольные переменные не отслеживаются Level Snapshots; для них нужен отдельный способ контроля.

• Переименовывать sublevel: если после создания snapshot переименовать sublevel, система может посчитать Actor внутри него новыми, а не существующими изменёнными элементами.

• Смешивать разные типы фильтров в одной группе: Epic в большинстве случаев не рекомендует одновременно использовать фильтры Is Actor Valid и Is Property Valid; не объединяйте их в одной группе фильтров.

Влияние на процессы архитектурной визуализации

В архитектурных презентациях Level Snapshots может помочь сохранять и выборочно восстанавливать такие параметры, как схема освещения, расположение элементов сцены или положение отдельных Actor. Это удобно командам, которые сравнивают разные состояния сцены в одном level, а также для виртуального продакшена. Однако важно помнить, что функция охватывает только состояние Actor и их свойств: изменения Asset, например Material, в snapshot не включаются. Landscape, USD Actor и консольные переменные также нужно отслеживать отдельно.

На странице документации Level Snapshots не указаны совместимость с версиями, условия лицензирования и требования к оборудованию; проверьте эту информацию отдельно при планировании проекта. Если используется nDisplay, учитывайте необходимость дополнительного плагина поддержки и перезапуска редактора после его включения. В больших сценах особенно важно перед восстановлением проверять список затрагиваемых Actor и свойств, чтобы избежать нежелательных изменений.