QuaternionKeyFrameAnimation Clase

Definición

Espacio de nombres:

Microsoft.UI.Composition

Animación basada en tiempo que tiene como destino la propiedad Orientation con uno o varios fotogramas clave.

La clase QuaternionKeyFrameAnimation es uno de los tipos admitidos de KeyFrameAnimationque se usa para animar la propiedad Orientation en un objeto Visual. Los cuaterniones son una manera útil y a veces más sencilla de pensar en las rotaciones: los cuaterniones toman el camino más corto entre ángulos y evitan problemas como el bloqueo gimbal en el que se encuentran las matrices de giro y eje y ángulo de rotación. Un cuaternión se compone de dos componentes: una parte escalar y vectorial.

public ref class QuaternionKeyFrameAnimation sealed : 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.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

Herencia

Object Platform::Object IInspectable CompositionObject CompositionAnimation KeyFrameAnimation QuaternionKeyFrameAnimation

Atributos

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Ejemplos

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

Comentarios

Una animación está asociada a la propiedad de un objeto llamando a CompositionObject.StartAnimation y especificando el nombre de propiedad y la animación. Consulte la sección de comentarios de CompositionObject.StartAnimation para obtener una lista de propiedades animables.

Un cuaternión se compone de dos partes distintivas: un vector y un componente escalar. Cuando se usa con animaciones de fotograma clave, el cuaternión se puede definir mediante la notación de System.Numerics de 4 floats o vector3 y un escalar. System.Numerics proporciona constructores para cualquiera de estas notaciones.

Al traducir una rotación a un cuaternión, puede usar funciones auxiliares System.Numerics Quaternion que le permiten crear cuaterniones a partir de un combo eje/ángulo, matriz de rotación o eje/giro/lanzamiento/roll. En el ejemplo anterior, el mismo Quaternion se podría construir a partir del asistente siguiente:

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

Propiedades

Comment	Cadena que se va a asociar con compositionObject. (Heredado de CompositionObject)
Compositor	Compositor que se usa para crear este CompositionObject. (Heredado de CompositionObject)
DelayBehavior	Comportamiento de retraso de la animación de fotograma clave. (Heredado de KeyFrameAnimation)
DelayTime	Retraso antes de que se inicie la animación después de llamar a CompositionObject.StartAnimation . (Heredado de KeyFrameAnimation)
Direction	Dirección en la que se está reproduciendo la animación. La propiedad Direction te permite controlar la animación de principio a fin o fin para iniciar o alternar entre el inicio y el final o el final para iniciar si la animación tiene un IterationCount mayor que uno. Esto proporciona una manera sencilla de personalizar las definiciones de animación. (Heredado de KeyFrameAnimation)
DispatcherQueue	Obtiene dispatcherQueue para compositionObject. (Heredado de CompositionObject)
Duration	Duración de la animación. (Heredado de KeyFrameAnimation)
ImplicitAnimations	Colección de animaciones implícitas adjuntas a este objeto. (Heredado de CompositionObject)
InitialValueExpressions	Obtiene los valores iniciales de la animación. (Heredado de CompositionAnimation)
IterationBehavior	Comportamiento de iteración para la animación del fotograma clave. (Heredado de KeyFrameAnimation)
IterationCount	Número de veces que se repite la animación del fotograma clave. (Heredado de KeyFrameAnimation)
KeyFrameCount	Número de fotogramas clave de KeyFrameAnimation. (Heredado de KeyFrameAnimation)
Properties	Colección de propiedades asociadas a CompositionObject. (Heredado de CompositionObject)
StopBehavior	Especifica cómo establecer el valor de propiedad cuando se llama a StopAnimation . (Heredado de KeyFrameAnimation)
Target	Destino de la animación. (Heredado de CompositionAnimation)

Métodos

