Inside Macintosh: Apple Game Sprockets Guide /

Chapter 1 - SoundSprocket / SoundSprocket Reference

SoundSprocket Functions / Creating and Managing Listeners

SSpListener_GetMetersPerUnit

You can use the SSpListener_GetMetersPerUnit function to get the number of meters in one listener unit.

OSStatus SSpListener_GetMetersPerUnit (
SSpListenerReference inListenerReference,
float *outMetersPerUnit);

inListenerReference

A listener reference.

outMetersPerUnit

On exit, the number of meters in the listener unit of the specified listener.

function result

A result code.

DESCRIPTION

The SSpListener_GetMetersPerUnit function returns, in the outMetersPerUnit parameter, the number of meters in the listener unit associated with the listener specified by the inListenerReference parameter. The default listener unit is one meter--that is, all units passed to SoundSprocket functions are interpreted as meters.