Ambiente

Família: Renderização · Grupo: Ambiente · Identificador: astra.render.environment · Payload: 12

Escopo da evidência

Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.

Para que usar

Céu, atmosfera, neblina e pós globais ou por volume

Atribua geometria e recursos compatíveis; altere material/slot, luz ou ambiente e observe o resultado pela câmera. Valores autorais e política gráfica efetiva têm estados distintos.

Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → Renderização / Ambiente → Ambiente.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é Astra.Components.EnvironmentVolume.

Exemplo de uso

Uma malha, câmera e luz: compare rugosidade/metalness no mesmo enquadramento, ou alcance/intensidade da luz sobre a malha. Material emissivo sozinho não equivale a uma luz iluminando objetos vizinhos.

Dependências

Nenhuma regra adicional declarada no schema deste componente.

Conflitos

Nenhuma regra adicional declarada no schema deste componente.

Edição e ciclo de vida

Operação	Contrato
Adicionar/remover em Play	ponto seguro
Alterar propriedades em Play	ponto seguro
Múltiplas instâncias	Não
Versão do payload	12

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja Play e cena autoral.

Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

Recursos do projeto

Estes seletores ficam no componente e não entram na contagem dos campos numéricos. Use recursos registrados do projeto; nome ou caminho externo não substitui uma referência válida.

Recurso	Onde	Tipo	Uso
Perfil · profile	Inspector → Ambiente → Geral	environment_profile	Aparência compartilhada; forma, peso, prioridade e camada continuam nesta instância Pode herdar da fonte; herdar e limpar são estados diferentes.
Mapa HDRI · environment_map	Inspector → Ambiente → HDRI	environment_map	Panorama HDR linear: céu, irradiância global e reflexão compartilham a mesma fonte Pode herdar da fonte; herdar e limpar são estados diferentes.

Geral

Propriedade	Tipo / unidade	Padrão	Domínio
Prioridade priority	número	0	-1000 … 1000
Ativo enabled	booleano	verdadeiro	verdadeiro | falso

Prioridade · priority

Onde: Inspector → Ambiente → Geral → Prioridade.

Uso e efeito: Prioridade entre candidatos do mesmo sistema; compare o consumidor efetivo, não só o número no Inspector.

Valor: 0 · Tipo: número · Domínio: -1000 … 1000.

Capacidade necessária: render.environment.atmosphere; veja estado do renderer.

Ativo · enabled

Onde: Inspector → Ambiente → Geral → Ativo.

Uso e efeito: Participa da seleção por prioridade

Valor: verdadeiro · Tipo: booleano · Domínio: verdadeiro | falso.

Atmosfera

Propriedade	Tipo / unidade	Padrão	Domínio
Zênite R sky_zenith.r	número	0.025	0 … 1
Zênite G sky_zenith.g	número	0.1	0 … 1
Zênite B sky_zenith.b	número	0.32	0 … 1
Horizonte R sky_horizon.r	número	0.28	0 … 1
Horizonte G sky_horizon.g	número	0.42	0 … 1
Horizonte B sky_horizon.b	número	0.62	0 … 1
Chão R ground.r	número	0.11	0 … 1
Chão G ground.g	número	0.12	0 … 1
Chão B ground.b	número	0.14	0 … 1
Força atmosférica atmosphere	número	1	0 … 1
Diâmetro do sol sun_disk_degrees	número · °	0.53	0.05 … 10
Brilho do disco solar sun_disk_intensity	número	8	0 … 100
Céu sky	enumeração	Atmosfera	HDRI | Atmosfera | Atmosfera física

Zênite R · sky_zenith.r

Onde: Inspector → Ambiente → Atmosfera → Zênite R.

Uso e efeito: Canal R da cor sky_zenith no consumidor correspondente. Combine os três canais e intensidade quando existente.

Valor: 0.025 · Tipo: número · Domínio: 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.atmosphere; veja estado do renderer.

Zênite G · sky_zenith.g

Onde: Inspector → Ambiente → Atmosfera → Zênite G.

Uso e efeito: Canal G da cor sky_zenith no consumidor correspondente. Combine os três canais e intensidade quando existente.

Valor: 0.1 · Tipo: número · Domínio: 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.atmosphere; veja estado do renderer.

Zênite B · sky_zenith.b

