--- title: "Astra.Components.EnvironmentVolume" version: snapshot-2026-10-06 engineGeneration: astra-current language: C# status: semantic-reference runtimeVerified: false platformEvidence: [] url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-components-environmentvolume/ --- # Astra.Components.EnvironmentVolume Ambiente: Céu, atmosfera, neblina e pós globais ou por volume. Família Renderização · Ambiente. **Namespace:** `Astra.Components` · **Assembly:** `Astra.Scripting` · **Tipo:** Struct :::note[Sobre esta referência] Assinaturas extraídas semanticamente com Roslyn/MSBuild. Isso confirma a superfície do código deste snapshot; não comprova execução no Android. As descrições vêm dos comentários da API. Membros sem explicação ainda exigem revisão editorial. ::: ## Declaração ```csharp readonly struct Astra.Components.EnvironmentVolume ``` Ambiente: Céu, atmosfera, neblina e pós globais ou por volume. Família Renderização · Ambiente. Referência estudada: https://docs.unity3d.com/Packages/com.unity.render-pipelines.universal@17.0/manual/Volumes.html **Interfaces:** `Astra.Components.IComponentFacade`. Consulte também [Ambiente](/pt-br/snapshot-2026-10-06/componentes/astra-render-environment/) para propriedades, valores iniciais, requisitos e edição em Play. ## Membros | Membro | Categoria | |---|---| | [.ctor](#member-aae0b35a18d8b573) | Method | | [GetEnvironmentMap](#member-96a33bec6af52dba) | Method | | [GetProfile](#member-a8b1c6156a07f971) | Method | | [Remove](#member-a1b7feb7117bb023) | Method | | [SetEnvironmentMap](#member-28b9144f5d83ffbb) | Method | | [SetProfile](#member-b3fa3c3110ca5f88) | Method | | [Wrap](#member-fc5bc45909f9d41d) | Method | | [AerosolAnisotropy](#member-bb4a646483156225) | Property | | [AerosolDensity](#member-68b1583ede542771) | Property | | [AerosolScaleHeightKm](#member-a5c7b75141d05f32) | Property | | [AirDensity](#member-9cac01a3e1cd01cc) | Property | | [AmbientOcclusion](#member-b2a2e4f02cb74905) | Property | | [AmbientOcclusionBias](#member-b7bcfa37ec84603b) | Property | | [AmbientOcclusionIntensity](#member-19bc66877c6085bd) | Property | | [AmbientOcclusionPower](#member-6a55125d30ddf785) | Property | | [AmbientOcclusionRadius](#member-0a86b7c337f3e965) | Property | | [Atmosphere](#member-f85e71c09c41bafe) | Property | | [AtmosphereHeightKm](#member-3dd232b321e23dfb) | Property | | [AutoExposure](#member-150bf6d11ef79fce) | Property | | [AutoExposureCenterWeighted](#member-612e575638dc7369) | Property | | [AutoExposureHighPercent](#member-2af33b9297bfb3fb) | Property | | [AutoExposureLowPercent](#member-d108c7bc9a9dfdba) | Property | | [AutoExposureMaxEv](#member-a75643116f8ef2b8) | Property | | [AutoExposureMinEv](#member-c2728fe7cc1228c8) | Property | | [AutoExposureSpeedDown](#member-06572cfcbfc3c6b7) | Property | | [AutoExposureSpeedUp](#member-f77281681da15bc8) | Property | | [AutoExposureTargetGrey](#member-b5a47e0f12934eb6) | Property | | [BlendDistance](#member-37b62604fddf72b0) | Property | | [Bloom](#member-47417c9cffa0b261) | Property | | [BloomIntensity](#member-cc2de476e2c64750) | Property | | [BloomThreshold](#member-64b19e98d6b94632) | Property | | [BoxSize](#member-a9b22b99816e4192) | Property | | [Component](#member-38faac38a83fed68) | Property | | [Contrast](#member-345b6b409a5f219c) | Property | | [Enabled](#member-1f9919dcf8b4ba51) | Property | | [ExposureEv](#member-f722e055dc2aec13) | Property | | [FilmGrain](#member-fe6326087f429cef) | Property | | [FilmGrainIntensity](#member-53adf0ae46a23144) | Property | | [Fog](#member-3a9aad49bca28179) | Property | | [FogBaseHeight](#member-6d9eb7f566b5a906) | Property | | [FogColor](#member-a971b3cf6b51a2f4) | Property | | [FogDensity](#member-27294c3b79b9ccd1) | Property | | [FogHeightFalloff](#member-eb88c8a8ad7fbc88) | Property | | [FogLightEnergy](#member-b26369556c404ded) | Property | | [FogStart](#member-63c05a0aa816018d) | Property | | [Ground](#member-3d15e698631b75ed) | Property | | [GroundAlbedo](#member-145d862725eb16dc) | Property | | [HdriExposureEv](#member-eec4341df306dec8) | Property | | [HdriRotationDegrees](#member-db8969a304c65eeb) | Property | | [IndirectDiffuse](#member-13ce96dcf3bacc04) | Property | | [IndirectSpecular](#member-d0cf7fcbd3cc8c76) | Property | | [InstanceId](#member-d1884675ad7191ae) | Property | | [IsAlive](#member-9b8addbd989eda6a) | Property | | [Object](#member-b09c8f0635398642) | Property | | [ObserverHeightKm](#member-10a09fa306fc42e2) | Property | | [OverrideFog](#member-27930a5f2c190742) | Property | | [OverrideIndirect](#member-609aa3a23eefffc4) | Property | | [OverridePost](#member-3e9334ba6a90f868) | Property | | [OverrideSky](#member-de5165cee458794c) | Property | | [PhysicalAtmosphereHighQuality](#member-05d8decd832634dc) | Property | | [PhysicalSkyIntensity](#member-dadda510f8663cea) | Property | | [PlanetRadiusKm](#member-bfffb47e1c0d2089) | Property | | [Post](#member-9f2a65a67dfe3fd8) | Property | | [Priority](#member-0b6aae482eb04408) | Property | | [RayleighScaleHeightKm](#member-3022153199a71b0e) | Property | | [Saturation](#member-74ffff1493f5af84) | Property | | [Sky](#member-75855762525493eb) | Property | | [SkyHorizon](#member-0859d4067c8ffb99) | Property | | [SkyZenith](#member-d66ab0280d022744) | Property | | [SphereRadius](#member-5a8b5278453379d3) | Property | | [SunDiskDegrees](#member-c0241ffc4e16d4c0) | Property | | [SunDiskIntensity](#member-57fef3399132e5c8) | Property | | [ToneMapper](#member-121948131c8bfa60) | Property | | [TypeId](#member-5531f76dd6844b1d) | Property | | [Vignette](#member-4a1d03589141bf13) | Property | | [VignetteIntensity](#member-c63ff4eb5341b28b) | Property | | [VolumeLayer](#member-f279314125f2bdc0) | Property | | [VolumeShape](#member-717d7fa80220c5a5) | Property | | [Weight](#member-a71c8a464e8c25b5) | Property |

