FogVolume
Локальный или глобальный вклад в объёмный туман.
Объект Entity3D с формой, размером и материалом тумана. Требует Forward+ и включённого объёмного тумана Environment. FogMaterial предоставляет готовое поведение; ShaderMaterial типа fog задаёт вклад самостоятельно.
Объявления сверены с C# SDK 1.0.0. Раскройте имя, чтобы увидеть сигнатуры и описание.
Конструкторы1
FogVolumeКонструктор
public FogVolume();Создаёт Box-объём размера (2,2,2) без назначенного материала. Нужны Forward+ и включённый объёмный туман окружения. В текущем RD отсутствие материала использует стандартный туман с плотностью 1, а не отключает объём. Назначьте FogMaterial или ShaderMaterial типа fog для управления вкладом.
Свойства3
MaterialСвойство
public Material Material { get; set; }Материал локальной среды. Используйте FogMaterial или ShaderMaterial с shader_type fog; StandardMaterial3D описывает поверхность меша и не является fog-шейдером. Для видимого FogVolume нужны Forward+ и включённый VolumetricFogEnabled у действующего Environment.
ShapeСвойство
public RenderingServer.FogVolumeShape Shape { get; set; }Геометрическая область объёмного тумана: Ellipsoid, Cone, Cylinder, Box или World из RenderingServer.FogVolumeShape. Локальные формы используют Size и transform Entity. World действует глобально и игнорирует ограничение Size; это не переключатель Environment.VolumetricFogEnabled.
SizeСвойство
public Vector3 Size { get; set; }Полный размер локального объёма по трём осям, а не половина размера. Отрицательные компоненты при присваивании становятся нулём; нулевой размер не создаёт полезную область тумана. Shape=World не ограничивается этим размером. В примере Box использует 10×5×10.
Методы6
GetMaterialMaterial
public Material GetMaterial();Материал вклада объёма в туман: FogMaterial или ShaderMaterial с shader_type fog. Не включает Environment.VolumetricFogEnabled автоматически. При общем материале объёмы разделяют его параметры. null снимает назначение, но текущий RD использует стандартный материал; для скрытия задайте Visible=false.
MaterialНазначенный Material либо null. Внутренний материал по умолчанию рендерера этим getter не возвращается.
GetShapeRenderingServer.FogVolumeShape
public RenderingServer.FogVolumeShape GetShape();Форма объёма: Ellipsoid, Cone, Cylinder, Box либо World. Локальные формы используют Size и преобразование Entity3D; World действует глобально. В текущем RD обращение шейдера к SDF отключает автоматическую маску формы, поэтому задайте собственную маску DENSITY.
RenderingServer.FogVolumeShapeНазначенное значение FogVolumeShape.
GetSizeVector3
public Vector3 GetSize();Полный размер локальной формы, не половина размера и не разрешение сетки тумана. Отрицательные компоненты приводятся к 0. В форме World этот размер не ограничивает глобальный объём.
Vector3Сохранённый размер после приведения отрицательных компонентов к 0.
SetMaterialvoid
public void SetMaterial(Material material);Материал вклада объёма в туман: FogMaterial или ShaderMaterial с shader_type fog. Не включает Environment.VolumetricFogEnabled автоматически. При общем материале объёмы разделяют его параметры. null снимает назначение, но текущий RD использует стандартный материал; для скрытия задайте Visible=false.
| Имя | Тип | По умолчанию |
|---|---|---|
material | Material | — |
materialМатериал тумана или null. null возвращает стандартный материал RD, а не отключает объём.
SetShapevoid
public void SetShape(RenderingServer.FogVolumeShape shape);Форма объёма: Ellipsoid, Cone, Cylinder, Box либо World. Локальные формы используют Size и преобразование Entity3D; World действует глобально. В текущем RD обращение шейдера к SDF отключает автоматическую маску формы, поэтому задайте собственную маску DENSITY.
| Имя | Тип | По умолчанию |
|---|---|---|
shape | RenderingServer.FogVolumeShape | — |
shapeФорма FogVolumeShape; World не ограничивается Size.
SetSizevoid
public void SetSize(Vector3 size);Полный размер локальной формы, не половина размера и не разрешение сетки тумана. Отрицательные компоненты приводятся к 0. В форме World этот размер не ограничивает глобальный объём.
| Имя | Тип | По умолчанию |
|---|---|---|
size | Vector3 | — |
sizeПолный размер; используйте положительные компоненты для непустой локальной формы.