Back to Qt.io
Contact Us Blog Download Qt

Animator QML Type

모든 QML 애니메이터의 기반입니다. 더 보기...

Import Statement: import QtQuick
Inherits:

Animation

Inherited By:

OpacityAnimator, RotationAnimator, ScaleAnimator, UniformAnimator, XAnimator, and YAnimator

속성

자세한 설명

애니메이터 유형은 일반 애니메이션 유형처럼 QML 객체와 그 프로퍼티가 아닌 Qt Quick 의 씬 그래프에서 직접 작동하는 특수한 애니메이션 유형입니다. 애니메이터 기반 애니메이션은 UI 스레드가 차단된 경우에도 씬 그래프의 렌더링 스레드에서 애니메이션을 적용할 수 있다는 이점이 있습니다.

QML 프로퍼티의 값은 애니메이션이 완료된 후에 업데이트됩니다. 애니메이션이 실행되는 동안에는 프로퍼티가 업데이트되지 않습니다.

애니메이터 유형은 다른 애니메이션 유형과 마찬가지로 사용할 수 있습니다.

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
    }
}

ParallelAnimation 및 SequentialAnimation 의 모든 하위 애니메이션이 애니메이터 유형인 경우 ParallelAnimation 및 SequentialAnimation 도 애니메이터로 간주되어 가능한 경우 씬 그래프의 렌더링 스레드에서 실행됩니다.

애니메이터 유형은 전환 중 애니메이션에 사용할 수 있지만 reversible 속성은 지원하지 않습니다.

애니메이터 유형은 QML 파일에서 직접 사용할 수 없습니다. 이 유형은 이를 상속하는 다른 모든 애니메이터 유형에서 사용할 수 있는 공통 속성 및 메서드 집합을 제공하기 위해 존재합니다. 애니메이터 유형을 직접 사용하려고 하면 오류가 발생합니다.

프로퍼티 문서

duration : int

이 프로퍼티는 애니메이션의 지속 시간을 밀리초 단위로 저장합니다.

기본값은 250입니다.


easing group

easing.amplitude : real

easing.bezierCurve : list<real>

easing.overshoot : real

easing.period : real

easing.type : enumeration

애니메이션에 사용되는 완화 커브를 지정합니다.

완화 커브를 지정하려면 최소한 유형을 지정해야 합니다. 일부 커브의 경우 진폭, 주기 및/또는 오버슈트를 지정할 수도 있습니다(자세한 내용은 표 뒤에 제공됨). 기본 완화 곡선은 Easing.Linear 입니다.

PropertyAnimation { properties: "y";
                    easing.type: Easing.InOutElastic;
                    easing.amplitude: 2.0;
                    easing.period: 1.5 }

사용 가능한 유형은 다음과 같습니다:

