Add Instances
InstancedStaticMeshComponentЧто это
Exec-функция компонента InstancedStaticMeshComponent. Добавляет несколько экземпляров (instance) статической сетки за один вызов. Принимает массив трансформаций и возвращает true, если все экземпляры успешно добавлены.
Пины
Exec-входы:
- execute (exec) — запуск добавления.
Exec-выходы:
- then (exec) — продолжение выполнения после завершения.
Входы (данные):
- Transformations (Array of Transform) — массив трансформаций (позиция, поворот, масштаб) для каждого нового экземпляра.
_Точные имена и наличие других пинов (например, World Space) неизвестны._
Выходы (данные):
- Return Value (bool) —
true, если все экземпляры добавлены;falseпри ошибке (например, превышение лимита или некорректные трансформации).
Когда используется
- Моментальное размещение большого числа однотипных объектов (трава, камни, здания) без потери производительности за счёт инстансинга.
- Динамическое создание инстансов во время игры (например, постройки, снаряды, разрушаемые элементы).
Типичные проблемы
- Игнорирование возвращаемого значения. Функция может вернуть
false(например, при превышении лимита массива или нехватке памяти), но код продолжит выполняться, а экземпляры не появятся. Рекомендуется проверятьReturn Valueи обрабатывать ошибку. - Пустой массив Transformations. Не вызывает ошибок, но и не добавляет ни одного экземпляра — лишний вызов, не имеющий практического эффекта.
- Несоответствие порядка трансформаций — если требуется определённая последовательность экземпляров, массив должен быть правильно отсортирован до вызова.