인식기 플러그 인
인식기 플러그 인은 제스처, 필기 또는 기타 개체에 대한 태블릿 펜의 움직임을 모니터링하는 개체입니다.
시스템 제스처
RealTimeStylus 개체는 시스템 제스처를 인식합니다. RealTimeStylus 개체는 SystemGesture에 대한 StylusUpData 개체와 같이 제스처를 완료하는 데이터에 대한 응답으로 StylusQueues 큐에 SystemGestureData 개체를 추가합니다. 자세한 내용은 플러그 인 데이터 및 RealTimeStylus 클래스를 참조하세요.
GestureRecognizer 개체
GestureRecognizer 개체는 IStylusSyncPlugin 및 IStylusAsyncPlugin 인터페이스를 구현합니다. GestureRecognizer 개체는 애플리케이션 제스처를 인식합니다. 내부적으로 GestureRecognizer 개체는 Microsoft 제스처 인식기를 사용하여 제스처 인식을 수행합니다.
GestureRecognizer 개체가 제스처를 인식하면 스트로크에 대한 StylusUpData 개체에 대한 응답으로 StylusQueues 큐에 사용자 지정 스타일러스 데이터를 추가합니다. CustomStylusData 개체의 CustomDataId 속성은 GestureRecognitionDataGuid 값으로 설정되고 CustomStylusData 개체의 Data 속성에는 GestureRecognitionData 개체가 포함됩니다.
다음 다이어그램에서는 GestureRecognizer 개체가 태블릿 펜 데이터에 데이터를 추가하는 방법을 보여 줍니다.
이 다이어그램에서 "SD"라는 원 문자는 StylusDownData 개체를 나타내고 "P"라는 문자가 있는 원은 RealTimeStylus 개체의 출력 큐에 이미 추가되어 아직 비동기 플러그 인 컬렉션으로 전송되지 않은 PacketsData 개체를 나타냅니다. 원 문자 "SU"는 RealTimeStylus 개체가 현재 처리 중인 StylusUpData 개체를 나타냅니다. 동기 플러그 인 컬렉션으로 전송된 다음 출력 큐에 배치됩니다. "GR"이라는 문자가 지정된 원은 "SU"와 연결된 스타일러스 업 알림에 대한 응답으로 GestureRecognizer 플러그 인에 의해 입력 큐에 추가되는 사용자 지정 스타일러스 데이터를 나타냅니다. 그런 다음 사용자 지정 스타일러스 데이터 문자 "GR"이 동기 플러그 인에 전달된 다음, 다음 태블릿 펜 데이터가 처리되기 전에 출력 큐에 전달됩니다. 빈 원은 이후 태블릿 펜 데이터가 추가되는 출력 큐의 위치를 나타냅니다.
기본적으로 GestureRecognizer 개체는 단일 스트로크 제스처만 인식합니다. 그러나 GestureRecognizer 개체는 다중 입력 제스처를 인식하도록 설정할 수 있습니다. 다중 입력 제스처의 경우 CustomStylusData 개체는 제스처의 마지막 스트로크에 대한 StylusUpData 개체에 대한 응답으로 StylusQueues 큐에 추가됩니다. 다중 입력 제스처를 인식할 때 겹치는 스트로크 집합에 대한 알림을 받을 수 있습니다. 예를 들어 첫 번째와 두 번째 스트로크를 함께 하나의 제스처로 인식할 수 있으며 두 번째 스트로크 자체는 제스처로 인식될 수 있습니다. 다중 입력 제스처 인식에 대한 자세한 내용은 GestureRecognizer 클래스 및 MaxStrokeCount 속성을 참조하세요.
다중 입력 제스처 인식에 GestureRecognizer 개체를 사용하는 경우 계단식 RealTimeStylus 모델을 사용하고 GestureRecognizer 개체를 보조 RealTimeStylus 개체에 연결하여 최적의 성능을 얻을 수 있습니다. 연속 RealTimeStylus 모델에 대한 자세한 내용은 Cascaded RealTimeStylus 모델을 참조하세요.
특별 고려 사항
다음 목록에서는 GestureRecognizer 개체를 사용할 때 고려해야 할 다른 사항에 대해 설명합니다.
-
GestureRecognizer 개체를 둘 이상의 RealTimeStylus 개체에 연결하면 안 됩니다.
GestureRecognizer 개체가 연결된 RealTimeStylus 개체 두 개를 사용하도록 설정하면 다음이 발생합니다.
- GestureRecognizer 개체는 RealTimeStylusEnabled 메서드에 대한 두 번째 호출에 대한 응답으로 예외를 throw합니다.
- 사용하도록 설정된 두 번째 RealTimeStylus 개체는 ErrorData 개체를 생성하고 플러그 인 컬렉션의 나머지 플러그 인에 오류에 대해 알릴 수 있습니다.
- GestureRecognizer 개체는 제스처 인식을 중지합니다.
- RealTimeStylus 개체는 Guid 매개 변수를 Microsoft.StylusInput.GestureRecognizer.GestureRecognitionDataGuid GUID(Globally Unique Identifier)로 설정하여 AddCustomStylusDataToQueue 메서드를 호출할 때 예외를 throw합니다.
- GestureRecognizer 개체는 COM(구성 요소 개체 모델) 래퍼로 구현되며 IStylusSyncPlugin 또는 IStylusAsyncPlugin 인터페이스 메서드를 직접 호출할 수 없습니다. COM 구현 및 RealTimeStylus 개체에 대한 자세한 내용은 StylusInput API에 대한 구현 정보를 참조하세요.
사용자 지정 제스처 인식
다음을 통해 필기, 제스처 또는 기타 개체를 인식하는 사용자 지정 인식기 플러그 인을 만들 수 있습니다.
- 스트로크 정보를 기존 Recognizer 개체에 전달하고 AddCustomStylusDataToQueue 메서드를 사용하여 결과를 태블릿 펜 데이터 스트림에 추가합니다.
- 플러그 인 내에서 인식을 수행하고 AddCustomStylusDataToQueue 메서드를 사용하여 결과를 태블릿 펜 데이터 스트림에 추가합니다.
관련 항목