QuaternionKeyFrameAnimation Classe

Référence

Définition

Espace de noms:: Windows.UI.Composition

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

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 de KeyFrameAnimationqui est utilisé pour animer la propriété Orientation sur un visuel. Les quaternions sont un moyen utile et parfois plus simple de penser aux rotations : les quaternions prennent le chemin le plus court entre les angles et évitent les problèmes tels que le verrou de cardan que les matrices d’angle/axe de rotation et de rotation se rencontrent. Un Quaternion est constitué de deux composants : une partie scalaire et une partie vectorielle.

public ref class QuaternionKeyFrameAnimation sealed : KeyFrameAnimation

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

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 131072)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
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

Configuration requise pour Windows

Famille d’appareils	Windows 10 (introduit dans 10.0.10586.0)
API contract	Windows.Foundation.UniversalApiContract (introduit dans v2.0)

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 pouvant être distinguées : un vecteur et un composant scalaire. Lors de l’utilisation avec des animations d’images clés, 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.

Lorsque vous convertissez 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, Matrice de rotation ou 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 à l’objet CompositionObject. (Hérité de CompositionObject)
Compositor	Compositeur utilisé pour créer cet Objet CompositionObject. (Hérité de CompositionObject)
DelayBehavior	Comportement de délai de l’animation de l’image clé. (Hérité de KeyFrameAnimation)
DelayTime	Délai avant le démarrage de l’animation après l’appel de CompositionObject.StartAnimation . (Hérité de KeyFrameAnimation)
Direction	Direction de la lecture de l’animation. La propriété Direction vous permet de piloter votre animation de début en bout ou de bout en début ou d’alterner entre début et fin ou de bout en début si l’animation a une valeur ItérationCount supérieure à un. Cela permet de personnaliser facilement les définitions d’animation. (Hérité de KeyFrameAnimation)
Dispatcher	Répartiteur de l’objet CompositionObject. (Hérité de CompositionObject)
DispatcherQueue	Obtient dispatcherQueue pour compostionObject. (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 l’image clé. (Hérité de KeyFrameAnimation)
KeyFrameCount	Nombre d’images clés dans KeyFrameAnimation. (Hérité de KeyFrameAnimation)
Properties	Collection de propriétés associées à CompositionObject. (Hérité de CompositionObject)
StopBehavior	Spécifie comment définir la valeur de la propriété lorsque StopAnimation est appelé. (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 l’objet CompositionObject et libère les ressources système. (Hérité de CompositionObject)
ConnectAnimation(String, CompositionAnimation)	Se connecte et animation. (Hérité de CompositionObject)
DisconnectAnimation(String)	Déconnecte une animation. (Hérité de CompositionObject)
Dispose()	Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées. (Hérité de CompositionObject)
InsertExpressionKeyFrame(Single, String)	Insère un frame clé d’expression. (Hérité de KeyFrameAnimation)
InsertExpressionKeyFrame(Single, String, CompositionEasingFunction)	Insère une image clé d’expression. (Hérité de KeyFrameAnimation)
InsertKeyFrame(Single, Quaternion)	Insère un cadre clé.
InsertKeyFrame(Single, Quaternion, CompositionEasingFunction)	Insère un frame clé avec la fonction d’accélération spécifiée.
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 une expressionAnimation ou une image clé d’expression. (Hérité de CompositionAnimation)
SetColorParameter(String, Color)	Définit un paramètre de valeur de couleur à utiliser avec une 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 une expressionAnimation. (Hérité de CompositionAnimation)
SetMatrix3x2Parameter(String, Matrix3x2)	Définit un paramètre de valeur Matrix3x2 à utiliser avec une expressionAnimation ou une image clé d’expression. (Hérité de CompositionAnimation)
SetMatrix4x4Parameter(String, Matrix4x4)	Définit un paramètre de valeur Matrix4x4 à utiliser avec une expressionAnimation ou une image clé d’expression. (Hérité de CompositionAnimation)
SetQuaternionParameter(String, Quaternion)	Définit une valeur Quaternion à utiliser avec une 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 une expressionAnimation ou une image clé d’expression. (Hérité de CompositionAnimation)
SetScalarParameter(String, Single)	Définit un paramètre de valeur scalaire à utiliser avec une expressionAnimation ou une image clé d’expression. (Hérité de CompositionAnimation)
SetVector2Parameter(String, Vector2)	Définit un paramètre de valeur Vector2 à utiliser avec une expressionAnimation ou une image clé d’expression. (Hérité de CompositionAnimation)
SetVector3Parameter(String, Vector3)	Définit un paramètre de valeur Vector3 à utiliser avec une expressionAnimation ou une image clé d’expression. (Hérité de CompositionAnimation)
SetVector4Parameter(String, Vector4)	Définit un paramètre de valeur Vector4 à utiliser avec une expressionAnimation ou une image clé d’expression. (Hérité de CompositionAnimation)
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)
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)
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)

S’applique à