Skeleton3D

public bool AnimatePhysicalBones { get; set; }

Если вы следуете рекомендуемому рабочему процессу и явно указываете PhysicalBoneSimulator3D как дочерний элемент Skeleton3D, вы можете контролировать, будет ли он затронут raycasting без запуска Skeleton3D.PhysicalBonesStartSimulation, с помощью его SkeletonModifier3D.Active. Однако для старых (устаревших) конфигураций Skeleton3D имеет внутренний виртуальный PhysicalBoneSimulator3D для совместимости. Это свойство управляет внутренним виртуальным PhysicalBoneSimulator3D SkeletonModifier3D.Active.

public Skeleton3D.ModifierCallbackModeProcessEnum ModifierCallbackModeProcess { get; set; }

Устанавливает время обработки для модификатора.

public float MotionScale { get; set; }

Положительный множитель позиционных анимационных треков костей в AnimationMixer. Не меняет трансформацию Entity или напрямую заданную SetBonePosePosition позицию. Значения <= 0 нативный setter отклоняет с восстановлением 1; не используйте 0 для остановки анимации.

public bool ShowRestOnly { get; set; }

Если true, то кости возвращаются в исходную позу покоя, независимо от их значений. В редакторе это также предотвращает редактирование костей.

public int AddBone(string name);

Добавляет новую кость с указанным именем. Возвращает индекс новой кости или -1, если этот метод не срабатывает. Примечание: Имена костей должны быть уникальными, непустыми и не могут включать символы : и /.

public void Advance(double delta);

Вручную переместите дочерние SkeletonModifier3D на указанное время (в секундах). Примечание: delta временно накапливается в Skeleton3D, а отложенный процесс использует накопленное значение для обработки модификации.

public void ClearBones();

Очистите этот скелет от всех костей.

public void ClearBonesGlobalPoseOverride();

Удаляет глобальное переопределение позы для всех костей скелета.

public int FindBone(string name);

Возвращает индекс кости, который соответствует name в качестве имени. Возвращает -1, если кости с таким именем не существует.

public void ForceUpdateAllBoneTransforms();

Принудительно обновляет трансформации/позы костей для всех костей скелета.

public void ForceUpdateBoneChildTransform(int boneIdx);

Принудительно обновляет преобразование кости для кости с параметром bone_idx и всех ее дочерних элементов.

public int[] GetBoneChildren(int boneIdx);

Возвращает массив, содержащий индексы костей всех дочерних узлов переданной кости, bone_idx.

public int GetBoneCount();

Возвращает количество костей в скелете.

public Transform3D GetBoneGlobalPose(int boneIdx);

Вычисляет текущую позу кости с учётом её родителей, в системе координат Skeleton3D. Слово Global здесь не означает мировую трансформацию. Для мира умножьте Skeleton3D.GlobalTransform на результат. Значение зависит от текущей фазы обновления анимации и модификаторов.

public Transform3D GetBoneGlobalPoseNoOverride(int boneIdx);

Возвращает общую трансформацию указанной кости относительно скелета, но без глобальных переопределений позы. Будучи относительно скелетного кадра, это не фактическая "глобальная" трансформация кости.

public Transform3D GetBoneGlobalPoseOverride(int boneIdx);

Возвращает глобальное преобразование переопределения позы для bone_idx.

public Transform3D GetBoneGlobalRest(int boneIdx);

Читает композицию Rest кости и её родителей в системе Skeleton3D. Не использует текущие анимационные позы и не включает мировую трансформацию самого скелета.

public Variant GetBoneMeta(int boneIdx, StringName key);

Возвращает метаданные с заданным ключом key для кости по индексу bone_idx.

public Reckfell.Collections.Array<StringName> GetBoneMetaList(int boneIdx);

Возвращает список всех ключей метаданных для кости по индексу bone_idx.

public string GetBoneName(int boneIdx);

Возвращает имя кости по индексу bone_idx.

public int GetBoneParent(int boneIdx);

Возвращает индекс кости, которая является родителем кости в bone_idx. Если -1, то у кости нет родителя. Примечание: Возвращаемая родительская кость всегда будет меньше, чем bone_idx.

public Transform3D GetBonePose(int boneIdx);

Читает текущую локальную трансформацию кости относительно родительской кости, либо скелета для корня. Это не дополнительная трансформация, автоматически умножаемая на Rest. Анимация и модификаторы могут изменить позу в своей фазе обновления.

