FmodReverbZone3D#
场景树中的 3D 混响区域节点
描述#
FmodReverbZone3D 是 FmodReverb3D 的节点封装。节点进入场景树后会创建内部混响对象，并使用节点的全局位置作为球形混响区域中心。启用 sync_transform 时，节点移动会同步到 FMOD 混响区域。 （参见 min_distance ） （参见 max_distance ）
属性#
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
方法#
枚举#
enum Preset:
Preset PRESET_CUSTOM = 0
自定义参数
Preset PRESET_OFF = 1
关闭混响
Preset PRESET_GENERIC = 2
通用混响
Preset PRESET_PADDED_CELL = 3
软包小房间
Preset PRESET_ROOM = 4
普通房间
Preset PRESET_BATHROOM = 5
浴室
Preset PRESET_LIVING_ROOM = 6
客厅
Preset PRESET_STONE_ROOM = 7
石室
Preset PRESET_AUDITORIUM = 8
礼堂
Preset PRESET_CONCERT_HALL = 9
音乐厅
Preset PRESET_CAVE = 10
洞穴
Preset PRESET_ARENA = 11
竞技场
Preset PRESET_HANGAR = 12
机库
Preset PRESET_HALLWAY = 13
走廊
Preset PRESET_STONE_CORRIDOR = 14
石质走廊
Preset PRESET_ALLEY = 15
小巷
Preset PRESET_FOREST = 16
森林
Preset PRESET_CITY = 17
城市
Preset PRESET_MOUNTAINS = 18
山地
Preset PRESET_UNDERWATER = 19
水下
属性说明#
bool active = true
该混响区域是否参与输出
bool sync_transform = true
是否每帧同步节点位置到内部混响对象
float min_distance = 5.0
完整混响半径
float max_distance = 20.0
混响淡出结束半径
Preset preset = 2
混响预设；手动修改参数后会切换为 PRESET_CUSTOM
float decay_time = 1500.0
混响衰减时间，单位为毫秒
float early_delay = 7.0
早期反射延迟，单位为毫秒
float late_delay = 11.0
后期混响延迟，单位为毫秒
float hf_reference = 5000.0
高频参考频率，单位为 Hz
float hf_decay_ratio = 83.0
高频衰减比例
float diffusion = 100.0
扩散度
float density = 100.0
密度
float low_shelf_frequency = 250.0
低频搁架参考频率
float low_shelf_gain = 0.0
低频搁架增益
float high_cut = 14500.0
高频截止频率
float early_late_mix = 96.0
早期/后期混响混合比例
float wet_level = -8.0
混响湿声电平，单位为分贝
方法说明#
void set_active(active: bool)
Sets active.
bool get_active() const
Returns active.
void set_sync_transform(sync: bool)
Sets sync_transform.
bool get_sync_transform() const
Returns sync_transform.
void set_min_distance(distance: float)
Sets min_distance.
float get_min_distance() const
Returns min_distance.
void set_max_distance(distance: float)
Sets max_distance.
float get_max_distance() const
Returns max_distance.
void set_preset(preset: Preset)
Sets preset.
Preset get_preset() const
Returns preset.
void set_decay_time(value: float)
Sets decay_time.
float get_decay_time() const
Returns decay_time.
void set_early_delay(value: float)
Sets early_delay.
float get_early_delay() const
Returns early_delay.
void set_late_delay(value: float)
Sets late_delay.
float get_late_delay() const
Returns late_delay.
void set_hf_reference(value: float)
Sets hf_reference.
float get_hf_reference() const
Returns hf_reference.
void set_hf_decay_ratio(value: float)
Sets hf_decay_ratio.
float get_hf_decay_ratio() const
Returns hf_decay_ratio.
void set_diffusion(value: float)
Sets diffusion.
float get_diffusion() const
Returns diffusion.
void set_density(value: float)
Sets density.
float get_density() const
Returns density.
void set_low_shelf_frequency(value: float)
Sets low_shelf_frequency.
float get_low_shelf_frequency() const
Returns low_shelf_frequency.
void set_low_shelf_gain(value: float)
Sets low_shelf_gain.
float get_low_shelf_gain() const
Returns low_shelf_gain.
void set_high_cut(value: float)
Sets high_cut.
float get_high_cut() const
Returns high_cut.
void set_early_late_mix(value: float)
Sets early_late_mix.
float get_early_late_mix() const
Returns early_late_mix.
void set_wet_level(value: float)
Sets wet_level.
float get_wet_level() const
Returns wet_level.
FmodReverb3D get_reverb() const
返回该节点内部创建并管理的 FmodReverb3D 。如果节点尚未进入场景树或创建失败，则返回 null 。