Bone Utilities

Utilities for constructing bone meshes. More...

Functions
USDSKELIMAGING_API bool	UsdSkelImagingComputeBoneTopology (const UsdSkelTopology &skelTopology, HdMeshTopology *meshTopology, size_t *numPoints)
	Compute mesh topology for imaging skelTopology.
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.
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	UsdSkelImagingComputeBoneJointIndices (const UsdSkelTopology &topology, VtIntArray *jointIndices, size_t numPoints)
	Compute joint indices corresponding to each point in a bone mesh.
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 void	UsdSkelImagingComputePointsForSingleBone (const GfMatrix4d &xform, const GfMatrix4d &parentXform, GfVec3f *points)
	Compute mesh points for imaging a single bone of a skeleton.

Detailed Description

Utilities for constructing bone meshes.

Function Documentation

UsdSkelImagingComputeBoneJointIndices() [1/2]

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.

UsdSkelImagingComputeBoneJointIndices() [2/2]

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.

UsdSkelImagingComputeBonePoints() [1/2]

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.

UsdSkelImagingComputeBonePoints() [2/2]

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.

UsdSkelImagingComputeBoneTopology()

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.

UsdSkelImagingComputePointsForSingleBone()

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.