이 페이지에서

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
상태: 기술 미리보기

이 클래스는 기술 미리보기 단계에 있으며 변경될 수 있습니다.

속성

공개 함수

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 * additiveClip

additiveFacor 속성에 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.