Add Instance World Space
InstancedStaticMeshComponentЧто это
Exec-функция класса UInstancedStaticMeshComponent. Добавляет новый экземпляр статического меша в коллекцию инстансов, используя заданную трансформацию в мировом пространстве. Возвращает индекс добавленного экземпляра (начиная с 0). Полезно для динамического размещения множества одинаковых объектов с разными трансформациями без создания отдельных Actor.
Пины
Exec-входы:
- execute (exec) — запуск добавления.
Exec-выходы:
- then (exec) — продолжение после завершения операции.
Входы (данные):
- Target (InstancedStaticMeshComponent Object Reference) — сама компонента, в которую добавляется инстанс.
- World Transform (Transform) — трансформация добавляемого экземпляра в мировых координатах (положение, поворот, масштаб).
Выходы (данные):
- Return Value (Integer) — индекс добавленного инстанса. Используется для последующего изменения или удаления через
UpdateInstanceTransform/RemoveInstance.
Когда используется
- Динамическое размещение декоративных объектов (камней, растительности) на ландшафте.
- Создание повторяющихся элементов уровня в коде (лампы, стулья, препятствия) в мировых координатах, когда заранее известна глобальная позиция.
Типичные проблемы
- Передача локальных координат вместо мировых — если используется
AddInstanceWorldSpace, а переданы координаты относительно компонента, инстанс окажется смещённым. Для локальных трансформаций применяйтеAddInstance (Instance). - Нулевой масштаб — если
World Transformсодержит масштаб 0 по любой оси, инстанс не будет виден, но ошибки не возникнет. - Работа с пустым StaticMesh — компонент не отобразит инстансы, если в поле
StaticMeshничего не назначено. Проверьте настройку на этапе проектирования.