QuaternionKeyFrameAnimation Classe

Définition

Espace de noms:

Microsoft.UI.Composition

Animation basée sur le temps qui cible la propriété Orientation avec une ou plusieurs images clés.

La classe QuaternionKeyFrameAnimation est l’un des types pris en charge d'KeyFrameAnimations qui est utilisé pour animer la propriété Orientation sur un Visual. Les quaternions sont un moyen utile et parfois plus simple de réfléchir à des rotations : les quaternions prennent le chemin le plus court entre les angles et évitent les problèmes tels que Gimbal Lock que les matrices de rotation et d’angle de rotation s’exécutent. Un Quaternion est constitué de deux composants : une partie scalaire et vectorielle.

public ref class QuaternionKeyFrameAnimation sealed : KeyFrameAnimation

/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
class QuaternionKeyFrameAnimation final : KeyFrameAnimation

[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
public sealed class QuaternionKeyFrameAnimation : KeyFrameAnimation

Public NotInheritable Class QuaternionKeyFrameAnimation
Inherits KeyFrameAnimation

Héritage

Object Platform::Object IInspectable CompositionObject CompositionAnimation KeyFrameAnimation QuaternionKeyFrameAnimation

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Exemples

void QuaternionAnimation(SpriteVisual visual)
{
  // Create the QuaternionKeyFrameAnimation
  var quaternionKFA = _compositor.CreateQuaternionKeyFrameAnimation();

  // Create a Quaternion that represents a 45 degree rotation around X Axis
  Quaternion quaternion = new Quaternion(0.380f, 0f, 0.0f, 0.92f);

  // Insert the Quaternion into the KeyFrame
  quaternionKFA.InsertKeyFrame(1.0f, quaternion);
  quaternionKFA.Duration = TimeSpan.FromSeconds(1);

  // Attach to the Orientation property of Visual
  visual.StartAnimation("Orientation", quaternionKFA);
}

Remarques

Une animation est associée à la propriété d’un objet en appelant CompositionObject.StartAnimation et en spécifiant le nom de la propriété et l’animation. Consultez la section remarques de CompositionObject.StartAnimation pour obtenir la liste des propriétés animatables.

Un Quaternion est constitué de deux parties distinguées : un vecteur et un composant scalaire. Lorsque vous utilisez des animations keyframe, le Quaternion peut être défini par la notation de System.Numerics de 4 floats ou d’un Vector3 et d’un scalaire. System.Numerics fournit des constructeurs pour l’une de ces notations.

Lors de la traduction d’une rotation en Quaternion, vous pouvez utiliser les fonctions d’assistance System.Numerics Quaternion qui vous permettent de créer des Quaternions à partir d’une combinaison Axe/Angle, d’une matrice de rotation ou d’un Yaw/Pitch/Roll. Dans l’exemple ci-dessus, le même Quaternion peut être construit à partir de l’assistance ci-dessous :

Quaternion quaternion = Quaternion.CreateFromAxisAngle(new Vector3(1.0f, 0.0f, 0.0f), 0.78f);

Propriétés

Comment	Chaîne à associer au CompositionObject. (Hérité de CompositionObject)
Compositor	Le compositor utilisé pour créer cette CompositionObject. (Hérité de CompositionObject)
DelayBehavior	Comportement de délai de l’animation de trame clé. (Hérité de KeyFrameAnimation)
DelayTime	Délai avant le démarrage de l’animation après CompositionObject.StartAnimation est appelé. (Hérité de KeyFrameAnimation)
Direction	Direction que l’animation joue. La propriété Direction vous permet de piloter votre animation de début à fin ou de fin pour démarrer ou de basculer entre le début et la fin ou la fin si l’animation a un ItérationCount supérieur à un. Cela permet de personnaliser facilement les définitions d’animation. (Hérité de KeyFrameAnimation)
DispatcherQueue	Obtient le DispatcherQueue pour CompositionObject. (Hérité de CompositionObject)
Duration	Durée de l’animation. (Hérité de KeyFrameAnimation)
ImplicitAnimations	Collection d’animations implicites attachées à cet objet. (Hérité de CompositionObject)
InitialValueExpressions	Obtient les valeurs initiales de l’animation. (Hérité de CompositionAnimation)
IterationBehavior	Comportement d’itération pour l’animation de trame clé. (Hérité de KeyFrameAnimation)
IterationCount	Nombre de fois où répéter l’animation de trame clé. (Hérité de KeyFrameAnimation)
KeyFrameCount	Nombre d’images clés dans le KeyFrameAnimation. (Hérité de KeyFrameAnimation)
Properties	Collection de propriétés associées au CompositionObject. (Hérité de CompositionObject)
StopBehavior	Spécifie comment définir la valeur de propriété quand StopAnimation est appelée. (Hérité de KeyFrameAnimation)
Target	Cible de l’animation. (Hérité de CompositionAnimation)

Méthodes

ClearAllParameters()	Efface tous les paramètres de l’animation. (Hérité de CompositionAnimation)
ClearParameter(String)	Efface un paramètre de l’animation. (Hérité de CompositionAnimation)
Close()	Ferme les ressources système CompositionObject et libère. (Hérité de CompositionObject)
Dispose()	Effectue des tâches définies par l’application associées à la libération, à la libération ou à la réinitialisation des ressources non managées. (Hérité de CompositionObject)
InsertExpressionKeyFrame(Single, String, CompositionEasingFunction)	Insère une image clé d’expression. (Hérité de KeyFrameAnimation)
InsertExpressionKeyFrame(Single, String)	Insère un cadre clé d’expression. (Hérité de KeyFrameAnimation)
InsertKeyFrame(Single, Quaternion, CompositionEasingFunction)	Insère un cadre clé avec la fonction d’accélération spécifiée.
InsertKeyFrame(Single, Quaternion)	Insère un cadre clé.
PopulatePropertyInfo(String, AnimationPropertyInfo)	Définit une propriété qui peut être animée. (Hérité de CompositionObject)
SetBooleanParameter(String, Boolean)	Définit un paramètre de valeur booléenne à utiliser avec un ExpressionAnimation ou une image clé d’expression . (Hérité de CompositionAnimation)
SetColorParameter(String, Color)	Définit un paramètre de valeur Color à utiliser avec un ExpressionAnimation ou une image clé d’expression . (Hérité de CompositionAnimation)
SetExpressionReferenceParameter(String, IAnimationObject)	Définit un objet qui implémente IAnimationObject en tant que paramètre de référence dans un ExpressionAnimation. (Hérité de CompositionAnimation)
SetMatrix3x2Parameter(String, Matrix3x2)	Définit un paramètre de valeur Matrix3x2 à utiliser avec un ExpressionAnimation ou un image clé d’expression. (Hérité de CompositionAnimation)
SetMatrix4x4Parameter(String, Matrix4x4)	Définit un paramètre de valeur matrix4x4 à utiliser avec un ExpressionAnimation ou un clé d’expression. (Hérité de CompositionAnimation)
SetQuaternionParameter(String, Quaternion)	Définit une valeur Quaternion à utiliser avec un ExpressionAnimation ou une image clé d’expression . (Hérité de CompositionAnimation)
SetReferenceParameter(String, CompositionObject)	Définit une référence à un objet Composition à utiliser avec un ExpressionAnimation ou une image clé d’expression . (Hérité de CompositionAnimation)
SetScalarParameter(String, Single)	Définit un paramètre de valeur Scalaire à utiliser avec un expressionAnimation ou un image clé d’expression. (Hérité de CompositionAnimation)
SetVector2Parameter(String, Vector2)	Définit un paramètre de valeur Vector2 à utiliser avec un ExpressionAnimation ou un image clé d’expression. (Hérité de CompositionAnimation)
SetVector3Parameter(String, Vector3)	Définit un paramètre de valeur Vector3 à utiliser avec un ExpressionAnimation ou unclé d’expression . (Hérité de CompositionAnimation)
SetVector4Parameter(String, Vector4)	Définit un paramètre de valeur Vector4 à utiliser avec un ExpressionAnimation ou un image clé d’expression. (Hérité de CompositionAnimation)
StartAnimation(String, CompositionAnimation, AnimationController)	Connecte une animation avec la propriété spécifiée de l’objet et démarre l’animation. (Hérité de CompositionObject)
StartAnimation(String, CompositionAnimation)	Connecte une animation avec la propriété spécifiée de l’objet et démarre l’animation. (Hérité de CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	Démarre un groupe d’animations. La méthode StartAnimationGroup sur CompositionObject vous permet de démarrer CompositionAnimationGroup. Toutes les animations du groupe sont démarrées en même temps sur l’objet. (Hérité de CompositionObject)
StopAnimation(String)	Déconnecte une animation de la propriété spécifiée et arrête l’animation. (Hérité de CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	Arrête un groupe d’animations. (Hérité de CompositionObject)
TryGetAnimationController(String)	Retourne un AnimationController pour l’animation en cours d’exécution sur la propriété spécifiée. (Hérité de CompositionObject)

Voir aussi

• KeyFrameAnimation
• Vue d’ensemble des animations de composition
• IClosable