Pular para o conteúdo
AstraDOCS

Astra.GuiControlSettings

Astra 0.2.3-preview.20261007Referência de assinaturasReferência revisada · 07 out. 2026

Struct da API C# da Astra. 15 membros declarados neste snapshot.

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

readonly record struct Astra.GuiControlSettings

Interfaces: System.IEquatable<Astra.GuiControlSettings>.

Editor → Interface → documento .aeui; cena → objeto Canvas UI. Dentro de um Behavior, Gui.ForCanvas(owner) seleciona a instância, Find/TryFind localiza o elemento e Poll consome eventos. GuiControlSettings configura ou descreve dados de GUI. Leia campos e valores e use os records/enums com GuiElement ou GuiAccess. HUD completo.

Canvas e UI de jogo: 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.

Membro Categoria
.ctor Method
Axis Property
BaseRadius Property
Deadzone Property
Default Property
Exponent Property
Gate Property
InputRadius Property
KnobRadius Property
Mode Property
OuterDeadzone Property
ReturnSeconds Property
Sensitivity Property
ShowBase Property
ShowKnob Property

.ctor

public GuiControlSettings(Astra.GuiStickMode Mode, Astra.GuiStickAxis Axis, Astra.GuiStickGate Gate, float InputRadius, float BaseRadius, float KnobRadius, float Deadzone, float OuterDeadzone, float Exponent, float Sensitivity, float ReturnSeconds, bool ShowBase, bool ShowKnob)

Caminho: Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em 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: Canvas e UI de jogo. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Parâmetro Tipo Contrato
Mode Astra.GuiStickMode
Axis Astra.GuiStickAxis
Gate Astra.GuiStickGate
InputRadius float
BaseRadius float
KnobRadius float
Deadzone float
OuterDeadzone float
Exponent float
Sensitivity float
ReturnSeconds float
ShowBase bool
ShowKnob bool

Axis

public Astra.GuiStickAxis Axis { get; init; }

Caminho: Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

Uso: Restringe eixo Livre/Horizontal/Vertical.

Roadmap deste membro: Canvas e UI de jogo. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

BaseRadius

public float BaseRadius { get; init; }

Caminho: Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

Uso: Raio visual da base em pixels.

Roadmap deste membro: Canvas e UI de jogo. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Deadzone

public float Deadzone { get; init; }

Caminho: Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

Uso: Zona morta interna normalizada.

Roadmap deste membro: Canvas e UI de jogo. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Default

public static Astra.GuiControlSettings Default { get; }

Caminho: Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

Uso: 80/80/28 px, deadzone 0,12, ganho/expoente 1, retorno 0,12 s.

Roadmap deste membro: Canvas e UI de jogo. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Exponent

public float Exponent { get; init; }

Caminho: Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

Uso: Expoente da curva de resposta.

Roadmap deste membro: Canvas e UI de jogo. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Gate

public Astra.GuiStickGate Gate { get; init; }

Caminho: Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

Uso: Domínio circular ou quadrado.

Roadmap deste membro: Canvas e UI de jogo. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

InputRadius

public float InputRadius { get; init; }

Caminho: Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

Uso: Raio de referência da entrada em pixels.

Roadmap deste membro: Canvas e UI de jogo. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

KnobRadius

public float KnobRadius { get; init; }

Caminho: Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

Uso: Raio visual do puxador.

Roadmap deste membro: Canvas e UI de jogo. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Mode

public Astra.GuiStickMode Mode { get; init; }

Caminho: Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

Uso: Fixo/Flutuante/Dinâmico do controle.

Roadmap deste membro: Canvas e UI de jogo. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

OuterDeadzone

public float OuterDeadzone { get; init; }

Caminho: Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

Uso: Zona morta externa normalizada.

Roadmap deste membro: Canvas e UI de jogo. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

ReturnSeconds

public float ReturnSeconds { get; init; }

Caminho: Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

Uso: Tempo do retorno visual.

Roadmap deste membro: Canvas e UI de jogo. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

Sensitivity

public float Sensitivity { get; init; }

Caminho: Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

Uso: Ganho da resposta.

Roadmap deste membro: Canvas e UI de jogo. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

ShowBase

public bool ShowBase { get; init; }

Caminho: Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

Uso: Mostra desenho da base.

Roadmap deste membro: Canvas e UI de jogo. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

ShowKnob

public bool ShowKnob { get; init; }

Caminho: Interface / Canvas UI → documento → elemento; use o contexto Gui.ForCanvas em Behavior.

Uso: Mostra desenho do puxador.

Roadmap deste membro: Canvas e UI de jogo. Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.