---
title: "Transform Tween"
version: snapshot-2026-10-07
engineGeneration: astra-current
language: C#
status: source-reviewed
reviewedAt: 2026-10-07
appRelease: "0.2.3-preview.20261007"
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-07/componentes/astra-tween-transform/
---

# Transform Tween

Interpola canais locais com espera, curva e repetição

**Família:** Lógica · **Grupo:** Tempo · **Identificador:** `astra.tween.transform` · **Payload:** 3

:::note[Escopo da evidência]
Este contrato foi extraído dos descritores compilados da engine, incluindo padrões resolvidos. A presença do contrato não substitui a validação do comportamento em um aparelho.
:::

## Para que usar

Interpola canais locais com espera, curva e repetição

Configure duração/intervalo e reprodução, depois ligue a ação ou Behavior consumidor. Separe relógio escalado do relógio real e callbacks de quadro dos passos físicos.

## Criar e configurar

Hierarquia → selecione o objeto → Inspector → Adicionar componente → **Lógica** / **Tempo** → **Transform Tween**.

O schema permite uma única instância desse tipo por objeto. A fachada C# correspondente é [Astra.Components.TransformTween](/pt-br/snapshot-2026-10-07/api/astra-components-transformtween/).





## Exemplo de uso

Use intervalo de 1 s, inicie Play e altere pausa/escala do tempo. Confira a diferença ao ligar Ignorar escala do tempo; ligue um receptor para observar a ação.



## Dependências

Nenhuma regra adicional declarada no schema deste componente.

## Conflitos

Nenhuma regra adicional declarada no schema deste componente.

## Edição e ciclo de vida

| Operação | Contrato |
|---|---|
| Adicionar/remover em Play | ponto seguro |
| Alterar propriedades em Play | ponto seguro |
| Múltiplas instâncias | Não |
| Versão do payload | 3 |

Alterações em ponto seguro são aplicadas entre passos da simulação. Um componente exigido por outro não pode ser removido enquanto a dependência existir. Salvar a cena autoral e modificar o mundo de Play são operações distintas; veja [Play e cena autoral](/pt-br/snapshot-2026-10-06/conceitos/play-e-cena-autoral/).

## Propriedades

Valores abaixo são resolvidos pelo descritor de um componente recém-criado. Campos por slot dependem dos recursos atribuídos. Um campo sem padrão significa que o descritor não fornece um valor independente de contexto.

