Inside Macintosh: Apple Game Sprockets Guide /

Chapter 1 - SoundSprocket / SoundSprocket Reference

SoundSprocket Functions / Creating and Managing Listeners

SSpListener_SetReverb

You can use the SSpListener_SetReverb function to set the reverberation model of a listener.

OSStatus SSpListener_SetReverb (
SSpListenerReference inListenerReference,
float inRoomSize,
float inRoomReflectivity,
float inReverbAttenuation);

inListenerReference

A listener reference.

inRoomSize

The desired 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.

inRoomReflectivity

The desired room reflectivity attenuation.

inReverbAttenuation

The desired reverberation attenuation.

function result

A result code.

DESCRIPTION

The SSpListener_SetReverb function sets the room size, room reflectivity, and reverberation attenuation of the listener specified by the inListenerReference parameter to the values specified in the inRoomSize, inRoomReflectivity, and inReverbAttenuation parameters. The inRoomReflectivity and inReverbAttenuation parameters are used only when inRoomSize is nonzero. If inRoomSize is 0, you should set inRoomReflectivity and inReverbAttenuation to 0 as well.