---
title: "Astra.GuiControlSettings"
version: snapshot-2026-10-07
engineGeneration: astra-current
language: C#
status: semantic-reference
reviewedAt: 2026-10-07
appRelease: "0.2.3-preview.20261007"
runtimeVerified: false
platformEvidence: []
url: https://astraengine.com.br/pt-br/snapshot-2026-10-07/api/astra-guicontrolsettings/
---

# Astra.GuiControlSettings

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

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

:::note[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

```csharp
readonly record struct Astra.GuiControlSettings
```

**Interfaces:** `System.IEquatable<Astra.GuiControlSettings>`.

## Onde acessar este tipo

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](/pt-br/snapshot-2026-10-06/ui/layout-e-campos/) e use os records/enums com GuiElement ou GuiAccess. [HUD completo](/pt-br/snapshot-2026-10-06/ui/hud-coracoes/).

## Roadmap e uso

[Canvas e UI de jogo](/pt-br/snapshot-2026-10-06/ui/roadmap/): 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](/pt-br/snapshot-2026-10-06/editor/mapa-de-acesso/).

## Membros

| Membro | Categoria |
|---|---|
| [.ctor](#member-470b7b58f15dad13) | Method |
| [Axis](#member-4371af1be648c89a) | Property |
| [BaseRadius](#member-8145ac698f001826) | Property |
| [Deadzone](#member-1655ddc5595b1a5d) | Property |
| [Default](#member-81370696472fb35c) | Property |
| [Exponent](#member-95ff5a6c9aa0ad5d) | Property |
| [Gate](#member-85b1175514df3e07) | Property |
| [InputRadius](#member-88718089a36cb0d1) | Property |
| [KnobRadius](#member-a9b2966172dd63e9) | Property |
| [Mode](#member-e2ca6580ce8ae073) | Property |
| [OuterDeadzone](#member-68961cd6a425b287) | Property |
| [ReturnSeconds](#member-f703e04900144ab1) | Property |
| [Sensitivity](#member-0802de94fc02898c) | Property |
| [ShowBase](#member-b1c0f616591b77db) | Property |
| [ShowKnob](#member-50de30e174f69bf2) | Property |

<h3 id="member-470b7b58f15dad13" class="astra-member">.ctor</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/ui/roadmap/). 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` |  |

<h3 id="member-4371af1be648c89a" class="astra-member">Axis</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-8145ac698f001826" class="astra-member">BaseRadius</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-1655ddc5595b1a5d" class="astra-member">Deadzone</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-81370696472fb35c" class="astra-member">Default</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-95ff5a6c9aa0ad5d" class="astra-member">Exponent</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-85b1175514df3e07" class="astra-member">Gate</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-88718089a36cb0d1" class="astra-member">InputRadius</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-a9b2966172dd63e9" class="astra-member">KnobRadius</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-e2ca6580ce8ae073" class="astra-member">Mode</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-68961cd6a425b287" class="astra-member">OuterDeadzone</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-f703e04900144ab1" class="astra-member">ReturnSeconds</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-0802de94fc02898c" class="astra-member">Sensitivity</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-b1c0f616591b77db" class="astra-member">ShowBase</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.

<h3 id="member-50de30e174f69bf2" class="astra-member">ShowKnob</h3>

```csharp
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](/pt-br/snapshot-2026-10-06/ui/roadmap/). Contrato existente neste snapshot; sem tarefa individual/datada registrada nesta referência.