Retrieves location of the specified joint in model-space. The location is in the runtime pose, not the default pose. To get the location in the default pose, retrieve it from ICharacterInstance::GetIDefaultSkeleton.

This function is safe to call while the animation job is running; if you do so it will simply return the previous frame's data. New data is returned only after the job has been synchronized (ICharacterInstance::FinishAnimationComputations has been called, or we are in the PostProcess callback).

Parameters

nJointID.

Behavior is undefined when the nJointID is invalid.

Returns

Model-space location of the specified joint.

See also

ISkeletonPose::SetPostProcessCallback

ISkeletonPose::GetRelJointByID

ICharacterInstance::FinishAnimationComputations

#include 

// Basic example of how the absolute joint orientation can be retrieved from a character's current pose
void GetJointOrientation(ICharacterInstance& character)
{
    // Get the default skeleton, a read-only construct in which we can get joint identifiers from names
    const IDefaultSkeleton& defaultSkeleton = character.GetIDefaultSkeleton();
    // Get the internal identifier of our joint, labeled in the DCC (Max / Maya for example)
    const int32 jointId = defaultSkeleton.GetJointIDByName("Bip 01 Head");

    // Get the orientation of the joint in world coordinates
    const QuatT& jointOrientation = character.GetISkeletonPose()->GetAbsJointByID(jointId);
    // jointOrientation.q contains a quaternion with the world-space rotation of the joint
    const Quat& jointRotation = jointOrientation.q;
    // jointOrientation.t contains a vector with the world-space position of the joint
    const Vec3& jointPosition = jointOrientation.t;
}

Gets the pose modifier used to target gun aiming at a specific world coordinate

Example (Aim-IK)

#include

// Example for how to make the character aim at a specific position

void SetAimInverseKinematicsTarget(ICharacterInstance& character, const Vec3& targetWorldPosition)

{

// Query the pose blender aim interface

if (IAnimationPoseBlenderDir* pPoseBlenderAim = character.GetISkeletonPose()->GetIPoseBlenderAim())

{

// Enable the Aim-IK

pPoseBlenderAim->SetState(true);

// Make Aim-IK operate on the second animation layer

pPoseBlenderAim->SetLayer(1);

// Indicate the position we want to aim at

pPoseBlenderAim->SetTarget(targetWorldPosition);

}

}

Gets the pose modifier used to target gun aiming at a specific world coordinate

Example (Aim-IK)

#include

// Example for how to make the character aim at a specific position

void SetAimInverseKinematicsTarget(ICharacterInstance& character, const Vec3& targetWorldPosition)

{

// Query the pose blender aim interface

if (IAnimationPoseBlenderDir* pPoseBlenderAim = character.GetISkeletonPose()->GetIPoseBlenderAim())

{

// Enable the Aim-IK

pPoseBlenderAim->SetState(true);

// Make Aim-IK operate on the second animation layer

pPoseBlenderAim->SetLayer(1);

// Indicate the position we want to aim at

pPoseBlenderAim->SetTarget(targetWorldPosition);

}

}

Gets the pose modifier used to target look aim at a specific world coordinate

Example (Look-IK)

#include

// Example for how to make the character look at a specific position

void SetLookInverseKinematicsTarget(ICharacterInstance& character, const Vec3& targetWorldPosition)

{

// Query the pose blender look interface

if (IAnimationPoseBlenderDir* pPoseBlenderLook = character.GetISkeletonPose()->GetIPoseBlenderLook())

{

// Enable the Look-IK

pPoseBlenderLook->SetState(true);

// Make Look-IK operate on the second animation layer

pPoseBlenderLook->SetLayer(1);

// Indicate the position we want to look at

pPoseBlenderLook->SetTarget(targetWorldPosition);

}

}

Gets the pose modifier used to target look aim at a specific world coordinate

Example (Look-IK)

#include

// Example for how to make the character look at a specific position

void SetLookInverseKinematicsTarget(ICharacterInstance& character, const Vec3& targetWorldPosition)

{

// Query the pose blender look interface

if (IAnimationPoseBlenderDir* pPoseBlenderLook = character.GetISkeletonPose()->GetIPoseBlenderLook())

{

// Enable the Look-IK

pPoseBlenderLook->SetState(true);

// Make Look-IK operate on the second animation layer

pPoseBlenderLook->SetLayer(1);

// Indicate the position we want to look at

pPoseBlenderLook->SetTarget(targetWorldPosition);

}

}

Retrieves location of the specified joint in parent-joint space. The location is in the runtime pose, not the default pose. To get the location in the default pose, retrieve it from ICharacterInstance::GetIDefaultSkeleton.

This function is safe to call while the animation job is running; if you do so it will simply return the previous frame's data. New data is returned only after the job has been synchronized (ICharacterInstance::FinishAnimationComputations has been called, or we are in the PostProcess callback).

Parameters

nJointID.

Behavior is undefined when the nJointID is invalid.

Returns

Parent-joint space location of the specified joint.

See also

ISkeletonPose::SetPostProcessCallback

ISkeletonPose::GetAbsJointByID

ICharacterInstance::FinishAnimationComputations

Force updates of the skeleton pose (even when invisible). Note that this is not recommended. If possible use CA_FORCE_SKELETON_UPDATE when starting animations that need an update.

Parameters

numFrames

Number of frames to force the update. Use ISkeletonPose::kForceSkeletonUpdatesInfinitely to force it on all the time.

See also

CA_FORCE_SKELETON_UPDATE