Astra.Components.PathFollow

Namespace: Astra.Components · Assembly: Astra.Scripting · Tipo: Struct

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

readonly struct Astra.Components.PathFollow

Path Follow: Percorre curva em distância mundial e orienta +Z. Família Lógica · Caminhos.

Referência estudada: https://docs.godotengine.org/en/4.5/classes/class_pathfollow3d.html

Interfaces: Astra.Components.IComponentFacade<Astra.Components.PathFollow>.

Onde acessar este tipo

Hierarquia → selecione o objeto → Inspector → Adicionar componente → Lógica / Caminhos → Path Follow.

No Behavior em Play, obtenha a fachada com Object.GetComponent<PathFollow>(); trate null antes de usar. Para outro objeto, resolva uma ObjectReference e consulte nesse objeto. Criar new PathFollow(component) envolve um componente existente; não adiciona um componente à cena.

Roadmap e uso

Caminhos e seguidores: 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 Path Follow para propriedades, valores iniciais, requisitos e edição em Play.

Membros

Membro	Categoria
.ctor	Method
Playing	Method
Progress	Method
Remove	Method
Restart	Method
Stop	Method
Wrap	Method
Autoplay	Property
Backwards	Property
Component	Property
Duration	Property
Enabled	Property
InstanceId	Property
IsAlive	Property
Loop	Property
Mode	Property
Object	Property
OffsetX	Property
OffsetY	Property
OffsetZ	Property
Orient	Property
ProgressDistance	Property
Speed	Property
Target	Property
TypeId	Property

.ctor

public PathFollow(Astra.Component component)

Caminho: Inspector → Path Follow; 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: Caminhos e seguidores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro	Tipo	Contrato
component	Astra.Component

Playing

public bool Playing()

Em movimento. Verdadeiro enquanto avança

Executado no mundo de Play; fora dele lança WorldException NotRunning.

Caminho: Inspector → Path Follow; ou fachada C# em um Behavior.

Uso: Em movimento. Verdadeiro enquanto avança

Roadmap deste membro: Caminhos e seguidores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Progress

public double Progress()

Progresso. Distância percorrida no mundo

Executado no mundo de Play; fora dele lança WorldException NotRunning.

Caminho: Inspector → Path Follow; ou fachada C# em um Behavior.

Uso: Progresso. Distância percorrida no mundo

Roadmap deste membro: Caminhos e seguidores. 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 → Path Follow; ou fachada C# em um Behavior.

Uso: Solicita remoção pelo lifecycle nativo; dependências e regras de Play podem recusar.

Roadmap deste membro: Caminhos e seguidores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Restart

public void Restart()

Reiniciar. Volta à distância inicial e avança

Executado no mundo de Play; fora dele lança WorldException NotRunning.

Caminho: Inspector → Path Follow; ou fachada C# em um Behavior.

Uso: Reiniciar. Volta à distância inicial e avança

Roadmap deste membro: Caminhos e seguidores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Stop

public void Stop()

Parar. Congela pose e progresso

Executado no mundo de Play; fora dele lança WorldException NotRunning.

Caminho: Inspector → Path Follow; ou fachada C# em um Behavior.

Uso: Parar. Congela pose e progresso

Roadmap deste membro: Caminhos e seguidores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Wrap

public static Astra.Components.PathFollow Wrap(Astra.Component component)

Caminho: Inspector → Path Follow; ou fachada C# em um Behavior.

Uso: Envolve um Component existente após conferir TypeId; não cria componente.

Roadmap deste membro: Caminhos e seguidores. 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 → Path Follow → Execução; 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: Caminhos e seguidores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Backwards

public bool Backwards { get; set; }

Sentido inverso

Caminho: Inspector → Path Follow → Execução; ou fachada C# em um Behavior.

Uso: Sentido inverso: Percorre a curva na direção reversa.

Roadmap deste membro: Caminhos e seguidores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Component

public Astra.Component Component { get; }

Caminho: Inspector → Path Follow; 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: Caminhos e seguidores. 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 100000.

Caminho: Inspector → Path Follow → Percurso; ou fachada C# em um Behavior.

Uso: Duração: Tempo para completar o percurso no modo por duração; modo velocidade usa Speed.

