Inside Macintosh: Apple Game Sprockets Guide /

Chapter 1 - SoundSprocket / SoundSprocket Reference

SoundSprocket Functions / Creating and Managing Listeners

SSpListener_SetUpVector

You can use the SSpListener_SetUpVector function to set the up vector of a listener.

OSStatus SSpListener_SetUpVector (
SSpListenerReference inListenerReference,
const TQ3Vector3D *inUpVector);

inListenerReference

A listener reference.

inUpVector

The desired untransformed up vector of the listener. This up vector should be a unit vector.

function result

A result code.

DESCRIPTION

The SSpListener_SetUpVector function sets the up vector of the listener specified by the inListenerReference parameter to the vector specified by the inUpVector parameter. The inUpVector parameter specifies the untransformed up vector of the listener (that is, the up vector of the listener before the listener's transform is applied). The actual up vector of the listener is calculated at the time you call the SSpSource_CalcLocalization function. The default up vector of a listener is the unit y vector (0, 1, 0).

Note

When you call SSpSource_CalcLocalization, the listener's orientation and up vectors should not be parallel.