En esta página

Animator QML Type (Uncreatable)

Es la base de todos los animadores de QML. Más...

Import Statement: import QtQuick
Inherits:

Animation

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

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.LinearCurva de aceleración para una función lineal (t): la velocidad es constante.Curva de aceleración lineal
Easing.InQuadCurva de aceleración para una función cuadrática (t²): acelera partiendo de una velocidad cero.Curva de atenuación de InQuad
Easing.OutQuadCurva de aceleración/deceleración para una función cuadrática (t²): desaceleración hasta una velocidad nula.Curva de atenuación de OutQuad
Easing.InOutQuadCurva de aceleración/deceleración para una función cuadrática (t²): aceleración hasta la mitad del recorrido, seguida de deceleración.Curva de aceleración/deceleración InOutQuad
Easing.OutInQuadCurva de aceleración/deceleración para una función cuadrática (t²): desaceleración hasta la mitad del recorrido, seguida de aceleración.Curva de aceleración OutInQuad
Easing.InCubicCurva de aceleración/deceleración para una función cúbica (t³): aceleración partiendo de una velocidad nula.Curva de suavizado InCubic
Easing.OutCubicCurva de suavizado para una función cúbica (t³): desaceleración hasta velocidad cero.Curva de aceleración de OutCubic
Easing.InOutCubicCurva de suavizado para una función cúbica (t³): aceleración hasta la mitad del recorrido, seguida de una desaceleración.Curva de aceleración InOutCubic
Easing.OutInCubicCurva de suavizado para una función cúbica (t^3): desaceleración hasta la mitad del recorrido, y luego aceleración.Curva de aceleración OutInCubic
Easing.InQuartCurva de suavizado para una función de cuarto grado (t^4): aceleración partiendo de una velocidad nula.Curva de atenuación de InQuart
Easing.OutQuartCurva de suavizado para una función de cuarto grado (t^4): desaceleración hasta velocidad cero.Curva de atenuación OutQuart
Easing.InOutQuartCurva de suavizado para una función de cuarto grado (t^4): aceleración hasta la mitad del recorrido, seguida de desaceleración.Curva de atenuación InOutQuart
Easing.OutInQuartCurva de suavizado para una función de cuarto grado (t^4): desaceleración hasta la mitad del recorrido, y luego aceleración.Curva de atenuación OutInQuart
Easing.InQuintCurva de suavizado para una función quíntica (t^5): aceleración partiendo de una velocidad nula.Curva de atenuación de InQuint
Easing.OutQuintCurva de suavizado para una función quíntica (t^5): desaceleración hasta velocidad cero.Curva de atenuación de OutQuint
Easing.InOutQuintCurva de suavizado para una función quíntica (t^5): aceleración hasta la mitad del recorrido, seguida de desaceleración.Curva de aceleración InOutQuint
Easing.OutInQuintCurva de suavizado para una función quíntica (t^5): desaceleración hasta la mitad del recorrido, seguida de aceleración.Curva de aceleración OutInQuint
Easing.InSineCurva de suavizado para una función sinusoidal (sin(t)): aceleración partiendo de una velocidad nula.Curva de atenuación InSine
Easing.OutSineCurva de suavizado para una función sinusoidal (sin(t)): desaceleración hasta velocidad cero.Curva de atenuación de OutSine
Easing.InOutSineCurva de suavizado para una función sinusoidal (sin(t)): aceleración hasta la mitad del recorrido, seguida de desaceleración.Curva de suavizado InOutSine
Easing.OutInSineCurva de suavizado para una función sinusoidal (sin(t)): desaceleración hasta la mitad del recorrido, seguida de aceleración.Curva de aceleración OutInSine
Easing.InExpoCurva de suavizado para una función exponencial (2^t): aceleración partiendo de una velocidad nula.Curva de relajación de InExpo
Easing.OutExpoCurva de aceleración/desaceleración para una función exponencial (2^t): desaceleración hasta velocidad cero.Curva de relajación de OutExpo
Easing.InOutExpoCurva de aceleración/deceleración para una función exponencial (2^t): aceleración hasta la mitad del recorrido, seguida de deceleración.Curva de relajación de InOutExpo
Easing.OutInExpoCurva de aceleración/deceleración para una función exponencial (2^t): desaceleración hasta la mitad del recorrido, seguida de aceleración.Curva de adaptación de OutInExpo
Easing.InCircCurva de aceleración/deceleración para una función circular (sqrt(1-t^2)): aceleración partiendo de una velocidad nula.Curva de atenuación de InCirc
Easing.OutCircCurva de suavizado para una función circular (sqrt(1-t^2)): desaceleración hasta la velocidad cero.Curva de atenuación de OutCirc
Easing.InOutCircCurva 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.Curva de aceleración InOutCirc
Easing.OutInCircCurva de suavizado para una función circular (sqrt(1-t^2)): desaceleración hasta la mitad del recorrido, y luego aceleración.Curva de aceleración OutInCirc
Easing.InElasticCurva 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 ».
Curva de aceleración inelástica
Easing.OutElasticCurva 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 ».
Curva de aceleración OutElastic
Easing.InOutElasticCurva 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.Curva de aceleración elástica InOut
Easing.OutInElasticCurva 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.Curva de aceleración OutInElastic
Easing.InBackCurva 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.Curva de atenuación de InBack
Easing.OutBackCurva 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.Curva de desaceleración de OutBack
Easing.InOutBackCurva 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.Curva de aceleración de InOutBack
Easing.OutInBackCurva 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.Curva de aceleración OutInBack
Easing.InBounceCurva de aceleración/desaceleración para una función de rebote (rebote parabólico con decaimiento exponencial): aceleración partiendo de una velocidad nula.Curva de atenuación de InBounce
Easing.OutBounceCurva de aceleración/deceleración para una función de rebote (rebote parabólico con decaimiento exponencial): desaceleración hasta velocidad cero.Curva de atenuación de OutBounce
Easing.InOutBounceCurva 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.Curva de aceleración InOutBounce
Easing.OutInBounceCurva 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.Curva de aceleración OutInBounce
Easing.BezierSplineCurva 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.