Add Instance
InstancedStaticMeshComponentЧто это
Exec-функция компонента InstancedStaticMeshComponent. Добавляет один экземпляр (instance) статического меша с заданной трансформацией. Возвращает индекс добавленного инстанса или -1 при ошибке.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- Instance Transform (Transform) — матрица преобразования нового инстанса (позиция, поворот, масштаб)
- bWorld Space (Bool) — если true, трансформация задана в мировых координатах; если false — в локальных координатах компонента (по умолчанию false)
Выходы (данные):
- Return Value (Integer) — индекс добавленного инстанса (0-based), -1 если не удалось добавить (например, не назначен StaticMesh)
Когда используется
Создание множества управляемых экземпляров статического меша с разными трансформациями — трава, камни, монеты, декали, повторяющиеся объекты на уровне.
Типичные проблемы
- Меш не назначен — компоненту InstancedStaticMeshComponent не задан StaticMesh в Defaults или через конструкцию. Вызов AddInstance приведёт к крашу или молчаливому отказу.
- Неправильный флаг bWorldSpace — если трансформация вычисляется относительно мира, а флаг стоит false (по умолчанию), инстанс появится в локальных координатах компонента, что часто не совпадает с ожидаемой позицией.
- Смешение локальных и мировых данных — манипуляции с трансформацией до вызова AddInstance (например, умножение на WorldTransform уже родителя) без учёта bWorldSpace приводят к двойному учёту иерархии.