Pular para o conteúdo
AstraDOCS

Astra.Components.Camera

Astra 0.4.0-preview.20261028Referência de assinaturas

Câmera: Projeção e enquadramento. Família Câmera · Projeção.

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

readonly struct Astra.Components.Camera

Câmera: Projeção e enquadramento. Família Câmera · Projeção.

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

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

Hierarquia → selecione o objeto → Inspector → Adicionar componente → Câmera / Projeção → Câmera.

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

Câmera e navegação: 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 Câmera para propriedades, valores iniciais, requisitos e edição em Play.

Membro Categoria
.ctor Method
Remove Method
Wrap Method
AllowHDR Property
Antialiasing Property
BackgroundColor Property
BackgroundType Property
ClearFlags Property
Component Property
CullingMask Property
CullingMaskBits Property
Depth Property
Enabled Property
EnvironmentMask Property
FarClipPlane Property
FarPlane Property
FieldOfView Property
FocalLength Property
GateFit Property
Hdr Property
InstanceId Property
IsAlive Property
NearClipPlane Property
NearPlane Property
Object Property
Orthographic Property
OrthographicHalfHeight Property
OrthographicSize Property
PhysicalCamera Property
PostProcessing Property
Priority Property
Projection Property
Rect Property
RenderPostProcessing Property
RenderShadows Property
SensorHeight Property
SensorSize Property
SensorWidth Property
TypeId Property
UsePhysicalProperties Property
VerticalFov Property
ViewportHeight Property
ViewportWidth Property
ViewportX Property
ViewportY Property
VolumeLayerMask Property

.ctor

public Camera(Astra.Component component)

Caminho: Inspector → Câmera; 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: Câmera e navegação. 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 → Câmera; ou fachada C# em um Behavior.

Uso: Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

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

Wrap

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

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

Uso: Envolve um Component existente após conferir TypeId; não cria componente.

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

Parâmetro Tipo Contrato
component Astra.Component

AllowHDR

public bool AllowHDR { get; set; }

Caminho: Inspector → Câmera; 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: Câmera e navegação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Antialiasing

public Astra.Components.Camera.AntialiasingOption Antialiasing { get; set; }

Antisserrilhado. Do projeto usa a política de qualidade; TAA só quando o projeto já usa TAA

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

Uso: Antisserrilhado: Do projeto usa a política de qualidade; TAA só quando o projeto já usa TAA

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

BackgroundColor

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

Cor de fundo. Cor linear RGB

Caminho: Inspector → Câmera → Ambiente; ou fachada C# em um Behavior.

Uso: Fundo R: Canal vermelho da cor de fundo quando Fundo = Cor sólida. Fundo G: Canal verde da cor de fundo quando Fundo = Cor sólida. Fundo B: Canal azul da cor de fundo quando Fundo = Cor sólida.

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

BackgroundType

public Astra.Components.Camera.BackgroundTypeOption BackgroundType { get; set; }

Fundo. O que preenche a tela antes da cena (Background Type)

Caminho: Inspector → Câmera → Ambiente; ou fachada C# em um Behavior.

Uso: Fundo: O que preenche a tela antes da cena (Background Type)

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

ClearFlags

public Astra.Components.CameraClearFlags ClearFlags { get; set; }

Caminho: Inspector → Câmera; 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: Câmera e navegação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Component

public Astra.Component Component { get; }

Caminho: Inspector → Câmera; 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: Câmera e navegação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

CullingMask

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

Camadas visíveis. Culling Mask: só objetos destas camadas aparecem nesta câmera

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

Uso: Camadas visíveis: Culling Mask: só objetos destas camadas aparecem nesta câmera

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

CullingMaskBits

public uint CullingMaskBits { get; set; }

Caminho: Inspector → Câmera; 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: Câmera e navegação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Depth

public float Depth { get; set; }

Camera.depth: a câmera de maior prioridade desenha por último.

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

Uso: Camera.depth: a câmera de maior prioridade desenha por último.

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

Enabled

public bool Enabled { get; set; }

Usar no Play

