QuaternionKeyFrameAnimation Classe

Riferimento

Definizione

Spazio dei nomi:: Windows.UI.Composition

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Modifica

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

La classe QuaternionKeyFrameAnimation è uno dei tipi supportati di KeyFrameAnimations utilizzati per animare la proprietà Orientation in un oggetto Visual. I quaternioni sono un modo utile e talvolta più semplice per considerare le rotazioni: i quaternioni accettano il percorso più breve tra angoli ed evitare problemi come Gimbal Lock che le matrici di rotazione e angolo di rotazione vengono eseguite. Un quaternione è costituito da due componenti: una parte scalare e vettoriale.

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

Ereditarietà: Object Platform::Object IInspectable CompositionObject CompositionAnimation KeyFrameAnimation QuaternionKeyFrameAnimation

Attributi: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Requisiti Windows

Famiglia di dispositivi	Windows 10 (è stato introdotto in 10.0.10586.0)
API contract	Windows.Foundation.UniversalApiContract (è stato introdotto in v2.0)

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 quaternione è costituito da due parti distinguibili: un vettore e un componente scalare. Quando si usa con le animazioni con fotogrammi chiave, 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 converte una rotazione in quaternione, è possibile utilizzare le funzioni helper System.Numerics Quaternion che consentono di creare quaternioni da una combinazione Asse/Angolo, Matrice di rotazione o Yaw/Pitch/Roll. Nell'esempio precedente, lo stesso Quaternion può essere costruito dall'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	Compositor utilizzato per creare questo 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 a CompositionObject.StartAnimation . (Ereditato da KeyFrameAnimation)
Direction	Direzione in cui viene riprodotta l'animazione. La proprietà Direction consente di guidare l'animazione dall'inizio alla fine o dalla fine all'inizio o dall'inizio o dall'inizio o dalla fine per iniziare se l'animazione ha un Valore IterationCount maggiore di uno. In questo modo è possibile personalizzare facilmente le definizioni di animazione. (Ereditato da KeyFrameAnimation)
Dispatcher	Dispatcher per CompositionObject. (Ereditato da CompositionObject)
DispatcherQueue	Ottiene dispatcherQueue per CompostionObject. (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 in 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 CompositionObject e rilascia le risorse di sistema. (Ereditato da CompositionObject)
ConnectAnimation(String, CompositionAnimation)	Connette e animazione. (Ereditato da CompositionObject)
DisconnectAnimation(String)	Disconnette un'animazione. (Ereditato da CompositionObject)
Dispose()	Esegue attività definite dall'applicazione, come rilasciare o reimpostare risorse non gestite. (Ereditato da CompositionObject)
InsertExpressionKeyFrame(Single, String)	Inserisce un fotogramma chiave dell'espressione. (Ereditato da KeyFrameAnimation)
InsertExpressionKeyFrame(Single, String, CompositionEasingFunction)	Inserisce un fotogramma chiave dell'espressione. (Ereditato da KeyFrameAnimation)
InsertKeyFrame(Single, Quaternion)	Inserisce un fotogramma chiave.
InsertKeyFrame(Single, Quaternion, CompositionEasingFunction)	Inserisce un fotogramma 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 utilizzare con un oggetto ExpressionAnimation o un fotogramma chiave dell'espressione. (Ereditato da CompositionAnimation)
SetColorParameter(String, Color)	Imposta un parametro di valore Color da utilizzare con un oggetto ExpressionAnimation o un fotogramma chiave dell'espressione. (Ereditato da CompositionAnimation)
SetExpressionReferenceParameter(String, IAnimationObject)	Imposta un oggetto che implementa IAnimationObject come parametro di riferimento in un oggetto ExpressionAnimation. (Ereditato da CompositionAnimation)
SetMatrix3x2Parameter(String, Matrix3x2)	Imposta un parametro di valore Matrix3x2 da usare con expressionAnimation o un fotogramma chiave dell'espressione. (Ereditato da CompositionAnimation)
SetMatrix4x4Parameter(String, Matrix4x4)	Imposta un parametro di valore Matrix4x4 da utilizzare con un oggetto ExpressionAnimation o un fotogramma chiave dell'espressione. (Ereditato da CompositionAnimation)
SetQuaternionParameter(String, Quaternion)	Imposta un valore Quaternion da utilizzare con expressionAnimation o un fotogramma chiave dell'espressione. (Ereditato da CompositionAnimation)
SetReferenceParameter(String, CompositionObject)	Imposta un riferimento a un oggetto Composition da utilizzare con un oggetto ExpressionAnimation o un fotogramma chiave dell'espressione. (Ereditato da CompositionAnimation)
SetScalarParameter(String, Single)	Imposta un parametro di valore scalare da utilizzare con un'espressioneAnimation o un fotogramma chiave dell'espressione. (Ereditato da CompositionAnimation)
SetVector2Parameter(String, Vector2)	Imposta un parametro di valore Vector2 da utilizzare con un oggetto ExpressionAnimation o un fotogramma chiave di espressione. (Ereditato da CompositionAnimation)
SetVector3Parameter(String, Vector3)	Imposta un parametro di valore Vector3 da utilizzare con un oggetto ExpressionAnimation o un fotogramma chiave dell'espressione. (Ereditato da CompositionAnimation)
SetVector4Parameter(String, Vector4)	Imposta un parametro di valore Vector4 da utilizzare con un oggetto ExpressionAnimation o un fotogramma chiave dell'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 nel 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 sulla proprietà specificata. (Ereditato da CompositionObject)

Si applica a

Condividi tramite