QuaternionKeyFrameAnimation Classe
Definizione
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.
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 : KeyFrameAnimationPublic NotInheritable Class QuaternionKeyFrameAnimation
Inherits KeyFrameAnimation- Ereditarietà
-
Object Platform::Object IInspectable CompositionObject CompositionAnimation KeyFrameAnimation QuaternionKeyFrameAnimation
- Attributi
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) |