public Vector3 GetBonePosePosition(int boneIdx);

Читает позиционную часть локальной Bone Pose относительно родительской кости; для корневой кости — относительно скелета. Это не мировая позиция и не общая позиция дочерней кости в скелете.

public Quaternion GetBonePoseRotation(int boneIdx);

Возвращает вращение позы кости в bone_idx. Возвращаемый Quaternion является локальным для кости по отношению к вращению любых родительских костей.

public Vector3 GetBonePoseScale(int boneIdx);

Возвращает масштаб позы кости в bone_idx.

public Transform3D GetBoneRest(int boneIdx);

Читает опорную трансформацию кости относительно её родительской кости, либо скелета для корня. Это отдельные данные от изменяемой текущей позы.

public Vector3 GetBoneSkinScale(int boneIdx);

Возвращает размер кожи кости в bone_idx.

public StringName GetConcatenatedBoneNames();

Возвращает все имена костей, объединенные запятыми (,) как один StringName. Полезно задать его как подсказку для свойства enum.

public int[] GetParentlessBones();

Возвращает массив со всеми костями, которые не имеют родителей. Другой способ взглянуть на это — это то, что он возвращает индексы всех костей, которые не зависят или не изменяются другими костями в Скелете.

public ulong GetVersion();

Возвращает количество раз, когда иерархия костей изменялась в этом скелете, включая переименования. Версия скелета не сериализуется: используется только в одном экземпляре Skeleton3D. Используется для аннулирования кэшей в IK и других узлах, которые обрабатывают кости.

public bool HasBoneMeta(int boneIdx, StringName key);

Возвращает true, если кость с индексом bone_idx имеет метаданные с заданным key.

public bool IsBoneEnabled(int boneIdx);

Возвращает, включена ли поза кости для кости в bone_idx.

public void LocalizeRests();

Возвращает все кости скелета в исходное (rest) положение.

public void PhysicalBonesAddCollisionException(Rid exception);

Добавляет исключение столкновения к физической кости. Работает так же, как узел RigidBody3D.

public void PhysicalBonesRemoveCollisionException(Rid exception);

Удаляет исключение столкновения с физической костью. Работает так же, как узел RigidBody3D.

public void PhysicalBonesStartSimulation(Reckfell.Collections.Array<StringName> bones = null);

Сообщает узлам PhysicalBone3D в скелете начать симуляцию и реагировать на физический мир. При желании можно передать список имен костей, что позволит моделировать только переданные кости.

public void PhysicalBonesStopSimulation();

Сообщает узлам PhysicalBone3D в скелете о необходимости прекратить симуляцию.

public SkinReference RegisterSkin(Skin skin);

Привязывает указанный Skin к скелету.

public void ResetBonePose(int boneIdx);

Копирует позицию, вращение и масштаб из Rest в текущую локальную позу одной кости. Не сбрасывает анимационный проигрыватель; следующая анимация или модификатор может снова изменить позу. Перегрузка без bool сохраняет отдельный Bone Skin Scale.

public void ResetBonePose(int boneIdx, bool resetBoneSkinScale = false);

Копирует позицию, вращение и масштаб из Rest в текущую локальную позу одной кости. Не сбрасывает анимационный проигрыватель; следующая анимация или модификатор может снова изменить позу. Перегрузка без bool сохраняет отдельный Bone Skin Scale.

public void ResetBonePoses();

Выполняет сброс позы из Rest для каждой кости. Не меняет сами Rest и не останавливает анимацию. Перегрузка без bool сохраняет отдельные Bone Skin Scale.

public void ResetBonePoses(bool resetBoneSkinScale = false);

Выполняет сброс позы из Rest для каждой кости. Не меняет сами Rest и не останавливает анимацию. Перегрузка без bool сохраняет отдельные Bone Skin Scale.

public void SetBoneEnabled(int boneIdx, bool enabled = true);

Отключает позу кости в bone_idx если false, включает позу кости если true.

public void SetBoneGlobalPose(int boneIdx, Transform3D pose);

Устанавливает глобальное преобразование позы, pose, для кости в bone_idx. Примечание: Если были изменены другие позы костей, этот метод выполняет грязный пересчет поз и приведет к ухудшению производительности. Если вы знаете, что будет применено несколько глобальных поз, рассмотрите возможность использования Skeleton3D.SetBonePose с предварительным расчетом.

public void SetBoneGlobalPoseOverride(int boneIdx, Transform3D pose, float amount, bool persistent = false);

