Set Custom Data Value
ITypedElementPrimitiveCustomDataInterfaceЧто это
Exec-функция интерфейса ITypedElementPrimitiveCustomDataInterface. Устанавливает значение пользовательского данного (custom data) на примитивном элементе (например, статической меше) по указанному индексу. Используется в Typed Elements Framework для работы с произвольными данными, хранящимися на уровне рендера.
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- Target (ITypedElementPrimitiveCustomDataInterface) — объект интерфейса, к которому применяется операция
- CustomDataIndex (Integer) — индекс пользовательского данного (начиная с 0)
- CustomDataValue (Float) — значение, которое будет записано
Выходы (данные):
- нет (void)
Когда используется
- Установка произвольных данных на статические или скелетальные меши для последующего чтения в материалах (например, через Custom Data в материалах).
- Синхронизация пользовательских данных между логикой и рендером в проектах, использующих Typed Elements.
Типичные проблемы
- Выход за границы массива: индекс
CustomDataIndexдолжен быть меньше количества доступных слотов custom data на элементе (обычно задаётся в настройках меша). Передача невалидного индекса может привести к крашу или игнорированию. - Игнорирование обновления рендера: после вызова функции может потребоваться принудительное обновление состояния рендера (например, через
MarkRenderStateDirty), если значение должно сразу отобразиться в материале. В некоторых версиях движка это делается автоматически, но не всегда.