Get Parameter Info
MaterialInterfaceЧто это
Pure-функция, которая возвращает информацию о параметре материала (UMaterialInterface) по его имени. Позволяет получить структуру FMaterialParameterInfo — тип ассоциации (глобальный, слой, бленд), индекс и другие метаданные параметра. Используется для динамического контроля материалов в Blueprint, когда нужно узнать, как параметр связан с конкретным слоем или экземпляром.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Target (Material Interface Object) — сам материал или его экземпляр.
- Parameter Name (Name) — имя параметра, информацию о котором нужно получить.
Выходы (данные):
- Return Value (bool) — true, если параметр с таким именем найден в материале.
- Parameter Info (FMaterialParameterInfo) — структура, содержащая Association (EMaterialParameterAssociation), Index (int), Parameter Type (EMaterialParameterType) и другое.
Когда используется
- Динамическое управление параметрами материалов: перед установкой значения (Set Scalar/Vector Parameter Value) нужно убедиться, что параметр существует, и получить его полную информацию.
- Работа с многослойными материалами, где один и тот же параметр может быть в разных слоях — для выбора нужного слоя.
- Инструменты, разбирающие структуру материала: получение списка всех параметров с их метаданными.
Типичные проблемы
- Передача неправильного имени параметра — функция возвращает false, а в Parameter Info остаются нулевые значения. Рекомендуется сначала получить список допустимых имён через GetParameterNames.
- Путаница между родительским материалом и экземпляром — GetParameterInfo на родительском материале может не увидеть параметры, добавленные в экземпляре. Всегда вызывайте на нужном экземпляре (Material Instance Dynamic / Material Instance Constant).
- Игнорирование Association — если не проверить Association после получения Parameter Info, можно ошибочно применить значение к глобальному параметру вместо параметра слоя.