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