Astra.Components.LightProbeGroup
Grupo de sondas de luz: Pontos que guardam a luz da cena para iluminar objetos que se movem. Família Luz · Sondas.
Namespace: Astra.Components · Assembly: Astra.Scripting · Tipo: Struct
Declaração
Seção intitulada “Declaração”readonly struct Astra.Components.LightProbeGroupGrupo de sondas de luz: Pontos que guardam a luz da cena para iluminar objetos que se movem. Família Luz · Sondas.
Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-LightProbeGroup.html
Interfaces: Astra.Components.IComponentFacade<Astra.Components.LightProbeGroup>.
Onde acessar este tipo
Seção intitulada “Onde acessar este tipo”Hierarquia → selecione o objeto → Inspector → Adicionar componente → Luz / Sondas → Grupo de sondas de luz.
No Behavior em Play, obtenha a fachada com Object.GetComponent<LightProbeGroup>(); trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar new LightProbeGroup(component) envolve um componente existente; não adiciona um componente à cena.
Roadmap e uso
Seção intitulada “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 Grupo de sondas de luz para propriedades, valores iniciais, requisitos e edição em Play.
Membros
Seção intitulada “Membros”| Membro | Categoria |
|---|---|
| .ctor | Method |
| GetBakedData | Method |
| GetProbePosition | Method |
| GetProbePositionX | Method |
| GetProbePositionY | Method |
| GetProbePositionZ | Method |
| ProbeCount | Method |
| Remove | Method |
| SetBakedData | Method |
| SetProbePosition | Method |
| SetProbePositionX | Method |
| SetProbePositionY | Method |
| SetProbePositionZ | Method |
| Wrap | Method |
| Component | Property |
| Enabled | Property |
| InstanceId | Property |
| IsAlive | Property |
| Object | Property |
| RemoveRinging | Property |
| ShowWireframe | Property |
| TypeId | Property |
.ctor
public LightProbeGroup(Astra.Component component)Caminho: Inspector → Grupo de sondas de 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 |
GetBakedData
public Astra.AssetGuid GetBakedData(uint slot = 0)Sondas assadas. Recurso do projeto por slot
Caminho: Inspector → Grupo de sondas de luz; ou fachada C# em um Behavior.
Uso: Sondas assadas. 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 |
GetProbePosition
public System.Numerics.Vector3 GetProbePosition(uint index)LightProbeGroup.probePositions[index], no espaço do objeto.
Caminho: Inspector → Grupo de sondas de luz; ou fachada C# em um Behavior.
Uso: LightProbeGroup.probePositions[index], no espaço do objeto.
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
index |
uint |
GetProbePositionX
public float GetProbePositionX(uint slot)Posição X (m). Valor por slot
Caminho: Inspector → Grupo de sondas de luz; ou fachada C# em um Behavior.
Uso: Posição X (m). Valor 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 |
GetProbePositionY
public float GetProbePositionY(uint slot)Posição Y (m). Valor por slot
Caminho: Inspector → Grupo de sondas de luz; ou fachada C# em um Behavior.
Uso: Posição Y (m). Valor 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 |
GetProbePositionZ
public float GetProbePositionZ(uint slot)Posição Z (m). Valor por slot
Caminho: Inspector → Grupo de sondas de luz; ou fachada C# em um Behavior.
Uso: Posição Z (m). Valor 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 |
ProbeCount
public long ProbeCount()Quantidade de sondas. Quantos pontos o grupo tem (probePositions.Length da Unity)
Executado no mundo de Play; fora dele lança WorldException NotRunning.
Caminho: Inspector → Grupo de sondas de luz; ou fachada C# em um Behavior.
Uso: Quantidade de sondas. Quantos pontos o grupo tem (probePositions.Length da Unity)
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Remove
public void Remove()Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.
Caminho: Inspector → Grupo de sondas de 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.
SetBakedData
public void SetBakedData(Astra.AssetGuid value, uint slot = 0)Caminho: Inspector → Grupo de sondas de luz; 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 |
SetProbePosition
public void SetProbePosition(uint index, System.Numerics.Vector3 position)Caminho: Inspector → Grupo de sondas de luz; 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 |
|---|---|---|
index |
uint |
|
position |
System.Numerics.Vector3 |
SetProbePositionX
public void SetProbePositionX(uint slot, float value)Caminho: Inspector → Grupo de sondas de luz; 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 |
|---|---|---|
slot |
uint |
|
value |
float |
SetProbePositionY
public void SetProbePositionY(uint slot, float value)Caminho: Inspector → Grupo de sondas de luz; 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 |
|---|---|---|
slot |
uint |
|
value |
float |
SetProbePositionZ
public void SetProbePositionZ(uint slot, float value)Caminho: Inspector → Grupo de sondas de luz; 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 |
|---|---|---|
slot |
uint |
|
value |
float |
Wrap
public static Astra.Components.LightProbeGroup Wrap(Astra.Component component)Caminho: Inspector → Grupo de sondas de 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 |
Component
public Astra.Component Component { get; }Caminho: Inspector → Grupo de sondas de 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; }Ativo
Caminho: Inspector → Grupo de sondas de luz → Sondas; ou fachada C# em um Behavior.
Uso: Ativo: Desligado, o componente para de agir e conserva os dados.
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 → Grupo de sondas de 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.
IsAlive
public bool IsAlive { get; }Caminho: Inspector → Grupo de sondas de 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.
Object
public Astra.GameObject Object { get; }Caminho: Inspector → Grupo de sondas de 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.
RemoveRinging
public bool RemoveRinging { get; set; }Remover anéis. Tira os halos escuros atrás de uma luz forte; a luz das sondas fica mais suave
Caminho: Inspector → Grupo de sondas de luz → Sondas; ou fachada C# em um Behavior.
Uso: Remover anéis: Tira os halos escuros atrás de uma luz forte; a luz das sondas fica mais suave
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
ShowWireframe
public bool ShowWireframe { get; set; }Mostrar arestas. Desenha no viewport os tetraedros que ligam as sondas
Caminho: Inspector → Grupo de sondas de luz → Sondas; ou fachada C# em um Behavior.
Uso: Mostrar arestas: Desenha no viewport os tetraedros que ligam as sondas
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 → Grupo de sondas de 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.