Skip to main content

IGameInputReading::GetMouseState

마우스의 상태를 설명하는 입력 판독의 뷰를 검색합니다.

구문

매개변수

state   _Out_
형식: GameInputMouseState*
입력을 마우스로 해석한 결과입니다.

반환값

형식: bool 마우스 입력 해석에 성공하면 true를 반환합니다. 마우스 입력으로 인식되지 않는 입력을 읽으려고 하면 false를 반환합니다.

설명

IGameInputReading::GetInputKind 메서드를 호출하여 특정 IGameInputReading에 대해 어떤 Get*State 함수가 유효한 해석을 반환할지 확인하세요. 각 Get*State 함수는 IGameInputReading::GetInputKind 열거형에 대응하는 항목이 있습니다. 대응하는 IGameInputReading::GetInputKind 플래그가 설정되지 않은 Get*State 함수를 호출하려고 하면, 함수는 기본 정지 값과 함께 false 반환값을 반환합니다. 마우스 움직임은 장치 기능에 따라 상대 델타 값 및/또는 절대 값으로 장치에서 기본적으로 보고됩니다. 상대 위치는 폴링 API와는 그다지 호환되지 않는데, 이는 주기적으로 현재 마우스 판독을 요청하면 여러 중간 델타를 놓칠 가능성이 크기 때문입니다. GameInput API는 폴링 API를 사용하는 앱이 잠재적으로 수십 개의 이전 마우스 판독을 살펴보고 델타를 더해야 하는 대신, 델타를 가상 “위치” 값에 지속적으로 누적하여 상대적 마우스 움직임을 노출합니다. 그러면 애플리케이션은 이전에 얻은 판독에서 “위치” 값을 빼서 자체 델타를 계산합니다. 이렇게 하면 연속된 판독에 대해 계산될 때는 개별 델타에 접근할 수 있고, 중간 판독이 의도적으로 건너뛰어졌을 때는 누적된 델타에 접근할 수 있습니다. 강조하자면, 마우스 “위치” 값은 단지 모든 이동 델타의 합계이며, 어떤 방식으로도 화면 공간 좌표와 상관관계가 없습니다.

요구 사항

헤더: GameInput.h Input API 개요
IGameInputReading

버전 기록

마지막 수정일 2026년 8월 13일