Partager via


QuaternionKeyFrameAnimation Classe

Définition

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

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 à

Voir aussi