Inside Macintosh: Apple Game Sprockets Guide /

Chapter 1 - SoundSprocket / SoundSprocket Reference

SoundSprocket Functions / Creating and Managing 3D Sound Sources

SSpSource_GetAngularAttenuation

You can use the SSpSource_GetAngularAttenuation function to get the angular attenuation of a sound source.

OSStatus SSpSource_GetAngularAttenuation (
SSpSourceReference inSourceReference,
float *outConeAngle,
float *outConeAttenuation);

inSourceReference

A source reference.

outConeAngle

On exit, the angle, in radians, at the apex of the angular attenuation cone. This angle is between 0 and 2p.

outConeAttenuation

On exit, the amount of attenuation, in decibels (dB), that occurs outside the angular attenuation cone.

function result

A result code.

DESCRIPTION

The SSpSource_GetAngularAttenuation function returns, in the outConeAngle and outConeAttenuation parameters, the angle at the apex of the angular attenuation cone and the amount of attenuation that occurs outside that cone.