Gesture Tap Count 함수 설명
gesture_tap_count
함수는 탭 카운팅 기능을 활성화하거나 비활성화하는 데 사용됩니다. 이 함수의 사용법과 다양한 활용 예제를 아래에서 설명합니다.
기능 설명
- 탭 카운팅 활성화:
true
로 설정하면 탭 카운팅이 활성화됩니다. - 탭 카운팅 비활성화:
false
로 설정하면 탭 카운팅이 비활성화됩니다. - 탭 카운트 확인:
gesture_get_tap_count()
함수를 사용하여 현재 탭 카운팅 상태를 확인할 수 있습니다.
탭 카운팅이 활성화되면 각 탭 이벤트에 "tapcount" DS 맵 항목이 추가되어 탭 수가 기록됩니다. 예를 들어, 두 번 탭하면 단일 탭 이벤트와 이중 탭 이벤트가 모두 트리거됩니다. 단일 탭 이벤트의 탭 카운트는 1, 이중 탭 이벤트의 탭 카운트는 2입니다.
탭 카운트 값은 이중 탭 감지 시간(gesture_double_tap_time()
)이 지나면 0으로 초기화됩니다. 탭 카운팅이 비활성화된 경우, 초기 탭은 이중 탭 시간 동안 두 번째 탭이 감지되지 않으면 등록되지 않습니다. 기본적으로 탭 카운팅은 활성화되어 있습니다.
문법
gesture_tap_count(enable);
인수 설명
인수 | 타입 | 설명 |
---|---|---|
enable | Boolean | 탭 카운팅을 활성화(true) 또는 비활성화(false) |
반환값
- 없음
예제 코드
탭 카운팅이 활성화되어 있는지 확인하고, 비활성화되어 있다면 활성화하는 코드 예제입니다.
if (!gesture_get_tap_count()) {
gesture_tap_count(true);
}
활용 예제
- 탭 카운팅 활성화 후 이벤트 처리
gml gesture_tap_count(true);
- 탭 카운트에 따라 다른 행동 수행
gml if (gesture_get_tap_count() == 1) { // 단일 탭 처리 } else if (gesture_get_tap_count() == 2) { // 이중 탭 처리 }
- 탭 카운팅 비활성화
gml gesture_tap_count(false);
- 탭 카운트 초기화
gml if (gesture_get_tap_count() > 0) { // 탭 카운트가 0보다 크면 초기화 gesture_tap_count(false); gesture_tap_count(true); }
이와 같이 gesture_tap_count
함수를 활용하여 다양한 터치 이벤트를 관리할 수 있습니다.