Inside Macintosh: Apple Game Sprockets Guide /

Chapter 1 - SoundSprocket / SoundSprocket Reference

SoundSprocket Functions / Creating and Managing 3D Sound Sources

SSpSource_SetAngularAttenuation

You can use the SSpSource_SetAngularAttenuation function to set the angular attenuation of a sound source.

OSStatus SSpSource_SetAngularAttenuation (
SSpSourceReference inSourceReference,
float inConeAngle,
float inConeAttenuation);

inSourceReference

A source reference.

inConeAngle

The angle, in radians, at the apex of the angular attenuation cone. This angle should be between 0 and 2p.

inConeAttenuation

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

function result

A result code.

DESCRIPTION

The SSpSource_SetAngularAttenuation function sets the angle at the apex of the angular attenuation cone and the amount of attenuation for the sound source specified by the inSourceReference parameter to the values specified in the inConeAngle and inConeAttenuation parameters. The default settings provide no attenuation in any direction (that is, inConeAngle is 2p and inConeAttenuation is 0.0).