Model.CopyAbsoluteBoneTransformsTo Method

Copies a transform of each bone in a model relative to all parent bones of the bone into a given array.

Syntax

'Declaration
Public Sub CopyAbsoluteBoneTransformsTo ( _
         destinationBoneTransforms As Matrix() _
)
public void CopyAbsoluteBoneTransformsTo (
         Matrix[] destinationBoneTransforms
)
public:
void CopyAbsoluteBoneTransformsTo(
         Matrix destinationBoneTransforms[]
)

Parameters

  • destinationBoneTransforms
    Type: Matrix
    The array to receive bone transforms.

Exceptions

Exception type Condition
ArgumentNullException destinationBoneTransforms is null.
ArgumentOutOfRangeException destinationBoneTransforms is not the same size as Bones

Remarks

In an absolute transform, each bone is transformed according to the position of all parent bones.

This is the same as iterating the Bones collection and applying the transformation matrix of every parent of a ModelBone to the Transform property of each ModelBone and copying the results into an array that can be indexed into by the bone index.

An array of transformation matrices for the meshes of any model can be obtained by calling CopyAbsoluteBoneTransformsTo or CopyBoneTransformsTo. The resulting array contains the transforms that describe how each ModelMesh is located relative to one another in the Model. The transformation matrix that should be applied to each ModelMesh can be obtained using the index of the CopyAbsoluteBoneTransformsTo to retrieve a transformation matrix from this collection.

Requirements

Namespace: Microsoft.Xna.Framework.Graphics

Assembly: Microsoft.Xna.Framework.Graphics (in microsoft.xna.framework.graphics.dll)

See Also

Reference

Model Class
Model Members
Microsoft.Xna.Framework.Graphics Namespace

Platforms

Windows Phone