이 페이지에서

Animator QML Type (Uncreatable)

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

Import Statement: import QtQuick
Inherits:

Animation

Inherited By:

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

참고: 이 유형은 생성할 수 없는 유형입니다. QML에서 인스턴스화할 수 없습니다.

속성

상세 설명

애니메이터(Animator) 유형은 일반적인 애니메이션 유형이 QML 객체 및 해당 속성을 대상으로 하는 것과는 달리, Qt Quick 의 씬 그래프에서 직접 작동하는 특수한 유형의 애니메이션입니다. 이로 인해 UI 스레드가 차단된 상태에서도 씬 그래프의 렌더링 스레드에서 애니메이터 기반 애니메이션을 실행할 수 있다는 장점이 있습니다.

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

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

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 의 모든 하위 애니메이션이 Animator 유형인 경우, ParallelAnimation 와 SequentialAnimation 도 Animator로 취급되어 가능한 경우 씬 그래프의 렌더링 스레드에서 실행됩니다.

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

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

참고: 비스레드형 렌더링 루프를 사용하는 경우Animator 유형은 아무런 이점을 제공하지 않습니다.

참고: 애플리케이션에서는 메인(GUI) 스레드에서 리소스 소모가 크고 차단되는 작업을 수행하는 동안 Animator에 의존하여 애니메이션 콘텐츠를 표시하기보다는, 멀티스레드 및 비동기 원리에 기반한 설계를 고려하는 것이 좋습니다 . 길고 차단되는 작업 대신, QML에서는 ` WorkerScript ` 및 ` asynchronous image loading `을, C++에서는 워커 스레드, 병렬 알고리즘, Qt Concurrent, 코루틴을 사용하는 것이 좋습니다. 이를 통해 전체 애플리케이션과 UI가 항상 반응성을 유지할 수 있습니다.

