Condividi tramite


QuaternionKeyFrameAnimation Classe

Definizione

Animazione basata sul tempo che punta alla proprietà Orientation con uno o più fotogrammi chiave.

La classe QuaternionKeyFrameAnimation è uno dei tipi supportati di KeyFrameAnimations che viene usato per animare la proprietà Orientation in un oggetto Visivo. I quaternioni sono un modo utile e talvolta più semplice per pensare alle rotazioni: i quaternioni prendono il percorso più breve tra angoli ed evitare problemi come Blocchi gimbal che ruotano l'angolo/asse e le matrici di rotazione eseguite. Un Quaternion è costituito da due componenti: una parte scalare e vettore.

public ref class QuaternionKeyFrameAnimation sealed : KeyFrameAnimation
/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.LiftedContract, 65536)]
/// [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.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.ContractVersion(typeof(Microsoft.Foundation.LiftedContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class QuaternionKeyFrameAnimation : 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
Ereditarietà
Object Platform::Object IInspectable CompositionObject CompositionAnimation KeyFrameAnimation QuaternionKeyFrameAnimation
Attributi

Esempio

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);
}

Commenti

Un'animazione è associata alla proprietà di un oggetto chiamando CompositionObject.StartAnimation e specificando il nome della proprietà e l'animazione. Per un elenco di proprietà animabili, vedere la sezione osservazioni di CompositionObject.StartAnimation .

Un Quaternion è costituito da due parti distinguebili: un componente vettoriale e scalare. Quando si usa con animazioni keyframe, il Quaternion può essere definito dalla notazione di System.Numerics di 4 float o vector3 e scalare. System.Numerics fornisce costruttori per una di queste notazioni.

Quando si traduce una rotazione in un Quaternion, è possibile usare le funzioni helper System.Numerics Quaternion che consentono di creare quaternioni fuori da una combinazione Asse/Angolo, Matrice di rotazione o Yaw/Pitch/Roll. Nell'esempio precedente, lo stesso Quaternion potrebbe essere costruito dal helper seguente:

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

Proprietà

Comment

Stringa da associare a CompositionObject.

(Ereditato da CompositionObject)
Compositor

Compositore usato per creare questo oggetto CompositionObject.

(Ereditato da CompositionObject)
DelayBehavior

Comportamento di ritardo dell'animazione del fotogramma chiave.

(Ereditato da KeyFrameAnimation)
DelayTime

Ritardo prima dell'avvio dell'animazione dopo la chiamata di CompositionObject.StartAnimation .

(Ereditato da KeyFrameAnimation)
Direction

La direzione in cui viene riprodotta l'animazione.

La proprietà Direction consente di guidare l'animazione dall'inizio alla fine o alla fine o alternativa tra inizio e fine o fine per iniziare se l'animazione ha un IterationCount maggiore di uno. In questo modo è possibile personalizzare le definizioni di animazione.

(Ereditato da KeyFrameAnimation)
DispatcherQueue

Ottiene DispatcherQueue per CompositionObject.

(Ereditato da CompositionObject)
Duration

Durata dell'animazione.

(Ereditato da KeyFrameAnimation)
ImplicitAnimations

Raccolta di animazioni implicite associate a questo oggetto.

(Ereditato da CompositionObject)
InitialValueExpressions

Ottiene i valori iniziali per l'animazione.

(Ereditato da CompositionAnimation)
IterationBehavior

Comportamento di iterazione per l'animazione del fotogramma chiave.

(Ereditato da KeyFrameAnimation)
IterationCount

Numero di volte in cui ripetere l'animazione del fotogramma chiave.

(Ereditato da KeyFrameAnimation)
KeyFrameCount

Numero di fotogrammi chiave nella KeyFrameAnimation.

(Ereditato da KeyFrameAnimation)
Properties

Raccolta di proprietà associate a CompositionObject.

(Ereditato da CompositionObject)
StopBehavior

Specifica come impostare il valore della proprietà quando viene chiamato StopAnimation .

(Ereditato da KeyFrameAnimation)
Target

Destinazione dell'animazione.

(Ereditato da CompositionAnimation)

Metodi

ClearAllParameters()

Cancella tutti i parametri dell'animazione.