Onde: Inspector → Ambiente → Atmosfera → Zênite B.

Uso e efeito: Canal B da cor sky_zenith no consumidor correspondente. Combine os três canais e intensidade quando existente.

Valor: 0.32 · Tipo: número · Domínio: 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.atmosphere; veja estado do renderer.

Horizonte R · sky_horizon.r

Onde: Inspector → Ambiente → Atmosfera → Horizonte R.

Uso e efeito: Canal R da cor sky_horizon no consumidor correspondente. Combine os três canais e intensidade quando existente.

Valor: 0.28 · Tipo: número · Domínio: 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.atmosphere; veja estado do renderer.

Horizonte G · sky_horizon.g

Onde: Inspector → Ambiente → Atmosfera → Horizonte G.

Uso e efeito: Canal G da cor sky_horizon no consumidor correspondente. Combine os três canais e intensidade quando existente.

Valor: 0.42 · Tipo: número · Domínio: 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.atmosphere; veja estado do renderer.

Horizonte B · sky_horizon.b

Onde: Inspector → Ambiente → Atmosfera → Horizonte B.

Uso e efeito: Canal B da cor sky_horizon no consumidor correspondente. Combine os três canais e intensidade quando existente.

Valor: 0.62 · Tipo: número · Domínio: 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.atmosphere; veja estado do renderer.

Chão R · ground.r

Onde: Inspector → Ambiente → Atmosfera → Chão R.

Uso e efeito: Canal R da cor ground no consumidor correspondente. Combine os três canais e intensidade quando existente.

Valor: 0.11 · Tipo: número · Domínio: 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.atmosphere; veja estado do renderer.

Chão G · ground.g

Onde: Inspector → Ambiente → Atmosfera → Chão G.

Uso e efeito: Canal G da cor ground no consumidor correspondente. Combine os três canais e intensidade quando existente.

Valor: 0.12 · Tipo: número · Domínio: 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.atmosphere; veja estado do renderer.

Chão B · ground.b

Onde: Inspector → Ambiente → Atmosfera → Chão B.

Uso e efeito: Canal B da cor ground no consumidor correspondente. Combine os três canais e intensidade quando existente.

Valor: 0.14 · Tipo: número · Domínio: 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.atmosphere; veja estado do renderer.

Força atmosférica · atmosphere

Onde: Inspector → Ambiente → Atmosfera → Força atmosférica.

Uso e efeito: Quantidade da contribuição atmosférica no modelo de céu selecionado.

Valor: 1 · Tipo: número · Domínio: 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.atmosphere; veja estado do renderer.

Diâmetro do sol · sun_disk_degrees

Onde: Inspector → Ambiente → Atmosfera → Diâmetro do sol.

Uso e efeito: Tamanho angular do disco solar desenhado no céu.

Valor: 0.53 · Tipo: número · Unidade: ° · Domínio: 0.05 … 10.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.atmosphere; veja estado do renderer.

Brilho do disco solar · sun_disk_intensity

Onde: Inspector → Ambiente → Atmosfera → Brilho do disco solar.

Uso e efeito: Brilho do disco solar; não substitui a intensidade de uma luz direcional.

Valor: 8 · Tipo: número · Domínio: 0 … 100.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.atmosphere; veja estado do renderer.

Céu · sky

Onde: Inspector → Ambiente → Atmosfera → Céu.

Uso e efeito: Fonte visual do céu

Valor: Atmosfera · Tipo: enumeração · Domínio: HDRI | Atmosfera | Atmosfera física.

Capacidade necessária: render.environment.atmosphere; veja estado do renderer.

Neblina

Propriedade	Tipo / unidade	Padrão	Domínio
Neblina R fog_color.r	número	0.58	0 … 1
Neblina G fog_color.g	número	0.67	0 … 1
Neblina B fog_color.b	número	0.76	0 … 1
Energia da neblina fog_light_energy	número · ×	1	0 … 65504
Densidade fog_density	número · 1/m	0.008	0 … 1
Início fog_start	número · m	8	0 … 10000
Altura base fog_base_height	número · m	0	-100000 … 100000
Decaimento por altura fog_height_falloff	número · 1/m	0	0 … 10
Neblina fog	booleano	falso	verdadeiro | falso

Neblina R · fog_color.r

Onde: Inspector → Ambiente → Neblina → Neblina R.

