QKeyframeAnimation Class
class Qt3DAnimation::QKeyframeAnimation간단한 키프레임 애니메이션을 구현하는 클래스 QTransform.. . 더보기...
| Header: | #include <QKeyframeAnimation> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3danimation)target_link_libraries(mytarget PRIVATE Qt6::3danimation) |
| qmake: | QT += 3danimation |
| QML에서: | KeyframeAnimation |
| 상속합니다: | Qt3DAnimation::QAbstractAnimation |
| 상태: | Deprecated |
공용 유형
| enum | RepeatMode { None, Constant, Repeat } |
속성
|
|
공용 기능
| QKeyframeAnimation(QObject *parent = nullptr) | |
| void | addKeyframe(Qt3DCore::QTransform *keyframe) |
| QEasingCurve | easing() const |
| Qt3DAnimation::QKeyframeAnimation::RepeatMode | endMode() const |
| QList<float> | framePositions() const |
| QList<Qt3DCore::QTransform *> | keyframeList() const |
| void | removeKeyframe(Qt3DCore::QTransform *keyframe) |
| void | setKeyframes(const QList<Qt3DCore::QTransform *> &keyframes) |
| Qt3DAnimation::QKeyframeAnimation::RepeatMode | startMode() const |
| Qt3DCore::QTransform * | target() const |
| QString | targetName() const |
공용 슬롯
| void | setEasing(const QEasingCurve &easing) |
| void | setEndMode(Qt3DAnimation::QKeyframeAnimation::RepeatMode mode) |
| void | setFramePositions(const QList<float> &positions) |
| void | setStartMode(Qt3DAnimation::QKeyframeAnimation::RepeatMode mode) |
| void | setTarget(Qt3DCore::QTransform *target) |
| void | setTargetName(const QString &name) |
신호
| void | easingChanged(const QEasingCurve &easing) |
| void | endModeChanged(Qt3DAnimation::QKeyframeAnimation::RepeatMode endMode) |
| void | framePositionsChanged(const QList<float> &positions) |
| void | startModeChanged(Qt3DAnimation::QKeyframeAnimation::RepeatMode startMode) |
| void | targetChanged(Qt3DCore::QTransform *target) |
| void | targetNameChanged(const QString &name) |
상세 설명
Qt3DAnimation::QKeyframeAnimation 클래스는 QTransform 에 애니메이션을 적용하는 데 사용할 수 있는 간단한 키프레임 애니메이션을 구현합니다. 키프레임은 여러 개의 시간 지정된 QTransform으로 구성되며, 이는 보간되어 대상 QTransform 에 적용됩니다. QEasingCurve 은 보간기를 제어하기 위해 키프레임 사이에 사용됩니다. RepeatMode 은 QKeyframeAnimation에 설정된 위치가 키프레임 위치에 정의된 값보다 낮거나 높을 때 설정할 수 있습니다.
멤버 유형 문서
enum QKeyframeAnimation::RepeatMode
이 열거형은 키프레임 값 외부의 위치 값이 처리되는 방식을 지정합니다.
| Constant | 값 | 설명 |
|---|---|---|
Qt3DAnimation::QKeyframeAnimation::None | 0 | 애니메이션이 대상 트랜스폼에 적용되지 않습니다. |
Qt3DAnimation::QKeyframeAnimation::Constant | 1 | 가장자리 키프레임 값이 사용됩니다. |
Qt3DAnimation::QKeyframeAnimation::Repeat | 2 | 애니메이션이 반복됩니다. |
속성 문서
easing : QEasingCurve
키프레임 사이의 보간기의 완화 곡선을 유지합니다.
기능에 액세스합니다:
| QEasingCurve | easing() const |
| void | setEasing(const QEasingCurve &easing) |
알림 신호:
| void | easingChanged(const QEasingCurve &easing) |
endMode : RepeatMode
마지막 프레임 위치보다 큰 위치 값에 대한 반복 모드를 유지합니다.
기능에 액세스합니다:
| Qt3DAnimation::QKeyframeAnimation::RepeatMode | endMode() const |
| void | setEndMode(Qt3DAnimation::QKeyframeAnimation::RepeatMode mode) |
알림 신호:
| void | endModeChanged(Qt3DAnimation::QKeyframeAnimation::RepeatMode endMode) |
framePositions : QList<float>
키프레임의 위치를 유지합니다. 목록의 각 위치는 동일한 인덱스를 가진 해당 키프레임의 위치를 지정합니다. 값은 오름차순이어야 합니다. 값은 양수 또는 음수일 수 있으며 미리 정의된 단위가 없습니다.
기능에 액세스합니다:
| QList<float> | framePositions() const |
| void | setFramePositions(const QList<float> &positions) |
알림 신호:
| void | framePositionsChanged(const QList<float> &positions) |
startMode : RepeatMode
첫 번째 프레임 위치보다 작은 위치 값에 대한 반복 모드를 유지합니다.
기능에 액세스합니다:
| Qt3DAnimation::QKeyframeAnimation::RepeatMode | startMode() const |
| void | setStartMode(Qt3DAnimation::QKeyframeAnimation::RepeatMode mode) |
알림 신호:
| void | startModeChanged(Qt3DAnimation::QKeyframeAnimation::RepeatMode startMode) |
target : Qt3DCore::QTransform*
애니메이션이 적용되는 대상 QTransform 을 보유합니다.
기능에 액세스합니다:
| Qt3DCore::QTransform * | target() const |
| void | setTarget(Qt3DCore::QTransform *target) |
알림 신호:
| void | targetChanged(Qt3DCore::QTransform *target) |
targetName : QString
대상 트랜스폼의 이름을 보유합니다. 이 속성은 대상 트랜스폼을 키프레임 애니메이션에 쉽게 일치시킬 수 있는 편의 속성입니다. 이름은 일반적으로 대상 트랜스폼의 상위 엔티티 이름과 동일하지만, 반드시 동일할 필요는 없습니다.
함수 액세스:
| QString | targetName() const |
| void | setTargetName(const QString &name) |
알림 신호:
| void | targetNameChanged(const QString &name) |
멤버 함수 문서
[explicit] QKeyframeAnimation::QKeyframeAnimation(QObject *parent = nullptr)
parent 를 사용하여 QKeyframeAnimation을 생성합니다.
void QKeyframeAnimation::addKeyframe(Qt3DCore::QTransform *keyframe)
애니메이션 끝에 keyframe 을 새로 추가합니다. QTransform 을 애니메이션에 여러 번 추가할 수 있습니다.
QList<Qt3DCore::QTransform *> QKeyframeAnimation::keyframeList() const
키프레임 목록을 반환합니다.
void QKeyframeAnimation::removeKeyframe(Qt3DCore::QTransform *keyframe)
애니메이션에서 keyframe 을 제거합니다. 동일한 QTransform 이 여러 번 키프레임으로 설정된 경우 모든 항목이 제거됩니다.
void QKeyframeAnimation::setKeyframes(const QList<Qt3DCore::QTransform *> &keyframes)
애니메이션의 keyframes 을 설정합니다. 이전 키프레임이 지워집니다.
© 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.
