Astra.GuiCanvas

Astra 0.2.3-preview.20261007Referência de assinaturasReferência revisada · 07 out. 2026

Struct da API C# da Astra. 7 membros declarados neste snapshot.

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

Declaração

readonly record struct Astra.GuiCanvas

Interfaces: System.IEquatable<Astra.GuiCanvas>.

Onde acessar este tipo

Editor → Interface → documento .aeui; cena → objeto Canvas UI. Dentro de um Behavior, Gui.ForCanvas(owner) seleciona a instância, Find/TryFind localiza o elemento e Poll consome eventos. GuiCanvas configura ou descreve dados de GUI. Leia campos e valores e use os records/enums com GuiElement ou GuiAccess. HUD completo.

Roadmap e uso

Canvas e UI de jogo: 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.

Membros

Membro	Categoria
.ctor	Method
Mode	Property
Occlusion	Property
Position	Property
Resolution	Property
Rotation	Property
UnitsPerPixel	Property

.ctor

public GuiCanvas(Astra.GuiCanvasMode Mode, System.Numerics.Vector2 Resolution, System.Numerics.Vector3 Position, System.Numerics.Vector3 Rotation, float UnitsPerPixel, bool Occlusion)

Caminho: Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em 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: Canvas e UI de jogo. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
`Mode`	`Astra.GuiCanvasMode`
`Resolution`	`System.Numerics.Vector2`
`Position`	`System.Numerics.Vector3`
`Rotation`	`System.Numerics.Vector3`
`UnitsPerPixel`	`float`
`Occlusion`	`bool`

Mode

public Astra.GuiCanvasMode Mode { get; init; }

Caminho: Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

Uso: Screen para Tela ou World para plano de mundo.

Roadmap deste membro: Canvas e UI de jogo. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Occlusion

public bool Occlusion { get; init; }

Caminho: Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

Uso: Profundidade/hit no plano de mundo.

Roadmap deste membro: Canvas e UI de jogo. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Position

public System.Numerics.Vector3 Position { get; init; }

Caminho: Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

Uso: Posição local do plano.

Roadmap deste membro: Canvas e UI de jogo. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Resolution

public System.Numerics.Vector2 Resolution { get; init; }

Caminho: Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

Uso: Resolução do plano de mundo; Screen usa viewport.

Roadmap deste membro: Canvas e UI de jogo. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Rotation

public System.Numerics.Vector3 Rotation { get; init; }

Caminho: Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

Uso: Euler do plano, em graus.

Roadmap deste membro: Canvas e UI de jogo. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

UnitsPerPixel

public float UnitsPerPixel { get; init; }

Caminho: Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

Uso: Unidades do mundo por pixel.

Roadmap deste membro: Canvas e UI de jogo. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.