FogVolume

继承： VisualInstance3D < Node3D < Node < Object

影响世界环境中默认体积雾的区块。

描述

FogVolume 用于将局部雾添加到全局体积雾效果中。如果使用具有负 FogMaterial.density 的 FogMaterial，FogVolume 也可以从特定区域移除体积雾。

FogVolume 的性能与它在屏幕上的相对大小以及它所附加的 FogMaterial 的复杂性直接相关。最好尽可能保持 FogVolume 相对较小且简单。

注意：**FogVolume 只有在 Environment.volumetric_fog_enabled 为 true 时才会有可见效果。如果不希望雾全局可见（而只是在 FogVolume** 节点内），请将 Environment.volumetric_fog_density 设置为 0.0。

教程

• 体积雾及规模

属性

属性说明

Material material 🔗

• void set_material(value: Material)

• Material get_material()

FogVolume 使用的 Material。可以是一个内置的 FogMaterial 或一个自定义的 ShaderMaterial。

FogVolumeShape shape = 3 🔗

• void set_shape(value: FogVolumeShape)

• FogVolumeShape get_shape()

FogVolume 的形状。这可以被设置为 RenderingServer.FOG_VOLUME_SHAPE_ELLIPSOID、RenderingServer.FOG_VOLUME_SHAPE_CONE、RenderingServer.FOG_VOLUME_SHAPE_CYLINDER、RenderingServer.FOG_VOLUME_SHAPE_BOX 或 RenderingServer.FOG_VOLUME_SHAPE_WORLD。

Vector3 size = Vector3(2, 2, 2) 🔗

• void set_size(value: Vector3)

• Vector3 get_size()

当 shape 为 RenderingServer.FOG_VOLUME_SHAPE_ELLIPSOID、RenderingServer.FOG_VOLUME_SHAPE_CONE、RenderingServer.FOG_VOLUME_SHAPE_CYLINDER 或 RenderingServer.FOG_VOLUME_SHAPE_BOX时，该 FogVolume 的大小。

注意：当相机移动或旋转时，薄雾体积可能会出现闪烁。这可以通过增加 ProjectSettings.rendering/environment/volumetric_fog/volume_depth（以性能为代价）或减少 Environment.volumetric_fog_length（无性能成本，但以降低雾的范围为代价）来缓解。或者，FogVolume 可以做得更厚，并在 material 中使用较低的密度。

注意：如果 shape 为 RenderingServer.FOG_VOLUME_SHAPE_CONE 或 RenderingServer.FOG_VOLUME_SHAPE_CYLINDER，圆锥体/圆柱体将被调整以适应该大小。不支持通过 size 属性对圆锥体/圆柱体形状进行非均匀缩放，但可以改为缩放该 FogVolume 节点。