Caminho: Inspector → Câmera → Saída; ou fachada C# em um Behavior.

Uso: Usar no Play: Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.

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

EnvironmentMask

public Astra.Components.Camera.EnvironmentMaskOption EnvironmentMask { get; set; }

Máscara de volume. Volume Mask: só volumes em objetos destas camadas afetam esta câmera

Caminho: Inspector → Câmera → Ambiente; ou fachada C# em um Behavior.

Uso: Máscara de volume: Volume Mask: só volumes em objetos destas camadas afetam esta câmera

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

FarClipPlane

public float FarClipPlane { get; set; }

Caminho: Inspector → Câmera; 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: Câmera e navegação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

FarPlane

public float FarPlane { get; set; }

Distante (m)

Faixa válida: 0.01 a 1000000.

Caminho: Inspector → Câmera → Lente; ou fachada C# em um Behavior.

Uso: Distante: Plano de corte distante; objetos além ficam cortados.

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

FieldOfView

public float FieldOfView { get; set; }

Caminho: Inspector → Câmera; 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: Câmera e navegação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

FocalLength

public float FocalLength { get; set; }

Distância focal (mm). Com o sensor, define o campo de visão (Physical Camera)

Faixa válida: 0.1 a 1000.

Caminho: Inspector → Câmera → Lente; ou fachada C# em um Behavior.

Uso: Distância focal: Com o sensor, define o campo de visão (Physical Camera)

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

GateFit

public Astra.Components.Camera.GateFitOption GateFit { get; set; }

Ajuste do sensor. Como o sensor encaixa na proporção da tela (Gate Fit)

Caminho: Inspector → Câmera → Lente; ou fachada C# em um Behavior.

Uso: Ajuste do sensor: Como o sensor encaixa na proporção da tela (Gate Fit)

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

Hdr

public bool Hdr { get; set; }

HDR. Desligado, a cena é tonalizada no próprio shader e nada passa de 1 antes do pós

Caminho: Inspector → Câmera → Saída; ou fachada C# em um Behavior.

Uso: HDR: Desligado, a cena é tonalizada no próprio shader e nada passa de 1 antes do pós

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

InstanceId

public ulong InstanceId { get; }

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

Uso: Distingue a instância no mesmo objeto; importante para componentes múltiplos.

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

IsAlive

public bool IsAlive { get; }

Caminho: Inspector → Câmera; 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: Câmera e navegação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

NearClipPlane

public float NearClipPlane { get; set; }

Caminho: Inspector → Câmera; 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: Câmera e navegação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

NearPlane

public float NearPlane { get; set; }

Próximo (m)

Faixa válida: 0.001 a 10000.

Caminho: Inspector → Câmera → Lente; ou fachada C# em um Behavior.

Uso: Próximo: Plano de corte próximo; valor exageradamente baixo reduz precisão de depth.

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

Object

public Astra.GameObject Object { get; }

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

Uso: Objeto dono deste componente; use para resolver composição.

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

Orthographic

public bool Orthographic { get; set; }

Caminho: Inspector → Câmera; 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: Câmera e navegação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

OrthographicHalfHeight

public float OrthographicHalfHeight { get; set; }

Meia altura (m). Metade da altura visível. Zoom altera esta extensão.

Faixa válida: 0.001 a 100000.

Caminho: Inspector → Câmera → Lente; ou fachada C# em um Behavior.

Uso: Meia altura: Metade da altura visível. Zoom altera esta extensão.

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

OrthographicSize

public float OrthographicSize { get; set; }

Caminho: Inspector → Câmera; 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: Câmera e navegação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

PhysicalCamera

public bool PhysicalCamera { get; set; }

Câmera física. Lente por distância focal e sensor, como uma câmera real

Caminho: Inspector → Câmera → Lente; ou fachada C# em um Behavior.

Uso: Câmera física: Lente por distância focal e sensor, como uma câmera real

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

PostProcessing

public bool PostProcessing { get; set; }

Pós-processamento. Bloom, gradação, vinheta e exposição automática dos volumes

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

