Inside Macintosh: Apple Game Sprockets Guide /

Chapter 1 - SoundSprocket / SoundSprocket Reference

SoundSprocket Functions / Creating and Managing Listeners

SSpListener_GetCameraPlacement

You can use the SSpListener_GetCameraPlacement function to get the position, orientation, and up vector of a listener.

OSStatus SSpListener_GetCameraPlacement (
SSpListenerReference inListenerReference,
TQ3CameraPlacement *outCameraPlacement);

inListenerReference

A listener reference.

outCameraPlacement

On entry, a pointer to a camera placement structure. On exit, that structure is updated to specify the position, orientation, and up vector of the listener.

function result

A result code.

DESCRIPTION

The SSpListener_GetCameraPlacement function updates the camera placement structure pointed to by the outCameraPlacement parameter to indicate the position, orientation, and up vector of the listener specified by the inListenerReference parameter. (The point of interest of the camera placement is the listener's position plus its orientation vector.) This function is provided as a convenient method for getting that information in a single function call.

Note

The TQ3CameraPlacement data type is defined by QuickDraw 3D. See 3D Graphics Programming With QuickDraw 3D for details.

SEE ALSO

Instead of calling SSpListener_GetCameraPlacement, you could call SSpListener_GetPosition, SSpListener_GetOrientation, and SSpListener_GetUpVector.