CurveAnimation

CurveAnimation est un sous-type de AnimationClip consommé par le système d'animation de Roblox.Il stocke les données d'animation pour chaque canal animé dans un rig comme une courbe séparée et individuelle.Par exemple, CurveAnimation stocke le canal de position pour une articulation articulée en tant que Vector3Curve , et il peut stocker le canal de rotation en tant que EulerRotationCurve ou RotationCurve .

Structure

CurveAnimation stocke les courbes de manière hiérarchique, en correspondant à la hiérarchie de la structure de Motor6Ds ou Bones dans le modèle animé.Sous chaque instance CurveAnimation se trouve une hiérarchie de Folder instances représentant des jointures animées dans le modèle.Sous chaque instance de dossier de ce type, plusieurs instances possibles peuvent exister.Une instance nommée Position de type Vector3Curve peut conduire la traduction locale du Motor6D ou Bone sur le modèle animé, tandis qu'une instance nommée Rotation de type EulerRotationCurve ou RotationCurve peut conduire la rotation locale du Motor6D ou Bone sur le modèle animé.

Correspondance partielle de la hiérarchie

Vous pouvez associer des hiérarchies partielles à un modèle lorsque vous jouez à un CurveAnimation dans le système d'animation de Roblox.Cela signifie que toutes les articulations ne doivent pas être présentes dans la hiérarchie pour que les articulations existantes s'appliquent correctement.De plus, vous pouvez correspondre aux hiérarchies de manière "relative".Par exemple, la racine de la première instance enfant Folder peut être UpperTorso et le système d'animation correspond à toute sous-hiérarchie existante dans le modèle.

Animer des canaux divers

CurveAnimation peut également animer d'autres valeurs numériques dans un modèle.Par exemple, vous pouvez animer les contrôles FACS pour les animations faciales en créant un Folder sous l'instance CurveAnimation nommée après une instance existante FaceControls dans le modèle.Ensuite, pour animer des contrôleurs faciaux individuels, vous pouvez stocker des instances individuelles FloatCurve nommées après la propriété animée FaceControls.

Utilisation lors de la création d'animations

Comme pour d'autres types AnimationClip tels que KeyframeSequence , vous devez d'abord télécharger CurveAnimation instances sur Roblox avant de les jouer.Si vous voulez prévisualiser une animation avant de la télécharger sur Roblox, vous pouvez générer un ID temporaire en utilisant AnimationClipProvider:RegisterAnimationClip() ; cela génère un ID de hachage que vous pouvez utiliser pour les tests d'animation localisés.

Si vous souhaitez télécharger la CurveAnimation correspondant à une animation téléchargée existante en utilisant les scripts Luau, utilisez AnimationClipProvider:GetAnimationClipAsync() .