Qt3DAnimation::QAdditiveClipBlend Class
class Qt3DAnimation::QAdditiveClipBlend두 개의 애니메이션 클립을 가산 계수를 기준으로 가산 합성합니다. 더 보기...
| 헤더: | #include <qadditiveclipblend.h> |
| CMake: | find_package(Qt6 REQUIRED COMPONENTS 3danimation) target_link_libraries(mytarget PRIVATE Qt6::3danimation) |
| qmake: | QT += 3danimation |
| QML에서: | AdditiveClipBlend |
| 상속: | Qt3DAnimation::QAbstractClipBlendNode |
| 상태: | 기술 미리보기 |
이 클래스는 기술 미리보기 단계에 있으며 변경될 수 있습니다.
속성
- additiveClip : Qt3DAnimation::QAbstractClipBlendNode*
- additiveFactor : float
- baseClip : Qt3DAnimation::QAbstractClipBlendNode*
공개 함수
| Qt3DAnimation::QAbstractClipBlendNode * | additiveClip() const |
| float | additiveFactor() const |
| Qt3DAnimation::QAbstractClipBlendNode * | baseClip() const |
공개 슬롯
| void | setAdditiveClip(Qt3DAnimation::QAbstractClipBlendNode *additiveClip) |
| void | setAdditiveFactor(float additiveFactor) |
| void | setBaseClip(Qt3DAnimation::QAbstractClipBlendNode *baseClip) |
신호
| void | additiveClipChanged(Qt3DAnimation::QAbstractClipBlendNode *additiveClip) |
| void | additiveFactorChanged(float additiveFactor) |
| void | baseClipChanged(Qt3DAnimation::QAbstractClipBlendNode *baseClip) |
상세 설명
QAdditiveClipBlend는 개별 애니메이션 클립을 기반으로 한 고급 애니메이션 효과를 만드는 데 유용할 수 있습니다. 예를 들어, 다음과 같이 설정하면:
- baseClip 속성을 일반적인 걷기 사이클 애니메이션 클립으로 설정하고
- additiveClip 속성을 고개를 흔드는 차이 애니메이션 클립으로 설정하면,
이때 ` additiveFactor ` 속성을 조정하면 ` additiveClip `가 ` baseClip`에 얼마나 더해질지 제어할 수 있습니다. 이는 ` additiveFactor ` 값이 0일 때 이 블렌드 노드가 원래의 걷기 사이클 클립을 출력하는 효과를 냅니다. ` additiveFactor ` 값이 1일 때는 고개를 흔드는 애니메이션이 포함된 걷기 사이클을 출력합니다.
이 클래스에서 구현된 블렌딩 연산은 다음과 같습니다:
resultClip = baseClip + additiveFactor * additiveClipadditiveFacor 속성에 0에서 1 사이의 범위를 벗어난 값을 사용하는 것을 막는 제한은 없지만, 입력 애니메이션 클립이 이러한 설정이 의미 있게 작동하도록 제작되지 않았을 수 있다는 점에 유의하시기 바랍니다.
QBlendedClipAnimator도 참조하십시오 .
속성 문서
additiveClip : Qt3DAnimation::QAbstractClipBlendNode*
이 속성은 ‘ baseClip ’과 블렌딩될 ‘additive clip’을 저장합니다. 블렌딩 정도는 ‘ additiveFactor ’ 속성으로 제어됩니다.
액세스 함수:
| Qt3DAnimation::QAbstractClipBlendNode * | additiveClip() const |
| void | setAdditiveClip(Qt3DAnimation::QAbstractClipBlendNode *additiveClip) |
알림 신호:
| void | additiveClipChanged(Qt3DAnimation::QAbstractClipBlendNode *additiveClip) |
additiveFactor : float
두 애니메이션 클립의 블렌딩을 제어하기 위한 블렌딩 계수(일반적으로 0에서 1 사이)를 지정합니다.
액세스 함수:
| float | additiveFactor() const |
| void | setAdditiveFactor(float additiveFactor) |
알림 신호:
| void | additiveFactorChanged(float additiveFactor) |
baseClip : Qt3DAnimation::QAbstractClipBlendNode*
이 속성은 기본 애니메이션 클립을 저장합니다. ‘ additiveFactor ’ 값이 0일 경우, ‘baseClip’도 이 블렌드 노드의 결과 클립이 됩니다.
액세스 함수:
| Qt3DAnimation::QAbstractClipBlendNode * | baseClip() const |
| void | setBaseClip(Qt3DAnimation::QAbstractClipBlendNode *baseClip) |
알림 신호:
| void | baseClipChanged(Qt3DAnimation::QAbstractClipBlendNode *baseClip) |
© 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.