(Ereditato da CompositionAnimation)
ClearParameter(String)

Cancella un parametro dall'animazione.

(Ereditato da CompositionAnimation)
Close()

Chiude l'oggetto CompositionObject e rilascia le risorse di sistema.

(Ereditato da CompositionObject)
Dispose()

Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite.

(Ereditato da CompositionObject)
InsertExpressionKeyFrame(Single, String)

Inserisce un frame di chiave dell'espressione.

(Ereditato da KeyFrameAnimation)
InsertExpressionKeyFrame(Single, String, CompositionEasingFunction)

Inserisce un fotogramma chiave di espressione.

(Ereditato da KeyFrameAnimation)
InsertKeyFrame(Single, Quaternion)

Inserisce una cornice chiave.

InsertKeyFrame(Single, Quaternion, CompositionEasingFunction)

Inserisce una cornice chiave con la funzione di interpolazione specificata.

PopulatePropertyInfo(String, AnimationPropertyInfo)

Definisce una proprietà che può essere animata.

(Ereditato da CompositionObject)
SetBooleanParameter(String, Boolean)

Imposta un parametro valore booleano da usare con un'espressioneAnimation o un keyframe di espressione.

(Ereditato da CompositionAnimation)
SetColorParameter(String, Color)

Imposta un parametro color per l'uso con un'espressioneAnimation o un fotogramma chiave di espressione.

(Ereditato da CompositionAnimation)
SetExpressionReferenceParameter(String, IAnimationObject)

Imposta un oggetto che implementa IAnimationObject come parametro di riferimento in un'espressioneAnimation.

(Ereditato da CompositionAnimation)
SetMatrix3x2Parameter(String, Matrix3x2)

Imposta un parametro di valore Matrix3x2 da usare con un'espressioneAnimation o un fotogramma chiave di espressione.

(Ereditato da CompositionAnimation)
SetMatrix4x4Parameter(String, Matrix4x4)

Imposta un parametro di valore Matrix4x4 da usare con un'espressioneAnimation o un fotogramma chiave di espressione.

(Ereditato da CompositionAnimation)
SetQuaternionParameter(String, Quaternion)

Imposta un valore Quaternion da usare con un'espressioneAnimation o un fotogramma chiave di espressione.

(Ereditato da CompositionAnimation)
SetReferenceParameter(String, CompositionObject)

Imposta un riferimento a un oggetto Composition da usare con un oggetto ExpressionAnimation o un keyframe di espressione.

(Ereditato da CompositionAnimation)
SetScalarParameter(String, Single)

Imposta un parametro valore scalare da usare con un'espressioneAnimation o un fotogramma chiave di espressione.

(Ereditato da CompositionAnimation)
SetVector2Parameter(String, Vector2)

Imposta un parametro di valore Vector2 da usare con un'espressioneAnimation o un keyframe di espressione.

(Ereditato da CompositionAnimation)
SetVector3Parameter(String, Vector3)

Imposta un parametro di valore Vector3 da usare con un'espressioneAnimation o un fotogramma chiave di espressione.

(Ereditato da CompositionAnimation)
SetVector4Parameter(String, Vector4)

Imposta un parametro di valore Vector4 da usare con un'espressioneAnimation o un keyframe di espressione.

(Ereditato da CompositionAnimation)
StartAnimation(String, CompositionAnimation)

Connette un'animazione con la proprietà specificata dell'oggetto e avvia l'animazione.

(Ereditato da CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)

Connette un'animazione con la proprietà specificata dell'oggetto e avvia l'animazione.

(Ereditato da CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)

Avvia un gruppo di animazioni.

Il metodo StartAnimationGroup in CompositionObject consente di avviare CompositionAnimationGroup. Tutte le animazioni del gruppo verranno avviate contemporaneamente sull'oggetto.

(Ereditato da CompositionObject)
StopAnimation(String)

Disconnette un'animazione dalla proprietà specificata e arresta l'animazione.

(Ereditato da CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)

Arresta un gruppo di animazioni.

(Ereditato da CompositionObject)
TryGetAnimationController(String)

Restituisce un oggetto AnimationController per l'animazione in esecuzione nella proprietà specificata.

(Ereditato da CompositionObject)

Si applica a

Vedi anche