Inside Macintosh: Apple Game Sprockets Guide /

Chapter 1 - SoundSprocket / SoundSprocket Reference

SoundSprocket Functions / Creating and Managing 3D Sound Sources

SSpSource_GetCameraPlacement

You can use the SSpSource_GetCameraPlacement function to get the position, orientation, and up vector of a sound source.

OSStatus SSpSource_GetCameraPlacement (
SSpSourceReference inSourceReference,
TQ3CameraPlacement *outCameraPlacement);

inSourceReference

A source 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 sound source.

function result

A result code.

DESCRIPTION

The SSpSource_GetCameraPlacement function updates the camera placement structure pointed to by the outCameraPlacement parameter to indicate the position, orientation, and up vector of the sound source specified by the inSourceReference parameter. (The point of interest of the camera placement is the sound source'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 SSpSource_GetCameraPlacement, you could call SSpSource_GetPosition, SSpSource_GetOrientation, and SSpSource_GetUpVector.