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
ColorRgb	Property
ColorTemperature	Property
Component	Property
CullingMask	Property
CullingMaskBits	Property
Enabled	Property
InnerSpotAngle	Property
InstanceId	Property
Intensity	Property
IsAlive	Property
Kind	Property
Mode	Property
Object	Property
Range	Property
RenderingLayerMask	Property
RenderingLayers	Property
ShadowBias	Property
ShadowMode	Property
ShadowNearPlane	Property
ShadowNormalBias	Property
ShadowResolution	Property
Shadows	Property
ShadowStrength	Property
SpotAngle	Property
Type	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. Cor sRGB, como o seletor; o motor converte para linear

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

Uso: Cor R: Componente sRGB, o mesmo número do seletor de cor; o motor converte para linear Cor G: Componente sRGB, o mesmo número do seletor de cor; o motor converte para linear Cor B: Componente sRGB, o mesmo número do seletor de cor; o motor converte para linear

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

ColorRgb

public Astra.Color ColorRgb { get; set; }

Light.color em sRGB, como o seletor.

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

Uso: Light.color em sRGB, como o seletor.

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.

CullingMask

public Astra.Components.Light.CullingMaskOption CullingMask { get; set; }

Máscara de culling. Camadas de objeto que esta luz ilumina

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

Uso: Máscara de culling: Camadas de objeto que esta luz ilumina

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

CullingMaskBits

public uint CullingMaskBits { get; set; }

Light.cullingMask (bits das camadas de objeto).

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

Uso: Light.cullingMask (bits das camadas de objeto).

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.

InnerSpotAngle

public float InnerSpotAngle { get; set; }

Ângulo interno do spot (°). Abertura total do miolo com intensidade plena (Inner Spot Angle)

Faixa válida: 0 a 179.

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

Uso: Ângulo interno do spot: Abertura total do miolo com intensidade plena (Inner Spot Angle)

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; }

Tipo. Direcional ilumina a cena inteira numa direção; pontual e spot partem de um ponto

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

Uso: Tipo: Direcional ilumina a cena inteira numa direção; pontual e spot partem de um ponto

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

Mode

public Astra.Components.Light.ModeOption Mode { get; set; }

Modo. Tempo real ilumina a cada quadro; Misto assa só o rebote; Assado grava luz e rebote no lightmap

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

Uso: Modo: Tempo real ilumina a cada quadro; Misto assa só o rebote; Assado grava luz e rebote no lightmap

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.

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.

RenderingLayerMask

public uint RenderingLayerMask { get; set; }

Light.renderingLayerMask (bits das Rendering Layers).

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

Uso: Light.renderingLayerMask (bits das Rendering Layers).

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

RenderingLayers

public Astra.Components.Light.RenderingLayersOption RenderingLayers { get; set; }

Camadas de renderização. Ilumina só renderers com uma camada de renderização em comum

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

Uso: Camadas de renderização: Ilumina só renderers com uma camada de renderização em comum

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; 0,05 é o desvio da política do aparelho

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; 0,05 é o desvio da política do aparelho

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; }

Tipo de sombra. Dura usa uma busca; suave filtra a borda. A política do aparelho pode desligar a sombra

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

Uso: Tipo de sombra: Dura usa uma busca; suave filtra a borda. A política do aparelho pode desligar a sombra

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; 0,4 é o deslocamento da política do aparelho

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; 0,4 é o deslocamento da política do aparelho

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.

Shadows

public Astra.Components.LightShadows Shadows { get; set; }

Light.shadows.

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

Uso: Light.shadows.

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.

SpotAngle

public float SpotAngle { get; set; }

Ângulo do spot (°). Abertura total do cone (Spot Angle); a luz zera na borda

Faixa válida: 1 a 179.

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

Uso: Ângulo do spot: Abertura total do cone (Spot Angle); a luz zera na borda

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

Type

public Astra.Components.LightType Type { get; set; }

Light.type.

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

Uso: Light.type.

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. Relativa é a intensidade da URP; lux, candela e lúmen são as unidades físicas da HDRP

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

Uso: Unidade: Relativa é a intensidade da URP; lux, candela e lúmen são as unidades físicas da HDRP

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.