StdMeshSkeleton Class Reference

#include <StdMesh.h>

Public Member Functions
	~StdMeshSkeleton ()
const StdMeshBone &	GetBone (size_t i) const
size_t	GetNumBones () const
const StdMeshBone *	GetBoneByName (const StdStrBuf &name) const
const StdMeshAnimation *	GetAnimationByName (const StdStrBuf &name) const
bool	IsAnimated () const
void	MirrorAnimation (const StdMeshAnimation &animation)
void	InsertAnimation (const StdMeshAnimation &animation)
void	InsertAnimation (const StdMeshSkeleton &source, const StdMeshAnimation &animation)
void	PostInit ()
std::vector< int >	GetMatchingBones (const StdMeshSkeleton &skeleton) const
std::vector< const StdMeshAnimation * >	GetAnimations () const

Friends
class	StdMeshSkeletonLoader
class	StdMeshXML
class	StdMesh
class	StdMeshAnimationUpdate

Detailed Description

Definition at line 105 of file StdMesh.h.

Constructor & Destructor Documentation

~StdMeshSkeleton()

StdMeshSkeleton::~StdMeshSkeleton

(

)

Definition at line 374 of file StdMesh.cpp.

{
    for (auto & Bone : Bones)
        delete Bone;
}

Member Function Documentation

GetAnimationByName()

const StdMeshAnimation * StdMeshSkeleton::GetAnimationByName

(

const StdStrBuf &

name

)

const

Definition at line 398 of file StdMesh.cpp.

{
    StdCopyStrBuf name2(name);
    std::map<StdCopyStrBuf, StdMeshAnimation>::const_iterator iter = Animations.find(name2);
    if (iter == Animations.end()) return nullptr;
    return &iter->second;
}

Referenced by StdMeshInstanceAnimationNode::CompileFunc(), and StdMeshInstance::PlayAnimation().

Here is the caller graph for this function:

GetAnimations()

std::vector< const StdMeshAnimation * > StdMeshSkeleton::GetAnimations

(

)

const

Definition at line 406 of file StdMesh.cpp.

{
    std::vector<const StdMeshAnimation*> result;
    result.reserve(Animations.size());
    for (const auto & Animation : Animations)
        result.push_back(&Animation.second);
    return result;
}

GetBone()

const StdMeshBone& StdMeshSkeleton::GetBone ( size_t  i ) const

inline

Definition at line 116 of file StdMesh.h.

{ return *Bones[i]; }

Referenced by StdMeshInstanceAnimationNode::CompileFunc(), GetMatchingBones(), MirrorAnimation(), StdMeshUpdate::StdMeshUpdate(), and StdMeshInstance::UpdateBoneTransforms().

Here is the caller graph for this function:

GetBoneByName()

const StdMeshBone * StdMeshSkeleton::GetBoneByName

(

const StdStrBuf &

name

)

const

Definition at line 388 of file StdMesh.cpp.

{
    // Lookup parent bone
    for (const auto & Bone : Bones)
        if (Bone->Name == name)
            return Bone;
 
    return nullptr;
}

Referenced by StdMeshInstance::AttachMeshImpl(), StdMeshInstanceAnimationNode::CompileFunc(), and MirrorAnimation().

Here is the caller graph for this function:

GetMatchingBones()

std::vector< int > StdMeshSkeleton::GetMatchingBones

(

const StdMeshSkeleton &

skeleton

)

const

Definition at line 521 of file StdMesh.cpp.

{
    std::vector<int> MatchedBoneInParentSkeleton;
 
    // find matching bones names in both skeletons
    for (unsigned int i = 0; i < child_skeleton.GetNumBones(); ++i)
    {
        int parent_bone_index = -1; // instantiate with invalid index == no match
 
        for (unsigned int j = 0; j < GetNumBones(); ++j)
        {
            // start searching at the same index
            int sample_index = (i + j) % GetNumBones();
 
            if (GetBone(sample_index).Name == child_skeleton.GetBone(i).Name)
            {
                parent_bone_index = sample_index;
                break;
            }
        }
 
        // add valid or invalid mapped index to list of mapped bones
        MatchedBoneInParentSkeleton.push_back(parent_bone_index);
    }
 
    return MatchedBoneInParentSkeleton;
}

References GetBone(), GetNumBones(), and StdMeshBone::Name.

Referenced by InsertAnimation().

Here is the call graph for this function:

Here is the caller graph for this function:

GetNumBones()

size_t StdMeshSkeleton::GetNumBones ( ) const

inline

Definition at line 117 of file StdMesh.h.

{ return Bones.size(); }

Referenced by GetMatchingBones(), InsertAnimation(), MirrorAnimation(), and StdMeshUpdate::Update().

Here is the caller graph for this function:

InsertAnimation() [1/2]

void StdMeshSkeleton::InsertAnimation

(

const StdMeshAnimation &

animation

)

Definition at line 473 of file StdMesh.cpp.

{
    assert(Animations.find(animation.Name) == Animations.end());
 
    Animations.insert(std::make_pair(animation.Name, animation));
}

References StdMeshAnimation::Name.

InsertAnimation() [2/2]

void StdMeshSkeleton::InsertAnimation	(	const StdMeshSkeleton &	source,
		const StdMeshAnimation &	animation
	)

Definition at line 480 of file StdMesh.cpp.

