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

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

QuickDraw 3D Mathematical Utilities / Managing Quaternions

Q3Quaternion_SetRotateAboutAxis

You can use the Q3Quaternion_SetRotateAboutAxis function to configure a rotate-about-axis quaternion.

TQ3Quaternion *Q3Quaternion_SetRotateAboutAxis (
TQ3Quaternion *quaternion, 
const TQ3Vector3D *axis, 
float angle);

quaternion

A quaternion.

axis

The desired axis of rotation.

angle

The desired angle of rotation, in radians.

DESCRIPTION

The Q3Quaternion_SetRotateAboutAxis function returns, as its function result and in the quaternion parameter, a rotate-about-axis quaternion that rotates an object by the angle angle around the axis specified by the axis parameter.