Q3Matrix4x4_SetRotateVectorToVector (IM: QD3D)

Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 20 - QuickDraw 3D Mathematical Utilities / QuickDraw 3D Mathematical Utilities Reference

QuickDraw 3D Mathematical Utilities / Setting Up Transformation Matrices

Q3Matrix4x4_SetRotateVectorToVector
You can use the Q3Matrix4x4_SetRotateVectorToVector function to configure a 4-by-4 transformation matrix that rotates objects around the origin in such a way that a transformed vector matches a given vector.
TQ3Matrix4x4 *Q3Matrix4x4_SetRotateVectorToVector (
TQ3Matrix4x4 *matrix4x4, 
const TQ3Vector3D *v1, 
const TQ3Vector3D *v2);
matrix4x4
A 4-by-4 matrix.
v1
A three-dimensional vector.
v2
A three-dimensional vector.

DESCRIPTION
The Q3Matrix4x4_SetRotateVectorToVector function returns, as its function result and in the matrix4x4 parameter, a rotational matrix that rotates objects around the origin in such a way that the transformed vector v1 matches the vector v2. Both v1 and v2 should be normalized.