Información general sobre animaciones personalizadas

En este tema se describe cómo y cuándo extender el sistema de animación de WPF creando fotogramas clave personalizados o clases de animación, o utilizando la devolución de llamada por fotograma para omitirlo.

Requisitos previos

Para entender este tema, debe estar familiarizado con los distintos tipos de animación proporcionados por WPF. Para obtener más información, consulte Información general sobre animaciones From/To/By, Información general sobre animaciones de fotogramas clave y Información general sobre animaciones en trazados.

Dado que las clases de animación heredan de la clase Freezable, debe estar familiarizado con los objetos Freezable y con cómo heredan de Freezable. Para obtener más información, vea Información general sobre objetos Freezable.

Extender el sistema de animación

Hay varias maneras de extender el sistema de animación de WPF, dependiendo del nivel de funcionalidad integrada que se desee utilizar. Existen tres puntos principales de extensibilidad en el motor de animación de WPF:

• Crear un objeto de fotograma clave personalizado heredando de una de las clases *<Tipo>*KeyFrame, como DoubleKeyFrame. En este enfoque se utiliza la mayoría de la funcionalidad integrada del motor de animación de WPF.

• Crear su propia clase de animación heredando de AnimationTimeline o de una de las clases *<Tipo>*AnimationBase.

• Utilizar la devolución de llamada por fotograma para generar animaciones fotograma a fotograma. En este enfoque se omite completamente el sistema de animación y control de tiempo.

En la tabla siguiente se describen algunos de los escenarios para extender el sistema de animación.

Crear un fotograma clave personalizado

Crear una clase de fotograma clave personalizado es la manera más simple de extender el sistema de animación. Utilice este enfoque cuando desee utilizar un método de interpolación diferente para una animación de fotograma clave. Como se describe en Información general sobre animaciones de fotogramas clave, una animación de fotograma clave objetos de fotograma clave para generar sus valores de salida. Cada objeto de fotograma clave realiza tres funciones:

• Especifica un valor de destino mediante su propiedad Value.

• Especifica la hora a la que se alcanzará ese valor mediante la propiedad KeyTime.

• Interpola entre el valor del fotograma clave anterior y su propio valor implementando el método InterpolateValueCore.

Instrucciones de implementación

Derive de la clase abstracta *<Tipo>*KeyFrame e implemente el método InterpolateValueCore. El método InterpolateValueCore devuelve el valor actual del fotograma clave. Acepta dos parámetros: el valor del fotograma clave anterior y un valor de progreso que oscila de 0 a 1. Un progreso de 0 indica que el fotograma clave se acaba de iniciar, y un valor de 1 indica que el fotograma clave se acaba de completar y debe devolver el valor especificado por su propiedad Value.

Dado que las clases *<Tipo>*KeyFrame heredan de la clase Freezable, también debe invalidar el núcleo del método CreateInstanceCore para devolver una nueva instancia de la clase. Si la clase no utiliza propiedades de dependencia para almacenar sus datos o requiere que se inicialice otra vez después de haberse creado, es posible que tenga que invalidar otros métodos; consulte Información general sobre objetos Freezable para obtener más información.

Después de haber creado la animación personalizada de *<Tipo>*KeyFrame, puede utilizarla con la clase *<Tipo>*AnimationUsingKeyFrames correspondiente a ese tipo.

Crear una clase de animación personalizada

Crear su propio tipo de animación le ofrece más control sobre cómo se anima un objeto. Hay dos maneras recomendadas de crear su propio tipo de animación: puede derivar de la clase AnimationTimeline o de la clase *<Tipo>*AnimationBase. No se recomienda derivar de las clases *<Tipo>*Animation o *<Tipo>*AnimationUsingKeyFrames.

Derivar de <Tipo>AnimationBase

Derivar de una clase *<Tipo>*AnimationBase es la manera más sencilla de crear un nuevo tipo de animación. Utilice este enfoque cuando desee crear una nueva animación para un tipo que ya tiene una clase *<Tipo>*AnimationBase correspondiente.

Instrucciones de implementación

Derive de una clase *<Tipo>*Animation e implemente el método GetCurrentValueCore. El método GetCurrentValueCore devuelve el valor actual de la animación. Acepta tres parámetros: un valor inicial sugerido, un valor final sugerido y un AnimationClock, que se utiliza para determinar el progreso de la animación.

Dado que las clases *<Tipo>*AnimationBase heredan de la clase Freezable, también debe invalidar el núcleo del método CreateInstanceCore para devolver una nueva instancia de la clase. Si la clase no utiliza propiedades de dependencia para almacenar sus datos o requiere que se inicialice otra vez después de haberse creado, es posible que tenga que invalidar otros métodos; consulte Información general sobre objetos Freezable para obtener más información.

