AddStroke 함수(recapis.h)

RecognizerContext에 잉크 스트로크를 추가합니다.

구문

HRESULT AddStroke(
  HRECOCONTEXT             hrc,
  const PACKET_DESCRIPTION *pPacketDesc,
  ULONG                    cbPacket,
  const BYTE               *pPacket,
  const XFORM              *pXForm
);

매개 변수

hrc

인식기 컨텍스트에 대한 핸들입니다.

pPacketDesc

패킷의 내용을 설명합니다. 설명은 pPacket의 패킷 내용과 일치해야 합니다. NULL인 경우 이 함수는 GetPreferredPacketDescription 함수를 사용합니다.

cbPacket

pPacket 버퍼의 크기(바이트)입니다.

pPacket

태블릿 공간 좌표를 포함하는 패킷의 배열입니다.

pXForm

잉크에 적용하여 태블릿 공간에서 잉크 공간으로 변환할 수 있는 변환에 대해 설명합니다. 인식기에서 이 변환을 무시하고 고유한 잉크 회전 알고리즘을 구현하도록 선택할 수 있습니다. 이러한 인식기는 여전히 이 변환을 기준으로 격자 데이터에서 계산된 속성을 반환해야 합니다.

반환 값

이 함수는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	Description
S_OK	성공.
E_POINTER	매개 변수 중 하나가 잘못된 포인터입니다.
E_OUTOFMEMORY	작업을 완료하기 위해 메모리를 할당할 수 없습니다.
TPC_E_INVALID_PACKET_DESCRIPTION	패킷 설명에는 유효한 것으로 간주되는 패킷에 필요한 정보가 포함되어 있지 않습니다. 예를 들어 GUID_X 또는 GUID_Y 속성은 포함되지 않습니다.
TPC_E_OUT_OF_ORDER_CALL	메서드에 대한 호출이 순서대로 수행되었습니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.
E_INVALIDARG	잘못된 인수가 수신되었습니다.

설명

인식기에서는 태블릿 좌표가 아닌 잉크 공간 좌표의 기준 과 같은 속성을 반환해야 합니다.

인식기는 컨텍스트당 스트로크 수 및/또는 지정된 스트로크에서 허용되는 지점에 제한을 두는 것이 좋습니다. 입력을 컨텍스트당 1024 스트로크로 제한하고 스트로크당 32767포인트로 제한합니다.

점이 0인 스트로크는 허용되지 않습니다. 이러한 경우 E_FAIL 반환해야 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP 태블릿 PC 버전 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	지원되는 버전 없음
대상 플랫폼	Windows
헤더	recapis.h
DLL	inkobjcore.dll

추가 정보

GetPreferredPacketDescription

PACKET_DESCRIPTION 구조체