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

Chapter 9 - Camera Objects / Camera Objects Reference

Camera Objects Routines / Managing Cameras

Q3Camera_GetWorldToView

You can use the Q3Camera_GetWorldToView function to get the current world-to-view space transform.

TQ3Status Q3Camera_GetWorldToView (
TQ3CameraObject camera, 
TQ3Matrix4x4 *worldToView);

camera

A camera object.

worldToView

On output, a pointer to a 4-by-4 matrix.

DESCRIPTION

The Q3Camera_GetWorldToView function returns, in the worldToView parameter, a pointer to a 4-by-4 matrix that describes the current world-to-view space transform defined by the camera specified by the camera parameter. The world-to-view space transform is defined only by the placement of the camera; it establishes the camera location as the origin of the view space, with the view vector (that is, the vector from the camera's eye toward the point of interest) placed along the -z axis and the up vector placed along the y axis.