---
title: "Astra.Components.LightingSettings"
version: snapshot-2026-10-28
engineGeneration: astra-current
language: C#
status: semantic-reference
reviewedAt: 2026-10-28
appRelease: "0.4.0-preview.20261028"
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-28/api/astra-components-lightingsettings/
---

# Astra.Components.LightingSettings

Iluminação da cena: Fonte do sol: qual luz direcional é o sol da cena. Família Luz · Luzes.

**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.LightingSettings
```

Iluminação da cena: Fonte do sol: qual luz direcional é o sol da cena. Família Luz · Luzes.

Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/lighting-window.html

**Interfaces:** `Astra.Components.IComponentFacade<Astra.Components.LightingSettings>`.

## Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Luz** / **Luzes** → **Iluminação da cena**.

No Behavior em Play, obtenha a fachada com `Object.GetComponent<LightingSettings>()`; trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar `new LightingSettings(component)` envolve um componente existente; não adiciona um componente à cena.

## Roadmap e uso

[Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/): o membro presente nesta referência pertence ao contrato atual. O roadmap registra a família; não há promessa/data individual de evolução para cada membro. Membros ainda sem explicação especializada são indicados como revisão editorial pendente.

Para ler os campos e recursos pelo caminho do editor, use [mapa de acesso](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

Consulte também [Iluminação da cena](/pt-br/snapshot-2026-10-28/componentes/astra-render-lighting-settings/) para propriedades, valores iniciais, requisitos e edição em Play.

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-5eb98af2748bdeb6) | Method |
| [GetLightingData](#member-b799ee6835e464c9) | Method |
| [Remove](#member-78a29a3e448df489) | Method |
| [SetLightingData](#member-e5824a45fc06a811) | Method |
| [Wrap](#member-57461efe0e393fdf) | Method |
| [AlbedoBoost](#member-ceb703b1d71ec319) | Property |
| [BakedGlobalIllumination](#member-4141fd4a3edbcf07) | Property |
| [Bounces](#member-9118f950e7ba6a32) | Property |
| [Component](#member-8d81c744c3d762f9) | Property |
| [CompressLightmaps](#member-2d4300a754bda907) | Property |
| [Denoise](#member-452bd72b4df3a6f6) | Property |
| [DirectionalMode](#member-3f74b8c209a38a75) | Property |
| [DirectSamples](#member-182410a23ba44391) | Property |
| [EnvironmentSamples](#member-f676971bdc3190d5) | Property |
| [IndirectIntensity](#member-fb114e58383148ae) | Property |
| [IndirectSamples](#member-d79265bcb5fa9066) | Property |
| [InstanceId](#member-50f5027f2a8225ae) | Property |
| [IsAlive](#member-7a0e35e57058c71d) | Property |
| [LightmapPadding](#member-6e8e9103f01d100b) | Property |
| [LightmapResolution](#member-c744163c7a47e03b) | Property |
| [MaxLightmapSize](#member-6f79f0335dc82f6d) | Property |
| [Object](#member-0dc2a280027d2bb7) | Property |
| [Sun](#member-f0993efd21f8e70b) | Property |
| [SunSource](#member-577ce35762cbe0b8) | Property |
| [TypeId](#member-9d2865aed789cf09) | Property |

<h3 id="member-5eb98af2748bdeb6" class="astra-member">.ctor</h3>

```csharp
public LightingSettings(Astra.Component component)
```

**Caminho:** Inspector → Iluminação da cena; ou fachada C# em um Behavior.

**Uso:** Constrói o tipo pela assinatura declarada. Um construtor de fachada envolve um componente existente; um record de configuração só tem efeito quando atribuído ao consumidor.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-b799ee6835e464c9" class="astra-member">GetLightingData</h3>

```csharp
public Astra.AssetGuid GetLightingData(uint slot = 0)
```

Dados de iluminação. Recurso do projeto por slot

**Caminho:** Inspector → Iluminação da cena; ou fachada C# em um Behavior.

**Uso:** Dados de iluminação. Recurso do projeto por slot

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-78a29a3e448df489" class="astra-member">Remove</h3>

```csharp
public void Remove()
```

Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.

**Caminho:** Inspector → Iluminação da cena; ou fachada C# em um Behavior.

**Uso:** Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e5824a45fc06a811" class="astra-member">SetLightingData</h3>

```csharp
public void SetLightingData(Astra.AssetGuid value, uint slot = 0)
```

**Caminho:** Inspector → Iluminação da cena; ou fachada C# em um Behavior.

**Uso:** Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `value` | `Astra.AssetGuid` |  |
| `slot` | `uint` |  · Opcional: `0` |

<h3 id="member-57461efe0e393fdf" class="astra-member">Wrap</h3>

```csharp
public static Astra.Components.LightingSettings Wrap(Astra.Component component)
```

**Caminho:** Inspector → Iluminação da cena; ou fachada C# em um Behavior.

**Uso:** Envolve um Component existente após conferir TypeId; não cria componente.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

| Parâmetro | Tipo | Contrato |
|---|---|---|
| `component` | `Astra.Component` |  |

<h3 id="member-ceb703b1d71ec319" class="astra-member">AlbedoBoost</h3>

```csharp
public float AlbedoBoost { get; set; }
```

Reforço de albedo. Clareia a cor que rebate (Albedo Boost)

Faixa válida: 1 a 10.

**Caminho:** Inspector → Iluminação da cena → Lightmaps; ou fachada C# em um Behavior.

**Uso:** **Reforço de albedo:** Clareia a cor que rebate (Albedo Boost)

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4141fd4a3edbcf07" class="astra-member">BakedGlobalIllumination</h3>

```csharp
public bool BakedGlobalIllumination { get; set; }
```

Iluminação global assada. Liga o Generate Lighting de lightmaps (Baked Global Illumination)

**Caminho:** Inspector → Iluminação da cena → Lightmaps; ou fachada C# em um Behavior.

**Uso:** **Iluminação global assada:** Liga o Generate Lighting de lightmaps (Baked Global Illumination)

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9118f950e7ba6a32" class="astra-member">Bounces</h3>

```csharp
public Astra.Components.LightingSettings.BouncesOption Bounces { get; set; }
```

Rebotes. Quantas vezes a luz rebate entre superfícies (Bounces)

**Caminho:** Inspector → Iluminação da cena → Lightmaps; ou fachada C# em um Behavior.

**Uso:** **Rebotes:** Quantas vezes a luz rebate entre superfícies (Bounces)

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8d81c744c3d762f9" class="astra-member">Component</h3>

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

**Caminho:** Inspector → Iluminação da cena; ou fachada C# em um Behavior.

**Uso:** Handle genérico da instância, usado para operações de reflexão e recursos.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-2d4300a754bda907" class="astra-member">CompressLightmaps</h3>

```csharp
public bool CompressLightmaps { get; set; }
```

Comprimir lightmaps. 8 bits por canal com faixa por página; desligado usa meia precisão (Compress Lightmaps)

**Caminho:** Inspector → Iluminação da cena → Lightmaps; ou fachada C# em um Behavior.

**Uso:** **Comprimir lightmaps:** 8 bits por canal com faixa por página; desligado usa meia precisão (Compress Lightmaps)

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-452bd72b4df3a6f6" class="astra-member">Denoise</h3>

```csharp
public bool Denoise { get; set; }
```

Remover ruído. Filtro guiado por normal e posição depois do bake (Filtering)

**Caminho:** Inspector → Iluminação da cena → Lightmaps; ou fachada C# em um Behavior.

**Uso:** **Remover ruído:** Filtro guiado por normal e posição depois do bake (Filtering)

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-3f74b8c209a38a75" class="astra-member">DirectionalMode</h3>

```csharp
public Astra.Components.LightingSettings.DirectionalModeOption DirectionalMode { get; set; }
```

Modo direcional. Não direcional guarda só a irradiância (Directional Mode › Non-Directional)

**Caminho:** Inspector → Iluminação da cena → Lightmaps; ou fachada C# em um Behavior.

**Uso:** **Modo direcional:** Não direcional guarda só a irradiância (Directional Mode › Non-Directional)

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-182410a23ba44391" class="astra-member">DirectSamples</h3>

```csharp
public float DirectSamples { get; set; }
```

Amostras diretas. Raios de sombra por texel das luzes com raio de sombra (Direct Samples)

Faixa válida: 1 a 4096.

**Caminho:** Inspector → Iluminação da cena → Lightmaps; ou fachada C# em um Behavior.

**Uso:** **Amostras diretas:** Raios de sombra por texel das luzes com raio de sombra (Direct Samples)

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f676971bdc3190d5" class="astra-member">EnvironmentSamples</h3>

```csharp
public float EnvironmentSamples { get; set; }
```

Amostras do ambiente. Raios por texel para a visibilidade do céu (Environment Samples)

Faixa válida: 8 a 8192.

**Caminho:** Inspector → Iluminação da cena → Lightmaps; ou fachada C# em um Behavior.

**Uso:** **Amostras do ambiente:** Raios por texel para a visibilidade do céu (Environment Samples)

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-fb114e58383148ae" class="astra-member">IndirectIntensity</h3>

```csharp
public float IndirectIntensity { get; set; }
```

Intensidade indireta. Multiplica a luz indireta e o céu assados (Indirect Intensity)

Faixa válida: 0 a 5.

**Caminho:** Inspector → Iluminação da cena → Lightmaps; ou fachada C# em um Behavior.

**Uso:** **Intensidade indireta:** Multiplica a luz indireta e o céu assados (Indirect Intensity)

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-d79265bcb5fa9066" class="astra-member">IndirectSamples</h3>

```csharp
public float IndirectSamples { get; set; }
```

Amostras indiretas. Raios por texel em cada rebote (Indirect Samples)

Faixa válida: 8 a 8192.

**Caminho:** Inspector → Iluminação da cena → Lightmaps; ou fachada C# em um Behavior.

**Uso:** **Amostras indiretas:** Raios por texel em cada rebote (Indirect Samples)

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-50f5027f2a8225ae" class="astra-member">InstanceId</h3>

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

**Caminho:** Inspector → Iluminação da cena; ou fachada C# em um Behavior.

**Uso:** Distingue a instância no mesmo objeto; importante para componentes múltiplos.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-7a0e35e57058c71d" class="astra-member">IsAlive</h3>

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

**Caminho:** Inspector → Iluminação da cena; ou fachada C# em um Behavior.

**Uso:** Validade do handle no mundo/geração atuais. Remoção e novo Play invalidam a referência.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6e8e9103f01d100b" class="astra-member">LightmapPadding</h3>

```csharp
public float LightmapPadding { get; set; }
```

Espaçamento do lightmap (texels). Texels entre objetos na página (Lightmap Padding)

Faixa válida: 0 a 16.

**Caminho:** Inspector → Iluminação da cena → Lightmaps; ou fachada C# em um Behavior.

**Uso:** **Espaçamento do lightmap:** Texels entre objetos na página (Lightmap Padding)

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c744163c7a47e03b" class="astra-member">LightmapResolution</h3>

```csharp
public float LightmapResolution { get; set; }
```

Resolução do lightmap (texels/m). Texels por metro de superfície (Lightmap Resolution; Unity: 40)

Faixa válida: 0.1 a 400.

**Caminho:** Inspector → Iluminação da cena → Lightmaps; ou fachada C# em um Behavior.

**Uso:** **Resolução do lightmap:** Texels por metro de superfície (Lightmap Resolution; Unity: 40)

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-6f79f0335dc82f6d" class="astra-member">MaxLightmapSize</h3>

```csharp
public Astra.Components.LightingSettings.MaxLightmapSizeOption MaxLightmapSize { get; set; }
```

Tamanho máximo do lightmap. Lado máximo de cada página (Max Lightmap Size)

**Caminho:** Inspector → Iluminação da cena → Lightmaps; ou fachada C# em um Behavior.

**Uso:** **Tamanho máximo do lightmap:** Lado máximo de cada página (Max Lightmap Size)

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0dc2a280027d2bb7" class="astra-member">Object</h3>

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

**Caminho:** Inspector → Iluminação da cena; ou fachada C# em um Behavior.

**Uso:** Objeto dono deste componente; use para resolver composição.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f0993efd21f8e70b" class="astra-member">Sun</h3>

```csharp
public Astra.ObjectReference Sun { get; set; }
```

Lighting › Sun Source (RenderSettings.sun).

**Caminho:** Inspector → Iluminação da cena; ou fachada C# em um Behavior.

**Uso:** Lighting › Sun Source (RenderSettings.sun).

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-577ce35762cbe0b8" class="astra-member">SunSource</h3>

```csharp
public Astra.ObjectReference SunSource { get; set; }
```

Fonte do sol. A luz direcional que é o sol da cena: projeta as cascatas e aparece no céu

**Caminho:** Inspector → Iluminação da cena → Ambiente; ou fachada C# em um Behavior.

**Uso:** **Fonte do sol:** A luz direcional que é o sol da cena: projeta as cascatas e aparece no céu

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-9d2865aed789cf09" class="astra-member">TypeId</h3>

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

**Caminho:** Inspector → Iluminação da cena; ou fachada C# em um Behavior.

**Uso:** Identificador nativo usado em AddComponent/GetComponent.

**Roadmap deste membro:** [Renderização e materiais](/pt-br/snapshot-2026-10-06/roadmap/renderizacao-e-materiais/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.