### Tempo

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Duração**](#field-duration)<br/>`duration` | número · s | 1 | 0.001 … 36000 |
| [**Espera**](#field-delay)<br/>`delay` | número · s | 0 | 0 … 36000 |
| [**Ativo**](#field-enabled)<br/>`enabled` | booleano | verdadeiro | verdadeiro \| falso |
| [**Iniciar no Play**](#field-autoplay)<br/>`autoplay` | booleano | verdadeiro | verdadeiro \| falso |
| [**Ignorar escala de tempo**](#field-ignore-time-scale)<br/>`ignore_time_scale` | booleano | falso | verdadeiro \| falso |
| [**Curva**](#field-easing)<br/>`easing` | enumeração | Linear | Linear \| Smoothstep \| Quadrático entrada \| Quadrático saída |

<h4 id="field-duration">Duração · <code>duration</code></h4>

**Onde:** Inspector → **Transform Tween** → **Tempo** → **Duração**.

**Uso e efeito:** Tempo da reprodução/interpolação; configure na unidade indicada. Valor curto acelera a transição.

**Valor:** 1 · **Tipo:** número · **Unidade:** s · **Domínio:** 0.001 … 36000.



<h4 id="field-delay">Espera · <code>delay</code></h4>

**Onde:** Inspector → **Transform Tween** → **Tempo** → **Espera**.

**Uso e efeito:** Espera inicial antes de reproduzir a transição.

**Valor:** 0 · **Tipo:** número · **Unidade:** s · **Domínio:** 0 … 36000.



<h4 id="field-enabled">Ativo · <code>enabled</code></h4>

**Onde:** Inspector → **Transform Tween** → **Tempo** → **Ativo**.

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

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-autoplay">Iniciar no Play · <code>autoplay</code></h4>

**Onde:** Inspector → **Transform Tween** → **Tempo** → **Iniciar no Play**.

**Uso e efeito:** Inicia a reprodução automaticamente ao ativar a execução; não é o mesmo que repetição.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-ignore-time-scale">Ignorar escala de tempo · <code>ignore_time_scale</code></h4>

**Onde:** Inspector → **Transform Tween** → **Tempo** → **Ignorar escala de tempo**.

**Uso e efeito:** Usa o intervalo não escalado aceito; pausa editorial interrompe ambos os modos

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-easing">Curva · <code>easing</code></h4>

**Onde:** Inspector → **Transform Tween** → **Tempo** → **Curva**.

**Uso e efeito:** Escolhe a curva de interpolação; altera a velocidade ao longo da transição, não o valor final.

**Valor:** Linear · **Tipo:** enumeração · **Domínio:** Linear \| Smoothstep \| Quadrático entrada \| Quadrático saída.



### Destino

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Destino X**](#field-position-x)<br/>`position_x` | número · u | 0 | -100000 … 100000 |
| [**Destino Y**](#field-position-y)<br/>`position_y` | número · u | 0 | -100000 … 100000 |
| [**Destino Z**](#field-position-z)<br/>`position_z` | número · u | 0 | -100000 … 100000 |
| [**Rotação X**](#field-rotation-x)<br/>`rotation_x` | número · graus | 0 | -100000 … 100000 |
| [**Rotação Y**](#field-rotation-y)<br/>`rotation_y` | número · graus | 0 | -100000 … 100000 |
| [**Rotação Z**](#field-rotation-z)<br/>`rotation_z` | número · graus | 0 | -100000 … 100000 |
| [**Escala X**](#field-scale-x)<br/>`scale_x` | número · x | 1 | -100000 … 100000 |
| [**Escala Y**](#field-scale-y)<br/>`scale_y` | número · x | 1 | -100000 … 100000 |
| [**Escala Z**](#field-scale-z)<br/>`scale_z` | número · x | 1 | -100000 … 100000 |
| [**Destino relativo**](#field-relative)<br/>`relative` | booleano | falso | verdadeiro \| falso |
| [**Mover**](#field-position)<br/>`position` | booleano | verdadeiro | verdadeiro \| falso |
| [**Girar**](#field-rotation)<br/>`rotation` | booleano | falso | verdadeiro \| falso |
| [**Escalar**](#field-scale)<br/>`scale` | booleano | falso | verdadeiro \| falso |

<h4 id="field-position-x">Destino X · <code>position_x</code></h4>

**Onde:** Inspector → **Transform Tween** → **Destino** → **Destino X**.

**Uso e efeito:** Destino do canal de posição do tween, eixo X.

**Valor:** 0 · **Tipo:** número · **Unidade:** u · **Domínio:** -100000 … 100000.



<h4 id="field-position-y">Destino Y · <code>position_y</code></h4>

**Onde:** Inspector → **Transform Tween** → **Destino** → **Destino Y**.

**Uso e efeito:** Destino do canal de posição do tween, eixo Y.

**Valor:** 0 · **Tipo:** número · **Unidade:** u · **Domínio:** -100000 … 100000.



<h4 id="field-position-z">Destino Z · <code>position_z</code></h4>

**Onde:** Inspector → **Transform Tween** → **Destino** → **Destino Z**.

**Uso e efeito:** Destino do canal de posição do tween, eixo Z.

**Valor:** 0 · **Tipo:** número · **Unidade:** u · **Domínio:** -100000 … 100000.



<h4 id="field-rotation-x">Rotação X · <code>rotation_x</code></h4>

**Onde:** Inspector → **Transform Tween** → **Destino** → **Rotação X**.

**Uso e efeito:** Rotação autorada do sistema na unidade indicada, eixo X.

**Valor:** 0 · **Tipo:** número · **Unidade:** graus · **Domínio:** -100000 … 100000.



<h4 id="field-rotation-y">Rotação Y · <code>rotation_y</code></h4>

**Onde:** Inspector → **Transform Tween** → **Destino** → **Rotação Y**.

**Uso e efeito:** Rotação autorada do sistema na unidade indicada, eixo Y.

**Valor:** 0 · **Tipo:** número · **Unidade:** graus · **Domínio:** -100000 … 100000.



<h4 id="field-rotation-z">Rotação Z · <code>rotation_z</code></h4>

**Onde:** Inspector → **Transform Tween** → **Destino** → **Rotação Z**.

**Uso e efeito:** Rotação autorada do sistema na unidade indicada, eixo Z.

**Valor:** 0 · **Tipo:** número · **Unidade:** graus · **Domínio:** -100000 … 100000.



<h4 id="field-scale-x">Escala X · <code>scale_x</code></h4>

**Onde:** Inspector → **Transform Tween** → **Destino** → **Escala X**.

**Uso e efeito:** Destino do canal de escala do tween, eixo X.

**Valor:** 1 · **Tipo:** número · **Unidade:** x · **Domínio:** -100000 … 100000.



<h4 id="field-scale-y">Escala Y · <code>scale_y</code></h4>

**Onde:** Inspector → **Transform Tween** → **Destino** → **Escala Y**.

**Uso e efeito:** Destino do canal de escala do tween, eixo Y.

**Valor:** 1 · **Tipo:** número · **Unidade:** x · **Domínio:** -100000 … 100000.



<h4 id="field-scale-z">Escala Z · <code>scale_z</code></h4>

**Onde:** Inspector → **Transform Tween** → **Destino** → **Escala Z**.

**Uso e efeito:** Destino do canal de escala do tween, eixo Z.

**Valor:** 1 · **Tipo:** número · **Unidade:** x · **Domínio:** -100000 … 100000.



<h4 id="field-relative">Destino relativo · <code>relative</code></h4>

**Onde:** Inspector → **Transform Tween** → **Destino** → **Destino relativo**.

**Uso e efeito:** Interpreta os valores da transição como deslocamento relativo, conforme o canal.

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-position">Mover · <code>position</code></h4>

**Onde:** Inspector → **Transform Tween** → **Destino** → **Mover**.

**Uso e efeito:** Seleciona a participação do canal de posição no tween.

**Valor:** verdadeiro · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-rotation">Girar · <code>rotation</code></h4>

**Onde:** Inspector → **Transform Tween** → **Destino** → **Girar**.

**Uso e efeito:** Seleciona a participação do canal de rotação no tween.

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-scale">Escalar · <code>scale</code></h4>

**Onde:** Inspector → **Transform Tween** → **Destino** → **Escalar**.

**Uso e efeito:** Seleciona a participação do canal de escala no tween.

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



### Repetição

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Ida e volta**](#field-pingpong)<br/>`pingpong` | booleano | falso | verdadeiro \| falso |
| [**Ciclos**](#field-loops)<br/>`loops` | enumeração | Uma vez | Infinito \| Uma vez \| Duas vezes \| Três vezes \| Dez vezes |

<h4 id="field-pingpong">Ida e volta · <code>pingpong</code></h4>

**Onde:** Inspector → **Transform Tween** → **Repetição** → **Ida e volta**.

**Uso e efeito:** Alterna ida e volta na reprodução.

**Valor:** falso · **Tipo:** booleano · **Domínio:** verdadeiro \| falso.



<h4 id="field-loops">Ciclos · <code>loops</code></h4>

**Onde:** Inspector → **Transform Tween** → **Repetição** → **Ciclos**.

**Uso e efeito:** Número/política de repetições no domínio indicado; confira a opção de repetição contínua na enumeração/contrato.

**Valor:** Uma vez · **Tipo:** enumeração · **Domínio:** Infinito \| Uma vez \| Duas vezes \| Três vezes \| Dez vezes.



### Conexão

| Propriedade | Tipo / unidade | Padrão | Domínio |
|---|---|---|---|
| [**Ao concluir**](#field-finished-action)<br/>`finished_action` | enumeração | Desconectado | Desconectado \| Ativar objeto \| Desativar objeto \| Alternar objeto |
| [**Receptor**](#field-finished-target)<br/>`finished_target` | referência | Escolher objeto | qualquer objeto |

<h4 id="field-finished-action">Ao concluir · <code>finished_action</code></h4>

**Onde:** Inspector → **Transform Tween** → **Conexão** → **Ao concluir**.

**Uso e efeito:** Executa depois da pose final de todos os ciclos finitos; cancelar ou ciclo infinito não dispara

**Valor:** Desconectado · **Tipo:** enumeração · **Domínio:** Desconectado \| Ativar objeto \| Desativar objeto \| Alternar objeto.



<h4 id="field-finished-target">Receptor · <code>finished_target</code></h4>

**Onde:** Inspector → **Transform Tween** → **Conexão** → **Receptor**.

**Uso e efeito:** Referência persistente remapeada ao clonar; controla activeSelf do receptor

**Valor:** Escolher objeto · **Tipo:** referência · **Domínio:** qualquer objeto.

Campo condicional: o modo/forma/recurso selecionado controla a disponibilidade.

## Roadmap deste componente

[Tempo, eventos e tweens](/pt-br/snapshot-2026-10-06/roadmap/tempo-eventos-e-tweens/). Ampliar composição e diagnóstico de ações/curvas e conferir cancelamento, pausa, remoção e reinício. Sem data prometida. Timeline geral não é consequência da existência de Timer ou tween.

Os campos acima pertencem ao contrato existente; novas funções dependem do fechamento da família. Não há datas individuais prometidas para cada propriedade.

## Conferir na sua cena

1. Crie **Transform Tween** pelo fluxo indicado e resolva as dependências.
2. Altere uma propriedade por vez e observe o efeito esperado na cena.
3. Salve, reabra e confira os valores autorais.
4. Entre em Play e verifique o comportamento com os recursos reais do projeto.
5. Pare o Play e confira a cena autoral.

Este é um roteiro de conferência; não representa um teste executado nesta publicação.

## Limitações da referência

A tabela cobre os tipos de propriedade disponíveis no descritor de reflexão. Não presume persistência de campos transitórios, equivalência com outras engines ou suporte em todos os aparelhos. Recursos, coleções e operações podem exigir APIs específicas.

**Referência de arquitetura registrada pela engine:** [documentação oficial](https://docs.godotengine.org/en/4.5/classes/class_tween.html). Essa referência não representa paridade funcional.

## Comandos e leituras em Play

Os IDs abaixo são operações nativas do componente existente. Não são novos botões de autoria. Use a fachada C# correspondente para nomes e assinaturas; Conexão de evento oferece as ações compatíveis no seletor. Confira o componente e o mundo vivos antes de chamar.

| Operação / ID | Uso e efeito | Argumentos | Retorno |
|---|---|---|---|
| **Reiniciar** · `restart` | Recomeça da pose atual, conservando a pausa | Nenhum | nada |
| **Cancelar** · `cancel` | Interrompe sem voltar à pose inicial | Nenhum | nada |
| **Pausar** · `pause` | Congela o progresso | Nenhum | nada |
| **Retomar** · `resume` | Continua o progresso pausado | Nenhum | nada |
| **Decorrido** · `elapsed` | Segundos desde o início, incluindo o atraso | Nenhum | número |

[Assinaturas da fachada TransformTween](/pt-br/snapshot-2026-10-07/api/astra-components-transformtween/#membros)

## Eventos do componente

No Behavior, a fachada permite inscrever um receptor usando o owner vivo; a inscrição pertence ao lifecycle daquela execução. Uma Conexão de evento precisa de emissor, evento, receptor e ação: adicionar a conexão não define a regra do jogo.

| Evento / ID | Quando ocorre | Dados enviados |
|---|---|---|
| **Concluiu** · `completed` | Emitido uma vez quando as repetições finitas terminam, depois da pose final | Nenhum |