Astra.Components.ReflectionProbe
Sonda de reflexo: Captura a cena num cubemap: metal e vidro refletem o cômodo em vez do céu. Família Luz · Sondas.
Namespace: Astra.Components · Assembly: Astra.Scripting · Tipo: Struct
Declaração
Seção intitulada “Declaração”readonly struct Astra.Components.ReflectionProbeSonda de reflexo: Captura a cena num cubemap: metal e vidro refletem o cômodo em vez do céu. Família Luz · Sondas.
Referência estudada: https://docs.unity3d.com/6000.0/Documentation/Manual/class-ReflectionProbe.html
Interfaces: Astra.Components.IComponentFacade<Astra.Components.ReflectionProbe>.
Onde acessar este tipo
Seção intitulada “Onde acessar este tipo”Hierarquia → selecione o objeto → Inspector → Adicionar componente → Luz / Sondas → Sonda de reflexo.
No Behavior em Play, obtenha a fachada com Object.GetComponent<ReflectionProbe>(); trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar new ReflectionProbe(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 Sonda de reflexo para propriedades, valores iniciais, requisitos e edição em Play.
Membros
Seção intitulada “Membros”| Membro | Categoria |
|---|---|
| .ctor | Method |
| GetBakedTexture | Method |
| Remove | Method |
| RenderProbe | Method |
| SetBakedTexture | Method |
| Wrap | Method |
| Background | Property |
| BakedTexture | Property |
| BlendDistance | Property |
| BoxOffset | Property |
| BoxProjection | Property |
| BoxSize | Property |
| Center | Property |
| ClearFlags | Property |
| Component | Property |
| CullingMask | Property |
| Enabled | Property |
| FarClip | Property |
| FarClipPlane | Property |
| Hdr | Property |
| Importance | Property |
| InstanceId | Property |
| Intensity | Property |
| IsAlive | Property |
| Mode | Property |
| NearClip | Property |
| NearClipPlane | Property |
| Object | Property |
| RefreshMode | Property |
| RefreshModeUnity | Property |
| Resolution | Property |
| Size | Property |
| TimeSlicing | Property |
| TimeSlicingMode | Property |
| Type | Property |
| TypeId | Property |
.ctor
public ReflectionProbe(Astra.Component component)Caminho: Inspector → Sonda de reflexo; 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 |
GetBakedTexture
public Astra.AssetGuid GetBakedTexture(uint slot = 0)Cubemap assado. Recurso do projeto por slot
Caminho: Inspector → Sonda de reflexo; ou fachada C# em um Behavior.
Uso: Cubemap assado. 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 → Sonda de reflexo; 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.
RenderProbe
public void RenderProbe()Capturar agora. Recaptura a sonda de tempo real no próximo quadro (RenderProbe da Unity)
Executado no mundo de Play; fora dele lança WorldException NotRunning.
Caminho: Inspector → Sonda de reflexo; ou fachada C# em um Behavior.
Uso: Capturar agora. Recaptura a sonda de tempo real no próximo quadro (RenderProbe da Unity)
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
SetBakedTexture
public void SetBakedTexture(Astra.AssetGuid value, uint slot = 0)Caminho: Inspector → Sonda de reflexo; 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.ReflectionProbe Wrap(Astra.Component component)Caminho: Inspector → Sonda de reflexo; 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 |
Background
public System.Numerics.Vector3 Background { get; set; }Cor de fundo. Cor sRGB, como o seletor; o motor converte para linear
Caminho: Inspector → Sonda de reflexo → Captura; ou fachada C# em um Behavior.
Uso: Fundo R: Canal vermelho da cor de fundo da captura quando Fundo = Cor sólida. Fundo G: Canal verde da cor de fundo da captura quando Fundo = Cor sólida. Fundo B: Canal azul da cor de fundo da captura quando Fundo = Cor sólida.
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
BakedTexture
public Astra.AssetGuid BakedTexture { get; set; }ReflectionProbe.bakedTexture: o recurso assado (.aeprobe).
Caminho: Inspector → Sonda de reflexo; ou fachada C# em um Behavior.
Uso: ReflectionProbe.bakedTexture: o recurso assado (.aeprobe).
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
BlendDistance
public float BlendDistance { get; set; }Distância de mistura (m). Faixa dentro da caixa em que o reflexo passa desta sonda para a vizinha ou para o céu
Faixa válida: 0 a 100.
Caminho: Inspector → Sonda de reflexo → Tempo de execução; ou fachada C# em um Behavior.
Uso: Distância de mistura: Faixa dentro da caixa em que o reflexo passa desta sonda para a vizinha ou para o céu
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
BoxOffset
public System.Numerics.Vector3 BoxOffset { get; set; }Deslocamento da caixa
Caminho: Inspector → Sonda de reflexo → Tempo de execução; ou fachada C# em um Behavior.
Uso: Deslocamento X: Deslocamento da caixa em relação ao objeto no eixo X; a captura continua na posição do objeto. Deslocamento Y: Deslocamento da caixa em relação ao objeto no eixo Y; a captura continua na posição do objeto. Deslocamento Z: Deslocamento da caixa em relação ao objeto no eixo Z; a captura continua na posição do objeto.
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
BoxProjection
public bool BoxProjection { get; set; }Projeção na caixa. Paredes a distância finita: o reflexo muda com a posição na sala, em vez de ficar no infinito
Caminho: Inspector → Sonda de reflexo → Tempo de execução; ou fachada C# em um Behavior.
Uso: Projeção na caixa: Paredes a distância finita: o reflexo muda com a posição na sala, em vez de ficar no infinito
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
BoxSize
public System.Numerics.Vector3 BoxSize { get; set; }Tamanho da caixa
Caminho: Inspector → Sonda de reflexo → Tempo de execução; ou fachada C# em um Behavior.
Uso: Tamanho X: Tamanho da caixa de influência no eixo X, em metros. Com Projeção na caixa, deve coincidir com as paredes. Tamanho Y: Tamanho da caixa de influência no eixo Y, em metros. Com Projeção na caixa, deve coincidir com as paredes. Tamanho Z: Tamanho da caixa de influência no eixo Z, em metros. Com Projeção na caixa, deve coincidir com as paredes.
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Center
public System.Numerics.Vector3 Center { get; set; }Caminho: Inspector → Sonda de reflexo; ou fachada C# em um Behavior.
Uso: Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
ClearFlags
public Astra.Components.ReflectionProbe.ClearFlagsOption ClearFlags { get; set; }Fundo. O que aparece onde não há objeto: o céu da cena ou uma cor
Caminho: Inspector → Sonda de reflexo → Captura; ou fachada C# em um Behavior.
Uso: Fundo: O que aparece onde não há objeto: o céu da cena ou uma cor
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 → Sonda de reflexo; 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.ReflectionProbe.CullingMaskOption CullingMask { get; set; }Máscara de culling. Só objetos destas camadas entram no reflexo
Caminho: Inspector → Sonda de reflexo → Captura; ou fachada C# em um Behavior.
Uso: Máscara de culling: Só objetos destas camadas entram no reflexo
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; }Ativa
Caminho: Inspector → Sonda de reflexo → Tempo de execução; ou fachada C# em um Behavior.
Uso: Ativa: 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.
FarClip
public float FarClip { get; set; }Plano distante (m). Nada mais longe que isto entra no reflexo; além dele aparece o fundo
Faixa válida: 0.1 a 100000.
Caminho: Inspector → Sonda de reflexo → Captura; ou fachada C# em um Behavior.
Uso: Plano distante: Nada mais longe que isto entra no reflexo; além dele aparece o fundo
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
FarClipPlane
public float FarClipPlane { get; set; }Caminho: Inspector → Sonda de reflexo; ou fachada C# em um Behavior.
Uso: Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Hdr
public bool Hdr { get; set; }HDR. Guarda brilho acima de 1 (sol, lâmpadas); desligado, a captura é cortada em 0..1 e o recurso ocupa metade
Caminho: Inspector → Sonda de reflexo → Captura; ou fachada C# em um Behavior.
Uso: HDR: Guarda brilho acima de 1 (sol, lâmpadas); desligado, a captura é cortada em 0..1 e o recurso ocupa metade
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Importance
public float Importance { get; set; }Importância. Entre sondas sobrepostas, o objeto mistura as duas de maior importância
Faixa válida: 0 a 32767.
Caminho: Inspector → Sonda de reflexo → Tempo de execução; ou fachada C# em um Behavior.
Uso: Importância: Entre sondas sobrepostas, o objeto mistura as duas de maior importância
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 → Sonda de reflexo; 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. Multiplica o reflexo desta sonda nos materiais
Faixa válida: 0 a 10.
Caminho: Inspector → Sonda de reflexo → Tempo de execução; ou fachada C# em um Behavior.
Uso: Intensidade: Multiplica o reflexo desta sonda nos materiais
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 → Sonda de reflexo; 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.
Mode
public Astra.Components.ReflectionProbeMode Mode { get; set; }Caminho: Inspector → Sonda de reflexo; ou fachada C# em um Behavior.
Uso: Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
NearClip
public float NearClip { get; set; }Plano próximo (m). Nada mais perto da sonda que isto entra no reflexo
Faixa válida: 0.01 a 1000.
Caminho: Inspector → Sonda de reflexo → Captura; ou fachada C# em um Behavior.
Uso: Plano próximo: Nada mais perto da sonda que isto entra no reflexo
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
NearClipPlane
public float NearClipPlane { get; set; }Caminho: Inspector → Sonda de reflexo; ou fachada C# em um Behavior.
Uso: Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.
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 → Sonda de reflexo; 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.
RefreshMode
public Astra.Components.ReflectionProbe.RefreshModeOption RefreshMode { get; set; }Atualização. Ao acordar captura uma vez no início do Play; Todo quadro recaptura sem parar; Por script espera RenderProbe()
Caminho: Inspector → Sonda de reflexo → Tempo real; ou fachada C# em um Behavior.
Uso: Atualização: Ao acordar captura uma vez no início do Play; Todo quadro recaptura sem parar; Por script espera RenderProbe()
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
RefreshModeUnity
public Astra.Components.ReflectionProbeRefreshMode RefreshModeUnity { get; set; }Caminho: Inspector → Sonda de reflexo; ou fachada C# em um Behavior.
Uso: Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Resolution
public Astra.Components.ReflectionProbe.ResolutionOption Resolution { get; set; }Resolução. Lado de cada face capturada; mais nitidez em metal liso, mais custo de captura
Caminho: Inspector → Sonda de reflexo → Captura; ou fachada C# em um Behavior.
Uso: Resolução: Lado de cada face capturada; mais nitidez em metal liso, mais custo de captura
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Size
public System.Numerics.Vector3 Size { get; set; }Caminho: Inspector → Sonda de reflexo; ou fachada C# em um Behavior.
Uso: Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
TimeSlicing
public Astra.Components.ReflectionProbe.TimeSlicingOption TimeSlicing { get; set; }Fatiamento no tempo. Espalha a captura e o filtro por vários quadros para não pesar num quadro só
Caminho: Inspector → Sonda de reflexo → Tempo real; ou fachada C# em um Behavior.
Uso: Fatiamento no tempo: Espalha a captura e o filtro por vários quadros para não pesar num quadro só
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
TimeSlicingMode
public Astra.Components.ReflectionProbeTimeSlicingMode TimeSlicingMode { get; set; }Caminho: Inspector → Sonda de reflexo; ou fachada C# em um Behavior.
Uso: Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.
Roadmap deste membro: Renderização e materiais. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Type
public Astra.Components.ReflectionProbe.TypeOption Type { get; set; }Tipo. Assada é capturada no editor e guardada no projeto; Tempo real recaptura no aparelho
Caminho: Inspector → Sonda de reflexo → Geral; ou fachada C# em um Behavior.
Uso: Tipo: Assada é capturada no editor e guardada no projeto; Tempo real recaptura no aparelho
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 → Sonda de reflexo; 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.