Snapshot Object
KismetSystemLibraryЧто это
Функция создаёт снимок (snapshot) указанного объекта — сохраняет его текущее состояние в памяти для последующего восстановления.
Тип: exec (не pure), так как выполняет действие и не возвращает чистый результат без сайд-эффектов.
Пины
_(Точные имена и типы пинов неизвестны — не уверен в сигнатуре. Ниже приведена структура, основанная на общем поведении подобных функций движка, но без гарантии.)_
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- Target (Object) — объект, снимок которого создаётся
- Snapshot Name (Name) — уникальное имя для сохранённого снимка
Выходы (данные):
- Return Value (Boolean) — true, если снимок успешно создан
⚠ Примечание: точная сигнатура может отличаться. Перед использованием рекомендуется проверить пины в редакторе Blueprint или обратиться к официальной документации.
Когда используется
- Сохранение состояния объекта перед временными изменениями (например, перед симуляцией физики или анимацией), чтобы потом вернуть его в исходное состояние.
- Реализация механик "отката" (undo) или "предпросмотра" без необратимого изменения мира.
Типичные проблемы
- Неверное имя снимка: если передать пустое или неуникальное имя, функция может перезаписать существующий снимок или вернуть false.
- Объект не поддерживает снятие снимка: не все объекты могут быть сериализованы в снимок (например, компоненты).
- Забытая проверка возвращаемого значения: без проверки Return Value легко не заметить, что снимок не создан.