.ctor

```csharp public EnvironmentVolume(Astra.Component component) ``` | Parâmetro | Tipo | Contrato | |---|---|---| | `component` | `Astra.Component` | |

GetEnvironmentMap

```csharp public Astra.AssetGuid GetEnvironmentMap(uint slot = 0) ``` Mapa HDRI. Recurso do projeto por slot | Parâmetro | Tipo | Contrato | |---|---|---| | `slot` | `uint` | · Opcional: `0` |

GetProfile

```csharp public Astra.AssetGuid GetProfile(uint slot = 0) ``` Perfil. Recurso do projeto por slot | Parâmetro | Tipo | Contrato | |---|---|---| | `slot` | `uint` | · Opcional: `0` |

Remove

```csharp public void Remove() ``` Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

SetEnvironmentMap

```csharp public void SetEnvironmentMap(Astra.AssetGuid value, uint slot = 0) ``` | Parâmetro | Tipo | Contrato | |---|---|---| | `value` | `Astra.AssetGuid` | | | `slot` | `uint` | · Opcional: `0` |

SetProfile

```csharp public void SetProfile(Astra.AssetGuid value, uint slot = 0) ``` | Parâmetro | Tipo | Contrato | |---|---|---| | `value` | `Astra.AssetGuid` | | | `slot` | `uint` | · Opcional: `0` |

Wrap

```csharp public static Astra.Components.EnvironmentVolume Wrap(Astra.Component component) ``` | Parâmetro | Tipo | Contrato | |---|---|---| | `component` | `Astra.Component` | |

AerosolAnisotropy

```csharp public float AerosolAnisotropy { get; set; } ``` Anisotropia dos aerossóis (g) Faixa válida: 0 a 0.95.

AerosolDensity

```csharp public float AerosolDensity { get; set; } ``` Densidade de aerossóis (×) Faixa válida: 0 a 8.

AerosolScaleHeightKm

```csharp public float AerosolScaleHeightKm { get; set; } ``` Escala de aerossóis (km) Faixa válida: 0.05 a 50.

AirDensity

```csharp public float AirDensity { get; set; } ``` Densidade do ar (×) Faixa válida: 0 a 8.

AmbientOcclusion

