using System.Collections.Generic; using UnityEngine; namespace UnityGLTF { internal class AvatarUtils { // A static dictionary containing the mapping from joint/bones names in the model // to the names Unity uses for them internally. // In this case they match the naming from the included Mixamo model on the left // and the Unity equivalent name on the right. // This does not need to be hard-coded. public static Dictionary HumanSkeletonNames = new Dictionary() { {"mixamorig:Spine1", "Chest"}, {"mixamorig:Head", "Head" }, {"mixamorig:Hips", "Hips" }, {"mixamorig:LeftHandIndex3", "Left Index Distal" }, {"mixamorig:LeftHandIndex2", "Left Index Intermediate" }, {"mixamorig:LeftHandIndex1", "Left Index Proximal" }, {"mixamorig:LeftHandPinky3", "Left Little Distal" }, {"mixamorig:LeftHandPinky2", "Left Little Intermediate" }, {"mixamorig:LeftHandPinky1", "Left Little Proximal" }, {"mixamorig:LeftHandMiddle3", "Left Middle Distal" }, {"mixamorig:LeftHandMiddle2", "Left Middle Intermediate" }, {"mixamorig:LeftHandMiddle1", "Left Middle Proximal" }, {"mixamorig:LeftHandRing3", "Left Ring Distal" }, {"mixamorig:LeftHandRing2", "Left Ring Intermediate" }, {"mixamorig:LeftHandRing1", "Left Ring Proximal" }, {"mixamorig:LeftHandThumb3", "Left Thumb Distal" }, {"mixamorig:LeftHandThumb2", "Left Thumb Intermediate" }, {"mixamorig:LeftHandThumb1", "Left Thumb Proximal" }, {"mixamorig:LeftFoot", "LeftFoot" }, {"mixamorig:LeftHand", "LeftHand" }, {"mixamorig:LeftForeArm", "LeftLowerArm" }, {"mixamorig:LeftLeg", "LeftLowerLeg" }, {"mixamorig:LeftShoulder", "LeftShoulder" }, {"mixamorig:LeftToeBase", "LeftToes" }, {"mixamorig:LeftArm", "LeftUpperArm" }, {"mixamorig:LeftUpLeg", "LeftUpperLeg" }, {"mixamorig:Neck", "Neck" }, {"mixamorig:RightHandIndex3", "Right Index Distal" }, {"mixamorig:RightHandIndex2", "Right Index Intermediate" }, {"mixamorig:RightHandIndex1", "Right Index Proximal" }, {"mixamorig:RightHandPinky3", "Right Little Distal" }, {"mixamorig:RightHandPinky2", "Right Little Intermediate" }, {"mixamorig:RightHandPinky1", "Right Little Proximal" }, {"mixamorig:RightHandMiddle3", "Right Middle Distal" }, {"mixamorig:RightHandMiddle2", "Right Middle Intermediate" }, {"mixamorig:RightHandMiddle1", "Right Middle Proximal" }, {"mixamorig:RightHandRing3", "Right Ring Distal" }, {"mixamorig:RightHandRing2", "Right Ring Intermediate" }, {"mixamorig:RightHandRing1", "Right Ring Proximal" }, {"mixamorig:RightHandThumb3", "Right Thumb Distal" }, {"mixamorig:RightHandThumb2", "Right Thumb Intermediate" }, {"mixamorig:RightHandThumb1", "Right Thumb Proximal" }, {"mixamorig:RightFoot", "RightFoot" }, {"mixamorig:RightHand", "RightHand" }, {"mixamorig:RightForeArm", "RightLowerArm" }, {"mixamorig:RightLeg", "RightLowerLeg" }, {"mixamorig:RightShoulder", "RightShoulder" }, {"mixamorig:RightToeBase", "RightToes" }, {"mixamorig:RightArm", "RightUpperArm" }, {"mixamorig:RightUpLeg", "RightUpperLeg" }, {"mixamorig:Spine", "Spine" }, {"mixamorig:Spine2", "UpperChest" }, // Other common Avatar formats can also be added here // { "root", "" }, { "hips", "Hips" }, { "spine", "Spine" }, { "chest", "Chest" }, { "upperChest", "UpperChest" }, { "neck", "Neck" }, { "head", "Head" }, { "leftEye", "LeftEye" }, // { "eyeL_end", "" }, { "rightEye", "RightEye" }, // { "eyeR_end", "" }, { "leftShoulder", "LeftShoulder" }, { "leftUpperArm", "LeftUpperArm" }, { "leftLowerArm", "LeftLowerArm" }, { "leftHand", "LeftHand" }, // { "leftThumbMetacarpal", "" }, // { "leftThumbProximal", "" }, // { "leftThumbDistal", "" }, // { "thumbdistalL_end", "" }, // { "leftIndexProximal", "" }, // { "leftIndexIntermediate", "" }, // { "leftIndexDistal", "" }, // { "indexdistalL_end", "" }, // { "leftMiddleProximal", "" }, // { "leftMiddleIntermediate", "" }, // { "leftMiddleDistal", "" }, // { "middledistalL_end", "" }, // { "leftRingProximal", "" }, // { "leftRingIntermediate", "" }, // { "leftRingDistal", "" }, // { "ringdistalL_end", "" }, // { "leftLittleProximal", "" }, // { "leftLittleIntermediate", "" }, // { "leftLittleDistal", "" }, // { "littledistalL_end", "" }, { "rightShoulder", "RightShoulder" }, { "rightUpperArm", "RightUpperArm" }, { "rightLowerArm", "RightLowerArm" }, { "rightHand", "RightHand" }, // { "rightThumbMetacarpal", "" }, // { "rightThumbProximal", "" }, // { "rightThumbDistal", "" }, // { "thumbdistalR_end", "" }, // { "rightIndexProximal", "" }, // { "rightIndexIntermediate", "" }, // { "rightIndexDistal", "" }, // { "indexdistalR_end", "" }, // { "rightMiddleProximal", "" }, // { "rightMiddleIntermediate", "" }, // { "rightMiddleDistal", "" }, // { "middledistalR_end", "" }, // { "rightRingProximal", "" }, // { "rightRingIntermediate", "" }, // { "rightRingDistal", "" }, // { "ringdistalR_end", "" }, // { "rightLittleProximal", "" }, // { "rightLittleIntermediate", "" }, // { "rightLittleDistal", "" }, // { "littledistalR_end", "" }, { "leftUpperLeg", "LeftUpperLeg" }, { "leftLowerLeg", "LeftLowerLeg" }, { "leftFoot", "LeftFoot" }, { "leftToes", "LeftToes" }, // { "toesL_end", "" }, { "rightUpperLeg", "RightUpperLeg" }, { "rightLowerLeg", "RightLowerLeg" }, { "rightFoot", "RightFoot" }, { "rightToes", "RightToes" }, // { "toesR_end", "" }, }; /// /// Create a HumanDescription out of an avatar GameObject. /// The HumanDescription is what is needed to create an Avatar object /// using the AvatarBuilder API. This function takes care of /// creating the HumanDescription by going through the avatar's /// hierarchy, defining its T-Pose in the skeleton, and defining /// the transform/bone mapping in the HumanBone array. /// /// Root of your avatar object /// A HumanDescription which can be fed to the AvatarBuilder API public static HumanDescription CreateHumanDescription(GameObject avatarRoot) { HumanDescription description = new HumanDescription() { armStretch = 0.05f, feetSpacing = 0f, hasTranslationDoF = false, legStretch = 0.05f, lowerArmTwist = 0.5f, lowerLegTwist = 0.5f, upperArmTwist = 0.5f, upperLegTwist = 0.5f, skeleton = CreateSkeleton(avatarRoot), human = CreateHuman(avatarRoot), }; return description; } //Create a SkeletonBone array out of an Avatar GameObject //This assumes that the Avatar as supplied is in a T-Pose //The local positions of its bones/joints are used to define this T-Pose private static SkeletonBone[] CreateSkeleton(GameObject avatarRoot) { List skeleton = new List(); Transform[] avatarTransforms = avatarRoot.GetComponentsInChildren(); foreach (Transform avatarTransform in avatarTransforms) { SkeletonBone bone = new SkeletonBone() { name = avatarTransform.name, position = avatarTransform.localPosition, rotation = avatarTransform.localRotation, scale = avatarTransform.localScale }; skeleton.Add(bone); } return skeleton.ToArray(); } //Create a HumanBone array out of an Avatar GameObject //This is where the various bones/joints get associated with the //joint names that Unity understands. This is done using the //static dictionary defined at the top. private static HumanBone[] CreateHuman(GameObject avatarRoot) { List human = new List(); Transform[] avatarTransforms = avatarRoot.GetComponentsInChildren(); foreach (Transform avatarTransform in avatarTransforms) { if (HumanSkeletonNames.TryGetValue(avatarTransform.name, out string humanName)) { HumanBone bone = new HumanBone { boneName = avatarTransform.name, humanName = humanName, limit = new HumanLimit() }; bone.limit.useDefaultValues = true; human.Add(bone); } } return human.ToArray(); } } }