Create Dynamic Material Instance
PrimitiveComponentЧто это
Создаёт динамический экземпляр материала (Material Instance Dynamic) для заданного элемента материала на примитиве.
Функция pure — не имеет exec-пинов, возвращает значение напрямую.
Пины
Exec-входы:
- нет (pure)
Exec-выходы:
- нет (pure)
Входы (данные):
- Target (PrimitiveComponent) — компонент-примитив, на котором создаётся материал
- Element Index (Integer) — индекс слота материала (обычно 0 для первого материала)
Выходы (данные):
- Return Value (Material Instance Dynamic) — созданный динамический материал
(Примечание: в документации UE5 есть необязательный вход Source Material, но я не уверен в его точном имени и наличии в редакторе – поэтому он не указан.)
Когда используется
- При необходимости изменять свойства материала во время выполнения (например, цвет, UV, параметры).
- Для реализации эффектов повреждений, интерактивного окрашивания, динамического отображения состояния.
Типичные проблемы
- Неправильный Element Index — если у меша несколько слотов материала, указание неверного индекса возвращает/изменяет не тот слот.
- Отсутствие кэширования — при каждом вызове создаётся новый динамический материал, что может привести к утечке памяти и лишним аллокациям. Рекомендуется сохранять результат в переменную и переиспользовать его.
- Изменение не влияет на визуал — после получения динамического материала все изменения параметров нужно применять через
Set Scalar Parameter Value/Set Vector Parameter Value, а не через прямое редактирование возвращённого объекта.