다음을 통해 공유


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

X축에서 연락처 사각형의 왼쪽 위치입니다.

contactRectRight
형식: float

X축에서 접촉 직사각형의 오른쪽 위치입니다.

contactRectBottom
형식: float

Y축에서 접촉 직사각형의 아래쪽 위치입니다.

설명

이 구조는 IGameInputReading::GetTouchState 메서드에서 사용됩니다. 터치 센서의 좌표는 화면 좌표와 관련이 없습니다.

proximity 멤버에 대한 값은 반직관적으로 보일 수 있습니다. 값이 작을수록 터치 센서에서 멀리 떨어져 있음을 의미합니다.

자세한 내용은 GameInput 판독값을 참조하세요.

요구 사항

헤더: GameInput.h

지원되는 플랫폼: Windows, Xbox One 패밀리 콘솔 및 Xbox Series 콘솔

참고 항목

GameInput 개요
GameInput