---
title: "Astra.GuiCanvas"
version: snapshot-2026-10-07
engineGeneration: astra-current
language: C#
status: semantic-reference
reviewedAt: 2026-10-07
appRelease: "0.2.3-preview.20261007"
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-07/api/astra-guicanvas/
---

# Astra.GuiCanvas

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

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

:::note[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

```csharp
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](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): 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](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-fb7c7219439f72c1) | Method |
| [Mode](#member-99408b2cb717c3b3) | Property |
| [Occlusion](#member-4f2329f8b319a8a5) | Property |
| [Position](#member-17ffe328aaf97ef8) | Property |
| [Resolution](#member-e98e6842cad73741) | Property |
| [Rotation](#member-c4e351c57411520b) | Property |
| [UnitsPerPixel](#member-66d1a47a7be8ef1c) | Property |

<h3 id="member-fb7c7219439f72c1" class="astra-member">.ctor</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/ui/roadmap/). 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` |  |

<h3 id="member-99408b2cb717c3b3" class="astra-member">Mode</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-4f2329f8b319a8a5" class="astra-member">Occlusion</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-17ffe328aaf97ef8" class="astra-member">Position</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e98e6842cad73741" class="astra-member">Resolution</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-c4e351c57411520b" class="astra-member">Rotation</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-66d1a47a7be8ef1c" class="astra-member">UnitsPerPixel</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.