속성 문서

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.InQuad2차(t^2) 함수에 대한 이징 곡선: 0 속도에서 가속합니다.InQuad 완화 곡선
Easing.OutQuad2차(t^2) 함수에 대한 이징 곡선: 속도가 0이 될 때까지 감속합니다.OutQuad 이징 곡선
Easing.InOutQuad2차(t^2) 함수에 대한 이징 곡선: 중간 지점까지 가속한 후 감속합니다.InOutQuad 이징 곡선
Easing.OutInQuad2차(t^2) 함수에 대한 이징 곡선: 중간 지점까지 감속한 후 가속합니다.OutInQuad 이징 곡선
Easing.InCubic3차(t^3) 함수의 이징 곡선: 0 속도에서 가속합니다.InCubic 이징 곡선
Easing.OutCubic3차(t^3) 함수의 이징 곡선: 0 속도로 감속합니다.OutCubic 이징 커브
Easing.InOutCubic3차(t^3) 함수의 이징 곡선: 중간 지점까지 가속한 후 감속.InOutCubic 이징 곡선
Easing.OutInCubic3차(t^3) 함수의 이징 곡선: 중간 지점까지 감속한 뒤 가속합니다.OutInCubic 이징 커브
Easing.InQuart4차(t^4) 함수에 대한 이징 곡선: 0 속도에서 가속합니다.InQuart 이징 곡선
Easing.OutQuart4차(t^4) 함수의 이징 곡선: 0 속도까지 감속합니다.OutQuart 이징 곡선
Easing.InOutQuart4차(t^4) 함수의 이징 곡선: 중간 지점까지 가속한 후 감속합니다.InOutQuart 이징 곡선
Easing.OutInQuart4차(t^4) 함수의 이징 곡선: 중간 지점까지 감속한 후 가속합니다.OutInQuart 이징 곡선
Easing.InQuint5차 함수(t^5)의 이징 곡선: 0 속도에서 가속.InQuint 완화 곡선
Easing.OutQuint5차(t^5) 함수에 대한 이징 곡선: 0 속도로 감속합니다.OutQuint 감쇠 곡선
Easing.InOutQuint5차(t^5) 함수에 대한 이징 곡선: 중간 지점까지 가속한 후 감속.InOutQuint 이징 곡선
Easing.OutInQuint5차 함수(t^5)의 이징 곡선: 중간 지점까지 감속한 후 가속.OutInQuint 이징 곡선
Easing.InSine사인(sin(t)) 함수에 대한 이징 곡선: 0 속도에서 가속.InSine 이징 곡선
Easing.OutSine사인(sin(t)) 함수의 이징 커브: 속도가 0이 될 때까지 감속.OutSine 이징 곡선
Easing.InOutSine사인(sin(t)) 함수에 대한 이징 커브: 중간 지점까지 가속한 후 감속.InOutSine 이징 곡선
Easing.OutInSine사인(sin(t)) 함수의 이징 곡선: 중간 지점까지 감속한 후 가속합니다.OutInSine 이징 곡선
Easing.InExpo지수 함수(2^t)의 이징 곡선: 0 속도에서 가속.InExpo 완화 곡선
Easing.OutExpo지수 함수(2^t)에 대한 이징 곡선: 속도가 0이 될 때까지 감속합니다.OutExpo 완화 곡선
Easing.InOutExpo지수 함수(2^t)의 이징 곡선: 중간 지점까지 가속한 후 감속합니다.InOutExpo 완화 곡선
Easing.OutInExpo지수 함수(2^t)에 대한 이징 곡선: 중간 지점까지 감속한 후 가속합니다.OutInExpo 완화 곡선
Easing.InCirc원형(sqrt(1-t^2)) 함수의 이징 곡선: 0 속도에서 가속합니다.InCirc 완화 곡선
Easing.OutCirc원형(sqrt(1-t^2)) 함수의 이징 곡선: 0 속도로 감속합니다.OutCirc 이징 곡선
Easing.InOutCirc원형(sqrt(1-t^2)) 함수의 이징 곡선: 중간 지점까지 가속한 후 감속합니다.InOutCirc 이징 곡선
Easing.OutInCirc원형(sqrt(1-t^2)) 함수의 이징 곡선: 중간 지점까지 감속한 후 가속합니다.OutInCirc 이징 곡선
Easing.InElastic탄성(지수적으로 감쇠하는 사인파) 함수의 이징 곡선: 0 속도에서 가속.
최대 진폭은 amplitude 매개변수로, 감쇠 주기는 period 매개변수로 설정할 수 있습니다.
InElastic 이징 곡선
Easing.OutElastic탄성(지수적으로 감쇠하는 사인파) 함수의 이징 곡선: 속도가 0이 될 때까지 감속합니다.
피크 진폭은 amplitude 매개변수로, 감쇠 주기는 period 매개변수로 설정할 수 있습니다.
OutElastic 이징 곡선
Easing.InOutElastic탄성(지수적으로 감쇠하는 사인파) 함수에 대한 이징 커브: 중간 지점까지 가속한 후 감속.InOutElastic 이징 곡선
Easing.OutInElastic탄성(지수적으로 감쇠하는 사인파) 함수에 대한 이징 곡선: 중간 지점까지 감속한 후 가속.OutInElastic 이징 곡선
Easing.InBack백(오버슈팅 3차 함수: (s+1)*t^3 - s*t^2) 이징 커브: 0 속도에서 가속.InBack 이징 곡선
Easing.OutBack백(오버슈팅 3차 함수: (s+1)*t^3 - s*t^2) 이징 아웃의 이징 곡선: 속도가 0이 될 때까지 감속합니다.아웃백 완화 곡선
Easing.InOutBack백(오버슈팅 3차 함수: (s+1)*t^3 - s*t^2) 이징 인/아웃용 이징 커브: 중간 지점까지 가속한 후 감속합니다.InOutBack 완화 곡선
Easing.OutInBack뒤로 이동용 이징 곡선 (오버슈팅 3차 이징: (s+1)*t^3 - s*t^2) 이징 아웃/인: 중간 지점까지 감속한 후 가속.OutInBack 완화 곡선
Easing.InBounce바운스(지수적으로 감쇠하는 포물선형 바운스) 함수를 위한 이징 커브: 0 속도에서 가속합니다.InBounce 이징 곡선
Easing.OutBounce바운스(지수적으로 감쇠하는 포물선형 바운스) 함수에 대한 이징 커브: 속도가 0이 될 때까지 감속.OutBounce 이징 커브
Easing.InOutBounce바운스(지수적으로 감쇠하는 포물선형 바운스) 함수의 이징 곡선(이징 인/아웃): 중간 지점까지 가속한 후 감속합니다.InOutBounce 이징 곡선
Easing.OutInBounce바운스(지수적으로 감쇠하는 포물선형 바운스) 함수의 이징 아웃/인 이징 곡선: 중간 지점까지 감속한 후 가속합니다.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까지의 곡선을 정의하는 세 점의 그룹(제어점 1, 제어점 2, 끝점: [cx1, cy1, cx2, cy2, endx, endy, ...])을 포함하는 list<real>입니다. 마지막 점은 반드시 1,1이어야 합니다.

다양한 이징 설정에 대한 예시는 이징 곡선(Easing Curves )을 참조하십시오.

from : real

이 속성은 애니메이션의 시작 값을 저장합니다.

Animator가 Transition 또는 Behavior 내에 정의된 경우, 이 값은 기본적으로 Transition 의 시작 상태에 정의된 값이나, Behavior 가 트리거되는 시점의 속성 현재 값으로 설정됩니다.

Qt Quick 의 ‘애니메이션 및 전환’항목도 참조하십시오 .

target : QtQuick::Item

이 속성은 애니메이터의 대상 항목을 저장합니다.

참고: 애니메이터의 타깃은 반드시 아이템 기반 유형이어야 합니다.

to : real

이 속성은 애니메이션의 종료 값을 저장합니다.

Animator가 Transition 또는 Behavior 내에 정의된 경우, 이 값은 기본적으로 Transition 의 종료 상태에 정의된 값이나, 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.