Para obtener más información, consulte la documentación del método GetCurrentValueCore correspondiente a la clase *<Tipo>*AnimationBase del tipo que desea animar. Para obtener un ejemplo, vea Custom Animation Sample

Enfoques alternativos

Si simplemente desea cambiar cómo se interpolan los valores de animación, puede ser conveniente derivar de una de las clases *<Tipo>*KeyFrame. El fotograma clave que se crea se puede utilizar con las clases *<Tipo>*AnimationUsingKeyFrames correspondientes proporcionadas por WPF.

Derivar de AnimationTimeline

Derive de la clase AnimationTimeline cuando desee crear una animación para un tipo que aún no tiene una animación de WPF correspondiente, o cuando desee crear una animación que no tenga establecimiento inflexible de tipos.

Instrucciones de implementación

Derive de la clase AnimationTimeline e invalide los miembros siguientes:

• CreateInstanceCore: si la nueva clase es concreta, debe invalidar CreateInstanceCore para devolver una nueva instancia de la clase.

• GetCurrentValue: invalide este método para devolver el valor actual de la animación. Acepta tres parámetros: un valor de origen predeterminado, un valor de destino predeterminado y un objeto AnimationClock. Utilice AnimationClock para obtener la hora actual o el progreso de la animación. Puede decidir si usar los valores de origen y destino predeterminados.

• IsDestinationDefault: invalide esta propiedad para indicar si la animación usa el valor de destino predeterminado especificado por el método GetCurrentValue.

• TargetPropertyType: invalide esta propiedad para indicar el objeto Type de salida que genera la animación.

Si la clase no utiliza propiedades de dependencia para almacenar sus datos o requiere que se inicialice otra vez después de haberse creado, es posible que tenga que invalidar otros métodos; consulte Información general sobre objetos Freezable para obtener más información.

El paradigma recomendado (utilizado por las animaciones de WPF) es utilizar dos niveles de herencia:

1. Cree una clase *<Tipo>*AnimationBase abstracta que se derive de AnimationTimeline. Esta clase debe invalidar el método TargetPropertyType. También debe introducir un nuevo método abstracto, GetCurrentValueCore, e invalidar GetCurrentValue para validar el valor de origen y los parámetros de los valores de destino predeterminados; por último, llama a GetCurrentValueCore.

2. Cree otra clase que herede de la nueva clase *<Tipo>*AnimationBase e invalide el método CreateInstanceCore, el método GetCurrentValueCore que ha introducido y la propiedad IsDestinationDefault.

Enfoques alternativos

Si desea animar un tipo que no tiene ninguna animación From/To/By ni animación de fotograma clave correspondiente, puede ser interesante utilizar ObjectAnimationUsingKeyFrames. Al no tener establecimiento inflexible de tipos, ObjectAnimationUsingKeyFrames puede animar cualquier tipo de valor. La desventaja a este enfoque es que ObjectAnimationUsingKeyFrames admite únicamente la interpolación discreta.

Utilizar la devolución de llamada por fotograma

Utilice este enfoque cuando necesite omitir completamente el sistema de animación de WPF. Un escenario para este enfoque son las animaciones físicas, en las cuales es preciso volver a calcular una nueva dirección o posición de los objetos animados en cada paso de la animación de acuerdo con el último conjunto de interacciones de objeto.

Instrucciones de implementación

Al contrario que los demás enfoques descritos en esta información general, para utilizar la devolución de llamada por fotograma no se necesita crear una clase personalizada de animación o de fotograma clave.

En su lugar, se efectúa el registro para el evento Rendering del objeto que contiene los objetos que se desea animar. Se llama a este método de control de eventos una vez por cada fotograma. Cada vez que WPF calcula las referencias de los datos de representación conservados en el árbol visual hasta el árbol de composición, se llama a este método de control de eventos.

En el controlador de eventos, realice los cálculos necesarios para el efecto de animación y establezca las propiedades de los objetos que desea animar con estos valores.

Para obtener el tiempo de presentación del fotograma actual, puede convertir el EventArgs asociado a este evento como RenderingEventArgs, que proporciona una propiedad RenderingTime que puede utilizar para obtener el tiempo de representación del fotograma actual.

Para obtener más información, vea la página Rendering.

Vea también

Referencia

AnimationTimeline

IKeyFrame

Conceptos

Información general sobre técnicas de animación de propiedades

Información general sobre objetos Freezable

Información general sobre animaciones From/To/By

Información general sobre animaciones de fotogramas clave

Información general sobre animaciones en trazados

Información general sobre animaciones

Información general sobre sistemas de temporización y animación

Otros recursos

Ejemplo Custom Animation