Astra.Components.Light

Namespace: Astra.Components · Assembly: Astra.Scripting · Tipo: Struct

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

readonly struct Astra.Components.Light

Luz: Direcional, pontual ou spot. Família Luz · Luzes.

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

Interfaces: Astra.Components.IComponentFacade<Astra.Components.Light>.

Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → Luz / Luzes → Luz.

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

Roadmap e uso

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 Luz para propriedades, valores iniciais, requisitos e edição em Play.

Membros

Membro	Categoria
.ctor	Method
Remove	Method
Wrap	Method
Color	Property
ColorTemperature	Property
Component	Property
Enabled	Property
InnerAngle	Property
InstanceId	Property
Intensity	Property
IsAlive	Property
Kind	Property
Object	Property
OuterAngle	Property
Range	Property
ShadowBias	Property
ShadowMode	Property
ShadowNearPlane	Property
ShadowNormalBias	Property
ShadowResolution	Property
ShadowStrength	Property
TypeId	Property
Unit	Property
UseColorTemperature	Property

.ctor

public Light(Astra.Component component)

Caminho: Inspector → Luz; 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

Remove

public void Remove()

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

Caminho: Inspector → Luz; 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.

Wrap

public static Astra.Components.Light Wrap(Astra.Component component)

Caminho: Inspector → Luz; 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

Color

public System.Numerics.Vector3 Color { get; set; }

Cor linear. Cor linear RGB

Caminho: Inspector → Luz → Emissão; ou fachada C# em um Behavior.

Uso: Cor R: Canal R da cor color no consumidor correspondente. Combine os três canais e intensidade quando existente. Cor G: Canal G da cor color no consumidor correspondente. Combine os três canais e intensidade quando existente. Cor B: Canal B da cor color no consumidor correspondente. Combine os três canais e intensidade quando existente.

Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

ColorTemperature

public float ColorTemperature { get; set; }

Temperatura (K). Multiplicada pela cor linear; D65 é 6500 K

Faixa válida: 1667 a 25000.

Caminho: Inspector → Luz → Emissão; ou fachada C# em um Behavior.

Uso: Temperatura: Multiplicada pela cor linear; D65 é 6500 K

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 → Luz; 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.

Enabled

public bool Enabled { get; set; }

Acesa. Ativa a contribuição desta luz

Caminho: Inspector → Luz → Geral; ou fachada C# em um Behavior.

Uso: Acesa: Ativa a contribuição desta luz

Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

InnerAngle

public float InnerAngle { get; set; }

Meio-cone interno (°)

Faixa válida: 0 a 89.

Caminho: Inspector → Luz → Volume; ou fachada C# em um Behavior.

Uso: Meio-cone interno: Ângulo interno do cone spot; região de contribuição central.

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 → Luz; 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.

Intensity

public float Intensity { get; set; }

Intensidade

Faixa válida: 0 a 1000000.

Caminho: Inspector → Luz → Emissão; ou fachada C# em um Behavior.

Uso: Intensidade: Energia da luz na unidade selecionada; compare com distância/alcance constantes.

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 → Luz; 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.

Kind

public Astra.Components.Light.KindOption Kind { get; set; }

Modalidade. Tipo de emissão da luz

Caminho: Inspector → Luz → Geral; ou fachada C# em um Behavior.

Uso: Modalidade: Tipo de emissão da luz

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 → Luz; 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.

OuterAngle

public float OuterAngle { get; set; }

Meio-cone externo (°)

Faixa válida: 0 a 89.

Caminho: Inspector → Luz → Volume; ou fachada C# em um Behavior.

Uso: Meio-cone externo: Ângulo externo do cone spot; limite de contribuição.

Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Range

public float Range { get; set; }

Alcance (m)

Faixa válida: 0.01 a 1000.

Caminho: Inspector → Luz → Volume; ou fachada C# em um Behavior.

Uso: Alcance: Alcance de contribuição da luz pontual/spot.

Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

ShadowBias

public float ShadowBias { get; set; }

Desvio (texel). Afasta a comparação de profundidade e some com a acne

Faixa válida: 0 a 2.

Caminho: Inspector → Luz → Sombra; ou fachada C# em um Behavior.

Uso: Desvio: Afasta a comparação de profundidade e some com a acne

Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

ShadowMode

public Astra.Components.Light.ShadowModeOption ShadowMode { get; set; }

Sombra. Projeção de sombra desta luz no atlas local

Caminho: Inspector → Luz → Sombra; ou fachada C# em um Behavior.

Uso: Sombra: Projeção de sombra desta luz no atlas local

Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

ShadowNearPlane

public float ShadowNearPlane { get; set; }

Plano próximo da sombra (m). Perto demais perde precisão; longe demais corta o que está junto da lâmpada

Faixa válida: 0.01 a 10.

Caminho: Inspector → Luz → Sombra; ou fachada C# em um Behavior.

Uso: Plano próximo da sombra: Perto demais perde precisão; longe demais corta o que está junto da lâmpada

Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

ShadowNormalBias

public float ShadowNormalBias { get; set; }

Desvio na normal (texel). Desloca a amostra ao longo da normal; some com o serrilhado da borda

Faixa válida: 0 a 2.

Caminho: Inspector → Luz → Sombra; ou fachada C# em um Behavior.

Uso: Desvio na normal: Desloca a amostra ao longo da normal; some com o serrilhado da borda

Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

ShadowResolution

public Astra.Components.Light.ShadowResolutionOption ShadowResolution { get; set; }

Resolução da sombra. Automática escolhe pelo tamanho da luz na tela

Caminho: Inspector → Luz → Sombra; ou fachada C# em um Behavior.

Uso: Resolução da sombra: Automática escolhe pelo tamanho da luz na tela

Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

ShadowStrength

public float ShadowStrength { get; set; }

Força da sombra. 1 é sombra opaca; abaixo disso a luz vaza pelo oclusor

Faixa válida: 0 a 1.

Caminho: Inspector → Luz → Sombra; ou fachada C# em um Behavior.

Uso: Força da sombra: 1 é sombra opaca; abaixo disso a luz vaza pelo oclusor

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 → Luz; 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.

Unit

public Astra.Components.Light.UnitOption Unit { get; set; }

Unidade. Direcional usa lux; luz local usa candela ou lúmen

Caminho: Inspector → Luz → Emissão; ou fachada C# em um Behavior.

Uso: Unidade: Direcional usa lux; luz local usa candela ou lúmen

Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

UseColorTemperature

public bool UseColorTemperature { get; set; }

Filtro por temperatura. Multiplica a cor pela temperatura de corpo negro

Caminho: Inspector → Luz → Emissão; ou fachada C# em um Behavior.

Uso: Filtro por temperatura: Multiplica a cor pela temperatura de corpo negro

Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.