Uso: Pós-processamento: Bloom, gradação, vinheta e exposição automática dos volumes

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

Priority

public float Priority { get; set; }

Prioridade. Ordem de desenho (Depth): a maior fica por cima; empate pelo objeto mais novo

Faixa válida: -10000 a 10000.

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

Uso: Prioridade: Ordem de desenho (Depth): a maior fica por cima; empate pelo objeto mais novo

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

Projection

public Astra.Components.Camera.ProjectionOption Projection { get; set; }

Projeção

Caminho: Inspector → Câmera → Lente; ou fachada C# em um Behavior.

Uso: Projeção: Seleciona perspectiva ou ortográfica.

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

Rect

public System.Numerics.Vector4 Rect { get; set; }

Camera.rect normalizado: (x, y, largura, altura).

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

Uso: Camera.rect normalizado: (x, y, largura, altura).

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

RenderPostProcessing

public bool RenderPostProcessing { get; set; }

UniversalAdditionalCameraData.renderPostProcessing.

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

Uso: UniversalAdditionalCameraData.renderPostProcessing.

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

RenderShadows

public bool RenderShadows { get; set; }

Renderizar sombras. Sombras do sol e das luzes locais nesta câmera

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

Uso: Renderizar sombras: Sombras do sol e das luzes locais nesta câmera

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

SensorHeight

public float SensorHeight { get; set; }

Sensor · altura (mm)

Faixa válida: 0.1 a 100.

Caminho: Inspector → Câmera → Lente; ou fachada C# em um Behavior.

Uso: Sensor · altura: Altura do sensor da câmera física, em mm (Full Frame: 24). Com a focal, define o campo vertical.

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

SensorSize

public System.Numerics.Vector2 SensorSize { get; set; }

Caminho: Inspector → Câmera; 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: Câmera e navegação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

SensorWidth

public float SensorWidth { get; set; }

Sensor · largura (mm). Padrão 36 × 24 mm (full frame)

Faixa válida: 0.1 a 100.

Caminho: Inspector → Câmera → Lente; ou fachada C# em um Behavior.

Uso: Sensor · largura: Padrão 36 × 24 mm (full frame)

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

TypeId

public static string TypeId { get; }

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

Uso: Identificador nativo usado em AddComponent/GetComponent.

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

UsePhysicalProperties

public bool UsePhysicalProperties { get; set; }

Caminho: Inspector → Câmera; 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: Câmera e navegação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

VerticalFov

public float VerticalFov { get; set; }

Campo vertical (°)

Faixa válida: 1 a 170.

Caminho: Inspector → Câmera → Lente; ou fachada C# em um Behavior.

Uso: Campo vertical: Campo de visão vertical da perspectiva, em graus.

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

ViewportHeight

public float ViewportHeight { get; set; }

Viewport A. Altura em fração da tela

Faixa válida: 0 a 1.

Caminho: Inspector → Câmera → Saída; ou fachada C# em um Behavior.

Uso: Viewport A: Altura em fração da tela

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

ViewportWidth

public float ViewportWidth { get; set; }

Viewport L. Largura em fração da tela

Faixa válida: 0 a 1.

Caminho: Inspector → Câmera → Saída; ou fachada C# em um Behavior.

Uso: Viewport L: Largura em fração da tela

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

ViewportX

public float ViewportX { get; set; }

Viewport X. Fração da tela a partir da esquerda

Faixa válida: 0 a 1.

Caminho: Inspector → Câmera → Saída; ou fachada C# em um Behavior.

Uso: Viewport X: Fração da tela a partir da esquerda

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

ViewportY

public float ViewportY { get; set; }

Viewport Y. Fração da tela a partir de baixo

Faixa válida: 0 a 1.

Caminho: Inspector → Câmera → Saída; ou fachada C# em um Behavior.

Uso: Viewport Y: Fração da tela a partir de baixo

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

VolumeLayerMask

public uint VolumeLayerMask { get; set; }

UniversalAdditionalCameraData.volumeLayerMask.

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

Uso: UniversalAdditionalCameraData.volumeLayerMask.

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