> ## Documentation Index
> Fetch the complete documentation index at: https://devdocs.xbox.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GameInputAxisMapping

> GameInputAxisMapping

# GameInputAxisMapping

Descreve como um eixo é mapeado para o controle.

## Sintaxe

```cpp theme={null}
struct GameInputAxisMapping {
    GameInputElementKind controllerElementKind;
    uint32_t             controllerIndex;

    // When axis is mapped from a axis
    bool isInverted;

    // When the axis is mapped from a button
    bool     fromTwoButtons;
    uint32_t buttonMinIndexValue;

    // When the axis is mapped from a switch
    GameInputSwitchPosition referenceDirection;
};
```

### Membros

*controllerElementKind*<br />
Tipo: [GameInputElementKind](/pt-BR/reference/input/gameinput/enums/gameinputelementkind)

O tipo de elemento do controle a partir do qual o eixo é mapeado.

*controllerIndex*<br />
Tipo: uint32\_t

O índice do elemento do controle a partir do qual o eixo é mapeado. O índice começa em zero e é relativo a outros elementos do mesmo tipo. Esse índice é relevante quer o eixo seja mapeado a partir de outro eixo, de botões ou de um switch.

*isInverted*<br />
Tipo: bool
Indica se o eixo está invertido. Por exemplo, se o intervalo de valores fornecido for \[0 - 1], em que 0 é neutro e 1 é o deslocamento total, espera-se que 1 represente a posição neutra, 0 o deslocamento total e os valores intermediários sejam invertidos. Este membro só é válido quando o eixo é mapeado a partir de outro eixo.

*fromTwoButtons*<br />
Tipo: bool

Indica se o eixo é mapeado a partir de dois botões. Este membro só é válido quando o eixo é mapeado a partir de botões. Se for true, o campo de índice será o valor máximo do botão e o campo buttonMinIndexValue será o valor mínimo do botão.

*buttonMinIndexValue*<br />
Tipo: uint32\_t

O índice do botão que representa o valor mínimo do eixo. O índice começa em zero. Este membro só é válido quando o eixo é mapeado a partir de dois botões.

*referenceDirection*<br />
Tipo: [GameInputSwitchPosition](/pt-BR/reference/input/gameinput/enums/gameinputswitchposition)

A posição do switch que representa a direção positiva do eixo. Espera-se que a posição de referência seja mapeada para o valor de eixo `1.0` e a direção oposta para o valor de eixo `0.0`. Os valores intermediários podem variar. Se as posições adjacentes forem consideradas, espera-se que as adjacentes imediatas também sejam mapeadas para `1.0` e o valor seguinte para `0.5`; se não forem consideradas, todas as posições que não são de referência, exceto a direção oposta, serão mapeadas para `0.5`. Este membro só é válido quando o eixo é mapeado a partir de um switch.

## Comentários

Essas informações de mapeamento compartilham informações internas fornecidas pelo dispositivo ou protocolo sobre como ele espera ser interpretado para uma determinada entrada. Em alguns casos, não compartilhamos a totalidade dessas informações e, em vez disso, compartilhamos o que é mais relevante para gerar um mapeamento para a entrada fornecida.

Para eixos, permitimos que eles sejam mapeados a partir de um eixo, de botões ou de um switch. A entrada de origem é indicada por *controllerElementKind*. Para todos os tipos de elemento de origem, o índice da entrada de origem é indicado por *controllerIndex*. Esse índice pode então ser usado com eixos, botões ou switches do controle, de acordo com o valor de *controllerElementKind*.

## Requisitos

**Cabeçalho:** GameInput.h

**Plataformas com suporte:** Windows, consoles da família XBOX One e consoles XBOX Series

## Confira também

[Visão geral do GameInput](/pt-BR/build/core-features/common/input/overviews/input-overview)<br />

[GameInput](/pt-BR/reference/input/gameinput/gameinput_members)

## Histórico de versões

| Versão | Alterações |
| - | - |
| **v3** | **Nova estrutura** introduzida na API atual. Não está presente na v0, v1 ou v2. |


## Related topics

- [GameInputAxisMapping](/reference/input/gameinput/structs/gameinputaxismapping.md)
- [IGameInputMapper::GetGamepadAxisMappingInfo](/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getgamepadaxismappinginfo.md)
- [IGameInputMapper::GetFlightStickAxisMappingInfo](/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getflightstickaxismappinginfo.md)
- [IGameInputMapper::GetRacingWheelAxisMappingInfo](/reference/input/gameinput/interfaces/igameinputmapper/methods/igameinputmapper_getracingwheelaxismappinginfo.md)
- [GameInputElementKind](/reference/input/gameinput/enums/gameinputelementkind.md)