Initialize Scalar Parameter And Get Index
MaterialInstanceDynamicЧто это
Exec-функция класса MaterialInstanceDynamic. Инициализирует скалярный параметр материала и возвращает его индекс для последующего быстрого доступа через Set Scalar Parameter by Index. Позволяет избежать повторного поиска параметра по имени при частых изменениях.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- Target (MaterialInstanceDynamic Object Reference) — динамический экземпляр материала
- ParameterName (Name) — имя скалярного параметра в материале
Выходы (данные):
- ReturnValue (Integer) — индекс параметра для использования в
Set Scalar Parameter by Index
Когда используется
При работе с динамическими материалами, когда нужно многократно менять один и тот же скалярный параметр (например, значение эмиссива, прозрачности или времени анимации) в каждом кадре. Вызов InitializeScalarParameterAndGetIndex один раз при старте, затем использование полученного индекса в Set Scalar Parameter by Index — значительно быстрее, чем каждый раз искать параметр по имени.
Типичные проблемы
- Параметр не найден: если указанное имя параметра отсутствует в материале, функция вернёт
INDEX_NONE(-1), а последующие вызовыSet Scalar Parameter by Indexс этим значением не будут иметь эффекта. Всегда проверяйте, чтоReturnValue >= 0. - Изменение материала после инициализации: если после вызова
InitializeScalarParameterAndGetIndexвы изменили родительский материал (добавили/удалили параметры), индексы могут стать невалидными. Повторно вызывайте инициализацию после любых изменений материала. - Путаница с векторными параметрами: функция предназначена только для скалярных (float) параметров. Попытка инициализировать векторный параметр (Color, Vector4) приведёт к возврату
INDEX_NONE.