audio_emitter_falloff

使用此函数,可以设置发射器的衰减距离。这是从发射器listener到声音"下降"到0的音量之前的距离。其默认值为100,但注意将此值设置为低于1的任何值,因为这会使通过此发射器播放的任何声音对listener是听不到的,但是任何其他值将导致声音越远离listener,声音就会逐渐减弱。

如何听到声音本身将取决于衰减参考(即源音量通常下降一半的距离)和滚降因子(仅影响经过衰减参考距离的声音)。默认因子通常为1,不同衰减值的影响将取决于所选模型。

有关不同衰减模型的完整指南以及如何使用这些值,请参阅函数audio_falloff_set_model()

 

语法:

audio_emitter_falloff(emitter, falloff_ref, falloff_max, falloff_factor);

参数类型描述
emitterAudio Emitter ID要更改的发射器的索引。
falloff_refReal相对于侦听器(clamp)的衰减引用。
falloff_maxReal相对于侦听器的最大衰减距离。
falloff_factorReal衰减因子(默认值为1)。

 

返回:

N/A

 

例子:

s_emit = audio_emitter_create();
audio_emitter_position(s_emit, x, y, 0);
audio_emitter_falloff(s_emit, 100, 300, 1);

上面的代码创建了一个音频发射器,并将其索引分配给变量" s_emit "。然后,将该发射器放置在创建它的实例的位置,并为其提供300的衰减距离,这意味着当发射器距离侦听器位置超过300像素时,它将处于静默状态。其"衰减因子"(Falloff Factor)为默认值1,"衰减参考"(Falloff Reference)为100,因此衰减将在距离侦听器100像素处开始。