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은 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 콘솔