이 페이지에서

SpringAnimation QML Type

속성이 스프링처럼 탄력적으로 값을 추적할 수 있게 합니다. 더 보기...

Import Statement: import QtQuick
Inherits:

NumberAnimation

속성

상세 설명

SpringAnimation은 스프링의 진동 동작을 모방하며, 적절한 탄성 상수( spring )를 통해 가속도를 제어하고, 감쇠 상수( damping )를 통해 효과가 사라지는 속도를 제어합니다.

또한 애니메이션의 최대 velocity 을 제한할 수도 있습니다.

Rectangle 다음 예제에서는 마우스를 클릭하면 SpringAnimation을 사용하여 마우스 위치로 이동합니다. x 및 y 값에 Behavior 를 적용함으로써, 해당 값이 변경될 때마다 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
        }
    }
}

다른 애니메이션 유형과 마찬가지로, SpringAnimation은 전환(transitions), 동작(behaviors), 속성 값 소스(property value sources) 등 다양한 방법으로 적용할 수 있습니다. Qt Quick 문서의 ‘애니메이션 및 전환(Animation and Transitions )’ 섹션에서는 애니메이션을 생성하는 다양한 방법을 보여줍니다.

SmoothedAnimation, Qt Quick 의 ‘애니메이션 및 전환(Animation and Transitions)’, Qt Quick 의 ‘예제 - 애니메이션(Examples - Animation)’, 그리고 Qt Quick 의 ‘데모 - 시계(Demo - Clocks)’도 참조하십시오 .

속성 문서

damping : real

이 속성은 스프링 감쇠 값을 저장합니다.

이 값은 스프링과 같은 움직임이 얼마나 빨리 정지하는지를 나타냅니다. 기본값은 0입니다.

유용한 값의 범위는 0 ~ 1.0입니다. 값이 낮을수록 정지하는 속도가 빨라집니다.

epsilon : real

이 속성은 스프링 엡실론을 저장합니다.

엡실론은 값의 변화율과 변화량을 나타내며, 0에 충분히 가까워 0과 동일하게 간주될 수 있는 값입니다. 이는 해당 값의 용도에 따라 달라집니다. 픽셀 위치의 경우 0.25면 충분합니다. 스케일의 경우 0.005면 충분합니다.

기본값은 0.01입니다. 이 값을 조정하면 성능이 약간 향상될 수 있습니다.

mass : real

이 속성은 이동 중인 속성의 “질량”을 나타냅니다.

기본값은 1.0입니다.

질량이 클수록 이동 속도가 느려지고, 아이템이 정지할 때 더 탄성 있는 움직임을 보입니다.

modulus : real

이 속성은 모듈러스 값을 저장합니다. 기본값은 0입니다.

modulus 를 설정하면 대상 값이 모듈러스에서 "순환"하도록 강제됩니다. 예를 들어, 모듈러스를 360으로 설정하면 370이라는 값이 10으로 순환됩니다.

spring : real

이 속성은 대상이 소스 쪽으로 얼마나 강하게 당겨지는지를 나타냅니다. 기본값은 0입니다(즉, 스프링과 같은 움직임이 비활성화됨).

유용한 값의 범위는 0 ~ 5.0입니다.

이 속성이 설정되어 있고 ` velocity ` 값이 0보다 클 경우, ` velocity `가 최대 속도를 제한합니다.

velocity : real

이 속성은 소스를 추적할 때 허용되는 최대 속도를 지정합니다.

기본값은 0입니다(최대 속도 없음).

© 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.