Get Texture Parameter Value By Info
MaterialInstanceDynamicЧто это
Pure-функция, возвращающая значение текстурного параметра динамического экземпляра материала (MaterialInstanceDynamic) по структуре FMaterialParameterInfo. Позволяет получить текстуру, заданную в родительском материале или инстансе, без необходимости знать строковое имя параметра — достаточно передать информацию о параметре (имя, ассоциацию и индекс). Не требует exec-пинов (pure).
Пины
Exec-входы:
Нет (pure).
Exec-выходы:
Нет (pure).
Входы (данные):
- Target (MaterialInstanceDynamic) — динамический инстанс материала, из которого извлекается параметр.
- Parameter Info (Material Parameter Info) — структура, содержащая имя параметра, ассоциацию (Layer/Blend) и индекс (для массивов или слоёв).
Выходы (данные):
- Return Value (Boolean) — true, если параметр найден и значение прочитано; false, если параметр с таким Info отсутствует.
- Value (Texture) — значение текстурного параметра (может быть nullptr, если параметр не найден).
Когда используется
- Чтение значения текстурного параметра, заданного через структуру ParameterInfo (например, из массивов параметров слоёв или блендов).
- Динамическая смена текстур на материале с последующим возвратом к исходному значению (сохранение и восстановление).
- Отладка: проверка, какая текстура фактически установлена для заданного параметра.
Типичные проблемы
- Игнорирование Return Value — если параметр не найден, Value будет nullptr, но функция может вернуть false. Подключение этой текстуры в другие ноды без проверки bool приведёт к крашу.
- Некорректное заполнение ParameterInfo — особенно Association (Layer/Blend) и Index. Например, если параметр находится в Layer с индексом 0, а указать Association=Global или неверный индекс, поиск завершится неудачей.
- Использование на статическом MaterialInstance — функция работает только с MaterialInstanceDynamic, полученным через CreateDynamicMaterialInstance. На статическом инстансе она либо не скомпилируется, либо вернёт неопределённый результат.