GameInputTouchState

说明触控输入设备的状态。

语法

typedef struct GameInputTouchState {  
    uint64_t touchId;
    uint32_t sensorIndex;
    float positionX;  
    float positionY;  
    float pressure;  
    float proximity;  
    float contactRectTop;
    float contactRectLeft;
    float contactRectRight;
    float contactRectBottom;
} GameInputTouchState  

成员

touchId
类型:uint64_t

触摸输入的 ID。 这是一个单调递增的值。 第一个触控点的 ID 为1。 第二个触控点(无论是哪个位置)的 ID 为2。 这种行为使应用程序可以明确确定一组触控坐标是现有触控的延续还是另一个的部分。

sensorIndex
类型:uint32_t

触摸输入传感器的索引。

positionX
类型:float

作为 [-1.0, 1.0] 范围内的标准化值在 x 轴上的位置。

positionY
类型:float

作为 [-1.0, 1.0] 范围内的标准化值在 y 轴上的位置。

pressure
类型:float

在触控传感器上施加的压力。 该值在 [-1.0, 1.0] 范围内标准化。1.0 等于根据 GameInputTouchSensorInfomaxPressure 成员可以感测到的最大压力值。

proximity
类型:float

触控传感器和触控实施(如手指或触笔)之间的距离。 该值在范围 [0.0,1.0] 范围内标准化。 值 1.0 表示直接接触。 值 0.0 表示触控实施超出范围;也就是说,超出 GameInputTouchSensorInfomaxProximity 成员中指定的距离。 如果不支持近程感应,则仅报告值0.0 和1.0。

contactRectTop
类型:float

Y 轴上的接触矩形的顶部位置。

contactRectLeft
类型:float

Y 轴上的接触矩形的左侧位置。

contactRectRight
类型:float

Y 轴上的接触矩形的右侧位置。

contactRectBottom
类型:float

Y 轴上的接触矩形的底部位置。

备注

此结构由 IGameInputReading::GetTouchState 方法使用。 触控传感器中的坐标与屏幕坐标不相关。

邻近感应成员的值似乎违反常理。 值越小,与触控传感器之间的距离越大。

有关详细信息,请参阅 GameInput 读取

要求

头文件:GameInput.h

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

另请参阅

GameInput 概述
GameInput