Uso e efeito: Canal R da cor fog_color no consumidor correspondente. Combine os três canais e intensidade quando existente.

Valor: 0.58 · Tipo: número · Domínio: 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.fog; veja estado do renderer.

Neblina G · fog_color.g

Onde: Inspector → Ambiente → Neblina → Neblina G.

Uso e efeito: Canal G da cor fog_color no consumidor correspondente. Combine os três canais e intensidade quando existente.

Valor: 0.67 · Tipo: número · Domínio: 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.fog; veja estado do renderer.

Neblina B · fog_color.b

Onde: Inspector → Ambiente → Neblina → Neblina B.

Uso e efeito: Canal B da cor fog_color no consumidor correspondente. Combine os três canais e intensidade quando existente.

Valor: 0.76 · Tipo: número · Domínio: 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.fog; veja estado do renderer.

Energia da neblina · fog_light_energy

Onde: Inspector → Ambiente → Neblina → Energia da neblina.

Uso e efeito: Energia de luz na neblina conforme o modelo de fog.

Valor: 1 · Tipo: número · Unidade: × · Domínio: 0 … 65504.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.fog; veja estado do renderer.

Densidade · fog_density

Onde: Inspector → Ambiente → Neblina → Densidade.

Uso e efeito: Densidade da neblina; aumentar reduz visibilidade ao longo do percurso.

Valor: 0.008 · Tipo: número · Unidade: 1/m · Domínio: 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.fog; veja estado do renderer.

Início · fog_start

Onde: Inspector → Ambiente → Neblina → Início.

Uso e efeito: Distância a partir da qual a neblina começa.

Valor: 8 · Tipo: número · Unidade: m · Domínio: 0 … 10000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.fog; veja estado do renderer.

Altura base · fog_base_height

Onde: Inspector → Ambiente → Neblina → Altura base.

Uso e efeito: Altura de referência da neblina de altura.

Valor: 0 · Tipo: número · Unidade: m · Domínio: -100000 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.fog; veja estado do renderer.

Decaimento por altura · fog_height_falloff

Onde: Inspector → Ambiente → Neblina → Decaimento por altura.

Uso e efeito: Queda da densidade conforme altura.

Valor: 0 · Tipo: número · Unidade: 1/m · Domínio: 0 … 10.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.fog; veja estado do renderer.

Neblina · fog

Onde: Inspector → Ambiente → Neblina → Neblina.

Uso e efeito: Aplica neblina exponencial uniforme ou com decaimento por altura

Valor: falso · Tipo: booleano · Domínio: verdadeiro | falso.

Capacidade necessária: render.environment.fog; veja estado do renderer.

Exposição

Propriedade	Tipo / unidade	Padrão	Domínio
Compensação exposure_ev	número · EV	0	-16 … 16
EV mínimo auto_exposure_min_ev	número · EV	-8	-16 … 16
EV máximo auto_exposure_max_ev	número · EV	8	-16 … 16
Corte baixo auto_exposure_low_percent	número	0.05	0 … 1
Corte alto auto_exposure_high_percent	número	0.95	0 … 1
Cinza alvo auto_exposure_target_grey	número	0.18	0.01 … 1
Velocidade ao escurecer auto_exposure_speed_up	número · EV/s	2	0.01 … 20
Velocidade ao clarear auto_exposure_speed_down	número · EV/s	3	0.01 … 20
Exposição automática auto_exposure	booleano	falso	verdadeiro | falso
Peso central auto_exposure_center_weighted	booleano	falso	verdadeiro | falso

Compensação · exposure_ev

Onde: Inspector → Ambiente → Exposição → Compensação.

Uso e efeito: Exposição manual em EV antes do tonemapping; compare com auto exposição desligada.

Valor: 0 · Tipo: número · Unidade: EV · Domínio: -16 … 16.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.post.tonemap; veja estado do renderer.

EV mínimo · auto_exposure_min_ev

Onde: Inspector → Ambiente → Exposição → EV mínimo.

Uso e efeito: Limite inferior de exposição automática.

Valor: -8 · Tipo: número · Unidade: EV · Domínio: -16 … 16.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Histograma e adaptação por vista; o EV fica restrito à faixa autoral Capacidade necessária: render.post.auto_exposure; veja estado do renderer.

