Animator QML Type (Uncreatable)
Es la base de todos los animadores de QML. Más...
| Import Statement: | import QtQuick |
| Inherits: | |
| Inherited By: | OpacityAnimator, RotationAnimator, ScaleAnimator, UniformAnimator, XAnimator, and YAnimator |
Nota: Se trata de un tipo que no se puede crear. No se puede instanciar en QML.
Propiedades
- duration : int
- easing
- easing.amplitude : real
- easing.bezierCurve : list<real>
- easing.overshoot : real
- easing.period : real
- easing.type : enumeration
- from : real
- target : QtQuick::Item
- to : real
Descripción detallada
Los tipos de animador son un tipo especial de animación que opera directamente sobre el gráfico de escena de Qt Quick, en lugar de sobre los objetos QML y sus propiedades, como hacen los tipos de animación habituales. Esto tiene la ventaja de que las animaciones basadas en animadores pueden ejecutarse en el hilo de renderizado del gráfico de escena incluso cuando el hilo de la interfaz de usuario está bloqueado.
El valor de la propiedad QML se actualizará una vez finalizada la animación. La propiedad no se actualiza mientras la animación está en ejecución.
Los tipos «Animator» se pueden utilizar igual que cualquier otro tipo de animación.
Rectangle {
id: mixBox
width: 50
height: 50
ParallelAnimation {
ColorAnimation {
target: mixBox
property: "color"
from: "forestgreen"
to: "lightsteelblue";
duration: 1000
}
ScaleAnimator {
target: mixBox
from: 2
to: 1
duration: 1000
}
running: true
}
}Si todas las subanimaciones de ParallelAnimation y SequentialAnimation son de tipo «Animator», ParallelAnimation y SequentialAnimation también se tratarán como un «Animator» y se ejecutarán en el hilo de renderizado del grafo de escena siempre que sea posible.
Los tipos «Animator» pueden utilizarse para animaciones durante las transiciones, pero no admiten la propiedad « reversible ».
El tipo `Animator` no se puede utilizar directamente en un archivo QML. Su finalidad es proporcionar un conjunto de propiedades y métodos comunes, disponibles en todos los demás tipos de animador que heredan de él. Si se intenta utilizar el tipo `Animator` directamente, se producirá un error.
Nota: Los tiposAnimator no aportan ninguna ventaja cuando se utiliza un bucle de renderizado sin subprocesos.
Nota: Se recomienda que las aplicaciones consideren diseños basados en principios multihilo y asíncronos, en lugar de depender de los Animators para mostrar contenido animado mientras se realizan tareas costosas y bloqueantes en el hilo principal (GUI). En lugar de operaciones largas y bloqueantes, es preferible utilizar WorkerScript y asynchronous image loading en QML, así como hilos de trabajo, algoritmos paralelos Qt Concurrenty corutinas en C++, manteniendo así la capacidad de respuesta de toda la aplicación y la interfaz de usuario en todo momento.
Documentación de propiedades
duration : int
Esta propiedad contiene la duración de la animación en milisegundos.
El valor por defecto es 250.
easing group
easing.amplitude : real
easing.bezierCurve : list<real>
easing.overshoot : real
easing.period : real
easing.type : enumeration
Especifica la curva de aceleración utilizada para la animación
Para especificar una curva de aceleración, es necesario indicar al menos el tipo. En el caso de algunas curvas, también se puede especificar la amplitud, el período y/o el sobreimpulso (se ofrecen más detalles tras la tabla). La curva de aceleración predeterminada es Easing.Linear.
PropertyAnimation { properties: "y";
easing.type: Easing.InOutElastic;
easing.amplitude: 2.0;
easing.period: 1.5 }Los tipos disponibles son:
Easing.Linear | Curva de aceleración para una función lineal (t): la velocidad es constante. | ![]() |
Easing.InQuad | Curva de aceleración para una función cuadrática (t²): acelera partiendo de una velocidad cero. | ![]() |
Easing.OutQuad | Curva de aceleración/deceleración para una función cuadrática (t²): desaceleración hasta una velocidad nula. | ![]() |
Easing.InOutQuad | Curva de aceleración/deceleración para una función cuadrática (t²): aceleración hasta la mitad del recorrido, seguida de deceleración. | ![]() |
Easing.OutInQuad | Curva de aceleración/deceleración para una función cuadrática (t²): desaceleración hasta la mitad del recorrido, seguida de aceleración. | ![]() |
Easing.InCubic | Curva de aceleración/deceleración para una función cúbica (t³): aceleración partiendo de una velocidad nula. | ![]() |
Easing.OutCubic | Curva de suavizado para una función cúbica (t³): desaceleración hasta velocidad cero. | ![]() |
Easing.InOutCubic | Curva de suavizado para una función cúbica (t³): aceleración hasta la mitad del recorrido, seguida de una desaceleración. | ![]() |
Easing.OutInCubic | Curva de suavizado para una función cúbica (t^3): desaceleración hasta la mitad del recorrido, y luego aceleración. | ![]() |
Easing.InQuart | Curva de suavizado para una función de cuarto grado (t^4): aceleración partiendo de una velocidad nula. | ![]() |
Easing.OutQuart | Curva de suavizado para una función de cuarto grado (t^4): desaceleración hasta velocidad cero. | ![]() |
Easing.InOutQuart | Curva de suavizado para una función de cuarto grado (t^4): aceleración hasta la mitad del recorrido, seguida de desaceleración. | ![]() |
Easing.OutInQuart | Curva de suavizado para una función de cuarto grado (t^4): desaceleración hasta la mitad del recorrido, y luego aceleración. | ![]() |
Easing.InQuint | Curva de suavizado para una función quíntica (t^5): aceleración partiendo de una velocidad nula. | ![]() |
Easing.OutQuint | Curva de suavizado para una función quíntica (t^5): desaceleración hasta velocidad cero. | ![]() |
Easing.InOutQuint | Curva de suavizado para una función quíntica (t^5): aceleración hasta la mitad del recorrido, seguida de desaceleración. | ![]() |
Easing.OutInQuint | Curva de suavizado para una función quíntica (t^5): desaceleración hasta la mitad del recorrido, seguida de aceleración. | ![]() |
Easing.InSine | Curva de suavizado para una función sinusoidal (sin(t)): aceleración partiendo de una velocidad nula. | ![]() |
Easing.OutSine | Curva de suavizado para una función sinusoidal (sin(t)): desaceleración hasta velocidad cero. | ![]() |
Easing.InOutSine | Curva de suavizado para una función sinusoidal (sin(t)): aceleración hasta la mitad del recorrido, seguida de desaceleración. | ![]() |
Easing.OutInSine | Curva de suavizado para una función sinusoidal (sin(t)): desaceleración hasta la mitad del recorrido, seguida de aceleración. | ![]() |
Easing.InExpo | Curva de suavizado para una función exponencial (2^t): aceleración partiendo de una velocidad nula. | ![]() |
Easing.OutExpo | Curva de aceleración/desaceleración para una función exponencial (2^t): desaceleración hasta velocidad cero. | ![]() |
Easing.InOutExpo | Curva de aceleración/deceleración para una función exponencial (2^t): aceleración hasta la mitad del recorrido, seguida de deceleración. | ![]() |
Easing.OutInExpo | Curva de aceleración/deceleración para una función exponencial (2^t): desaceleración hasta la mitad del recorrido, seguida de aceleración. | ![]() |
Easing.InCirc | Curva de aceleración/deceleración para una función circular (sqrt(1-t^2)): aceleración partiendo de una velocidad nula. | ![]() |
Easing.OutCirc | Curva de suavizado para una función circular (sqrt(1-t^2)): desaceleración hasta la velocidad cero. | ![]() |
Easing.InOutCirc | Curva de aceleración/deceleración para una función circular (sqrt(1-t^2)): aceleración hasta la mitad del recorrido, seguida de deceleración. | ![]() |
Easing.OutInCirc | Curva de suavizado para una función circular (sqrt(1-t^2)): desaceleración hasta la mitad del recorrido, y luego aceleración. | ![]() |
Easing.InElastic | Curva de suavizado para una función elástica (onda sinusoidal con decaimiento exponencial): aceleración partiendo de una velocidad nula. La amplitud máxima se puede ajustar con el parámetro «amplitude», y el período de decaimiento con el parámetro «period ». | ![]() |
Easing.OutElastic | Curva de aceleración/deceleración para una función elástica (onda sinusoidal con decaimiento exponencial): desaceleración hasta velocidad cero. La amplitud máxima se puede ajustar con el parámetro «amplitude», y el período de decaimiento con el parámetro «period ». | ![]() |
Easing.InOutElastic | Curva de atenuación para una función elástica (onda sinusoidal con decaimiento exponencial): aceleración hasta la mitad del recorrido, seguida de desaceleración. | ![]() |
Easing.OutInElastic | Curva de aceleración/deceleración para una función elástica (onda sinusoidal con decaimiento exponencial): desaceleración hasta la mitad del recorrido, seguida de aceleración. | ![]() |
Easing.InBack | Curva de aceleración/deceleración para una función «back» (función cúbica con sobreimpulso: (s+1)*t^3 - s*t^2) con aceleración inicial: acelerando desde velocidad cero. | ![]() |
Easing.OutBack | Curva de aceleración/deceleración para una función «back» (función cúbica con sobreimpulso: (s+1)*t^3 - s*t^2) en la entrada: desaceleración hasta velocidad cero. | ![]() |
Easing.InOutBack | Curva de atenuación para una función cúbica con sobreimpulso (s+1)*t^3 - s*t^2) con entrada y salida: aceleración hasta la mitad y, a continuación, desaceleración. | ![]() |
Easing.OutInBack | Curva de aceleración/desaceleración para un retroceso (aceleración/desaceleración cúbica con sobreimpulso: (s+1)*t^3 - s*t^2): desaceleración hasta la mitad y, a continuación, aceleración. | ![]() |
Easing.InBounce | Curva de aceleración/desaceleración para una función de rebote (rebote parabólico con decaimiento exponencial): aceleración partiendo de una velocidad nula. | ![]() |
Easing.OutBounce | Curva de aceleración/deceleración para una función de rebote (rebote parabólico con decaimiento exponencial): desaceleración hasta velocidad cero. | ![]() |
Easing.InOutBounce | Curva de suavizado para una función de rebote (rebote parabólico con decaimiento exponencial) de entrada/salida: aceleración hasta la mitad y, a continuación, desaceleración. | ![]() |
Easing.OutInBounce | Curva de aceleración/deceleración para una función de rebote (rebote parabólico con decaimiento exponencial) con aceleración/deceleración de entrada/salida: desaceleración hasta la mitad y, a continuación, aceleración. | ![]() |
Easing.BezierSpline | Curva de suavizado personalizada definida por la propiedad easing.bezierCurve. |
easing.amplitude Solo es aplicable a las curvas de rebote y elásticas (curvas de tipo Easing.InBounce, Easing.OutBounce, Easing.InOutBounce, Easing.OutInBounce, Easing.InElastic, Easing.OutElastic, Easing.InOutElastic o Easing.OutInElastic).
easing.overshoot Solo es aplicable si easing.type es: Easing.InBack, Easing.OutBack, Easing.InOutBack o Easing.OutInBack.
easing.period Solo es aplicable si easing.type es: Easing.InElastic, Easing.OutElastic, Easing.InOutElastic o Easing.OutInElastic.
easing.bezierCurve Solo es aplicable si easing.type es: Easing.BezierSpline. Esta propiedad es una lista<real> que contiene grupos de tres puntos que definen una curva desde 0,0 hasta 1,1 —punto de control 1, punto de control 2, punto final—: [cx1, cy1, cx2, cy2, endx, endy, ...]. El último punto debe ser 1,1.
Consulta las «Curvas de aceleración» para ver una demostración de los diferentes ajustes de aceleración.
from : real
Esta propiedad contiene el valor inicial de la animación.
Si el Animator se define dentro de un Transition o un Behavior, este valor toma por defecto el valor definido en el estado inicial del Transition, o el valor actual de la propiedad en el momento en que se activa el Behavior.
Véase también «Animación y transiciones» en Qt Quick.
target : QtQuick::Item
Esta propiedad contiene el elemento de destino del animador.
Nota: Los objetivosdel animador deben ser de tipo «Item».
to : real
Esta propiedad contiene el valor final de la animación.
Si el Animator se define dentro de un « Transition » o un « Behavior », este valor toma por defecto el valor definido en el estado final del « Transition », o el valor del cambio de propiedad que desencadenó el « Behavior ».
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.








































