次の方法で共有

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 です。 2 番目のタッチ ポイント (場所を問わず) の 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 は、GameInputTouchSensorInfo の maxPressure メンバーに従って感知できる最大圧に相当します。

proximity
型: float

タッチ センサーと指やスタイラスなどのタッチ手段の間の距離。 この値は [0.0, 1.0] の範囲で正規化されます。 値 1.0 は、直接接触していることを意味します。 値 0.0 は、タッチ手段が圏外であることを意味します。GameInputTouchSensorInfo の maxProximity メンバーで指定されている距離を超えていることになります。 近接検知がサポートされていない場合、報告される値は、0.0 と 1.0 のみです。

contactRectTop
型: float

Y 軸上の接触矩形の上部位置。

contactRectLeft
型: float

X 軸上の接触矩形の左側位置。

contactRectRight
型: float

X 軸上の接触矩形の右側位置。

contactRectBottom
型: float

Y 軸上の接触矩形の下部位置。

解説

この構造体は、IGameInputReading::GetTouchState メソッドによって使用されます。 タッチ センサー上の座標は、画面の座標との相関関係がありません。

proximity メンバーの値は、直観に反するものである可能性があります。 値が小さくなるほど、タッチ センサーからの距離が大きいことを意味します。

詳細については、「GameInput の読み取り値」を参照してください。

要件

ヘッダー: GameInput.h

サポートされているプラットフォーム: Windows、Xbox One ファミリー本体、Xbox Series 本体

関連項目

GameInput の概要
GameInput