> ## 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

Décrit la manière dont un axe est mappé à la manette.

## Syntaxe

```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;
};
```

### Membres

*controllerElementKind*<br />
Type : [GameInputElementKind](/fr/reference/input/gameinput/enums/gameinputelementkind)

Type d'élément de manette à partir duquel l'axe est mappé.

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

Index de l'élément de manette à partir duquel l'axe est mappé. L'index commence à zéro et est relatif aux autres éléments du même type. Cet index est pertinent que l'axe soit mappé à partir d'un autre axe, de boutons ou d'un commutateur.

*isInverted*<br />
Type : bool
Indique si l'axe est inversé. Par exemple, si la plage de valeurs fournie est \[0 - 1], où 0 correspond à la position neutre et 1 au déplacement complet, alors 1 est censé représenter la position neutre, 0 le déplacement complet, et les valeurs intermédiaires sont inversées. Ce membre n'est valide que lorsque l'axe est mappé à partir d'un autre axe.

*fromTwoButtons*<br />
Type : bool

Indique si l'axe est mappé à partir de deux boutons. Ce membre n'est valide que lorsque l'axe est mappé à partir de boutons. Si la valeur est true, le champ d'index correspond à la valeur maximale du bouton et le champ buttonMinIndexValue à la valeur minimale du bouton.

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

Index du bouton qui représente la valeur minimale de l'axe. L'index commence à zéro. Ce membre n'est valide que lorsque l'axe est mappé à partir de deux boutons.

*referenceDirection*<br />
Type : [GameInputSwitchPosition](/fr/reference/input/gameinput/enums/gameinputswitchposition)

Position du commutateur qui représente la direction positive de l'axe. La position de référence est censée correspondre à la valeur d'axe `1.0` et la direction opposée à la valeur d'axe `0.0`. Les valeurs intermédiaires peuvent varier. Si les positions adjacentes sont prises en compte, les positions immédiatement adjacentes sont également censées être mappées à `1.0`, et les suivantes à `0.5` ; si elles ne sont pas prises en compte, toutes les positions autres que la position de référence, à l'exception de la direction opposée, sont mappées à `0.5`. Ce membre n'est valide que lorsque l'axe est mappé à partir d'un commutateur.

## Remarques

Ces informations de mappage partagent des informations internes fournies par l'appareil ou le protocole sur la manière dont il s'attend à être interprété pour une entrée donnée. Dans certains cas, nous ne partageons pas la totalité de ces informations et partageons plutôt ce qui est le plus pertinent pour générer un mappage pour l'entrée donnée.

Les axes peuvent être mappés à partir d'un axe, de boutons ou d'un commutateur. L'entrée source est indiquée par *controllerElementKind*. Pour tous les types d'éléments sources, l'index de l'entrée source est indiqué par *controllerIndex*. Cet index peut ensuite être utilisé avec les axes, les boutons ou les commutateurs de la manette, selon la valeur de *controllerElementKind*.

## Configuration requise

**En-tête :** GameInput.h

**Plateformes prises en charge :** Windows, consoles de la famille XBOX One et consoles XBOX Series

## Voir aussi

[Vue d'ensemble de GameInput](/fr/build/core-features/common/input/overviews/input-overview)<br />

[GameInput](/fr/reference/input/gameinput/gameinput_members)

## Historique des versions

| Version | Modifications |
| - | - |
| **v3** | **Nouvelle structure** introduite dans l'API actuelle. Absente des versions v0, v1 et 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)