SpringAnimation QML Type

Permite a una propiedad seguir un valor con un movimiento similar al de un muelle. Más...

• Lista de todos los miembros, incluidos los heredados

Propiedades

• damping : real
• epsilon : real
• mass : real
• modulus : real
• spring : real
• velocity : real

Descripción detallada

SpringAnimation imita el comportamiento oscilatorio de un muelle, con la constante spring apropiada para controlar la aceleración y la damping para controlar la rapidez con la que desaparece el efecto.

También se puede limitar el máximo velocity de la animación.

El siguiente Rectangle se mueve a la posición del ratón utilizando un SpringAnimation cuando se hace clic con el ratón. El uso de Behavior en los valores x y y indica que siempre que se cambien estos valores, se debe aplicar un SpringAnimation.

import QtQuick

Item {
    width: 300; height: 300

    Rectangle {
        id: rect
        width: 50; height: 50
        color: "red"

        Behavior on x { SpringAnimation { spring: 2; damping: 0.2 } }
        Behavior on y { SpringAnimation { spring: 2; damping: 0.2 } }
    }

    MouseArea {
        anchors.fill: parent
        onClicked: (mouse)=> {
            rect.x = mouse.x - rect.width/2
            rect.y = mouse.y - rect.height/2
        }
    }
}

Como cualquier otro tipo de animación, una SpringAnimation puede aplicarse de varias maneras, incluyendo transiciones, comportamientos y fuentes de valores de propiedades. La documentación Animación y transiciones en Qt Quick muestra una variedad de métodos para crear animaciones.

Consulte también SmoothedAnimation, Animación y transiciones en Qt Quick, Qt Quick Ejemplos - Animación, y Qt Quick Demo - Relojes.

Documentación de Propiedades

damping : real

Esta propiedad contiene el valor de amortiguación del muelle.

Este valor describe la rapidez con la que el movimiento del muelle vuelve al reposo. El valor por defecto es 0.

El rango de valores útiles es 0 - 1.0. Cuanto menor sea el valor, más rápido llegará al reposo.

epsilon : real

Esta propiedad mantiene el épsilon del muelle.

El épsilon es la tasa y la cantidad de cambio en el valor que está lo suficientemente cerca de 0 como para ser considerado igual a cero. Esto dependerá del uso del valor. Para posiciones de píxel, 0,25 sería suficiente. Para la escala, bastará con 0,005.

El valor por defecto es 0,01. Ajustar este valor puede proporcionar pequeñas mejoras de rendimiento.

mass : real

Esta propiedad contiene la "masa" de la propiedad que se está moviendo.

El valor por defecto es 1.0.

Una masa mayor provoca un movimiento más lento y un mayor movimiento de resorte cuando un elemento se detiene.

modulus : real

Esta propiedad contiene el valor del módulo. El valor por defecto es 0.

Establecer un modulus fuerza al valor objetivo a "envolverse" en el módulo. Por ejemplo, establecer el módulo en 360 hará que un valor de 370 se envuelva en 10.

spring : real

Esta propiedad describe con qué fuerza se tira del objetivo hacia la fuente. El valor por defecto es 0 (es decir, el movimiento de resorte está desactivado).

El rango de valores útiles es 0 - 5.0.

Cuando se establece esta propiedad y el valor de velocity es mayor que 0, velocity limita la velocidad máxima.

velocity : real

Esta propiedad contiene la velocidad máxima permitida cuando se rastrea la fuente.

El valor por defecto es 0 (sin velocidad máxima).