Qt3DAnimation::QAbstractClipAnimator Class
class Qt3DAnimation::QAbstractClipAnimatorQAbstractClipAnimator는 애니메이션 재생 기능을 제공하는 유형의 기본 클래스입니다. 더 보기...
| 헤더: | #include <qabstractclipanimator.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3danimation) target_link_libraries(mytarget PRIVATE Qt6::3danimation) |
| qmake: | QT += 3danimation |
| QML에서: | AbstractClipAnimator |
| 상속: | Qt3DCore::QComponent |
| 상속받는 클래스: | Qt3DAnimation::QBlendedClipAnimator 그리고 Qt3DAnimation::QClipAnimator |
| 상태: | 기술 미리보기 |
이 클래스는 기술 미리보기 단계에 있으며 변경될 수 있습니다.
공개 유형
| enum | Loops { Infinite } |
속성
|
|
공개 함수
| Qt3DAnimation::QChannelMapper * | channelMapper() const |
| Qt3DAnimation::QClock * | clock() const |
| bool | isRunning() const |
| int | loopCount() const |
| float | normalizedTime() const |
공개 슬롯
| void | setChannelMapper(Qt3DAnimation::QChannelMapper *channelMapper) |
| void | setClock(Qt3DAnimation::QClock *clock) |
| void | setLoopCount(int loops) |
| void | setNormalizedTime(float timeFraction) |
| void | setRunning(bool running) |
| void | start() |
| void | stop() |
신호
| void | channelMapperChanged(Qt3DAnimation::QChannelMapper *channelMapper) |
| void | clockChanged(Qt3DAnimation::QClock *clock) |
| void | loopCountChanged(int loops) |
| void | normalizedTimeChanged(float index) |
| void | runningChanged(bool running) |
상세 설명
QAbstractClipAnimator의 하위 클래스는 QEntity에 의해 집계되어 애니메이션 기능을 제공할 수 있습니다. 애니메이터 컴포넌트는 애니메이션 제어(예: 시작, 중지)를 위한 인터페이스를 제공합니다. 각 애니메이터 유형은 애니메이션 클립( QAbstractAnimationClip )과 같은 형태의 애니메이션 데이터와, 애니메이션 클립의 채널을 애니메이션 적용 대상 객체의 속성에 어떻게 매핑해야 하는지를 설명하는 매핑 데이터( QChannelMapper )가 필요합니다.
다음과 같은 하위 클래스를 사용할 수 있습니다:
멤버 유형 설명서
enum QAbstractClipAnimator::Loops
애니메이션이 재생되어야 할 횟수를 저장합니다.
| 상수 | 값 | 설명 |
|---|---|---|
Qt3DAnimation::QAbstractClipAnimator::Infinite | -1 | 명시적으로 중지될 때까지 루프가 계속 반복됩니다. |
속성 설명
channelMapper : Qt3DAnimation::QChannelMapper*
이 속성은 애니메이션 클립의 채널이 대상 객체의 속성에 어떻게 매핑되는지를 제어하는 ChannelMapper를 포함합니다.
액세스 함수:
| Qt3DAnimation::QChannelMapper * | channelMapper() const |
| void | setChannelMapper(Qt3DAnimation::QChannelMapper *channelMapper) |
Notifier 신호:
| void | channelMapperChanged(Qt3DAnimation::QChannelMapper *channelMapper) |
clock : Qt3DAnimation::QClock*
시계는 애니메이션이 재생되는 속도를 조절합니다.
액세스 함수:
| Qt3DAnimation::QClock * | clock() const |
| void | setClock(Qt3DAnimation::QClock *clock) |
알림 신호:
| void | clockChanged(Qt3DAnimation::QClock *clock) |
loops : int
애니메이션이 재생될 횟수를 지정합니다.
기본값은 1이며, 애니메이션이 한 번 재생된 후 중지됩니다.
QAbstractClipAnimator::Infinite 로 설정하면, 애니메이션은 명시적으로 중지될 때까지 계속 반복됩니다.
액세스 함수:
| int | loopCount() const |
| void | setLoopCount(int loops) |
알림 신호:
| void | loopCountChanged(int loops) |
normalizedTime : float
이 속성은 클립의 정규화된 시간을 저장합니다.
액세스 함수:
| float | normalizedTime() const |
| void | setNormalizedTime(float timeFraction) |
알림 신호:
| void | normalizedTimeChanged(float index) |
running : bool
이 속성은 애니메이션이 현재 실행 중인지 여부를 나타내는 부울 값을 저장합니다.
액세스 함수:
| bool | isRunning() const |
| void | setRunning(bool running) |
Notifier 신호:
| void | runningChanged(bool running) |
멤버 함수 설명서
bool QAbstractClipAnimator::isRunning() const
애니메이션이 현재 실행 중인지 여부를 나타내는 부울 값을 반환합니다.
참고: ` running` 속성에 대한게터 함수입니다.
int QAbstractClipAnimator::loopCount() const
애니메이션이 재생될 횟수를 반환합니다.
기본값은 1입니다. 애니메이션은 한 번 재생된 후 중지됩니다.
QAbstractClipAnimator::Infinite 로 설정하면 애니메이션이 명시적으로 중지될 때까지 계속 반복됩니다.
참고: loops 속성에 대한게터 함수입니다.
setLoopCount()도 참조하십시오 .
[slot] void QAbstractClipAnimator::start()
애니메이션을 시작합니다.
[slot] void QAbstractClipAnimator::stop()
애니메이션을 중지합니다.
© 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.
