Audio emitter roll-off (requires warning log)

[3risian]

Description

STK track creation lists a roll-off feature to allow sounds to gradually lose volume when you are further away from them. This appears to not work at all.

Steps to reproduce

Run any track with an audio emitter, and slowly approach the sound emitter. It should fade in as you drive closer, instead it immediately plays full volume. Modifying the roll-off rate in the scene.xml file makes no difference.

Example track: testrolloffparticles.zip

Configuration

STK release version:
1.4

[qwertychouskie]

Roll-off (and positional audio in general) requires that the source sound file be mono, stereo sources will cause the described behavior.

[3risian]

Confirmed that making the audio file mono will enable roll-off. Thanks!
I understand why a stereo positional sound is strange, although I still think this issue should remain open do discuss if the way the engine handles it is appropriate (I'd propose playing no sound and giving a console error, instead of quietly failing positional/roll-off) and adding this to documentation (and the Blender export tools tooltips) so new artists aren't confused like I was. (edit: it's briefly mentioned on the SFX Guidelines page, but not the Special Effects page that discusses the sound emitter options)

I can draft and commit the documentation changes in the other repos, thoughts on the engine handling would be appreciated.

[qwertychouskie]

I believe it's an OpenAL limitation, though a warning message in the terminal would probably be a good idea.

[Alayan-stk-2]

The game will now print in the console an error message such as:

[error ] SFXBuffer: Positional audio is not supported with stereo files, but path/to/audio.ogg is stereo