Astra.Components.PropertyTween
Tween de propriedade: Interpola uma propriedade numérica interpolável de um componente. Família Lógica · Tempo.
Namespace: Astra.Components · Assembly: Astra.Scripting · Tipo: Struct
Declaração
Seção intitulada “Declaração”readonly struct Astra.Components.PropertyTweenTween de propriedade: Interpola uma propriedade numérica interpolável de um componente. Família Lógica · Tempo.
Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_tween.html#class-tween-method-tween-property
Interfaces: Astra.Components.IComponentFacade<Astra.Components.PropertyTween>.
Onde acessar este tipo
Seção intitulada “Onde acessar este tipo”Hierarquia → selecione o objeto → Inspector → Adicionar componente → Lógica / Tempo → Tween de propriedade.
No Behavior em Play, obtenha a fachada com Object.GetComponent<PropertyTween>(); trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar new PropertyTween(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 Tween de propriedade 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 |
| Destination | Property |
| Duration | Property |
| Easing | Property |
| Enabled | Property |
| IgnoreTimeScale | Property |
| InstanceId | Property |
| IsAlive | Property |
| Loops | Property |
| Object | Property |
| Pingpong | Property |
| Relative | Property |
| Target | Property |
| TypeId | Property |
.ctor
public PropertyTween(Astra.Component component)Caminho: Inspector → Tween de propriedade; 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 ao valor inicial
Executado no mundo de Play; fora dele lança WorldException NotRunning.
Caminho: Inspector → Tween de propriedade; ou fachada C# em um Behavior.
Uso: Cancelar. Interrompe sem voltar ao valor 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 a espera
Executado no mundo de Play; fora dele lança WorldException NotRunning.
Caminho: Inspector → Tween de propriedade; ou fachada C# em um Behavior.
Uso: Decorrido. Segundos desde o início, incluindo a espera
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 do valor final
Caminho: Inspector → Tween de propriedade; ou fachada C# em um Behavior.
Uso: Concluiu. Emitido uma vez quando as repetições finitas terminam, depois do valor 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 → Tween de propriedade; 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 → Tween de propriedade; 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 do valor atual da propriedade, conservando a pausa
Executado no mundo de Play; fora dele lança WorldException NotRunning.
Caminho: Inspector → Tween de propriedade; ou fachada C# em um Behavior.
Uso: Reiniciar. Recomeça do valor atual da propriedade, 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 → Tween de propriedade; 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.PropertyTween Wrap(Astra.Component component)Caminho: Inspector → Tween de propriedade; 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 → Tween de propriedade → 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 → Tween de propriedade; 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 → Tween de propriedade → 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.
Destination
public float Destination { get; set; }Destino. Valor final; com “Destino relativo”, soma ao valor do início
Faixa válida: -100000 a 100000.
Caminho: Inspector → Tween de propriedade → Propriedade; ou fachada C# em um Behavior.
Uso: Destino: Valor de chegada na unidade do campo selecionado. Relativo desligado = valor final; ligado = incremento a partir do início.
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 → Tween de propriedade → 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.PropertyTween.EasingOption Easing { get; set; }Curva
Caminho: Inspector → Tween de propriedade → 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 → Tween de propriedade → 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.
IgnoreTimeScale
public bool IgnoreTimeScale { get; set; }Ignorar escala de tempo
Caminho: Inspector → Tween de propriedade → Tempo; ou fachada C# em um Behavior.
Uso: Ignorar escala de tempo: Usa relógio não afetado pela escala do tempo do mundo; confira pausa e segundos reais.
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 → Tween de propriedade; 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 → Tween de propriedade; 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.PropertyTween.LoopsOption Loops { get; set; }Repetição
Caminho: Inspector → Tween de propriedade → Repetição; ou fachada C# em um Behavior.
Uso: Repetição: 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 → Tween de propriedade; 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 → Tween de propriedade → 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.
Relative
public bool Relative { get; set; }Destino relativo
Caminho: Inspector → Tween de propriedade → Propriedade; 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.
Target
public Astra.ObjectReference Target { get; set; }Alvo. Objeto dono do componente animado; vazio usa este objeto
Caminho: Inspector → Tween de propriedade → Propriedade; ou fachada C# em um Behavior.
Uso: Alvo: Objeto dono do componente animado; vazio usa este objeto
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 → Tween de propriedade; 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.