Attention: Here be dragons

This is the latest (unstable) version of this documentation, which may document features not available in or compatible with released stable versions of Godot.

Checking the stable version of the documentation...

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
FogVolumeShape	shape	`3`
Vector3	size	`Vector3(2, 2, 2)`

属性说明¶

Material material

void set_material ( Material value )
Material get_material ( )

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

FogVolumeShape shape = 3

void set_shape ( FogVolumeShape value )
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 ( Vector3 value )
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 节点。