입력 애니메이션 파일 형식 - MRTK2

전체 구조체

입력 애니메이션 이진 파일은 64비트 정수 매직 넘버로 시작합니다. 이 숫자의 값은 16진수 표기법이며 0x6a8faf6e0f9e42c6 유효한 입력 애니메이션 파일을 식별하는 데 사용할 수 있습니다.

다음 8바이트는 파일의 주 버전 및 부 버전 번호를 선언하는 두 개의 Int32 값입니다.

나머지 파일은 애니메이션 데이터에 의해 수행되며 버전 번호 간에 변경 될 수 있습니다.

섹션	형식
매직 넘버	Int64
주 버전 번호	Int32
부 버전 번호	Int32
애니메이션 데이터	버전 섹션 참조

버전 1.1

입력 애니메이션 데이터는 애니메이션에 카메라, 손 및 시선 응시 데이터가 포함되는지 여부를 나타내는 세 개의 부울 값과 애니메이션 곡선 시퀀스로 구성됩니다. 존재하는 곡선은 이러한 부울의 값에 따라 달라집니다. 각 곡선에는 서로 다른 수의 키 프레임이 있을 수 있습니다.

섹션	형식	참고
카메라 포즈가 있습니다.	부울
손 데이터 사용	부울
시선 응시	부울
카메라	포즈 곡선	카메라 포즈가 true인 경우에만
왼쪽에서 손 추적	부울 곡선	Has Hand Data가 true인 경우에만
오른쪽에서 손 추적	부울 곡선	Has Hand Data가 true인 경우에만
왼쪽 손가락 모으기	부울 곡선	Has Hand Data가 true인 경우에만
오른쪽 손 꼬집기	부울 곡선	Has Hand Data가 true인 경우에만
왼쪽 손 관절	조인트 포즈 곡선	Has Hand Data가 true인 경우에만
오른쪽 손 관절	조인트 포즈 곡선	Has Hand Data가 true인 경우에만
시선 응시	광선 곡선]	시선 응시가 true인 경우에만

버전 1.0

입력 애니메이션 데이터는 애니메이션 곡선 시퀀스로 구성됩니다. 애니메이션 곡선의 수와 의미는 고정되어 있지만 각 곡선에는 서로 다른 수의 키 프레임이 있을 수 있습니다.

섹션	형식
카메라	포즈 곡선
왼쪽에서 손 추적	부울 곡선
오른쪽에서 손 추적	부울 곡선
왼쪽 손가락 모으기	부울 곡선
오른쪽 손 꼬집기	부울 곡선
왼쪽 손 관절	조인트 포즈 곡선
오른쪽 손 관절	조인트 포즈 곡선

조인트 포즈 곡선

각 손에 대해 조인트 애니메이션 곡선 시퀀스가 저장됩니다. 조인트 수가 고정되고 각 조인트마다 포즈 곡선 집합이 저장됩니다.

섹션	형식
없음	포즈 곡선
손목	포즈 곡선
Palm	포즈 곡선
ThumbMetacarpalJoint	포즈 곡선
ThumbProximalJoint	포즈 곡선
ThumbDistalJoint	포즈 곡선
ThumbTip	포즈 곡선
IndexMetacarpal	포즈 곡선
IndexKnuckle	포즈 곡선
IndexMiddleJoint	포즈 곡선
IndexDistalJoint	포즈 곡선
IndexTip	포즈 곡선
MiddleMetacarpal	포즈 곡선
MiddleKnuckle	포즈 곡선
MiddleMiddleJoint	포즈 곡선
MiddleDistalJoint	포즈 곡선
미들 팁	포즈 곡선
RingMetacarpal	포즈 곡선
RingKnuckle	포즈 곡선
RingMiddleJoint	포즈 곡선
RingDistalJoint	포즈 곡선
링 설명	포즈 곡선
PinkyMetacarpal	포즈 곡선
PinkyKnuckle	포즈 곡선
PinkyMiddleJoint	포즈 곡선
PinkyDistalJoint	포즈 곡선
PinkyTip	포즈 곡선

포즈 곡선

포즈 곡선은 위치 벡터의 애니메이션 곡선 3개와 회전 쿼터니언의 애니메이션 곡선 4개 시퀀스입니다.

섹션	형식
위치 X	부동 곡선
위치 Y	부동 곡선
Z 위치	부동 곡선
회전 X	부동 곡선
회전 Y	부동 곡선
회전 Z	부동 곡선
회전 W	부동 곡선

광선 곡선

광선 곡선은 원점 벡터의 애니메이션 곡선 3개와 방향 벡터의 애니메이션 곡선 3개 시퀀스입니다.

섹션	형식
원본 X	부동 곡선
원본 Y	부동 곡선
원본 Z	부동 곡선
방향 X	부동 곡선
방향 Y	부동 곡선
방향 Z	부동 곡선

부동 곡선

부동 소수점 곡선은 다양한 수의 키프레임이 있는 완전 본격적인 베지어 곡선입니다. 각 키 프레임은 시간 및 곡선 값뿐만 아니라 각 키 프레임의 왼쪽과 오른쪽에 탄젠트 및 가중치를 저장합니다.

섹션	형식
사전 래핑 모드	Int32, 래핑 모드
래핑 후 모드	Int32, 래핑 모드
키 프레임 수	Int32
키 프레임	Float 키프레임

Float 키프레임

float 키프레임은 기본 시간 및 값과 함께 탄젠트 및 가중치 값을 저장합니다.

섹션	형식
Time	Float32
값	Float32
InTangent	Float32
OutTangent	Float32
InWeight	Float32
OutWeight	Float32
WeightedMode	Int32, 가중 모드

부울 곡선

부울 곡선은 온/오프 값의 간단한 시퀀스입니다. 모든 키프레임에서 곡선의 값은 즉시 대칭 이동됩니다.

섹션	형식
사전 래핑 모드	Int32, 래핑 모드
래핑 후 모드	Int32, 래핑 모드
키 프레임 수	Int32
키 프레임	부울 키프레임

부울 키프레임

부울 키프레임은 시간과 값만 저장합니다.

섹션	형식
Time	Float32
값	Float32

래핑 모드

Pre-and Post-Wrap 모드의 의미 체계는 Unity WrapMode 정의를 따릅니다. 다음 비트의 조합입니다.

값	의미
0	기본값: 더 높게 설정된 기본 반복 모드를 읽습니다.
1	한 번: 시간이 애니메이션 클립의 끝에 도달하면 클립 재생이 자동으로 중지되고 시간이 클립의 시작 부분으로 다시 설정됩니다.
2	루프: 시간이 애니메이션 클립의 끝에 도달하면 시간이 시작 부분에서 계속됩니다.
4	PingPong: 시간이 애니메이션 클립의 끝에 도달하면 시간은 시작과 끝 사이에 탁구를 다시 탁구합니다.
8	ClampForever: 애니메이션을 재생합니다. 끝에 도달하면 마지막 프레임을 계속 재생하고 재생을 멈추지 않습니다.

가중 모드

가중 모드의 의미 체계는 Unity WeightedMode 정의를 따릅니다.

값	의미
0	없음: 곡선 세그먼트를 계산할 때 inWeight 또는 outWeight을 모두 제외합니다.
1	In: 이전 곡선 세그먼트를 계산할 때 inWeight를 포함합니다.
2	Out: 다음 곡선 세그먼트를 계산할 때 outWeight을 포함합니다.
3	둘 다: 곡선 세그먼트를 계산할 때 inWeight 및 outWeight을 포함합니다.