EV máximo · auto_exposure_max_ev

Onde: Inspector → Ambiente → Exposição → EV máximo.

Uso e efeito: Limite superior de exposição automática.

Valor: 8 · Tipo: número · Unidade: EV · Domínio: -16 … 16.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Histograma e adaptação por vista; o EV fica restrito à faixa autoral Capacidade necessária: render.post.auto_exposure; veja estado do renderer.

Corte baixo · auto_exposure_low_percent

Onde: Inspector → Ambiente → Exposição → Corte baixo.

Uso e efeito: Percentil inferior do histograma para auto exposição.

Valor: 0.05 · Tipo: número · Domínio: 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Histograma e adaptação por vista; o EV fica restrito à faixa autoral Capacidade necessária: render.post.auto_exposure; veja estado do renderer.

Corte alto · auto_exposure_high_percent

Onde: Inspector → Ambiente → Exposição → Corte alto.

Uso e efeito: Percentil superior do histograma para auto exposição.

Valor: 0.95 · Tipo: número · Domínio: 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Histograma e adaptação por vista; o EV fica restrito à faixa autoral Capacidade necessária: render.post.auto_exposure; veja estado do renderer.

Cinza alvo · auto_exposure_target_grey

Onde: Inspector → Ambiente → Exposição → Cinza alvo.

Uso e efeito: Nível cinza alvo da medição automática.

Valor: 0.18 · Tipo: número · Domínio: 0.01 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Histograma e adaptação por vista; o EV fica restrito à faixa autoral Capacidade necessária: render.post.auto_exposure; veja estado do renderer.

Velocidade ao escurecer · auto_exposure_speed_up

Onde: Inspector → Ambiente → Exposição → Velocidade ao escurecer.

Uso e efeito: Velocidade de adaptação ao elevar exposição.

Valor: 2 · Tipo: número · Unidade: EV/s · Domínio: 0.01 … 20.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Histograma e adaptação por vista; o EV fica restrito à faixa autoral Capacidade necessária: render.post.auto_exposure; veja estado do renderer.

Velocidade ao clarear · auto_exposure_speed_down

Onde: Inspector → Ambiente → Exposição → Velocidade ao clarear.

Uso e efeito: Velocidade de adaptação ao reduzir exposição.

Valor: 3 · Tipo: número · Unidade: EV/s · Domínio: 0.01 … 20.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Histograma e adaptação por vista; o EV fica restrito à faixa autoral Capacidade necessária: render.post.auto_exposure; veja estado do renderer.

Exposição automática · auto_exposure

Onde: Inspector → Ambiente → Exposição → Exposição automática.

Uso e efeito: Mede luminância HDR e adapta a exposição por câmera

Valor: falso · Tipo: booleano · Domínio: verdadeiro | falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Histograma e adaptação por vista; o EV fica restrito à faixa autoral Capacidade necessária: render.post.auto_exposure; veja estado do renderer.

Peso central · auto_exposure_center_weighted

Onde: Inspector → Ambiente → Exposição → Peso central.

Uso e efeito: Prioriza o centro da imagem na medição

Valor: falso · Tipo: booleano · Domínio: verdadeiro | falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Histograma e adaptação por vista; o EV fica restrito à faixa autoral Capacidade necessária: render.post.auto_exposure; veja estado do renderer.

Pós

Propriedade	Tipo / unidade	Padrão	Domínio
Limiar do bloom bloom_threshold	número	1	0 … 64
Intensidade do bloom bloom_intensity	número	0.1	0 … 2
Contraste contrast	número	1	0.5 … 2
Saturação saturation	número	1	0 … 2
Intensidade da vinheta vignette_intensity	número	0.18	0 … 1
Intensidade do grão film_grain_intensity	número	0.05	0 … 1
Pós-processamento post	booleano	verdadeiro	verdadeiro | falso
Bloom bloom	booleano	verdadeiro	verdadeiro | falso
Vinheta vignette	booleano	falso	verdadeiro | falso
Grão de filme film_grain	booleano	falso	verdadeiro | falso
Tonemapping tone_mapper	enumeração	ACES	Reinhard | ACES | AgX

Limiar do bloom · bloom_threshold

Onde: Inspector → Ambiente → Pós → Limiar do bloom.

Uso e efeito: Limiar de brilho que participa do bloom.

