Set Vector3f Property By Name
KismetSystemLibraryЧто это
Exec-функция из набора KismetSystemLibrary. Устанавливает значение свойства типа Vector3f у указанного объекта, используя строковое имя свойства. Позволяет динамически изменять свойство, известное только по имени (например, полученном из переменной или текстового поля). Не является pure-функцией, так как модифицирует объект.
Пины
Exec-входы:
- execute (exec) — запуск установки свойства
Exec-выходы:
- then (exec) — выполняется после завершения операции
Входы (данные):
- Target (Object) — объект, свойство которого нужно изменить
- PropertyName (String) — имя свойства (регистрозависимо, должно совпадать с именем в редакторе)
- Value (Vector3f) — новое значение свойства
Выходы (данные):
_(не уверен в точной сигнатуре — возможно, отсутствуют (void) или есть булевый выход успеха)_
Когда используется
- Динамическое изменение свойств, когда имя свойства заранее не известно и передаётся как строка (например, из конфигурации, пользовательского ввода или данных уровня).
- Сценарии, где нужно массово обновить одноимённые свойства у разных объектов без создания отдельных веток для каждого свойства.
- Инструменты отладки и редакторы, позволяющие изменять любые Vector3f-поля объекта по имени.
Типичные проблемы
- Опечатка в имени свойства — функция не найдёт свойство и, скорее всего, ничего не сделает (или вернёт false, если выход есть). Имя должно точно совпадать с именем в Blueprint-редакторе (регистр важен).
- Несовместимый тип — если свойство с указанным именем существует, но имеет другой тип (не Vector3f), операция не выполнится. Ошибка не всегда очевидна, так как нода не генерирует исключение.
- Свойство только для чтения — попытка установить свойство, помеченное как read-only (например, вычисляемое или защищённое), ни к чему не приведёт.