Устанавливает глобальное преобразование позы, pose, для кости в bone_idx. amount — это сила интерполяции, которая будет использоваться при применении позы, а persistent определяет, останется ли примененная поза. Примечание: Преобразование позы должно быть глобальным! Чтобы преобразовать мировое преобразование из Entity3D в глобальную позу кости, умножьте Transform3D.AffineInverse узла Entity3D.GlobalTransform на желаемое мировое преобразование.

public void SetBoneMeta(int boneIdx, StringName key, Variant value);

Устанавливает метаданные с заданным значением key равным value для кости с индексом bone_idx.

public void SetBoneName(int boneIdx, string name);

Устанавливает имя кости name для кости с параметром bone_idx.

public void SetBoneParent(int boneIdx, int parentIdx);

Устанавливает индекс кости parent_idx как родительский для кости в bone_idx. Если -1, то у кости нет родителя. Примечание: parent_idx должен быть меньше bone_idx.

public void SetBonePose(int boneIdx, Transform3D pose);

Устанавливает преобразование позы pose для кости с bone_idx.

public void SetBonePosePosition(int boneIdx, Vector3 position);

Заменяет позиционную часть локальной позы относительно родительской кости, либо скелета для корня. Не прибавляет position к Rest. Не меняет Rest, вращение или масштаб; последующее обновление анимации/модификаторов может перезаписать позу.

public void SetBonePoseRotation(int boneIdx, Quaternion rotation);

Устанавливает вращение позы кости в bone_idx на rotation. rotation — это Quaternion, описывающий вращение в локальном координатном пространстве кости относительно вращения любых родительских костей.

public void SetBonePoseScale(int boneIdx, Vector3 scale);

Устанавливает масштаб позы кости в bone_idx на scale.

public void SetBoneRest(int boneIdx, Transform3D rest);

Задаёт локальную опорную трансформацию. Сам по себе не заменяет текущую позу: для возврата к новому Rest вызовите ResetBonePose или ResetBonePoses. Изменение Rest затрагивает опорную геометрию скелета; проверяйте скин и анимацию отдельно.

public void SetBoneSkinScale(int boneIdx, Vector3 skinScale);

Устанавливает размер кожи кости на bone_idx в адрес skin_scaleЭта шкала не влияет на костных детей, что полезно для изменения визуальной толщины кожи. Даже если кожа является визуально деформированной, не происходит ни масштабирования, ни перемещения костей. Это означает, что, возможно, необходимо скорректировать происхождение детской кости для синхронизации ее сустава с масштабированием путем использования BoneSpaceAdjuster3D. Примечание: Маскировка кожи может исказить внешний вид гизмо для некоторых классов скелета Модификатора, таких как SpringBoneSimular и SpringSimulator. IKModifier3D, которые зависят от длины костей для обнажения.

public void UnparentBoneAndRest(int boneIdx);

Делает кость bone_idx без родительской, и устанавливает ее положение покоя в положение родительской кости перед сбросом.

public event Skeleton3D.BoneEnabledChangedEventHandler BoneEnabledChanged;

Выдается, когда кость в bone_idx переключается с помощью Skeleton3D.SetBoneEnabled. Используйте Skeleton3D.IsBoneEnabled для проверки нового значения.

public event Action BoneListChanged;

Вызывается при изменении списка костей, например, при вызове Skeleton3D.AddBone, Skeleton3D.SetBoneParent, Skeleton3D.UnparentBoneAndRest или Skeleton3D.ClearBones.

public event Action PoseUpdated;

Выдается при обновлении позы. Примечание: Во время процесса обновления этот сигнал не срабатывает, поэтому модификация SkeletonModifier3D не обнаруживается.

public event Action RestUpdated;

Выдается при обновлении rest данных.

public event Action ShowRestOnlyChanged;

Вызывается при изменении значения Skeleton3D.ShowRestOnly.

public event Action SkeletonUpdated;

Выдается, когда рассчитана окончательная поза, будет применена к skin'у в процессе обновления. Это означает, что вся обработка SkeletonModifier3D завершена. Чтобы обнаружить завершение обработки каждого SkeletonModifier3D, используйте SkeletonModifier3D.ModificationProcessed.

public const long NotificationUpdateSkeleton = 50;

Уведомление получено, когда поза этого скелета должна быть обновлена. В этом случае это вызывается только один раз за кадр в отложенном процессе.