GameInputAxisMapping

描述轴如何映射到控制器。

语法

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

成员

controllerElementKind
类型: GameInputElementKind

从中映射轴的控制器元素的类型。

controllerIndex
类型:uint32_t

从中映射轴的控制器元素的索引。 索引从零开始,相对于同一类型的其他元素。 无论轴是从另一个轴、按钮还是从开关映射,此索引都相关。

isInverted
类型:bool 指示轴是否反转。 例如,如果给定的值范围为 [0 - 1],其中 0 为中性,1 为完全位移,则预期 1 代表中性位置,0 表示完全位移,值介于倒置之间。 仅当轴从另一个轴映射时,此成员才有效。

fromTwoButtons
类型:bool

指示轴是否从两个按钮映射。 仅当轴从按钮映射时,此成员才有效。 如果为 true,则索引字段为按钮最大值,buttonMinIndexValue 字段为按钮最小值。

buttonMinIndexValue
类型:uint32_t

表示轴最小值的按钮的索引。 索引从零开始。 仅当轴从两个按钮映射时,此成员才有效。

referenceDirection
类型:GameInputSwitchPosition

表示轴正方向的开关位置。 参考位置应映射到轴值 1.0 ,与轴值 0.0相反的方向。 值之间的 值可能不同。 如果考虑相邻,则直接相邻也应映射到 1.0,并且将值后映射到 0.5,如果未考虑这些邻接,则除相反方向之外的所有非引用位置都将映射到 0.5。 仅当轴从开关映射时,此成员才有效。

备注

此映射信息共享设备或协议提供的内部信息,说明它预期如何为给定输入进行解释。 在某些情况下,我们不会共享此信息的全部信息,而是共享与为给定输入生成映射最相关的内容。

对于轴,我们允许从轴、按钮或开关映射这些对象。 哪个输入是源由 controllerElementKind 提供。 对于所有源元素类型,源输入的索引由 controllerIndex 提供。 然后,可以根据 controllerElementKind 值将此索引与控制器轴、按钮或开关一起使用。

要求

头文件:GameInput.h

支持平台:Windows、Xbox One 系列主机和 Xbox Series 主机

另请参阅

GameInput 概述

GameInput