Pular para o conteúdo
AstraDOCS

Astra.Components.LightingSettings

Astra 0.4.0-preview.20261028Referência de assinaturas

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

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>.

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.

Renderização 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.

Consulte também Iluminação da cena para propriedades, valores iniciais, requisitos e edição em Play.

Membro Categoria
.ctor Method
GetLightingData Method
Remove Method
SetLightingData Method
Wrap Method
AlbedoBoost Property
BakedGlobalIllumination Property
Bounces Property
Component Property
CompressLightmaps Property
Denoise Property
DirectionalMode Property
DirectSamples Property
EnvironmentSamples Property
IndirectIntensity Property
IndirectSamples Property
InstanceId Property
IsAlive Property
LightmapPadding Property
LightmapResolution Property
MaxLightmapSize Property
Object Property
Sun Property
SunSource Property
TypeId Property

.ctor

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro Tipo Contrato
component Astra.Component

GetLightingData

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro Tipo Contrato
slot uint · Opcional: 0

Remove

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

SetLightingData

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

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

Wrap

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro Tipo Contrato
component Astra.Component

AlbedoBoost

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

BakedGlobalIllumination

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Bounces

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Component

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

CompressLightmaps

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Denoise

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

DirectionalMode

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

DirectSamples

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

EnvironmentSamples

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

IndirectIntensity

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

IndirectSamples

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

InstanceId

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

IsAlive

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

LightmapPadding

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

LightmapResolution

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

MaxLightmapSize

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Object

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Sun

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

SunSource

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

TypeId

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. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.