ClearAllParameters()	Borra todos los parámetros de la animación. (Heredado de CompositionAnimation)
ClearParameter(String)	Borra un parámetro de la animación. (Heredado de CompositionAnimation)
Close()	Cierra compositionObject y libera los recursos del sistema. (Heredado de CompositionObject)
Dispose()	Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados. (Heredado de CompositionObject)
InsertExpressionKeyFrame(Single, String)	Inserta un fotograma clave de expresión. (Heredado de KeyFrameAnimation)
InsertExpressionKeyFrame(Single, String, CompositionEasingFunction)	Inserta un fotograma clave de expresión. (Heredado de KeyFrameAnimation)
InsertKeyFrame(Single, Quaternion)	Inserta un fotograma clave.
InsertKeyFrame(Single, Quaternion, CompositionEasingFunction)	Inserta un fotograma clave con la función de aceleración especificada.
PopulatePropertyInfo(String, AnimationPropertyInfo)	Define una propiedad que se puede animar. (Heredado de CompositionObject)
SetBooleanParameter(String, Boolean)	Establece un parámetro de valor booleano para su uso con expressionAnimation o un fotograma clave de expresión. (Heredado de CompositionAnimation)
SetColorParameter(String, Color)	Establece un parámetro de valor Color para su uso con expressionAnimation o un fotograma clave de expresión. (Heredado de CompositionAnimation)
SetExpressionReferenceParameter(String, IAnimationObject)	Establece un objeto que implementa IAnimationObject como parámetro de referencia en expressionAnimation. (Heredado de CompositionAnimation)
SetMatrix3x2Parameter(String, Matrix3x2)	Establece un parámetro de valor Matrix3x2 para su uso con expressionAnimation o un fotograma clave de expresión. (Heredado de CompositionAnimation)
SetMatrix4x4Parameter(String, Matrix4x4)	Establece un parámetro de valor Matrix4x4 para su uso con expressionAnimation o un fotograma clave de expresión. (Heredado de CompositionAnimation)
SetQuaternionParameter(String, Quaternion)	Establece un valor quaternion para su uso con expressionAnimation o un fotograma clave de expresión. (Heredado de CompositionAnimation)
SetReferenceParameter(String, CompositionObject)	Establece una referencia a un objeto Composition para su uso con expressionAnimation o un fotograma clave de expresión. (Heredado de CompositionAnimation)
SetScalarParameter(String, Single)	Establece un parámetro de valor escalar para su uso con expressionAnimation o un fotograma clave de expresión. (Heredado de CompositionAnimation)
SetVector2Parameter(String, Vector2)	Establece un parámetro de valor Vector2 para su uso con expressionAnimation o un fotograma clave de expresión. (Heredado de CompositionAnimation)
SetVector3Parameter(String, Vector3)	Establece un parámetro de valor Vector3 para su uso con expressionAnimation o un fotograma clave de expresión. (Heredado de CompositionAnimation)
SetVector4Parameter(String, Vector4)	Establece un parámetro de valor Vector4 para su uso con expressionAnimation o un fotograma clave de expresión. (Heredado de CompositionAnimation)
StartAnimation(String, CompositionAnimation)	Conecta una animación con la propiedad especificada del objeto e inicia la animación. (Heredado de CompositionObject)
StartAnimation(String, CompositionAnimation, AnimationController)	Conecta una animación con la propiedad especificada del objeto e inicia la animación. (Heredado de CompositionObject)
StartAnimationGroup(ICompositionAnimationBase)	Inicia un grupo de animación. El método StartAnimationGroup en CompositionObject permite iniciar CompositionAnimationGroup. Todas las animaciones del grupo se iniciarán al mismo tiempo en el objeto . (Heredado de CompositionObject)
StopAnimation(String)	Desconecta una animación de la propiedad especificada y detiene la animación. (Heredado de CompositionObject)
StopAnimationGroup(ICompositionAnimationBase)	Detiene un grupo de animaciones. (Heredado de CompositionObject)
TryGetAnimationController(String)	Devuelve un AnimationController para la animación que se ejecuta en la propiedad especificada. (Heredado de CompositionObject)

Consulte también

• KeyFrameAnimation
• Información general sobre animaciones de composición
• IClosable