Valor: 1 · Tipo: número · Domínio: 0 … 64.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.post.bloom; veja estado do renderer.

Intensidade do bloom · bloom_intensity

Onde: Inspector → Ambiente → Pós → Intensidade do bloom.

Uso e efeito: Intensidade do bloom habilitado.

Valor: 0.1 · Tipo: número · Domínio: 0 … 2.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.post.bloom; veja estado do renderer.

Contraste · contrast

Onde: Inspector → Ambiente → Pós → Contraste.

Uso e efeito: Contraste do pós-processamento.

Valor: 1 · Tipo: número · Domínio: 0.5 … 2.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.post.tonemap; veja estado do renderer.

Saturação · saturation

Onde: Inspector → Ambiente → Pós → Saturação.

Uso e efeito: Saturação do pós-processamento.

Valor: 1 · Tipo: número · Domínio: 0 … 2.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.post.tonemap; veja estado do renderer.

Intensidade da vinheta · vignette_intensity

Onde: Inspector → Ambiente → Pós → Intensidade da vinheta.

Uso e efeito: Força da vinheta habilitada.

Valor: 0.18 · Tipo: número · Domínio: 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.post.tonemap; veja estado do renderer.

Intensidade do grão · film_grain_intensity

Onde: Inspector → Ambiente → Pós → Intensidade do grão.

Uso e efeito: Força do grain habilitado.

Valor: 0.05 · Tipo: número · Domínio: 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.post.film_grain; veja estado do renderer.

Pós-processamento · post

Onde: Inspector → Ambiente → Pós → Pós-processamento.

Uso e efeito: Ativa os overrides autorais desta cena

Valor: verdadeiro · Tipo: booleano · Domínio: verdadeiro | falso.

Capacidade necessária: render.post.tonemap; veja estado do renderer.

Bloom · bloom

Onde: Inspector → Ambiente → Pós → Bloom.

Uso e efeito: Espalha altas luzes antes do tonemap

Valor: verdadeiro · Tipo: booleano · Domínio: verdadeiro | falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.post.bloom; veja estado do renderer.

Vinheta · vignette

Onde: Inspector → Ambiente → Pós → Vinheta.

Uso e efeito: Escurece gradualmente as bordas

Valor: falso · Tipo: booleano · Domínio: verdadeiro | falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.post.tonemap; veja estado do renderer.

Grão de filme · film_grain

Onde: Inspector → Ambiente → Pós → Grão de filme.

Uso e efeito: Adiciona grão sensível à luminância depois da resolução temporal

Valor: falso · Tipo: booleano · Domínio: verdadeiro | falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.post.film_grain; veja estado do renderer.

Tonemapping · tone_mapper

Onde: Inspector → Ambiente → Pós → Tonemapping.

Uso e efeito: Curva aplicada ao HDR antes da saída

Valor: ACES · Tipo: enumeração · Domínio: Reinhard | ACES | AgX.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.post.tonemap; veja estado do renderer.

Oclusão ambiente

Propriedade	Tipo / unidade	Padrão	Domínio
Raio ambient_occlusion_radius	número · m	1	0.05 … 10
Intensidade ambient_occlusion_intensity	número	1	0 … 4
Potência ambient_occlusion_power	número	1.5	0.1 … 4
Viés ambient_occlusion_bias	número · m	0.02	0 … 1
Oclusão ambiente ambient_occlusion	booleano	falso	verdadeiro | falso

Raio · ambient_occlusion_radius

Onde: Inspector → Ambiente → Oclusão ambiente → Raio.

Uso e efeito: Raio de amostragem do AO global.

Valor: 1 · Tipo: número · Unidade: m · Domínio: 0.05 … 10.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.post.ambient_occlusion; veja estado do renderer.

Intensidade · ambient_occlusion_intensity

Onde: Inspector → Ambiente → Oclusão ambiente → Intensidade.

Uso e efeito: Peso visual do AO global.

Valor: 1 · Tipo: número · Domínio: 0 … 4.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.post.ambient_occlusion; veja estado do renderer.

Potência · ambient_occlusion_power

Onde: Inspector → Ambiente → Oclusão ambiente → Potência.

Uso e efeito: Curva de contraste do AO.

