Partager via


Format de fichier d’animation d’entrée — MRTK2

Structure globale

Le fichier binaire d’animation d’entrée commence par un nombre magique entier 64 bits. La valeur de ce nombre en notation hexadécimale est 0x6a8faf6e0f9e42c6 et peut être utilisée pour identifier les fichiers d’animation d’entrée valides.

Les huit octets suivants sont deux valeurs Int32 déclarant le numéro de version principale et secondaire du fichier.

Le reste du fichier est occupé par les données d’animation, qui peuvent changer d’un numéro de version à l’autre.

Section Type
Nombre magique Int64
Numéro de version principale Int32
Numéro de version secondaire Int32
Données d’animation voir la section version

Version 1.1

Les données d’animation d’entrée se composent de trois valeurs booléennes qui indiquent si l’animation contient des données Caméra, Main et Regard, suivies d’une séquence de courbes d’animation. Les courbes présentes dépendent des valeurs de ces booléens. Chaque courbe peut avoir un nombre différent d’images clés.

Section Type Notes
A la pose de la caméra Boolean
A des données manuelles Boolean
A le regard Boolean
Appareil photo Courbes de pose Uniquement si la pose de l’appareil photo est vraie
Suivi à la main gauche Courbe booléenne Uniquement si les données de la main ont la valeur true
Suivi à la main droite Courbe booléenne Uniquement si les données de la main ont la valeur true
Pincement à gauche de la main Courbe booléenne Uniquement si les données de la main ont la valeur true
Pincement de la main vers la droite Courbe booléenne Uniquement si les données de la main ont la valeur true
Articulations de la main gauche Courbes de pose conjointes Uniquement si les données de la main ont la valeur true
Articulations de la main vers la droite Courbes de pose conjointes Uniquement si les données de la main ont la valeur true
Regard Courbes de rayon] Seulement si a le regard est vrai

Version 1.0

Les données d’animation d’entrée se composent d’une séquence de courbes d’animation. Le nombre et la signification des courbes d’animation sont fixes, mais chaque courbe peut avoir un nombre différent d’images clés.

Section Type
Appareil photo Courbes de pose
Suivi à la main gauche Courbe booléenne
Suivi à la main droite Courbe booléenne
Pincement à gauche de la main Courbe booléenne
Pincement de la main vers la droite Courbe booléenne
Articulations de la main gauche Courbes de pose conjointes
Articulations de la main vers la droite Courbes de pose conjointes

Courbes de pose conjointes

Pour chaque main, une séquence de courbes d’animation conjointes est stockée. Le nombre d’articulations est fixe et un ensemble de courbes de pose est stocké pour chaque joint.

Section Type
Aucune Courbes de pose
Poignet Courbes de pose
Palm Courbes de pose
ThumbMetacarpalJoint Courbes de pose
ThumbProximalJoint Courbes de pose
ThumbDistalJoint Courbes de pose
Info-bulle Courbes de pose
IndexMetacarpal Courbes de pose
IndexKnuckle Courbes de pose
IndexMiddleJoint Courbes de pose
IndexDistalJoint Courbes de pose
IndexTip Courbes de pose
MiddleMetacarpal Courbes de pose
MiddleKnuckle Courbes de pose
MiddleMiddleJoint Courbes de pose
MiddleDistalJoint Courbes de pose
MiddleTip Courbes de pose
RingMetacarpal Courbes de pose
RingKnuckle Courbes de pose
RingMiddleJoint Courbes de pose
RingDistalJoint Courbes de pose
RingTip Courbes de pose
PinkyMetacarpal Courbes de pose
PinkyKnuckle Courbes de pose
PinkyMiddleJoint Courbes de pose
PinkyDistalJoint Courbes de pose
PinkyTip Courbes de pose

Courbes de pose

Les courbes de pose sont une séquence de 3 courbes d’animation pour le vecteur de position, suivies de 4 courbes d’animation pour le quaternion de rotation.

Section Type
Position X Courbe float
Position Y Courbe float
Position Z Courbe float
Rotation X Courbe float
Rotation Y Courbe float
Rotation Z Courbe float
Rotation W Courbe float

Courbes de rayon

Les courbes de rayon sont une séquence de 3 courbes d’animation pour le vecteur d’origine, suivies de 3 courbes d’animation pour le vecteur directionnel.

Section Type
Origine X Courbe float
Origine Y Courbe float
Origine Z Courbe float
Direction X Courbe float
Direction Y Courbe float
Direction Z Courbe float

Courbe float

Les courbes à virgule flottante sont des courbes de Bézier à part entière avec un nombre variable d’images clés. Chaque image clé stocke une heure et une valeur de courbe, ainsi que des tangentes et des pondérations sur les côtés gauche et droit de chaque image clé.

Section Type
Mode Pré-habillage Int32, mode Wrap
Mode post-habillage Int32, mode Wrap
Nombre d’images clés Int32
Images clés Image clé float

Image clé float

Une image clé float stocke les valeurs de tangente et de pondération, ainsi que l’heure et la valeur de base.

Section Type
Temps Float32
Valeur Float32
InTangent Float32
OutTangent Float32
InWeight Float32
Poids hors poids Float32
Mode pondéré Int32, mode pondéré

Courbe booléenne

Les courbes booléennes sont des séquences simples de valeurs on/off. Sur chaque image clé, la valeur de la courbe bascule immédiatement.

Section Type
Mode Pré-habillage Int32, mode Wrap
Mode post-habillage Int32, mode Wrap
Nombre d’images clés Int32
Images clés Image clé booléenne

Image clé booléenne

Une image clé booléenne stocke uniquement une heure et une valeur.

Section Type
Temps Float32
Valeur Float32

Mode Wrap

La sémantique des modes Pré et Post-Wrap suit la définition Unity WrapMode . Il s’agit d’une combinaison des bits suivants :

Valeur Signification
0 Par défaut : lit le mode de répétition par défaut défini plus haut.
1 Une fois : lorsque l’heure atteint la fin du clip d’animation, la lecture du clip s’arrête automatiquement et l’heure est réinitialisée au début du clip.
2 Boucle : lorsque l’heure atteint la fin du clip d’animation, l’heure continue au début.
4 PingPong : lorsque l’heure atteint la fin du clip d’animation, le temps de ping pong est de retour entre le début et la fin.
8 ClampForever : lit l’animation. Lorsqu’il atteint la fin, il continuera à jouer le dernier cadre et ne cessera jamais de jouer.

Mode pondéré

La sémantique du mode pondéré suit la définition Unity WeightedMode .

Valeur Signification
0 Aucun : excluez inWeight ou outWeight lors du calcul des segments de courbe.
1 Dans : incluez inWeight lors du calcul du segment de courbe précédent.
2 Out : incluez outWeight lors du calcul du segment de courbe suivant.
3 Les deux : incluez inWeight et outWeight lors du calcul des segments de courbe.