Astra.Components.TransformTween
Transform Tween: Interpola canais locais com espera, curva e repetição. Família Lógica · Tempo.
Namespace: Astra.Components · Assembly: Astra.Scripting · Tipo: Struct
Declaração
Seção intitulada “Declaração”readonly struct Astra.Components.TransformTweenTransform Tween: Interpola canais locais com espera, curva e repetição. Família Lógica · Tempo.
Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_tween.html
Interfaces: Astra.Components.IComponentFacade<Astra.Components.TransformTween>.
Onde acessar este tipo
Seção intitulada “Onde acessar este tipo”Hierarquia → selecione o objeto → Inspector → Adicionar componente → Lógica / Tempo → Transform Tween.
No Behavior em Play, obtenha a fachada com Object.GetComponent<TransformTween>(); trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar new TransformTween(component) envolve um componente existente; não adiciona um componente à cena.
Roadmap e uso
Seção intitulada “Roadmap e uso”Tempo, eventos e tweens: 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 Transform Tween para propriedades, valores iniciais, requisitos e edição em Play.
Membros
Seção intitulada “Membros”| Membro | Categoria |
|---|---|
| .ctor | Method |
| Cancel | Method |
| Elapsed | Method |
| OnCompleted | Method |
| Pause | Method |
| Remove | Method |
| Restart | Method |
| Resume | Method |
| Wrap | Method |
| Autoplay | Property |
| Component | Property |
| Delay | Property |
| Duration | Property |
| Easing | Property |
| Enabled | Property |
| FinishedAction | Property |
| FinishedTarget | Property |
| IgnoreTimeScale | Property |
| InstanceId | Property |
| IsAlive | Property |
| Loops | Property |
| Object | Property |
| Pingpong | Property |
| Position | Property |
| PositionDestination | Property |
| Relative | Property |
| Rotation | Property |
| RotationDestination | Property |
| Scale | Property |
| ScaleDestination | Property |
| TypeId | Property |
.ctor
public TransformTween(Astra.Component component)Caminho: Inspector → Transform Tween; 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: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
component |
Astra.Component |
Cancel
public void Cancel()Cancelar. Interrompe sem voltar à pose inicial
Executado no mundo de Play; fora dele lança WorldException NotRunning.
Caminho: Inspector → Transform Tween; ou fachada C# em um Behavior.
Uso: Cancelar. Interrompe sem voltar à pose inicial
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Elapsed
public double Elapsed()Decorrido. Segundos desde o início, incluindo o atraso
Executado no mundo de Play; fora dele lança WorldException NotRunning.
Caminho: Inspector → Transform Tween; ou fachada C# em um Behavior.
Uso: Decorrido. Segundos desde o início, incluindo o atraso
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
OnCompleted
public Astra.ComponentSubscription OnCompleted(Astra.Behavior owner, System.Action<Astra.ComponentEventArgs> handler)Concluiu. Emitido uma vez quando as repetições finitas terminam, depois da pose final
Caminho: Inspector → Transform Tween; ou fachada C# em um Behavior.
Uso: Concluiu. Emitido uma vez quando as repetições finitas terminam, depois da pose final
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
owner |
Astra.Behavior |
|
handler |
System.Action<Astra.ComponentEventArgs> |
Pause
public void Pause()Pausar. Congela o progresso
Executado no mundo de Play; fora dele lança WorldException NotRunning.
Caminho: Inspector → Transform Tween; ou fachada C# em um Behavior.
Uso: Pausar. Congela o progresso
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Remove
public void Remove()Remove a instância pelo ciclo nativo; dependências e ownership podem recusar.
Caminho: Inspector → Transform Tween; ou fachada C# em um Behavior.
Uso: Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Restart
public void Restart()Reiniciar. Recomeça da pose atual, conservando a pausa
Executado no mundo de Play; fora dele lança WorldException NotRunning.
Caminho: Inspector → Transform Tween; ou fachada C# em um Behavior.
Uso: Reiniciar. Recomeça da pose atual, conservando a pausa
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Resume
public void Resume()Retomar. Continua o progresso pausado
Executado no mundo de Play; fora dele lança WorldException NotRunning.
Caminho: Inspector → Transform Tween; ou fachada C# em um Behavior.
Uso: Retomar. Continua o progresso pausado
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Wrap
public static Astra.Components.TransformTween Wrap(Astra.Component component)Caminho: Inspector → Transform Tween; ou fachada C# em um Behavior.
Uso: Envolve um Component existente após conferir TypeId; não cria componente.
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
component |
Astra.Component |
Autoplay
public bool Autoplay { get; set; }Iniciar no Play
Caminho: Inspector → Transform Tween → Tempo; ou fachada C# em um Behavior.
Uso: Iniciar no Play: Inicia a reprodução automaticamente ao ativar a execução; não é o mesmo que repetição.
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Component
public Astra.Component Component { get; }Caminho: Inspector → Transform Tween; 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: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Delay
public float Delay { get; set; }Espera (s)
Faixa válida: 0 a 36000.
Caminho: Inspector → Transform Tween → Tempo; ou fachada C# em um Behavior.
Uso: Espera: Espera inicial antes de reproduzir a transição.
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Duration
public float Duration { get; set; }Duração (s)
Faixa válida: 0.001 a 36000.
Caminho: Inspector → Transform Tween → Tempo; ou fachada C# em um Behavior.
Uso: Duração: Tempo da reprodução/interpolação; configure na unidade indicada. Valor curto acelera a transição.
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Easing
public Astra.Components.TransformTween.EasingOption Easing { get; set; }Curva
Caminho: Inspector → Transform Tween → Tempo; ou fachada C# em um Behavior.
Uso: Curva: Escolhe a curva de interpolação; altera a velocidade ao longo da transição, não o valor final.
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Enabled
public bool Enabled { get; set; }Ativo
Caminho: Inspector → Transform Tween → Tempo; ou fachada C# em um Behavior.
Uso: Ativo: Ativa/desativa a participação do componente no sistema consumidor; não remove seus dados.
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
FinishedAction
public Astra.Components.TransformTween.FinishedActionOption FinishedAction { get; set; }Ao concluir. Executa depois da pose final de todos os ciclos finitos; cancelar ou ciclo infinito não dispara
Caminho: Inspector → Transform Tween → Conexão; ou fachada C# em um Behavior.
Uso: Ao concluir: Executa depois da pose final de todos os ciclos finitos; cancelar ou ciclo infinito não dispara
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
FinishedTarget
public Astra.ObjectReference FinishedTarget { get; set; }Receptor. Referência persistente remapeada ao clonar; controla activeSelf do receptor
Caminho: Inspector → Transform Tween → Conexão; ou fachada C# em um Behavior.
Uso: Receptor: Referência persistente remapeada ao clonar; controla activeSelf do receptor
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
IgnoreTimeScale
public bool IgnoreTimeScale { get; set; }Ignorar escala de tempo. Usa o intervalo não escalado aceito; pausa editorial interrompe ambos os modos
Caminho: Inspector → Transform Tween → Tempo; ou fachada C# em um Behavior.
Uso: Ignorar escala de tempo: Usa o intervalo não escalado aceito; pausa editorial interrompe ambos os modos
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
InstanceId
public ulong InstanceId { get; }Caminho: Inspector → Transform Tween; ou fachada C# em um Behavior.
Uso: Distingue a instância no mesmo objeto; importante para componentes múltiplos.
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
IsAlive
public bool IsAlive { get; }Caminho: Inspector → Transform Tween; 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: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Loops
public Astra.Components.TransformTween.LoopsOption Loops { get; set; }Ciclos
Caminho: Inspector → Transform Tween → Repetição; ou fachada C# em um Behavior.
Uso: Ciclos: Número/política de repetições no domínio indicado; confira a opção de repetição contínua na enumeração/contrato.
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Object
public Astra.GameObject Object { get; }Caminho: Inspector → Transform Tween; ou fachada C# em um Behavior.
Uso: Objeto dono deste componente; use para resolver composição.
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Pingpong
public bool Pingpong { get; set; }Ida e volta
Caminho: Inspector → Transform Tween → Repetição; ou fachada C# em um Behavior.
Uso: Ida e volta: Alterna ida e volta na reprodução.
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Position
public bool Position { get; set; }Mover
Caminho: Inspector → Transform Tween → Destino; ou fachada C# em um Behavior.
Uso: Mover: Seleciona a participação do canal de posição no tween.
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
PositionDestination
public System.Numerics.Vector3 PositionDestination { get; set; }Posição destino
Caminho: Inspector → Transform Tween → Destino; ou fachada C# em um Behavior.
Uso: Destino X: Destino do canal de posição do tween, eixo X. Destino Y: Destino do canal de posição do tween, eixo Y. Destino Z: Destino do canal de posição do tween, eixo Z.
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Relative
public bool Relative { get; set; }Destino relativo
Caminho: Inspector → Transform Tween → Destino; ou fachada C# em um Behavior.
Uso: Destino relativo: Interpreta os valores da transição como deslocamento relativo, conforme o canal.
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Rotation
public bool Rotation { get; set; }Girar
Caminho: Inspector → Transform Tween → Destino; ou fachada C# em um Behavior.
Uso: Girar: Seleciona a participação do canal de rotação no tween.
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
RotationDestination
public System.Numerics.Vector3 RotationDestination { get; set; }Rotação destino
Caminho: Inspector → Transform Tween → Destino; ou fachada C# em um Behavior.
Uso: Rotação X: Rotação autorada do sistema na unidade indicada, eixo X. Rotação Y: Rotação autorada do sistema na unidade indicada, eixo Y. Rotação Z: Rotação autorada do sistema na unidade indicada, eixo Z.
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
Scale
public bool Scale { get; set; }Escalar
Caminho: Inspector → Transform Tween → Destino; ou fachada C# em um Behavior.
Uso: Escalar: Seleciona a participação do canal de escala no tween.
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
ScaleDestination
public System.Numerics.Vector3 ScaleDestination { get; set; }Escala destino
Caminho: Inspector → Transform Tween → Destino; ou fachada C# em um Behavior.
Uso: Escala X: Destino do canal de escala do tween, eixo X. Escala Y: Destino do canal de escala do tween, eixo Y. Escala Z: Destino do canal de escala do tween, eixo Z.
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
TypeId
public static string TypeId { get; }Caminho: Inspector → Transform Tween; ou fachada C# em um Behavior.
Uso: Identificador nativo usado em AddComponent/GetComponent.
Roadmap deste membro: Tempo, eventos e tweens. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.