Get Bone Track Index
IAnimationDataModelЧто это
Pure-функция, которая возвращает индекс трека (track index) для указанного имени кости (bone name) в анимационной модели (IAnimationDataModel). Позволяет получить числовой идентификатор кости для последующего доступа к её анимационным данным (трансформации, ключи и т.п.).
Пины
Exec-входы: нет (pure)
Exec-выходы: нет (pure)
Входы (данные):
- Target (IAnimationDataModel) — целевая анимационная модель, из которой извлекается индекс.
- Bone Name (Name) — имя кости, для которой требуется получить индекс трека.
Выходы (данные):
- Return Value (Integer) — индекс трека кости в модели. Если кость с указанным именем не найдена, возвращается
INDEX_NONE(обычно -1).
Когда используется
При кастомизации или анализе анимационных ассетов в редакторе, когда нужно по имени кости получить её числовой индекс, чтобы затем считывать или изменять её данные (например, через функции GetBoneTrackTransforms, GetBoneTrackKeys).
Типичные проблемы
- Передача имени кости с опечаткой или несовпадением регистра — функция вернёт
INDEX_NONE, и все последующие операции с этим индексом (например, получение трансформаций) приведут к ошибке или возврату пустых данных. - Попытка получить индекс для кости, которой нет в монтаже смешивания (LOD-скелет и т.п.) — также вернёт
INDEX_NONE.