Get Effect Material
RetainerBoxЧто это
Pure-функция, возвращающая динамический экземпляр материала эффекта (Effect Material), который применяется к отрисованному содержимому RetainerBox. Используется для последующего изменения его параметров во время выполнения.
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Target (RetainerBox Object Reference) — ссылка на RetainerBox, чей материал эффекта нужно получить.
Выходы (данные):
- ReturnValue (Material Instance Dynamic) — динамический материал, который можно модифицировать (например, через
Set Scalar Parameter Value).
Когда используется
Когда нужно изменить визуальные параметры RetainerBox в рантайме — например, обновить цвет, размытие или маску, управляя Material Instance Dynamic, полученным через этот геттер.
Типичные проблемы
- Попытка изменить сам Effect Material через
Set Material— геттер возвращает уже существующий динамический экземпляр, его следует использовать для изменения параметров, а не заменять. - Забыт установленный в RetainerBox материал эффекта — если он не задан, ReturnValue будет
null, и вызовSet Parameter Valueприведёт к ошибке. - Путаница с обычным материалом виджета (Widget Material) — GetEffectMaterial относится именно к слою эффекта RetainerBox, а не к материалу содержимого.