Inside Macintosh: Apple Game Sprockets Guide /

Chapter 1 - SoundSprocket / SoundSprocket Reference

SoundSprocket Functions / Creating and Managing 3D Sound Sources

SSpSource_SetCameraPlacement

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

OSStatus SSpSource_SetCameraPlacement (
SSpSourceReference inSourceReference,
const TQ3CameraPlacement *inCameraPlacement);

inSourceReference

A source reference.

inCameraPlacement

A pointer to a camera placement structure that specifies the desired position, orientation, and up vector of the sound source.

function result

A result code.

DESCRIPTION

The SSpSource_SetCameraPlacement function sets the position, orientation, and up vector of the sound source specified by the inSourceReference parameter to the values contained in the camera placement structure pointed to by the inCameraPlacement parameter. This function is provided as a convenient method for setting 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_SetCameraPlacement, you could call SSpSource_SetPosition, SSpSource_SetOrientation, and SSpSource_SetUpVector.