SkeletonProfile
Базовый класс для профиля виртуального скелета, используемого в качестве цели для перенацеливания.
Базовый класс для профиля виртуального скелета, используемого в качестве цели для перенацеливания.
Этот ресурс используется в EditorScenePostImport. Некоторые параметры ссылаются на кости в Skeleton3D, Skin, Animation, а некоторые другие узлы переписываются на основе параметров SkeletonProfile.
Примечание: Эти параметры необходимо устанавливать только при создании пользовательского профиля. В SkeletonProfileHumanoid они определены внутренне как значения, доступные только для чтения.
Объявления сверены с C# SDK 1.0.0. Раскройте имя, чтобы увидеть сигнатуры и описание.
Конструкторы1
SkeletonProfileКонструктор
public SkeletonProfile();Свойства4
BoneSizeСвойство
public int BoneSize { get; set; }Количество костей в перенацеливании участка BoneMap Редактор. SkeletonProfileHumanoid 56 костей.
Размер элементов в BoneMap обновление при изменении этого свойства в присвоенном ему SkeletonProfile.
GroupSizeСвойство
public int GroupSize { get; set; }Количество групп костей в редакторе BoneMap раздела перенацеливания. Например, SkeletonProfileHumanoid имеет 4 группы.
Это свойство существует для разделения списка костей на несколько разделов в редакторе.
RootBoneСвойство
public StringName RootBone { get; set; }Имя кости, которая будет использоваться как корневая кость в AnimationTree. Это должна быть кость родителя бедер, которая существует в начале координат мира.
ScaleBaseBoneСвойство
public StringName ScaleBaseBone { get; set; }Имя кости, которое будет использовать высоту модели как коэффициент для нормализации. Например, SkeletonProfileHumanoid определяет ее как Hips.
Методы29
FindBoneint
public int FindBone(StringName boneName);Возвращает индекс кости, имя которого совпадает с bone_name.
| Имя | Тип | По умолчанию |
|---|---|---|
boneName | StringName | — |
intGetBoneNameStringName
public StringName GetBoneName(int boneIdx);Возвращает имя кости в bone_idx, которое будет ключевым именем в BoneMap.
В процессе перенацеливания возвращаемое имя кости является именем кости целевого скелета.
| Имя | Тип | По умолчанию |
|---|---|---|
boneIdx | int | — |
StringNameGetBoneParentStringName
public StringName GetBoneParent(int boneIdx);Возвращает имя кости, которая является родителем кости в bone_idx. Результат пустой, если у кости нет родителя.
| Имя | Тип | По умолчанию |
|---|---|---|
boneIdx | int | — |
StringNameGetBoneSizeint
public int GetBoneSize();intGetBoneTailStringName
public StringName GetBoneTail(int boneIdx);Возвращает имя кости, которая является хвостом кости по адресу bone_idx.
| Имя | Тип | По умолчанию |
|---|---|---|
boneIdx | int | — |
StringNameGetGroupStringName
public StringName GetGroup(int boneIdx);Возвращает группу кости по параметру bone_idx.
| Имя | Тип | По умолчанию |
|---|---|---|
boneIdx | int | — |
StringNameGetGroupNameStringName
public StringName GetGroupName(int groupIdx);Возвращает имя группы в group_idx, которая будет группой рисования в редакторе BoneMap.
| Имя | Тип | По умолчанию |
|---|---|---|
groupIdx | int | — |
StringNameGetGroupSizeint
public int GetGroupSize();intGetHandleOffsetVector2
public Vector2 GetHandleOffset(int boneIdx);Возвращает смещение кости в bone_idx, которое будет позицией кнопки в редакторе BoneMap.
Это смещение с началом в левом верхнем углу квадрата.
| Имя | Тип | По умолчанию |
|---|---|---|
boneIdx | int | — |
Vector2GetReferencePoseTransform3D
public Transform3D GetReferencePose(int boneIdx);Возвращает преобразование опорной позы для кости bone_idx.
| Имя | Тип | По умолчанию |
|---|---|---|
boneIdx | int | — |
Transform3DGetRootBoneStringName
public StringName GetRootBone();StringNameGetScaleBaseBoneStringName
public StringName GetScaleBaseBone();StringNameGetTailDirectionSkeletonProfile.TailDirection
public SkeletonProfile.TailDirection GetTailDirection(int boneIdx);Возвращает направление хвоста кости в bone_idx.
| Имя | Тип | По умолчанию |
|---|---|---|
boneIdx | int | — |
SkeletonProfile.TailDirectionGetTextureTexture2D
public Texture2D GetTexture(int groupIdx);Возвращает текстуру группы в group_idx, которая будет фоновым изображением группы рисования в редакторе BoneMap.
| Имя | Тип | По умолчанию |
|---|---|---|
groupIdx | int | — |
Texture2DIsRequiredbool
public bool IsRequired(int boneIdx);Возвращает, требуется ли кость в bone_idx для перенацеливания.
Это значение используется редактором карты костей. Если этот метод возвращает true и кость не назначена, цвет ручки будет красным в редакторе карты костей.
| Имя | Тип | По умолчанию |
|---|---|---|
boneIdx | int | — |
boolSetBoneNamevoid
public void SetBoneName(int boneIdx, StringName boneName);Устанавливает имя кости в bone_idx, которое будет ключевым именем в BoneMap.
В процессе перенацеливания имя кости настройки — это имя кости целевого скелета.
| Имя | Тип | По умолчанию |
|---|---|---|
boneIdx | int | — |
boneName | StringName | — |
SetBoneParentvoid
public void SetBoneParent(int boneIdx, StringName boneParent);Устанавливает кость с именем bone_parent как родительскую для кости с bone_idx. Если передана пустая строка, то у кости нет родителя.
| Имя | Тип | По умолчанию |
|---|---|---|
boneIdx | int | — |
boneParent | StringName | — |
SetBoneSizevoid
public void SetBoneSize(int size);| Имя | Тип | По умолчанию |
|---|---|---|
size | int | — |
SetBoneTailvoid
public void SetBoneTail(int boneIdx, StringName boneTail);Устанавливает кость с именем bone_tail в качестве хвоста кости с координатами bone_idx.
| Имя | Тип | По умолчанию |
|---|---|---|
boneIdx | int | — |
boneTail | StringName | — |
SetGroupvoid
public void SetGroup(int boneIdx, StringName group);Устанавливает группу кости в bone_idx.
| Имя | Тип | По умолчанию |
|---|---|---|
boneIdx | int | — |
group | StringName | — |
SetGroupNamevoid
public void SetGroupName(int groupIdx, StringName groupName);Задает имя группы в group_idx, которая будет группой рисования в редакторе BoneMap.
| Имя | Тип | По умолчанию |
|---|---|---|
groupIdx | int | — |
groupName | StringName | — |
SetGroupSizevoid
public void SetGroupSize(int size);| Имя | Тип | По умолчанию |
|---|---|---|
size | int | — |
SetHandleOffsetvoid
public void SetHandleOffset(int boneIdx, Vector2 handleOffset);Устанавливает смещение кости в bone_idx, которое будет позицией кнопки в редакторе BoneMap.
Это смещение с началом в левом верхнем углу квадрата.
| Имя | Тип | По умолчанию |
|---|---|---|
boneIdx | int | — |
handleOffset | Vector2 | — |
SetReferencePosevoid
public void SetReferencePose(int boneIdx, Transform3D boneName);Устанавливает преобразование опорной позы для кости bone_idx.
| Имя | Тип | По умолчанию |
|---|---|---|
boneIdx | int | — |
boneName | Transform3D | — |
SetRequiredvoid
public void SetRequired(int boneIdx, bool required);Устанавливает требуемый статус для кости bone_idx на required.
| Имя | Тип | По умолчанию |
|---|---|---|
boneIdx | int | — |
required | bool | — |
SetRootBonevoid
public void SetRootBone(StringName boneName);| Имя | Тип | По умолчанию |
|---|---|---|
boneName | StringName | — |
SetScaleBaseBonevoid
public void SetScaleBaseBone(StringName boneName);| Имя | Тип | По умолчанию |
|---|---|---|
boneName | StringName | — |
SetTailDirectionvoid
public void SetTailDirection(int boneIdx, SkeletonProfile.TailDirection tailDirection);Устанавливает направление хвоста кости в bone_idx.
Примечание: Это только указывает метод расчета. Фактические требуемые координаты должны храниться во внешнем скелете, поэтому сам расчет должен выполняться извне.
| Имя | Тип | По умолчанию |
|---|---|---|
boneIdx | int | — |
tailDirection | SkeletonProfile.TailDirection | — |
SetTexturevoid
public void SetTexture(int groupIdx, Texture2D texture);Устанавливает текстуру группы в group_idx, которая будет фоновым изображением группы рисования в редакторе BoneMap.
| Имя | Тип | По умолчанию |
|---|---|---|
groupIdx | int | — |
texture | Texture2D | — |
Сигналы и события1
ProfileUpdatedСобытие
public event Action ProfileUpdated;Этот сигнал выдается при изменении значения в профиле. Он используется для обновления имени ключа в BoneMap и перерисовки редактора BoneMap.
Примечание: Этот сигнал не подключен напрямую к редактору для упрощения ссылки, вместо этого он передается редактору через BoneMap.
SkeletonProfile.TailDirection
| Значение | Описание |
|---|---|
AverageChildren = 0 | Направление к средним координатам костных детей. |
End = 2 | Направление не рассчитано. |
SpecificChild = 1 | Направление к координатам указанного ребенка кости. |