SmoothedAnimation QML Type
Permite que una propiedad siga de forma fluida la evolución de un valor. Más...
| Import Statement: | import QtQuick |
| Inherits: |
Propiedades
- duration : int
- maximumEasingTime : int
- reversingMode : enumeration
- velocity : real
Descripción detallada
Una SmoothedAnimation anima el valor de una propiedad hasta un valor objetivo establecido utilizando una curva de animación «ease in/out quad». Cuando cambia el valor objetivo, las curvas de animación utilizadas para animar entre el valor objetivo anterior y el nuevo se unen de forma fluida para crear un movimiento suave hacia el nuevo valor objetivo que mantiene la velocidad actual.
El siguiente ejemplo muestra un « Rectangle » que sigue la posición de otro utilizando «SmoothedAnimation». Los valores de « x » y « y » del rectángulo verde están vinculados a los del rectángulo rojo. Cada vez que estos valores cambian, el rectángulo verde se anima suavemente hasta su nueva posición:
import QtQuick
Rectangle {
width: 800; height: 600
color: "blue"
Rectangle {
width: 60; height: 60
x: rect1.x - 5; y: rect1.y - 5
color: "green"
Behavior on x { SmoothedAnimation { velocity: 200 } }
Behavior on y { SmoothedAnimation { velocity: 200 } }
}
Rectangle {
id: rect1
width: 50; height: 50
color: "red"
}
focus: true
Keys.onRightPressed: rect1.x = rect1.x + 100
Keys.onLeftPressed: rect1.x = rect1.x - 100
Keys.onUpPressed: rect1.y = rect1.y - 100
Keys.onDownPressed: rect1.y = rect1.y + 100
}Una SmoothedAnimation se puede configurar estableciendo el velocity en el que debe producirse la animación, o el duration que debe seguir la animación. Si se especifican tanto el velocity como el duration, se elige el que da lugar a la animación más rápida para cada cambio en el valor de destino.
Por ejemplo, una animación de 0 a 800 tardará 4 segundos si se establece una velocidad de 200, tardará 8 segundos si se establece una duración de 8000 y tardará 4 segundos si se establecen tanto una velocidad de 200 como una duración de 8000. La animación de 0 a 20 000 tardará 10 segundos si se establece una velocidad de 200, tardará 8 segundos si se establece una duración de 8 000 y tardará 8 segundos si se establecen tanto una velocidad de 200 como una duración de 8 000.
La velocidad predeterminada de SmoothedAnimation es de 200 unidades/segundo. Ten en cuenta que, si el rango del valor que se anima es pequeño, será necesario ajustar la velocidad adecuadamente. Por ejemplo, la opacidad de un elemento oscila entre 0 y 1,0. Para conseguir una animación fluida en este rango, será necesario establecer la velocidad en un valor como 0,5 unidades/segundo. Animar de 0 a 1,0 con una velocidad de 0,5 tardará 2000 ms en completarse.
Al igual que cualquier otro tipo de animación, una «SmoothedAnimation» puede aplicarse de diversas formas, incluyendo transiciones, comportamientos y fuentes de valores de propiedades. La documentación «Animación y transiciones» en Qt Quick muestra diversos métodos para crear animaciones.
Véase también SpringAnimation, NumberAnimation, «Animación y transiciones» en Qt Quick y Qt Quick Ejemplos - Animación.
Documentación de propiedades
duration : int
Esta propiedad almacena la duración de la animación, en milisegundos, que se utiliza al realizar el seguimiento de la fuente.
Si se establece en -1 (el valor por defecto), se desactiva el valor de duración.
Si tanto el valor de velocidad como el de duración están activados, la animación utilizará el que proporcione la duración más corta.
maximumEasingTime : int
Esta propiedad especifica el tiempo máximo, en milisegundos, que deben durar las «aceleraciones» durante el seguimiento. Al configurar esta propiedad, la velocidad se «estabiliza» tras un tiempo determinado. Si se establece un valor negativo, se vuelve al modo normal de aceleración durante toda la duración de la animación.
El valor por defecto es -1.
reversingMode : enumeration
Establece cómo se comporta el objeto « SmoothedAnimation » si se invierte la dirección de una animación.
Los valores posibles son:
| Constante | Descripción |
|---|---|
SmoothedAnimation.Eased | (por defecto) la animación desacelerará suavemente y, a continuación, invertirá la dirección |
SmoothedAnimation.Immediate | la animación comenzará a acelerar inmediatamente en la dirección opuesta, partiendo de una velocidad de 0 |
SmoothedAnimation.Sync | la propiedad se establece inmediatamente en el valor de destino |
velocity : real
Esta propiedad contiene la velocidad media permitida al realizar el seguimiento del valor «to».
La velocidad predeterminada de SmoothedAnimation es de 200 unidades por segundo.
Si se establece en -1, se desactiva el valor de velocidad.
Si tanto el valor de velocidad como el de duración están activados, la animación utilizará el que proporcione la duración más corta.
© 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.