```csharp public bool AmbientOcclusion { get; set; } ``` Oclusão ambiente. Escurece contatos e concavidades a partir da profundidade da câmera

AmbientOcclusionBias

```csharp public float AmbientOcclusionBias { get; set; } ``` Viés (m) Faixa válida: 0 a 1.

AmbientOcclusionIntensity

```csharp public float AmbientOcclusionIntensity { get; set; } ``` Intensidade Faixa válida: 0 a 4.

AmbientOcclusionPower

```csharp public float AmbientOcclusionPower { get; set; } ``` Potência Faixa válida: 0.1 a 4.

AmbientOcclusionRadius

```csharp public float AmbientOcclusionRadius { get; set; } ``` Raio (m) Faixa válida: 0.05 a 10.

Atmosphere

```csharp public float Atmosphere { get; set; } ``` Força atmosférica Faixa válida: 0 a 1.

AtmosphereHeightKm

```csharp public float AtmosphereHeightKm { get; set; } ``` Altura da atmosfera (km) Faixa válida: 1 a 1000.

AutoExposure

```csharp public bool AutoExposure { get; set; } ``` Exposição automática. Mede luminância HDR e adapta a exposição por câmera

AutoExposureCenterWeighted

```csharp public bool AutoExposureCenterWeighted { get; set; } ``` Peso central. Prioriza o centro da imagem na medição

AutoExposureHighPercent

```csharp public float AutoExposureHighPercent { get; set; } ``` Corte alto Faixa válida: 0 a 1.

AutoExposureLowPercent

```csharp public float AutoExposureLowPercent { get; set; } ``` Corte baixo Faixa válida: 0 a 1.

AutoExposureMaxEv

```csharp public float AutoExposureMaxEv { get; set; } ``` EV máximo (EV) Faixa válida: -16 a 16.

AutoExposureMinEv

```csharp public float AutoExposureMinEv { get; set; } ``` EV mínimo (EV) Faixa válida: -16 a 16.

AutoExposureSpeedDown

```csharp public float AutoExposureSpeedDown { get; set; } ``` Velocidade ao clarear (EV/s) Faixa válida: 0.01 a 20.

AutoExposureSpeedUp

```csharp public float AutoExposureSpeedUp { get; set; } ``` Velocidade ao escurecer (EV/s) Faixa válida: 0.01 a 20.

AutoExposureTargetGrey

```csharp public float AutoExposureTargetGrey { get; set; } ``` Cinza alvo Faixa válida: 0.01 a 1.

BlendDistance

```csharp public float BlendDistance { get; set; } ``` Distância de mistura (m) Faixa válida: 0 a 100000.

Bloom

```csharp public bool Bloom { get; set; } ``` Bloom. Espalha altas luzes antes do tonemap

BloomIntensity

```csharp public float BloomIntensity { get; set; } ``` Intensidade do bloom Faixa válida: 0 a 2.

BloomThreshold

```csharp public float BloomThreshold { get; set; } ``` Limiar do bloom Faixa válida: 0 a 64.

BoxSize

```csharp public System.Numerics.Vector3 BoxSize { get; set; } ``` Tamanho da caixa

Component

```csharp public Astra.Component Component { get; } ```

Contrast

```csharp public float Contrast { get; set; } ``` Contraste Faixa válida: 0.5 a 2.

Enabled

```csharp public bool Enabled { get; set; } ``` Ativo. Participa da seleção por prioridade

ExposureEv

```csharp public float ExposureEv { get; set; } ``` Compensação (EV) Faixa válida: -16 a 16.

FilmGrain

```csharp public bool FilmGrain { get; set; } ``` Grão de filme. Adiciona grão sensível à luminância depois da resolução temporal

FilmGrainIntensity

```csharp public float FilmGrainIntensity { get; set; } ``` Intensidade do grão Faixa válida: 0 a 1.

Fog

```csharp public bool Fog { get; set; } ``` Neblina. Aplica neblina exponencial uniforme ou com decaimento por altura

FogBaseHeight

```csharp public float FogBaseHeight { get; set; } ``` Altura base (m) Faixa válida: -100000 a 100000.

FogColor

```csharp public System.Numerics.Vector3 FogColor { get; set; } ``` Cor da neblina. Cor linear RGB

FogDensity

```csharp public float FogDensity { get; set; } ``` Densidade (1/m) Faixa válida: 0 a 1.

FogHeightFalloff

```csharp public float FogHeightFalloff { get; set; } ``` Decaimento por altura (1/m) Faixa válida: 0 a 10.

FogLightEnergy

```csharp public float FogLightEnergy { get; set; } ``` Energia da neblina (×) Faixa válida: 0 a 65504.

FogStart

```csharp public float FogStart { get; set; } ``` Início (m) Faixa válida: 0 a 10000.

