Astra.AnimatorController
Parâmetros e estados de um Animator, por nome, como a API da Unity: SetFloat, SetInteger, SetBool, SetTrigger e ResetTrigger mudam os valores que as transições leem; Play e CrossFade trocam o estado de uma camada; GetCurrentState informa o estado tocando. Valores de execução: o Play sempre parte dos padrões autorados. Nome ou tipo errado lança Astra.WorldException. Parâmetros vinculados a movimento físico podem ser lidos; setters são recusados com F:Astra.WorldStatus.Rejected para preservar uma única origem do valor.
Namespace: Astra · Assembly: Astra.Scripting · Tipo: Struct
Declaração
Seção intitulada “Declaração”readonly struct Astra.AnimatorControllerParâmetros e estados de um Animator, por nome, como a API da Unity: SetFloat, SetInteger, SetBool, SetTrigger e ResetTrigger mudam os valores que as transições leem; Play e CrossFade trocam o estado de uma camada; GetCurrentState informa o estado tocando. Valores de execução: o Play sempre parte dos padrões autorados. Nome ou tipo errado lança Astra.WorldException. Parâmetros vinculados a movimento físico podem ser lidos; setters são recusados com F:Astra.WorldStatus.Rejected para preservar uma única origem do valor.
Onde acessar este tipo
Seção intitulada “Onde acessar este tipo”Cena → raiz do modelo → Animator → Abrir grafo. No Behavior desse objeto, Object.Animator() fornece AnimatorController para parâmetros/estados. AnimatorStateInfo é a leitura retornada por GetCurrentState; construir o record não muda a animação. Ficha do Animator.
Roadmap e uso
Seção intitulada “Roadmap e uso”Animação e deformação: 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.
Membros
Seção intitulada “Membros”| Membro | Categoria |
|---|---|
| CrossFade | Method |
| GetBool | Method |
| GetCurrentState | Method |
| GetFloat | Method |
| GetInteger | Method |
| GetLayerBlendMode | Method |
| GetLayerReferenceClip | Method |
| GetLayerReferenceTime | Method |
| GetLayerWeight | Method |
| Play | Method |
| ResetLayerOverrides | Method |
| ResetTrigger | Method |
| SetBool | Method |
| SetFloat | Method |
| SetInteger | Method |
| SetLayerBlendMode | Method |
| SetLayerReferenceClip | Method |
| SetLayerReferenceTime | Method |
| SetLayerWeight | Method |
| SetTrigger | Method |
| Component | Property |
CrossFade
public void CrossFade(string state, float seconds, uint layer = 0)Transição por caminho em segundos. Durante uma mistura, preserva a pose composta exibida como origem.
Caminho: Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
Uso: Transição por caminho em segundos. Durante uma mistura, preserva a pose composta exibida como origem.
Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
state |
string |
|
seconds |
float |
|
layer |
uint |
· Opcional: 0 |
GetBool
public bool GetBool(string name)Caminho: Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
Uso: Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
name |
string |
GetCurrentState
public Astra.AnimatorStateInfo GetCurrentState(uint layer = 0)Caminho: Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
Uso: Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
layer |
uint |
· Opcional: 0 |
GetFloat
public float GetFloat(string name)Caminho: Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
Uso: Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
name |
string |
GetInteger
public int GetInteger(string name)Caminho: Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
Uso: Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
name |
string |
GetLayerBlendMode
public Astra.AnimationLayerBlendMode GetLayerBlendMode(uint layer)Caminho: Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
Uso: Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
layer |
uint |
GetLayerReferenceClip
public Astra.AssetGuid GetLayerReferenceClip(uint layer)Caminho: Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
Uso: Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
layer |
uint |
GetLayerReferenceTime
public float GetLayerReferenceTime(uint layer)Caminho: Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
Uso: Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
layer |
uint |
GetLayerWeight
public float GetLayerWeight(uint layer)Runtime composition settings are independent per instance and do not edit controller assets.
Caminho: Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
Uso: Runtime composition settings are independent per instance and do not edit controller assets.
Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
layer |
uint |
Play
public void Play(string state, uint layer = 0)Troca a camada na hora. Aceita caminho de estado ou de grupo (entra pelo padrão); nome curto deve ser único.
Caminho: Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
Uso: Troca a camada na hora. Aceita caminho de estado ou de grupo (entra pelo padrão); nome curto deve ser único.
Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
state |
string |
|
layer |
uint |
· Opcional: 0 |
ResetLayerOverrides
public void ResetLayerOverrides(uint layer)Caminho: Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
Uso: Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
layer |
uint |
ResetTrigger
public void ResetTrigger(string name)Caminho: Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
Uso: Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
name |
string |
SetBool
public void SetBool(string name, bool value)Caminho: Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
Uso: Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
name |
string |
|
value |
bool |
SetFloat
public void SetFloat(string name, float value)Caminho: Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
Uso: Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
name |
string |
|
value |
float |
SetInteger
public void SetInteger(string name, int value)Caminho: Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
Uso: Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
name |
string |
|
value |
int |
SetLayerBlendMode
public void SetLayerBlendMode(uint layer, Astra.AnimationLayerBlendMode mode)Caminho: Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
Uso: Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
layer |
uint |
|
mode |
Astra.AnimationLayerBlendMode |
SetLayerReferenceClip
public void SetLayerReferenceClip(uint layer, Astra.AssetGuid clip)Caminho: Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
Uso: Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
layer |
uint |
|
clip |
Astra.AssetGuid |
SetLayerReferenceTime
public void SetLayerReferenceTime(uint layer, float seconds)Caminho: Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
Uso: Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
layer |
uint |
|
seconds |
float |
SetLayerWeight
public void SetLayerWeight(uint layer, float weight)Caminho: Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
Uso: Chame pelo acesso deste tipo indicado acima, com argumentos da assinatura. O efeito especializado deste membro ainda precisa de revisão editorial individual; não deduza equivalência com Unity/Godot pelo nome.
Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
layer |
uint |
|
weight |
float |
SetTrigger
public void SetTrigger(string name)Liga o gatilho; ele fica ligado até uma transição usá-lo ou Astra.AnimatorController.ResetTrigger(System.String).
Caminho: Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
Uso: Liga o gatilho; ele fica ligado até uma transição usá-lo ou Astra.AnimatorController.ResetTrigger(System.String).
Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.
| Parâmetro | Tipo | Contrato |
|---|---|---|
name |
string |
Component
public Astra.Component Component { get; }Caminho: Área de código → Behavior compilado/anexado → acesso descrito em “Onde acessar este tipo”.
Uso: Campo/propriedade conforme a declaração. Confira get/set/init e o tipo; a interpretação especializada ainda não tem revisão editorial individual neste snapshot.
Roadmap deste membro: Animação e deformação. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.