{
    assert(Animations.find(animation.Name) == Animations.end());
 
    // get matching bones from the source
    std::vector<int> bone_index_source = source.GetMatchingBones(*this);
 
    // create a new animation and copy the basic data from the other animation
    StdMeshAnimation anim;
    anim.Name = animation.Name;
    anim.Length = animation.Length;
    anim.Tracks.resize(GetNumBones());
    anim.OriginSkeleton = &source;
 
    // sort the tracks according to the matched bones
    for (unsigned int i = 0; i < anim.Tracks.size(); ++i)
    {
        if (bone_index_source[i] > -1 && animation.Tracks[bone_index_source[i]] != nullptr)
        {
            anim.Tracks[i] = new StdMeshTrack(*animation.Tracks[bone_index_source[i]]);
        }
    }
 
    // and add it to the map
    Animations.insert(std::make_pair(animation.Name, anim));
}

References GetMatchingBones(), GetNumBones(), StdMeshAnimation::Length, and StdMeshAnimation::Name.

Here is the call graph for this function:

IsAnimated()

bool StdMeshSkeleton::IsAnimated ( ) const

inline

Definition at line 121 of file StdMesh.h.

{ return !Animations.empty(); }

MirrorAnimation()

void StdMeshSkeleton::MirrorAnimation

(

const StdMeshAnimation &

animation

)

Definition at line 415 of file StdMesh.cpp.

{
    StdCopyStrBuf name(animation.Name);
 
    // do nothing if the name cannot be switched from *.L to *.R or vice versa
    // or if the animation already exists
    if (!MirrorName(name) || Animations.find(name) != Animations.end())
    {
        return;
    }
 
    StdMeshAnimation& new_anim = Animations.insert(std::make_pair(name, animation)).first->second;
    new_anim.Name = name;
 
    // Go through all bones
    for (unsigned int i = 0; i < GetNumBones(); ++i)
    {
        const StdMeshBone& bone = GetBone(i);
        StdCopyStrBuf other_bone_name(bone.Name);
        if (MirrorName(other_bone_name))
        {
            const StdMeshBone* other_bone = GetBoneByName(other_bone_name);
            if (!other_bone)
                throw std::runtime_error(std::string("No counterpart for bone ") + bone.Name.getData() + " found");
 
            // Make sure to not swap tracks twice
            if ((animation.Tracks[i] != nullptr || animation.Tracks[other_bone->Index] != nullptr) &&
                other_bone->Index > bone.Index)
            {
                std::swap(new_anim.Tracks[i], new_anim.Tracks[other_bone->Index]);
 
                StdMeshTransformation own_trans = bone.GetParent()->InverseTransformation * bone.Transformation;
                StdMeshTransformation other_own_trans = other_bone->GetParent()->InverseTransformation * other_bone->Transformation;
 
                // Mirror all the keyframes of both tracks
                if (new_anim.Tracks[i] != nullptr)
                    for (auto & Frame : new_anim.Tracks[i]->Frames)
                        MirrorKeyFrame(Frame.second, own_trans, StdMeshTransformation::Inverse(other_own_trans));
 
                if (new_anim.Tracks[other_bone->Index] != nullptr)
                    for (auto & Frame : new_anim.Tracks[other_bone->Index]->Frames)
                        MirrorKeyFrame(Frame.second, other_own_trans, StdMeshTransformation::Inverse(own_trans));
            }
        }
        else if (bone.Name.Compare_(".N", bone.Name.getLength() - 2) != 0)
        {
            if (new_anim.Tracks[i] != nullptr)
            {
                StdMeshTransformation own_trans = bone.Transformation;
                if (bone.GetParent()) own_trans = bone.GetParent()->InverseTransformation * bone.Transformation;
 
                for (auto & Frame : new_anim.Tracks[i]->Frames)
                    MirrorKeyFrame(Frame.second, own_trans, StdMeshTransformation::Inverse(own_trans));
            }
        }
    }
}

References StdStrBuf::Compare_(), GetBone(), GetBoneByName(), StdStrBuf::getData(), StdStrBuf::getLength(), GetNumBones(), StdMeshBone::GetParent(), StdMeshBone::Index, StdMeshTransformation::Inverse(), StdMeshBone::InverseTransformation, StdMeshBone::Name, StdMeshAnimation::Name, and StdMeshBone::Transformation.

Referenced by PostInit().

Here is the call graph for this function:

Here is the caller graph for this function:

PostInit()

void StdMeshSkeleton::PostInit

(

)

Definition at line 507 of file StdMesh.cpp.

{
    // Mirror .R and .L animations without counterpart
    for (auto & Animation : Animations)
    {
        // For debugging purposes:
        //      if(iter->second.Name == "Jump")
        //          MirrorAnimation(StdCopyStrBuf("Jump.Mirror"), iter->second);
 
        // mirrors only if necessary
        MirrorAnimation(Animation.second);
    }
}

References MirrorAnimation().

Here is the call graph for this function:

Friends And Related Function Documentation

StdMesh

friend class StdMesh

friend

Definition at line 109 of file StdMesh.h.

StdMeshAnimationUpdate

friend class StdMeshAnimationUpdate

friend

Definition at line 110 of file StdMesh.h.

StdMeshSkeletonLoader

friend class StdMeshSkeletonLoader

friend

Definition at line 107 of file StdMesh.h.

StdMeshXML

friend class StdMeshXML

friend

Definition at line 108 of file StdMesh.h.

---

The documentation for this class was generated from the following files:

• StdMesh.h
• StdMesh.cpp