Oldest known version of this page was edited on 2007-01-04 22:41:19 by DintHer []

Reference Manual - TGLSMBASS

Given the position of the listener (eg the camera) TGLSMBass will emit a sound based upon a Source object TGLBaseSoundSource or via sound emitters (TGLBSoundEmitter) in the scene. Emitters are added to the behaviour property of a GLScene object. The sound emitted is in stereo and if a sound emitter is a long way from the camera it will not be as loud an emitter close to the camera. Also if a sound emitter is left of the camera it will sound as though it is to your left. The loudness and stereo position of the emitter is calculated in the onProgress handler of the TGLCadencer property.


Important TGLSMBass properties include:
listener : TGLBaseSceneObject
The object that is listening for sound. Usually it is set as the camera so that the sound is in relation to the viewer.
cadencer : TGLCadencer
The sound from the emitters is calculated in the onprogress handler of the cadencer therefore a cadencer must be specified.
DistanceFactor: The distance factor... 0 or less = leave current... examples: 1.0 = use meters, 0.9144 = use yards, 0.3048 = use feet. By default BASS measures distances in meters, you can change this setting if you are using a different unit of measurement.
RollOffFactor: The rolloff factor, how fast the sound quietens with distance... 0.0 (min) - 10.0 (max), less than 0.0 = leave current... examples: 0.0 = no rolloff, 1.0 = real world, 2.0 = 2x real.
DopplerFactor: The doppler factor... 0.0 (min) - 10.0 (max), less than 0.0 = leave current... examples: 0.0 = no doppler, 1.0 = real world, 2.0 = 2x real. The doppler effect is the way a sound appears to change pitch when it is moving towards or away from you. The listener and sound velocity settings are used to calculate this effect, this DopplerFactor value can be used to lessen or exaggerate the effect.
UpdateFrequency: Specified how many times per second the 3D information for sound generation is updated. This timing is supplied by the TGLCadencer connected to this component. Reduce the frequency for a lesser load on the CPU.




Demo: CVS/Demos/sound/3Dsound∞

Unit: GLSMBASS∞

Descends from TGLSoundManager.