---
title: "Astra.GuiAnimation"
version: snapshot-2026-10-06
engineGeneration: astra-current
language: C#
status: semantic-reference
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-06/api/astra-guianimation/
---

# Astra.GuiAnimation

One authored pose transition. Stop restores layout; completion holds the final pose. PingPong runs both directions; Loop repeats after the one-time Delay. Children inherit pose.

**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.GuiAnimation
```

One authored pose transition. Stop restores layout; completion holds the final pose. PingPong runs both directions; Loop repeats after the one-time Delay. Children inherit pose.

**Interfaces:** `System.IEquatable<Astra.GuiAnimation>`.

## 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. **GuiAnimation** 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-9a4de8f8ee9be38c) | Method |
| [AutoPlay](#member-e6444befc2ff01a4) | Property |
| [Default](#member-268d53fda1546cfb) | Property |
| [Delay](#member-f6b3bdaad0307fb6) | Property |
| [Duration](#member-5ceef6eab2d9113b) | Property |
| [Easing](#member-26afdec54bdabf40) | Property |
| [Enabled](#member-94b18ec2f4b36cb9) | Property |
| [From](#member-5142ed46acd0c73a) | Property |
| [Loop](#member-5caac6176a025a2e) | Property |
| [PingPong](#member-2830f4a93d49632b) | Property |
| [To](#member-2b5da846036b2a56) | Property |

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

```csharp
public GuiAnimation(bool Enabled, bool AutoPlay, bool Loop, bool PingPong, Astra.GuiEasing Easing, float Duration, float Delay, Astra.GuiPose From, Astra.GuiPose To)
```

One authored pose transition. Stop restores layout; completion holds the final pose. PingPong runs both directions; Loop repeats after the one-time Delay. Children inherit pose.

**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 |
|---|---|---|
| `Enabled` | `bool` |  |
| `AutoPlay` | `bool` |  |
| `Loop` | `bool` |  |
| `PingPong` | `bool` |  |
| `Easing` | `Astra.GuiEasing` |  |
| `Duration` | `float` |  |
| `Delay` | `float` |  |
| `From` | `Astra.GuiPose` |  |
| `To` | `Astra.GuiPose` |  |

<h3 id="member-e6444befc2ff01a4" class="astra-member">AutoPlay</h3>

```csharp
public bool AutoPlay { get; init; }
```

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

**Uso:** Inicia a transição automaticamente.

**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-268d53fda1546cfb" class="astra-member">Default</h3>

```csharp
public static Astra.GuiAnimation Default { get; }
```

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

**Uso:** Configuração desativada, 0,3 s, curva Smooth, poses identidade.

**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-f6b3bdaad0307fb6" class="astra-member">Delay</h3>

```csharp
public float Delay { get; init; }
```

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

**Uso:** Espera inicial, em segundos.

**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-5ceef6eab2d9113b" class="astra-member">Duration</h3>

```csharp
public float Duration { get; init; }
```

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

**Uso:** Tempo da transição, em segundos.

**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-26afdec54bdabf40" class="astra-member">Easing</h3>

```csharp
public Astra.GuiEasing Easing { get; init; }
```

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

**Uso:** Curva de interpolação.

**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-94b18ec2f4b36cb9" class="astra-member">Enabled</h3>

```csharp
public bool Enabled { get; init; }
```

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

**Uso:** Habilita a transição de duas poses.

**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-5142ed46acd0c73a" class="astra-member">From</h3>

```csharp
public Astra.GuiPose From { get; init; }
```

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

**Uso:** Pose inicial.

**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-5caac6176a025a2e" class="astra-member">Loop</h3>

```csharp
public bool Loop { get; init; }
```

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

**Uso:** Repete a transição após completar; atraso é inicial.

**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-2830f4a93d49632b" class="astra-member">PingPong</h3>

```csharp
public bool PingPong { get; init; }
```

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

**Uso:** Executa ida e volta.

**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-2b5da846036b2a56" class="astra-member">To</h3>

```csharp
public Astra.GuiPose To { get; init; }
```

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

**Uso:** Pose final.

**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.