Valor: 1.5 · Tipo: número · Domínio: 0.1 … 4.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.post.ambient_occlusion; veja estado do renderer.

Viés · ambient_occlusion_bias

Onde: Inspector → Ambiente → Oclusão ambiente → Viés.

Uso e efeito: Bias para evitar auto oclusão excessiva.

Valor: 0.02 · Tipo: número · Unidade: m · Domínio: 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.post.ambient_occlusion; veja estado do renderer.

Oclusão ambiente · ambient_occlusion

Onde: Inspector → Ambiente → Oclusão ambiente → Oclusão ambiente.

Uso e efeito: Escurece contatos e concavidades a partir da profundidade da câmera

Valor: falso · Tipo: booleano · Domínio: verdadeiro | falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.post.ambient_occlusion; veja estado do renderer.

Volume

Propriedade	Tipo / unidade	Padrão	Domínio
Peso weight	número	1	0 … 1
Distância de mistura blend_distance	número · m	0	0 … 100000
Tamanho X box_size.x	número · m	10	0.01 … 100000
Tamanho Y box_size.y	número · m	10	0.01 … 100000
Tamanho Z box_size.z	número · m	10	0.01 … 100000
Raio sphere_radius	número · m	5	0.01 … 100000
Sobrescrever céu override_sky	booleano	verdadeiro	verdadeiro | falso
Sobrescrever neblina override_fog	booleano	verdadeiro	verdadeiro | falso
Sobrescrever pós override_post	booleano	verdadeiro	verdadeiro | falso
Sobrescrever luz indireta override_indirect	booleano	verdadeiro	verdadeiro | falso
Modo volume_shape	enumeração	Global	Global | Caixa | Esfera
Camada volume_layer	enumeração	Ambiente 0	Ambiente 0 | Ambiente 1 | Ambiente 2 | Ambiente 3 | Ambiente 4 | Ambiente 5 | Ambiente 6 | Ambiente 7

Peso · weight

Onde: Inspector → Ambiente → Volume → Peso.

Uso e efeito: Peso da mistura do volume, combinado com shape, distância e prioridade.

Valor: 1 · Tipo: número · Domínio: 0 … 1.

Capacidade necessária: render.environment.volumes; veja estado do renderer.

Distância de mistura · blend_distance

Onde: Inspector → Ambiente → Volume → Distância de mistura.

Uso e efeito: Distância de mistura na borda do volume de ambiente.

Valor: 0 · Tipo: número · Unidade: m · Domínio: 0 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.volumes; veja estado do renderer.

Tamanho X · box_size.x

Onde: Inspector → Ambiente → Volume → Tamanho X.

Uso e efeito: Dimensão da caixa do volume de ambiente no eixo indicado; apenas no shape correspondente.

Valor: 10 · Tipo: número · Unidade: m · Domínio: 0.01 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.volumes; veja estado do renderer.

Tamanho Y · box_size.y

Onde: Inspector → Ambiente → Volume → Tamanho Y.

Uso e efeito: Dimensão da caixa do volume de ambiente no eixo indicado; apenas no shape correspondente.

Valor: 10 · Tipo: número · Unidade: m · Domínio: 0.01 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.volumes; veja estado do renderer.

Tamanho Z · box_size.z

Onde: Inspector → Ambiente → Volume → Tamanho Z.

Uso e efeito: Dimensão da caixa do volume de ambiente no eixo indicado; apenas no shape correspondente.

Valor: 10 · Tipo: número · Unidade: m · Domínio: 0.01 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.volumes; veja estado do renderer.

Raio · sphere_radius

Onde: Inspector → Ambiente → Volume → Raio.

Uso e efeito: Raio do volume esférico, quando esse shape está selecionado.

Valor: 5 · Tipo: número · Unidade: m · Domínio: 0.01 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.volumes; veja estado do renderer.

Sobrescrever céu · override_sky

Onde: Inspector → Ambiente → Volume → Sobrescrever céu.

Uso e efeito: Participa da mistura de céu e atmosfera

Valor: verdadeiro · Tipo: booleano · Domínio: verdadeiro | falso.

Capacidade necessária: render.environment.volumes; veja estado do renderer.

Sobrescrever neblina · override_fog

Onde: Inspector → Ambiente → Volume → Sobrescrever neblina.

Uso e efeito: Participa da mistura de neblina