Roadmap deste membro: Caminhos e seguidores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Enabled

public bool Enabled { get; set; }

Ativo

Caminho: Inspector → Path Follow → Execução; 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: Caminhos e seguidores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

InstanceId

public ulong InstanceId { get; }

Caminho: Inspector → Path Follow; ou fachada C# em um Behavior.

Uso: Distingue a instância no mesmo objeto; importante para componentes múltiplos.

Roadmap deste membro: Caminhos e seguidores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

IsAlive

public bool IsAlive { get; }

Caminho: Inspector → Path Follow; 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: Caminhos e seguidores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Loop

public bool Loop { get; set; }

Repetir percurso

Caminho: Inspector → Path Follow → Execução; ou fachada C# em um Behavior.

Uso: Repetir percurso: Repete a reprodução/percurso no fim.

Roadmap deste membro: Caminhos e seguidores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Mode

public Astra.Components.PathFollow.ModeOption Mode { get; set; }

Avanço

Caminho: Inspector → Path Follow → Percurso; ou fachada C# em um Behavior.

Uso: Avanço: Seleciona o modo do componente no domínio indicado; revise os campos que aparecem após trocar.

Roadmap deste membro: Caminhos e seguidores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Object

public Astra.GameObject Object { get; }

Caminho: Inspector → Path Follow; ou fachada C# em um Behavior.

Uso: Objeto dono deste componente; use para resolver composição.

Roadmap deste membro: Caminhos e seguidores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

OffsetX

public float OffsetX { get; set; }

Deslocamento lateral (u)

Faixa válida: -10000 a 10000.

Caminho: Inspector → Path Follow → Orientação; ou fachada C# em um Behavior.

Uso: Deslocamento lateral: Deslocamento do resultado/volume em relação à origem configurada, eixo X.

Roadmap deste membro: Caminhos e seguidores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

OffsetY

public float OffsetY { get; set; }

Deslocamento vertical (u)

Faixa válida: -10000 a 10000.

Caminho: Inspector → Path Follow → Orientação; ou fachada C# em um Behavior.

Uso: Deslocamento vertical: Deslocamento do resultado/volume em relação à origem configurada, eixo Y.

Roadmap deste membro: Caminhos e seguidores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

OffsetZ

public float OffsetZ { get; set; }

Deslocamento tangente (u)

Faixa válida: -10000 a 10000.

Caminho: Inspector → Path Follow → Orientação; ou fachada C# em um Behavior.

Uso: Deslocamento tangente: Deslocamento do resultado/volume em relação à origem configurada, eixo Z.

Roadmap deste membro: Caminhos e seguidores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Orient

public bool Orient { get; set; }

Orientar +Z

Caminho: Inspector → Path Follow → Orientação; ou fachada C# em um Behavior.

Uso: Orientar +Z: Alinha orientação ao frame do caminho.

Roadmap deste membro: Caminhos e seguidores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

ProgressDistance

public float ProgressDistance { get; set; }

Distância inicial (u)

Faixa válida: 0 a 1000000.

Caminho: Inspector → Path Follow → Percurso; ou fachada C# em um Behavior.

Uso: Distância inicial: Distância inicial mundial ao longo da curva.

Roadmap deste membro: Caminhos e seguidores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Speed

public float Speed { get; set; }

Velocidade (u/s)

Faixa válida: 0 a 100000.

Caminho: Inspector → Path Follow → Percurso; ou fachada C# em um Behavior.

Uso: Velocidade: Velocidade de reprodução/percurso/motor na unidade do componente.

Roadmap deste membro: Caminhos e seguidores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Target

public Astra.ObjectReference Target { get; set; }

Caminho

Caminho: Inspector → Path Follow → Percurso; ou fachada C# em um Behavior.

Uso: Caminho: Referência a objeto fonte/alvo usada por este componente. Atribua pelo seletor; nome sozinho não mantém identidade.

Roadmap deste membro: Caminhos e seguidores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

TypeId

public static string TypeId { get; }

Caminho: Inspector → Path Follow; ou fachada C# em um Behavior.

Uso: Identificador nativo usado em AddComponent/GetComponent.

Roadmap deste membro: Caminhos e seguidores. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.