Inside Macintosh: Apple Game Sprockets Guide /

Chapter 1 - SoundSprocket / SoundSprocket Reference

SoundSprocket Functions / Creating and Managing Listeners

SSpListener_GetReverb

You can use the SSpListener_GetReverb function to get the current reverberation model of a listener.

OSStatus SSpListener_GetReverb (
SSpListenerReference inListenerReference,
float *outRoomSize,
float *outRoomReflectivity,
float *outReverbAttenuation);

inListenerReference

A listener reference.

outRoomSize

On exit, the current room size of the listener. Room size is the distance, in listener units, between two reverberant walls spaced equidistant from the listener. A room size of 0.0 indicates no reverberation.

outRoomReflectivity

On exit, the current room reflectivity attenuation.

outReverbAttenuation

On exit, the current reverberation attenuation.

function result

A result code.

DESCRIPTION

The SSpListener_GetReverb function returns, in the outRoomSize, outRoomReflectivity, and outReverbAttenuation parameters, the current room size, room reflectivity, and reverberation attenuation of the listener specified by the inListenerReference parameter. By default, there is no reverberation.