Get Bone Index
SkinnedMeshComponentЧто это
Pure-функция, возвращает целочисленный индекс кости (int32) по её имени (Name). Используется для быстрого перехода от имени кости к числовому индексу, который применяется в других функциях скелета (например, GetBoneTransform, GetBoneRotation). Тип: pure (нет exec-пинов).
Пины
Exec-входы:
нет (pure)
Exec-выходы:
нет (pure)
Входы (данные):
- BoneName (Name) — имя кости, чей индекс нужно получить.
Выходы (данные):
- ReturnValue (Integer) — индекс кости в скелете; -1, если кость с таким именем не найдена.
Когда используется
- При необходимости получить числовой индекс кости для последующего вызова функций, работающих с индексами (например, SetBoneTransformByIndex, GetBoneByIndex).
- В инициализации анимационных логик, когда имя кости известно заранее, а индекс нужен для оптимизации или передачи в C++.
Типичные проблемы
- Неверное имя кости — если BoneName не совпадает с реальным именем в скелете (опечатка, изменение в ретаргетинге), возвращается -1. Дальнейшие операции с этим индексом (например, доступ к трансформации) приведут к некорректным результатам или крашу при игнорировании проверки.
- Изменение скелета — индексы костей могут измениться при пересборке скелета (MergeMeshes, ретаргетинг). Хранить индекс на постоянной основе ненадёжно; безопаснее сохранять имя и вызывать GetBoneIndex каждый раз при необходимости.