Release
TypedElementHandleLibrary
0
Что это
Статическая функция из библиотеки TypedElementHandleLibrary. Освобождает (уничтожает) элемент, связанный с переданным handle’ом, после чего handle становится недействительным. Это exec-функция (не pure) — вызывается по потоку выполнения.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- ElementHandle (TypedElementHandle) — дескриптор освобождаемого элемента
Выходы (данные):
- ReturnValue (bool) —
true, если элемент успешно освобождён;false, если handle некорректен или операция не удалась
Когда используется
- В редакторах и инструментах, работающих с Typed Elements (например, редактор уровней, ассетов), когда нужно программно удалить элемент (актёр, компонент, ассет) по его handle’у.
- В пользовательских утилитах манипуляции контентом, где требуется точный контроль жизненного цикла элементов.
Типичные проблемы
- Повторное использование handle после Release — handle становится недействительным, любая операция с ним (GetName, SetMetadata и т.д.) не сработает или приведёт к ошибке. Всегда проверяйте
ReturnValueи обнуляйте handle после успешного освобождения. - Игнорирование возвращаемого bool — неудачный Release может быть вызван неверным handle’ом (например, элемент уже удалён из другого места). Без проверки
ReturnValueлогика пойдёт дальше с испорченным handle’ом.
Справка из библиотеки BPai.
T3D этой ноды ещё не записан. Как только кто-то разберёт её через 📖 — в этом блоке появится граф с пинами.