Bone Utilities

Functions
USDSKELIMAGING_API bool	UsdSkelImagingComputeBoneTopology (const UsdSkelTopology &skelTopology, HdMeshTopology *meshTopology, size_t *numPoints)
USDSKELIMAGING_API bool	UsdSkelImagingComputeBonePoints (const UsdSkelTopology &topology, const VtMatrix4dArray &jointSkelXforms, size_t numPoints, VtVec3fArray *points)
USDSKELIMAGING_API bool	UsdSkelImagingComputeBonePoints (const UsdSkelTopology &topology, const GfMatrix4d *jointSkelXforms, GfVec3f *points, size_t numPoints)
USDSKELIMAGING_API bool	UsdSkelImagingComputeBoneJointIndices (const UsdSkelTopology &topology, VtIntArray *jointIndices, size_t numPoints)
USDSKELIMAGING_API bool	UsdSkelImagingComputeBoneJointIndices (const UsdSkelTopology &topology, int *jointIndices, size_t numPoints)
USDSKELIMAGING_API void	UsdSkelImagingComputePointsForSingleBone (const GfMatrix4d &xform, const GfMatrix4d &parentXform, GfVec3f *points)

Detailed Description

Utilities for constructing bone meshes.

Function Documentation

USDSKELIMAGING_API bool UsdSkelImagingComputeBoneJointIndices	(	const UsdSkelTopology &	topology,
		VtIntArray *	jointIndices,
		size_t	numPoints
	)

Compute joint indices corresponding to each point in a bone mesh. This can be used to animate a bone mesh using normal skinning algos. This does not compute joint weights (they would all be 1s). The numPoints corresponds to the number of points computed by UsdSkelImagingComputeBoneTopology.

USDSKELIMAGING_API bool UsdSkelImagingComputeBoneJointIndices	(	const UsdSkelTopology &	topology,
		int *	jointIndices,
		size_t	numPoints
	)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

USDSKELIMAGING_API bool UsdSkelImagingComputeBonePoints	(	const UsdSkelTopology &	topology,
		const VtMatrix4dArray &	jointSkelXforms,
		size_t	numPoints,
		VtVec3fArray *	points
	)

Compute mesh points for imaging a skeleton, given the topology of the skeleton and skelXforms. The numPoints corresponds to the number of points computed by UsdSkelImagingComputeBoneTopology.

USDSKELIMAGING_API bool UsdSkelImagingComputeBonePoints	(	const UsdSkelTopology &	topology,
		const GfMatrix4d *	jointSkelXforms,
		GfVec3f *	points,
		size_t	numPoints
	)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts.

USDSKELIMAGING_API bool UsdSkelImagingComputeBoneTopology	(	const UsdSkelTopology &	skelTopology,
		HdMeshTopology *	meshTopology,
		size_t *	numPoints
	)

Compute mesh topology for imaging skelTopology. The number of points that the mesh is expected to have are return in numPoints.

USDSKELIMAGING_API void UsdSkelImagingComputePointsForSingleBone	(	const GfMatrix4d &	xform,
		const GfMatrix4d &	parentXform,
		GfVec3f *	points
	)

Compute mesh points for imaging a single bone of a skeleton.

A bone corresponds to a joint that has a parent joint. The input to this function is the transform of that joint and parent joint.