Easing.Linear선형(t) 함수에 대한 완화 커브: 속도는 일정합니다.
Easing.InQuad이차(t^2) 함수에 대한 완화 곡선: 0 속도에서 가속합니다.
Easing.OutQuad이차(t^2) 함수에 대한 완화 곡선: 영속으로 감속합니다.
Easing.InOutQuad이차(t^2) 함수에 대한 완화 곡선: 절반까지 가속한 다음 감속합니다.
Easing.OutInQuad이차(t^2) 함수에 대한 완화 곡선: 절반까지 감속한 다음 가속합니다.
Easing.InCubic3차(t^3) 함수에 대한 완화 곡선: 영속에서 가속합니다.
Easing.OutCubic3차(t^3) 함수에 대한 완화 곡선: 영속으로 감속합니다.
Easing.InOutCubic3차(t^3) 함수에 대한 완화 곡선: 절반까지 가속한 다음 감속합니다.
Easing.OutInCubic세제곱(t^3) 함수에 대한 완화 곡선: 절반까지 감속한 다음 가속합니다.
Easing.InQuart2차(t^4) 함수에 대한 완화 곡선: 영속에서 가속합니다.
Easing.OutQuart이차(t^4) 함수에 대한 완화 곡선: 영속으로 감속합니다.
Easing.InOutQuart이차(t^4) 함수에 대한 완화 곡선: 절반까지 가속한 다음 감속합니다.
Easing.OutInQuart이차(t^4) 함수에 대한 완화 곡선: 절반까지 감속한 다음 가속합니다.
Easing.InQuint5차(t^5) 함수에 대한 완화 곡선: 영속에서 가속합니다.
Easing.OutQuint5차(t^5) 함수에 대한 완화 곡선: 영속으로 감속합니다.
Easing.InOutQuint5차(t^5) 함수에 대한 완화 곡선: 절반까지 가속한 다음 감속합니다.
Easing.OutInQuint5차(t^5) 함수에 대한 완화 곡선: 절반까지 감속한 다음 가속합니다.
Easing.InSine사인 곡선(sin(t)) 함수에 대한 완화 곡선: 영속에서 가속합니다.
Easing.OutSine정현파(sin(t)) 함수에 대한 완화 곡선: 영속으로 감속합니다.
Easing.InOutSine정현파(sin(t)) 함수에 대한 완화 곡선: 절반까지 가속한 다음 감속합니다.
Easing.OutInSine사인 곡선(sin(t)) 함수에 대한 완화 곡선: 절반까지 감속한 다음 가속합니다.
Easing.InExpo지수(2^t) 함수에 대한 완화 곡선: 0 속도에서 가속합니다.
Easing.OutExpo지수(2^t) 함수에 대한 완화 곡선: 영속으로 감속합니다.
Easing.InOutExpo지수(2^t) 함수에 대한 완화 곡선: 절반까지 가속한 다음 감속합니다.
Easing.OutInExpo지수(2^t) 함수에 대한 완화 곡선: 절반까지 감속한 다음 가속합니다.
Easing.InCirc원형(sqrt(1-t^2)) 함수에 대한 완화 곡선: 영속에서 가속합니다.
Easing.OutCirc원형 (sqrt(1-t^2)) 함수에 대한 완화 곡선: 영속으로 감속합니다.
Easing.InOutCirc원형 (sqrt(1-t^2)) 함수에 대한 완화 곡선: 절반까지 가속한 다음 감속합니다.
Easing.OutInCirc원형 (sqrt(1-t^2)) 함수에 대한 완화 곡선: 절반까지 감속한 다음 가속합니다.
Easing.InElastic탄성(지수적으로 감쇠하는 사인파) 함수에 대한 완화 곡선: 0 속도에서 가속합니다.
진폭 파라미터로 피크 진폭을, 주기 파라미터로 감쇠 주기를 설정할 수 있습니다.
Easing.OutElastic탄성(기하급수적으로 감쇠하는 사인파) 함수에 대한 완화 곡선: 제로 속도로 감속합니다.
진폭 파라미터로 피크 진폭을, 주기 파라미터로 감쇠 주기를 설정할 수 있습니다.
Easing.InOutElastic탄성(기하급수적으로 감쇠하는 사인파) 함수에 대한 완화 곡선: 절반까지 가속한 다음 감속합니다.
Easing.OutInElastic탄성(지수 함수) 함수에 대한 완화 곡선: 절반까지 감속한 다음 가속합니다.
Easing.InBack역(오버슈팅 입방 함수: (s+1)*t^3 - s*t^2) 완화 곡선 완화: 영속에서 가속합니다.
Easing.OutBack백에 대한 완화 곡선(오버슈팅 큐빅 함수: (s+1)*t^3 - s*t^2) 완화 아웃: 영속으로 감속합니다.
Easing.InOutBack백에 대한 이완 곡선(오버슈팅 큐빅 함수: (s+1)*t^3 - s*t^2) 이완 인/아웃: 절반까지 가속한 다음 감속합니다.
Easing.OutInBack백에 대한 완화 곡선(오버슈팅 큐빅 완화: (s+1)*t^3 - s*t^2) 완화 아웃/인: 절반까지 감속한 다음 가속합니다.
Easing.InBounce바운스(기하급수적으로 감쇠하는 포물선 바운스) 함수에 대한 완화 곡선: 제로 속도에서 가속합니다.
Easing.OutBounce바운스(기하급수적으로 감쇠하는 포물선 바운스) 함수에 대한 완화 곡선: 영속으로 감속합니다.
Easing.InOutBounce바운스(기하급수적으로 감쇠하는 포물선 바운스) 함수 이완 인/아웃에 대한 이완 커브: 중간까지 가속한 다음 감속합니다.
Easing.OutInBounce바운스(기하급수적으로 감쇠하는 포물선 바운스) 함수 이완 인/아웃에 대한 이완 커브: 절반까지 감속한 다음 가속합니다.
Easing.BezierSplineeasing.bezierCurve 속성으로 정의된 커스텀 완화 커브입니다.

easing.amplitude 는 바운스 및 탄성 커브( Easing.InBounce, Easing.OutBounce, Easing.InOutBounce, Easing.OutInBounce, Easing.InElastic, Easing.OutElastic, Easing.InOutElastic 또는 Easing.OutInElastic 유형의 커브)에만 적용 가능합니다.

easing.overshoot 는 easing.type 인 경우에만 적용됩니다: Easing.InBack, Easing.OutBack, Easing.InOutBack 또는 Easing.OutInBack.

easing.period 는 easing.type이 다음과 같은 경우에만 적용됩니다: Easing.InElastic, Easing.OutElastic, Easing.InOutElastic 또는 Easing.OutInElastic 입니다.

easing.bezierCurve 는 easing.type이 Easing.BezierSpline 인 경우에만 적용됩니다. 이 속성은 0,0에서 1,1까지의 커브를 정의하는 세 점의 그룹을 포함하는 목록<실제>입니다 - control1, control2, 끝점: [cx1, cy1, cx2, cy2, endx, endy, ...]. 마지막 점은 1,1이어야 합니다.

다양한 완화 설정에 대한 데모는 완화 커브를 참조하십시오.


from : real

이 프로퍼티는 애니메이션의 시작 값을 보유합니다.

애니메이터가 Transition 또는 Behavior 내에 정의된 경우 이 값은 Transition 의 시작 상태에 정의된 값 또는 Behavior 가 트리거되는 순간의 프로퍼티의 현재 값으로 기본값이 지정됩니다.

Qt Quick 의 애니메이션 및 전환을참조하세요 .


target : QtQuick::Item

이 프로퍼티는 애니메이터의 대상 항목을 보유합니다.

참고: 애니메이터 타깃은 항목 기반 유형이어야 합니다.


to : real

이 속성은 애니메이션의 끝 값을 보유합니다.

애니메이터가 Transition 또는 Behavior 내에 정의된 경우 이 값은 Transition 의 종료 상태 또는 Behavior 을 트리거한 속성 변경 값에 정의된 값으로 기본값이 지정됩니다.


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