Ground

```csharp public System.Numerics.Vector3 Ground { get; set; } ``` Cor do chão. Cor linear RGB

GroundAlbedo

```csharp public float GroundAlbedo { get; set; } ``` Albedo médio do solo Faixa válida: 0 a 1.

HdriExposureEv

```csharp public float HdriExposureEv { get; set; } ``` Exposição HDRI (EV) Faixa válida: -16 a 16.

HdriRotationDegrees

```csharp public float HdriRotationDegrees { get; set; } ``` Rotação HDRI (°) Faixa válida: -360 a 360.

IndirectDiffuse

```csharp public float IndirectDiffuse { get; set; } ``` Difuso indireto (×) Faixa válida: 0 a 4.

IndirectSpecular

```csharp public float IndirectSpecular { get; set; } ``` Reflexo indireto (×) Faixa válida: 0 a 4.

InstanceId

```csharp public ulong InstanceId { get; } ```

IsAlive

```csharp public bool IsAlive { get; } ```

Object

```csharp public Astra.GameObject Object { get; } ```

ObserverHeightKm

```csharp public float ObserverHeightKm { get; set; } ``` Altura do observador (km) Faixa válida: 0 a 1000.

OverrideFog

```csharp public bool OverrideFog { get; set; } ``` Sobrescrever neblina. Participa da mistura de neblina

OverrideIndirect

```csharp public bool OverrideIndirect { get; set; } ``` Sobrescrever luz indireta. Participa da mistura de difuso e reflexo indiretos

OverridePost

```csharp public bool OverridePost { get; set; } ``` Sobrescrever pós. Participa da mistura de exposição e pós

OverrideSky

```csharp public bool OverrideSky { get; set; } ``` Sobrescrever céu. Participa da mistura de céu e atmosfera

PhysicalAtmosphereHighQuality

```csharp public bool PhysicalAtmosphereHighQuality { get; set; } ``` Alta qualidade. Aumenta as amostras de vista e luz; custa mais GPU

PhysicalSkyIntensity

```csharp public float PhysicalSkyIntensity { get; set; } ``` Intensidade (×) Faixa válida: 0 a 16.

PlanetRadiusKm

```csharp public float PlanetRadiusKm { get; set; } ``` Raio do planeta (km) Faixa válida: 1 a 100000.

Post

```csharp public bool Post { get; set; } ``` Pós-processamento. Ativa os overrides autorais desta cena

Priority

```csharp public float Priority { get; set; } ``` Prioridade Faixa válida: -1000 a 1000.

RayleighScaleHeightKm

```csharp public float RayleighScaleHeightKm { get; set; } ``` Escala Rayleigh (km) Faixa válida: 0.1 a 100.

Saturation

```csharp public float Saturation { get; set; } ``` Saturação Faixa válida: 0 a 2.

Sky

```csharp public Astra.Components.EnvironmentVolume.SkyOption Sky { get; set; } ``` Céu. Fonte visual do céu

SkyHorizon

```csharp public System.Numerics.Vector3 SkyHorizon { get; set; } ``` Cor do horizonte. Cor linear RGB

SkyZenith

```csharp public System.Numerics.Vector3 SkyZenith { get; set; } ``` Cor do zênite. Cor linear RGB

SphereRadius

```csharp public float SphereRadius { get; set; } ``` Raio (m) Faixa válida: 0.01 a 100000.

SunDiskDegrees

```csharp public float SunDiskDegrees { get; set; } ``` Diâmetro do sol (°) Faixa válida: 0.05 a 10.

SunDiskIntensity

```csharp public float SunDiskIntensity { get; set; } ``` Brilho do disco solar Faixa válida: 0 a 100.

ToneMapper

```csharp public Astra.Components.EnvironmentVolume.ToneMapperOption ToneMapper { get; set; } ``` Tonemapping. Curva aplicada ao HDR antes da saída

TypeId

```csharp public static string TypeId { get; } ```

Vignette

```csharp public bool Vignette { get; set; } ``` Vinheta. Escurece gradualmente as bordas

VignetteIntensity

```csharp public float VignetteIntensity { get; set; } ``` Intensidade da vinheta Faixa válida: 0 a 1.

VolumeLayer

```csharp public Astra.Components.EnvironmentVolume.VolumeLayerOption VolumeLayer { get; set; } ``` Camada. Filtro consultado pela câmera

VolumeShape

```csharp public Astra.Components.EnvironmentVolume.VolumeShapeOption VolumeShape { get; set; } ``` Modo. Global afeta toda vista; formas usam o Transform do objeto

Weight

```csharp public float Weight { get; set; } ``` Peso Faixa válida: 0 a 1.