Valor: verdadeiro · Tipo: booleano · Domínio: verdadeiro | falso.

Capacidade necessária: render.environment.volumes; veja estado do renderer.

Sobrescrever pós · override_post

Onde: Inspector → Ambiente → Volume → Sobrescrever pós.

Uso e efeito: Participa da mistura de exposição e pós

Valor: verdadeiro · Tipo: booleano · Domínio: verdadeiro | falso.

Capacidade necessária: render.environment.volumes; veja estado do renderer.

Sobrescrever luz indireta · override_indirect

Onde: Inspector → Ambiente → Volume → Sobrescrever luz indireta.

Uso e efeito: Participa da mistura de difuso e reflexo indiretos

Valor: verdadeiro · Tipo: booleano · Domínio: verdadeiro | falso.

Capacidade necessária: render.environment.volumes; veja estado do renderer.

Modo · volume_shape

Onde: Inspector → Ambiente → Volume → Modo.

Uso e efeito: Global afeta toda vista; formas usam o Transform do objeto

Valor: Global · Tipo: enumeração · Domínio: Global | Caixa | Esfera.

Capacidade necessária: render.environment.volumes; veja estado do renderer.

Camada · volume_layer

Onde: Inspector → Ambiente → Volume → Camada.

Uso e efeito: Filtro consultado pela câmera

Valor: Ambiente 0 · Tipo: enumeração · Domínio: Ambiente 0 | Ambiente 1 | Ambiente 2 | Ambiente 3 | Ambiente 4 | Ambiente 5 | Ambiente 6 | Ambiente 7.

Capacidade necessária: render.environment.volumes; veja estado do renderer.

Luz indireta

Propriedade	Tipo / unidade	Padrão	Domínio
Difuso indireto indirect_diffuse	número · ×	1	0 … 4
Reflexo indireto indirect_specular	número · ×	1	0 … 4

Difuso indireto · indirect_diffuse

Onde: Inspector → Ambiente → Luz indireta → Difuso indireto.

Uso e efeito: Escala da iluminação indireta difusa disponível; não calcula GI bake.

Valor: 1 · Tipo: número · Unidade: × · Domínio: 0 … 4.

Capacidade necessária: render.ambient.hemispheric; veja estado do renderer.

Reflexo indireto · indirect_specular

Onde: Inspector → Ambiente → Luz indireta → Reflexo indireto.

Uso e efeito: Escala do reflexo especular do ambiente.

Valor: 1 · Tipo: número · Unidade: × · Domínio: 0 … 4.

Capacidade necessária: render.ambient.specular; veja estado do renderer.

Atmosfera física

Propriedade	Tipo / unidade	Padrão	Domínio
Intensidade physical_sky_intensity	número · ×	1	0 … 16
Densidade do ar air_density	número · ×	1	0 … 8
Densidade de aerossóis aerosol_density	número · ×	1	0 … 8
Anisotropia dos aerossóis aerosol_anisotropy	número · g	0.76	0 … 0.95
Raio do planeta planet_radius_km	número · km	6371	1 … 100000
Altura do observador observer_height_km	número · km	0.002	0 … 1000
Escala Rayleigh rayleigh_scale_height_km	número · km	8	0.1 … 100
Escala de aerossóis aerosol_scale_height_km	número · km	1.2	0.05 … 50
Altura da atmosfera atmosphere_height_km	número · km	100	1 … 1000
Albedo médio do solo ground_albedo	número	0.1	0 … 1
Alta qualidade physical_atmosphere_high_quality	booleano	falso	verdadeiro | falso

Intensidade · physical_sky_intensity

Onde: Inspector → Ambiente → Atmosfera física → Intensidade.

Uso e efeito: Multiplica a energia do céu físico.

Valor: 1 · Tipo: número · Unidade: × · Domínio: 0 … 16.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.physical_atmosphere; veja estado do renderer.

Densidade do ar · air_density

Onde: Inspector → Ambiente → Atmosfera física → Densidade do ar.

Uso e efeito: Densidade do ar usada pelo céu físico.

Valor: 1 · Tipo: número · Unidade: × · Domínio: 0 … 8.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.physical_atmosphere; veja estado do renderer.

Densidade de aerossóis · aerosol_density

Onde: Inspector → Ambiente → Atmosfera física → Densidade de aerossóis.

Uso e efeito: Densidade do aerosol usada pelo céu físico.

Valor: 1 · Tipo: número · Unidade: × · Domínio: 0 … 8.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.physical_atmosphere; veja estado do renderer.

Anisotropia dos aerossóis · aerosol_anisotropy

Onde: Inspector → Ambiente → Atmosfera física → Anisotropia dos aerossóis.

Uso e efeito: Anisotropia da dispersão de aerosol.

Valor: 0.76 · Tipo: número · Unidade: g · Domínio: 0 … 0.95.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.physical_atmosphere; veja estado do renderer.

Raio do planeta · planet_radius_km

Onde: Inspector → Ambiente → Atmosfera física → Raio do planeta.

Uso e efeito: Raio do planeta do modelo atmosférico em km.

Valor: 6371 · Tipo: número · Unidade: km · Domínio: 1 … 100000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.physical_atmosphere; veja estado do renderer.

Altura do observador · observer_height_km

Onde: Inspector → Ambiente → Atmosfera física → Altura do observador.

Uso e efeito: Altura do observador atmosférico em km.

Valor: 0.002 · Tipo: número · Unidade: km · Domínio: 0 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.physical_atmosphere; veja estado do renderer.

Escala Rayleigh · rayleigh_scale_height_km

Onde: Inspector → Ambiente → Atmosfera física → Escala Rayleigh.

Uso e efeito: Altura característica da dispersão Rayleigh.

Valor: 8 · Tipo: número · Unidade: km · Domínio: 0.1 … 100.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.physical_atmosphere; veja estado do renderer.

Escala de aerossóis · aerosol_scale_height_km

Onde: Inspector → Ambiente → Atmosfera física → Escala de aerossóis.

Uso e efeito: Altura característica do aerosol.

Valor: 1.2 · Tipo: número · Unidade: km · Domínio: 0.05 … 50.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.physical_atmosphere; veja estado do renderer.

Altura da atmosfera · atmosphere_height_km

Onde: Inspector → Ambiente → Atmosfera física → Altura da atmosfera.

Uso e efeito: Espessura da atmosfera do modelo.

Valor: 100 · Tipo: número · Unidade: km · Domínio: 1 … 1000.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.physical_atmosphere; veja estado do renderer.

Albedo médio do solo · ground_albedo

Onde: Inspector → Ambiente → Atmosfera física → Albedo médio do solo.

Uso e efeito: Refletância do chão do céu físico.

Valor: 0.1 · Tipo: número · Domínio: 0 … 1.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.physical_atmosphere; veja estado do renderer.

Alta qualidade · physical_atmosphere_high_quality

Onde: Inspector → Ambiente → Atmosfera física → Alta qualidade.

Uso e efeito: Aumenta as amostras de vista e luz; custa mais GPU

Valor: falso · Tipo: booleano · Domínio: verdadeiro | falso.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.physical_atmosphere; veja estado do renderer.

HDRI

Propriedade	Tipo / unidade	Padrão	Domínio
Rotação HDRI hdri_rotation_degrees	número · °	0	-360 … 360
Exposição HDRI hdri_exposure_ev	número · EV	0	-16 … 16

Rotação HDRI · hdri_rotation_degrees

Onde: Inspector → Ambiente → HDRI → Rotação HDRI.

Uso e efeito: Gira a orientação do ambiente HDRI em graus.

Valor: 0 · Tipo: número · Unidade: ° · Domínio: -360 … 360.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.atmosphere; veja estado do renderer.

Exposição HDRI · hdri_exposure_ev

Onde: Inspector → Ambiente → HDRI → Exposição HDRI.

Uso e efeito: Exposição do recurso HDRI em EV.

Valor: 0 · Tipo: número · Unidade: EV · Domínio: -16 … 16.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade. Capacidade necessária: render.environment.atmosphere; veja estado do renderer.

Roadmap deste componente

Renderização e materiais. Cookies e luz de área, GI/lightmap bake, unwrap/atlas e sondas continuam no registro de capacidades conforme o item. Recursos importados não comprovam consumo. Performance e compatibilidade Vulkan precisam de aceite por aparelho.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

Conferir na sua cena

1. Crie Ambiente pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

Referência de arquitetura registrada pela engine: documentação oficial. Essa referência não representa paridade funcional.